Poll an asynchronous execution | Runtype Documentation

Returns lifecycle status and, once terminal, the result of an execution accepted via Prefer: respond-async.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

executionIdstringRequired>=1 character

Response

Execution status returned

createdAtstring

executionIdstring

statusenum

targetKindenum

agentTargetResolutionenumOptional

How the run selected its definition: alias or version for a request that named a selector, legacy-live-row for a run that read the mutable agent row.

agentVersionobject or nullOptional

Version number and label for agentVersionId. null exactly when agentVersionId is null.

agentVersionIdstring or nullOptional

The agent_versions row the run was recorded against. Present only for durable agent executions; null when that surface stamps no version.

errorstringOptional

httpStatusintegerOptional

resultanyOptional

targetIdstringOptional

underlyingExecutionIdstringOptional

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

1	{
2	"createdAt": "string",
3	"executionId": "string",
4	"status": "queued",
5	"targetKind": "flow",
6	"agentTargetResolution": "alias",
7	"agentVersion": {
8	"id": "string",
9	"label": "string",
10	"versionNumber": 1
11	},
12	"agentVersionId": "string",
13	"error": "string",
14	"httpStatus": 1,
15	"targetId": "string",
16	"underlyingExecutionId": "string"
17	}