Get agent run

agentRun(conversationId: ID!, runId: ID!): AgentRun

Arguments

ArgumentTypeRequired
conversationIdID!Yes
runIdID!Yes

Response

Returns AgentRun. Open the type for its fields and nested types.

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!

All fields of AgentRun.

Types marked with ! cannot be null. Lists use [Type] notation. The type index lists all published input and response types.

Example

graphql
query AgentRun($conversationId: ID!, $runId: ID!) {
  agentRun(conversationId: $conversationId, runId: $runId) {
    projectId
    runId
    agentId
    status
    createdAt
  }
}
json
{
  "conversationId": "00000000-0000-4000-8000-000000000001",
  "runId": "00000000-0000-4000-8000-000000000001"
}