Skip to main content
POST
Report the outcome of an active action

Path Parameters

cue_id
string<uuid>
required

The action's ID

Query Parameters

secret
string
required

Signed secret authorising the caller for this action

Body

application/json
state
enum<string>
required

Outcome of the action: success marks it completed, fail records a failure and leaves it available to retry.

Available options:
success,
fail
payload
Payload · object | null

Optional free-form payload forwarded to the action handler (e.g. provider-specific result data).

location
Location · object | null

Optional caller location metadata recorded alongside the outcome event.

client_info
Client Info · object | null

Optional caller client metadata (user-agent, device, etc.) recorded alongside the outcome event.

Response

200 - application/json

OK

action_id
string
required

ID of the action whose outcome was recorded.