Skip to content
QuantCDN

Get Durable Execution Status

GET
/api/v3/organizations/{organisation}/ai/chat/executions/{identifier}

Poll the status of an async/durable chat execution. * * When to use: After starting chat inference with async: true, poll this endpoint * to check execution status and retrieve results when complete. * * Identifier: Accepts either: * - requestId (recommended): The short ID returned from the async request * - executionArn: The full AWS Lambda durable execution ARN (must be URL-encoded) * * Statuses: * - pending: Execution is starting (retry shortly) * - running: Execution is in progress * - waiting_callback: Execution paused, waiting for client tool results * - complete: Execution finished successfully * - failed: Execution failed with error * * Client Tool Callback: * When status is waiting_callback, submit tool results via POST /ai/chat/callback. * * Polling Recommendations: * - Start with 1 second delay, exponential backoff up to 30 seconds * - Stop polling after 15 minutes (consider failed)

Authorizations

Parameters

Path Parameters

organisation
required
string

The organisation ID

identifier
required
string

Either the requestId from async response, or full executionArn (URL-encoded)

Example
XkdVWiEfSwMEPrw=

Responses

200

Execution status retrieved

object
requestId
string
XkdVWiEfSwMEPrw=
executionArn
string
arn:aws:lambda:ap-southeast-2:...
status
string
Allowed values: pending running waiting_callback complete failed 
complete
awsStatus

Raw AWS Step Functions status

string
SUCCEEDED
callbackId

Present when status is waiting_callback - use with /chat/callback

string
Ab9hZXi/YXJuOmF3czpsYW1iZGE...
pendingTools

Present when status is waiting_callback - tools waiting for results

Array<object>
object
name
string
get_weather
toolUseId
string
toolu_bdrk_012KTC8NCG...
input
object 
{
  "location": "Sydney"
}
result

Present when status is complete

object
response
object
role
string
assistant
content
string
The weather in Sydney is sunny.
usage
object
inputTokens
integer
outputTokens
integer
totalTokens
integer
toolExecutions
Array<object>
object
error

Present when status is failed

object
ErrorMessage
string
ErrorType
string

403

Access denied

404

Execution not found

500

Failed to retrieve execution status