--- title: "Inspect Agent Run" method: GET path: "/api/agent-runs/{run_id}/inspect" tags: ["agent-tasks"] --- # Inspect Agent Run `GET /api/agent-runs/{run_id}/inspect` ## Request - Base URL: `https://platform.verbiflow.com/api/bridge` - URL: `https://platform.verbiflow.com/api/bridge/api/agent-runs/{run_id}/inspect` - Auth: one of: - HTTP bearer and API key in header `x-flage-org-id` - HTTP bearer and API key in header `x-flage-org-slug` ## Path parameters - `run_id` string, required ## Query parameters - `after_event_sequence` integer - `after_transcript_ordinal` integer - `limit` integer ## Response `200` Successful Response - AgentRunInspectResponse - `action` 'inspect', required - `activity` AgentRunActivityEvent[], required - `created_at` string, date-time, required - `event_type` string, required - `payload` object, required - `sequence` integer, required - `terminal` boolean, required - `completed_at` string, date-time, nullable, required - `created_at` string, date-time, required - `error` string, nullable, required - `next_event_sequence` integer, nullable - `next_transcript_ordinal` integer, nullable - `parent_run_id` string, nullable, required - `parent_tool_call_id` string, nullable, required - `result` object, nullable, required - `run_id` string, required - `started_at` string, date-time, nullable, required - `status` 'pending' | 'running' | 'waiting_input' | 'suspended' | 'completed' | 'failed' | 'cancelled', required - `task` string, required - `task_key` string, nullable, required - `thread_id` string, required - `tool_calls` integer, required - `transcript` AgentRunTranscriptEntry[], required - `created_at` string, date-time, required - `entry_id` string, required - `entry_type` 'message' | 'thinking_level_change' | 'model_change' | 'active_tools_change' | 'compaction' | 'branch_summary' | 'custom' | 'custom_message' | 'label' | 'session_info' | 'leaf', required: Canonical durable Mochi session-entry kind. - `ordinal` integer, required - `payload` union, required: Complete canonical session entry. Message provider fields and custom entry data remain recursive JSON extensions. - AgentRunMessageTranscriptPayload: One model-visible message and its optional host-only companion data. - `data` union: Recursive JSON value: object, array, string, integer, number, boolean, or null. - object - AgentJsonValueOutput[] - string - integer - number - boolean - `id` string, required: Immutable durable session-entry identity. - `message` AgentRunTranscriptMessage, required: Provider-extensible model message persisted inside a message entry. - `content` union, required: Provider-owned text or structured message parts, preserved as recursive JSON. - string - AgentJsonValueOutput[] - … - `role` 'system' | 'user' | 'assistant' | 'tool', required: Model-message participant role. - `parentId` string, nullable, required: Parent session-entry identity, or null for a root entry. - `timestamp` string, required: ISO-8601 timestamp persisted inside the canonical session entry. - `type` 'message', required: Message session-entry discriminator. - AgentRunThinkingLevelChangeTranscriptPayload: A persisted change to the model reasoning level. - `id` string, required: Immutable durable session-entry identity. - `parentId` string, nullable, required: Parent session-entry identity, or null for a root entry. - `thinkingLevel` string, required: Runtime reasoning level selected after this entry. - `timestamp` string, required: ISO-8601 timestamp persisted inside the canonical session entry. - `type` 'thinking_level_change', required: Thinking-level-change session-entry discriminator. - AgentRunModelChangeTranscriptPayload: A persisted change to the provider and model used by later turns. - `id` string, required: Immutable durable session-entry identity. - `modelId` string, required: Provider model identity selected after this entry. - `parentId` string, nullable, required: Parent session-entry identity, or null for a root entry. - `provider` string, required: Provider selected after this entry. - `timestamp` string, required: ISO-8601 timestamp persisted inside the canonical session entry. - `type` 'model_change', required: Model-change session-entry discriminator. - AgentRunActiveToolsChangeTranscriptPayload: A persisted replacement of the tools active for later turns. - `activeToolNames` string[], required: Complete tool-name set active after this entry. - `id` string, required: Immutable durable session-entry identity. - `parentId` string, nullable, required: Parent session-entry identity, or null for a root entry. - `timestamp` string, required: ISO-8601 timestamp persisted inside the canonical session entry. - `type` 'active_tools_change', required: Active-tools-change session-entry discriminator. - AgentRunCompactionTranscriptPayload: A summary replacing an earlier span of model context. - `details` union: Recursive JSON value: object, array, string, integer, number, boolean, or null. - object - AgentJsonValueOutput[] - string - integer - number - boolean - `firstKeptEntryId` string, required: First uncompacted session-entry identity. - `fromHook` boolean: Whether a runtime hook initiated this compaction. - `id` string, required: Immutable durable session-entry identity. - `parentId` string, nullable, required: Parent session-entry identity, or null for a root entry. - `summary` string, required: Summary substituted for compacted model context. - `timestamp` string, required: ISO-8601 timestamp persisted inside the canonical session entry. - `tokensBefore` union, required: Provider token count immediately before compaction. - integer - number - `type` 'compaction', required: Context-compaction session-entry discriminator. - AgentRunBranchSummaryTranscriptPayload: A summary of context inherited from another session-tree branch. - `details` union: Recursive JSON value: object, array, string, integer, number, boolean, or null. - object - AgentJsonValueOutput[] - string - integer - number - boolean - `fromHook` boolean: Whether a runtime hook created this branch summary. - `fromId` string, required: Session entry where the branch began. - `id` string, required: Immutable durable session-entry identity. - `parentId` string, nullable, required: Parent session-entry identity, or null for a root entry. - `summary` string, required: Summary of context inherited by this branch. - `timestamp` string, required: ISO-8601 timestamp persisted inside the canonical session entry. - `type` 'branch_summary', required: Branch-summary session-entry discriminator. - AgentRunCustomTranscriptPayload: A runtime-defined durable entry with recursive JSON data. - `customType` string, required: Runtime-owned subtype for the custom entry. - `data` union: Recursive JSON value: object, array, string, integer, number, boolean, or null. - object - AgentJsonValueOutput[] - string - integer - number - boolean - `id` string, required: Immutable durable session-entry identity. - `parentId` string, nullable, required: Parent session-entry identity, or null for a root entry. - `timestamp` string, required: ISO-8601 timestamp persisted inside the canonical session entry. - `type` 'custom', required: Custom session-entry discriminator. - AgentRunCustomMessageTranscriptPayload: A runtime-defined message intended for transcript display. - `content` union, required: Complete string or typed text and image parts shown for the custom message. - string - union[] - union - … - `customType` string, required: Runtime-owned subtype for the custom message. - `details` union: Recursive JSON value: object, array, string, integer, number, boolean, or null. - object - AgentJsonValueOutput[] - string - integer - number - boolean - `display` boolean, required: Whether clients should display the custom message. - `id` string, required: Immutable durable session-entry identity. - `parentId` string, nullable, required: Parent session-entry identity, or null for a root entry. - `timestamp` string, required: ISO-8601 timestamp persisted inside the canonical session entry. - `type` 'custom_message', required: Custom-message session-entry discriminator. - AgentRunLabelTranscriptPayload: A user-facing label applied to another session entry. - `id` string, required: Immutable durable session-entry identity. - `label` string: Optional label text. - `parentId` string, nullable, required: Parent session-entry identity, or null for a root entry. - `targetId` string, required: Session entry receiving the label. - `timestamp` string, required: ISO-8601 timestamp persisted inside the canonical session entry. - `type` 'label', required: Label session-entry discriminator. - AgentRunSessionInfoTranscriptPayload: Mutable display information recorded for the session. - `id` string, required: Immutable durable session-entry identity. - `name` string: Optional session display name. - `parentId` string, nullable, required: Parent session-entry identity, or null for a root entry. - `timestamp` string, required: ISO-8601 timestamp persisted inside the canonical session entry. - `type` 'session_info', required: Session-information entry discriminator. - AgentRunLeafTranscriptPayload: A durable selection of the active session-tree leaf. - `id` string, required: Immutable durable session-entry identity. - `parentId` string, nullable, required: Parent session-entry identity, or null for a root entry. - `targetId` string, nullable, required: Selected leaf session-entry identity, or null for no selected leaf. - `timestamp` string, required: ISO-8601 timestamp persisted inside the canonical session entry. - `type` 'leaf', required: Leaf-selection session-entry discriminator. ## Other responses - `422`: Validation Error --- [API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)