AgentRun

FieldTypeDescription
runIdID!
conversationIdID
messageIdIDNull when no message is attached to the run.
projectIdID
requestedByUserIdID!
triggerPrincipalTypeStringAuthenticated principal type that fired the run: system, user, api_key or service_account. Null for legacy rows.
triggerPrincipalIdStringStable identifier of the authenticated principal that fired the run. Null for legacy rows.
agentIdString!
statusString!Stored agent run status: pending, running, waiting_for_tool, completed, failed or cancelled. waiting_for_tool is the canonical Run status waiting, with waiting_reason tool when waitingToolCallId is set and input when it is null.
implementationKindString
workerKeyString
sourceTargetKindString
sourceTargetEnvironmentIdID
sourceTargetBranchIdID
sourceTargetReleaseVersionStringRelease version used as the source target, when the run was pinned to a release.
runtimeTargetKindString
runtimeTargetEnvironmentIdID
runtimeTargetBranchIdID
parentConversationIdID
parentRunIdID
spawnedFromMessageIdID
spawnedFromToolCallIdString
inputAnchorMessageIdID
handoffMessageIdID
resolvedDeploymentIdID
latestEventIdInt!
latestExternalEventSequenceIntHighest external event sequence appended by an externally managed runtime, or null when none.
waitingToolCallIdString
waitingToolNameString
terminalErrorCodeString
terminalErrorMessageString
createdAtString!
startedAtString
finishedAtString
runSnapshotJSON!Durable run identity derived from persisted run columns: projectAgent, source, runtimeTarget and requester. The camelCase projection of REST run_snapshot.

All GraphQL types · Operations