feat: FIT-974: [FSM API] Manual Transition Endpoint (#676)

Co-authored-by: fern-api[bot] <115122769+fern-api[bot]@users.noreply.github.com>

Author: robot-ci-heartex

.mock/definition/__package__.yml

@@ -2298,6 +2298,14 @@ types:
           maxLength: 2048
     source:
       openapi: openapi/openapi.yaml
+  FsmTransitionExecuteResponse:
+    docs: Response serializer for manual FSM transition execution.
+    properties:
+      new_state: optional<string>
+      state_record: optional<StateModel>
+      success: boolean
+    source:
+      openapi: openapi/openapi.yaml
   FileUpload:
     properties:
       file: string

.mock/definition/fsm.yml

@@ -76,5 +76,52 @@ service:
                     id: 1
       audiences:
         - internal
+    execute_transition:
+      path: /api/fsm/entities/{entity_name}/{entity_id}/transition/
+      method: POST
+      auth: true
+      docs: Execute a registered manual transition for an entity.
+      source:
+        openapi: openapi/openapi.yaml
+      path-parameters:
+        entity_id: integer
+        entity_name: string
+      display-name: Execute manual FSM transition
+      request:
+        name: FsmTransitionExecuteRequestRequest
+        body:
+          properties:
+            transition_data: optional<map<string, unknown>>
+            transition_name:
+              type: string
+              validation:
+                minLength: 1
+        content-type: application/json
+      response:
+        docs: ''
+        type: root.FsmTransitionExecuteResponse
+      examples:
+        - path-parameters:
+            entity_id: 1
+            entity_name: entity_name
+          request:
+            transition_name: transition_name
+          response:
+            body:
+              new_state: new_state
+              state_record:
+                context_data:
+                  key: value
+                created_at: '2024-01-15T09:30:00Z'
+                id: id
+                previous_state: previous_state
+                state: state
+                transition_name: transition_name
+                triggered_by:
+                  email: email
+                  id: 1
+              success: true
+      audiences:
+        - internal
   source:
     openapi: openapi/openapi.yaml

.mock/openapi/openapi.yaml

@@ -4048,6 +4048,49 @@ paths:
         results: $response.results
       x-fern-sdk-group-name: fsm
       x-fern-sdk-method-name: state_history
+  /api/fsm/entities/{entity_name}/{entity_id}/transition/:
+    post:
+      description: Execute a registered manual transition for an entity.
+      operationId: api_fsm_entities_transition_create
+      parameters:
+        - in: path
+          name: entity_id
+          required: true
+          schema:
+            type: integer
+        - in: path
+          name: entity_name
+          required: true
+          schema:
+            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/FSMTransitionExecuteRequestRequest'
+          application/x-www-form-urlencoded:
+            schema:
+              $ref: '#/components/schemas/FSMTransitionExecuteRequestRequest'
+          multipart/form-data:
+            schema:
+              $ref: '#/components/schemas/FSMTransitionExecuteRequestRequest'
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/FSMTransitionExecuteResponse'
+          description: ''
+      security:
+        - Token: []
+      summary: Execute manual FSM transition
+      tags:
+        - FSM
+      x-fern-audiences:
+        - internal
+      x-fern-sdk-group-name: fsm
+      x-fern-sdk-method-name: execute_transition
   /api/import/file-upload/{id}:
     delete:
       description: Delete a specific uploaded file.
@@ -22154,6 +22197,39 @@ components:
       required:
         - export_type
       type: object
+    FSMTransitionExecuteRequestRequest:
+      description: Request body serializer for executing a manual FSM transition.
+      properties:
+        transition_data:
+          additionalProperties: {}
+          nullable: true
+          type: object
+        transition_name:
+          minLength: 1
+          type: string
+      required:
+        - transition_name
+      type: object
+    FSMTransitionExecuteResponse:
+      description: Response serializer for manual FSM transition execution.
+      properties:
+        new_state:
+          nullable: true
+          readOnly: true
+          type: string
+        state_record:
+          allOf:
+            - $ref: '#/components/schemas/StateModel'
+          nullable: true
+          readOnly: true
+        success:
+          readOnly: true
+          type: boolean
+      required:
+        - new_state
+        - state_record
+        - success
+      type: object
     FileUpload:
       properties:
         file: