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

Allowed values:

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.

Allowed values:

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

executionLaneenumOptional

Which substrate ran this turn: durable for a Durable Object (a Runtype session, or the run owner a detached run is handed to), in_process for the request worker. Present only for an execution with a canonical agent row; a flow handle and a Claude Managed handle omit it.

Allowed values:

httpStatusintegerOptional

resultanyOptional

resultUnavailablebooleanOptional

Present and true when the execution settled but its result was too large to store or could not be retrieved; result then holds only a summary and resultUnavailableReason explains why. error keeps describing an execution failure; on an otherwise completed execution it repeats the reason.

resultUnavailableReasonstringOptional

Why the result is unavailable. Present exactly when resultUnavailable is true.

targetIdstringOptional

underlyingExecutionIdstringOptional

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error