> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# AgentRun

> Response type in the GraphQL API.

| Field | Type | Description |
| - | - | - |
| `runId` | [`ID!`](/docs/cloud/graphql/types/id) | |
| `conversationId` | [`ID`](/docs/cloud/graphql/types/id) | |
| `messageId` | [`ID`](/docs/cloud/graphql/types/id) | Null when no message is attached to the run. |
| `projectId` | [`ID`](/docs/cloud/graphql/types/id) | |
| `requestedByUserId` | [`ID!`](/docs/cloud/graphql/types/id) | |
| `triggerPrincipalType` | [`String`](/docs/cloud/graphql/types/string) | Authenticated principal type that fired the run: system, user, api\_key or service\_account. Null for legacy rows. |
| `triggerPrincipalId` | [`String`](/docs/cloud/graphql/types/string) | Stable identifier of the authenticated principal that fired the run. Null for legacy rows. |
| `agentId` | [`String!`](/docs/cloud/graphql/types/string) | |
| `status` | [`String!`](/docs/cloud/graphql/types/string) | 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. |
| `implementationKind` | [`String`](/docs/cloud/graphql/types/string) | |
| `workerKey` | [`String`](/docs/cloud/graphql/types/string) | |
| `sourceTargetKind` | [`String`](/docs/cloud/graphql/types/string) | |
| `sourceTargetEnvironmentId` | [`ID`](/docs/cloud/graphql/types/id) | |
| `sourceTargetBranchId` | [`ID`](/docs/cloud/graphql/types/id) | |
| `sourceTargetReleaseVersion` | [`String`](/docs/cloud/graphql/types/string) | Release version used as the source target, when the run was pinned to a release. |
| `runtimeTargetKind` | [`String`](/docs/cloud/graphql/types/string) | |
| `runtimeTargetEnvironmentId` | [`ID`](/docs/cloud/graphql/types/id) | |
| `runtimeTargetBranchId` | [`ID`](/docs/cloud/graphql/types/id) | |
| `parentConversationId` | [`ID`](/docs/cloud/graphql/types/id) | |
| `parentRunId` | [`ID`](/docs/cloud/graphql/types/id) | |
| `spawnedFromMessageId` | [`ID`](/docs/cloud/graphql/types/id) | |
| `spawnedFromToolCallId` | [`String`](/docs/cloud/graphql/types/string) | |
| `inputAnchorMessageId` | [`ID`](/docs/cloud/graphql/types/id) | |
| `handoffMessageId` | [`ID`](/docs/cloud/graphql/types/id) | |
| `resolvedDeploymentId` | [`ID`](/docs/cloud/graphql/types/id) | |
| `latestEventId` | [`Int!`](/docs/cloud/graphql/types/int) | |
| `latestExternalEventSequence` | [`Int`](/docs/cloud/graphql/types/int) | Highest external event sequence appended by an externally managed runtime, or null when none. |
| `waitingToolCallId` | [`String`](/docs/cloud/graphql/types/string) | |
| `waitingToolName` | [`String`](/docs/cloud/graphql/types/string) | |
| `terminalErrorCode` | [`String`](/docs/cloud/graphql/types/string) | |
| `terminalErrorMessage` | [`String`](/docs/cloud/graphql/types/string) | |
| `createdAt` | [`String!`](/docs/cloud/graphql/types/string) | |
| `startedAt` | [`String`](/docs/cloud/graphql/types/string) | |
| `finishedAt` | [`String`](/docs/cloud/graphql/types/string) | |
| `runSnapshot` | [`JSON!`](/docs/cloud/graphql/types/json) | Durable run identity derived from persisted run columns: projectAgent, source, runtimeTarget and requester. The camelCase projection of REST run\_snapshot. |

[All GraphQL types](/docs/cloud/graphql/schema) · [Operations](/docs/cloud/graphql)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.