Skip to main content
POST
/
api
/
partners
/
v2.0
/
cues
/
{cue_id}
/
state
Report the outcome of an active action
curl --request POST \
  --url https://api.example.com/api/partners/v2.0/cues/{cue_id}/state \
  --header 'Content-Type: application/json' \
  --data '
{
  "state": "success",
  "payload": {},
  "location": {},
  "client_info": {}
}
'
{
  "action_id": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://developers.podero.com/llms.txt

Use this file to discover all available pages before exploring further.

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

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

location
Location · object

Optional caller location metadata recorded alongside the outcome event.

client_info
Client Info · object

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.