Your API key:

All requests below will use this key. Your API key is sent directly to api.cueapi.ai and never stored by the docs site.

POST/v1/executions/{execution_id}/outcome

Report Outcome

Report the outcome of an execution. Write-once — can only be set once per execution.

execution_idstringrequiredpath

The execution UUID.

successbooleanrequiredbody

Whether the handler succeeded.

resultstringbody

Success message or output summary.

errorstringbody

Error message on failure.

metadataobjectbody

Structured data about the execution. Max 10 KB.

Request

bash

curl -X POST https://api.cueapi.ai/v1/executions/{execution_id}/outcome \
  -H "Authorization: Bearer cue_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "success": true,
    "result": "Report generated: 847 chars",
    "metadata": {"rows_processed": 142}
  }'

bash

curl -X POST https://api.cueapi.ai/v1/executions/{execution_id}/outcome \
  -H "Authorization: Bearer cue_sk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "success": false,
    "error": "Database connection timeout",
    "metadata": {"error_code": "DB_TIMEOUT"}
  }'

Response

json

{
  "execution_id": "550e8400-e29b-41d4-a716-446655440000",
  "outcome": {
    "success": true,
    "result": "Report generated: 847 chars",
    "metadata": {"rows_processed": 142},
    "recorded_at": "2026-03-13T09:01:23Z"
  }
}

json

{
  "error": {
    "code": "outcome_already_reported",
    "message": "Outcome already recorded for this execution",
    "status": 409
  }
}

POST/v1/executions/{execution_id}/outcome

Try it

Replace path parameters (e.g. {cue_id}) in the URL before sending.

Request Body

Enter your API key above to send requests

Previous← Claim Execution NextRegister →