Override Execution State

Manually override execution state (admin/debug)

Allows manual state transitions with reasoning. Records the override in the transitions table for audit purposes.

POST /api/v1/executions/{execution_id}/transitions/override

Override Execution State

cURL

curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/executions/{execution_id}/transitions/override \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "state": "<string>",
  "reasoning": "<string>"
}
'

422

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

Authorization · string · header · required

Enter your Kubiya API token (format: Bearer )

Path Parameters

execution_id · string · required

Body

application/json

Request to manually override execution state

state · string · required

New state (running, waiting_for_input, completed, failed)

reasoning · string · required

Reason for manual override

Response

200

application/json

Successful Response