---
title: "✨ Execute manual state transition"
method: POST
path: "/api/fsm/entities/{entity_name}/{entity_id}/transition/"
tags: ["States"]
---

# ✨ Execute manual state transition

`POST /api/fsm/entities/{entity_name}/{entity_id}/transition/`

<Card href="https://humansignal.com/goenterprise">
        <img style="pointer-events: none; margin-left: 0px; margin-right: 0px;" src="https://docs.humansignal.com/images/badge.svg" alt="Label Studio Enterprise badge"/>
        <p style="margin-top: 10px; font-size: 14px;">
            This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)
        </p>
    </Card>
Execute a registered manual transition for an entity.

## Path parameters

- `entity_id` integer, required
- `entity_name` string, required

## Request body

- FSMTransitionExecuteRequestRequest — Request body serializer for executing a manual FSM transition.
  - `transition_data` object, nullable
  - `transition_name` string, required

## Response `200`

- FSMTransitionExecuteResponse — Response serializer for manual FSM transition execution.
  - `new_state` string, nullable, required
  - `state_record` StateModel, required — Serializer for FSM state models. Uses Serializer instead of ModelSerializer because BaseState is abstract. Works with any concrete state model that inherits from BaseState.
    - `context_data` unknown, required
    - `created_at` string, date-time, required
    - `id` string, uuid, required
    - `previous_state` string, nullable, required
    - `reason` string, nullable, required
    - `state` string, required
    - `transition_name` string, nullable, required
    - `triggered_by` TriggeredBy, required — A ModelSerializer that takes additional arguments for "fields", "omit" and "expand" in order to control which fields are displayed, and whether to replace simple values with complex, nested serializations
      - `email` string, email
      - `id` integer, required
  - `success` boolean, required

---

[API](https://skmtc.dev/humansignal/apis/label-studio-api.md) · [All operations](https://skmtc.dev/humansignal/apis/label-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/humansignal/label-studio-api/revisions/cbc94e6444bb/schema)