Get Execution Status
Poll the status of an Agent execution via the Squadbase API.
GET
https://api.squadbase.dev/v0/agent/{agentId}/executions/{executionId}Returns the current state of an execution started with Trigger an Agent. Poll this endpoint until status is COMPLETED (or a terminal failure state), then fetch the result.
Request headers
Prop
Type
Required
The x-api-key header is required on every request — see Authentication.
Path parameters
Prop
Type
Required
Response — 200 OK
Returns the same execution object as the trigger endpoint.
{
"executionId": "uuid",
"agentId": "uuid",
"status": "COMPLETED",
"title": "Weekly signup analysis",
"message": "Analyze this week's signup trends",
"startedAt": "ISO8601",
"completedAt": "ISO8601",
"createdAt": "ISO8601"
}Example
curl 'https://api.squadbase.dev/v0/agent/<AGENT_ID>/executions/<EXECUTION_ID>' \
-H 'x-api-key: <YOUR_API_KEY>'A 422 (notFound) is returned if the executionId does not exist or does not belong to the agentId in the path. See Errors for details.