Skip to main content
POST
Execute a control action (retry, fallback model, or prompt modification)

Authorizations

Authorization
string
header
required

SDK API key (tl_...) or Clerk session JWT

Body

application/json
project_id
string<uuid>
required
action_type
enum<string>
required
Available options:
retry,
fallback_model,
prompt_modification,
agent_action
trace_id
string<uuid> | null
rule_id
string<uuid> | null
payload
object | null

Response

Control action created and executed

id
string<uuid>
required
tenant_id
string<uuid>
required
project_id
string<uuid>
required
action_type
enum<string>
required
Available options:
retry,
fallback_model,
prompt_modification,
agent_action,
escalate
status
enum<string>
required
Available options:
pending,
pending_approval,
executed,
failed
created_at
string<date-time>
required
updated_at
string<date-time>
required
trace_id
string<uuid> | null
rule_id
string<uuid> | null
payload
object | null
result
object | null
executed_at
string<date-time> | null