> ## 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. # List run events > List run events. ## OpenAPI ````yaml /cloud/rest/openapi.json get /runs/{run_id}/events openapi: 3.1.0 info: title: Veryfront REST API reference version: 1.0.0 description: |- ## Explore the API | Domain | Use it to | | --- | --- | | [Projects](#tag/projects) | Manage projects and files. | | [Agents](#tag/agents) | Manage agent primitives. | | [Orchestration](#tag/execution) | Manage conversations and runs. | | [Evaluations](#tag/evaluations) | Manage evaluations and results. | | [AI Gateway](#tag/ai-gateway) | Access models and inference. | | [MCP](#tag/mcp) | Discover tools and authorization. | | [Integrations](#tag/integrations) | Manage connections and integrations. | | [Knowledge](#tag/knowledge) | Manage documents and search. | | [Deployments](#tag/deployments) | Manage releases and deployments. | | [Runtime](#tag/runtime) | Manage environments and infrastructure. | | [Observability](#tag/observability) | Monitor activity and performance. | | [Identity & Access](#tag/identity-access) | Manage identity and access. | | [Billing & Usage](#tag/billing-usage) | Manage billing and usage. | | [Other](#tag/platform) | Inspect health and API metadata. | [OpenAPI specification (JSON)](/openapi.json) contact: name: Veryfront API Support url: https://veryfront.com/docs email: support@veryfront.com x-api-id: 5f1f0b8a-6b0e-4c1a-9b35-0f3a1e6d84c7 x-audience: external-public servers: - url: https://api.veryfront.com security: - bearerAuth: [] - apiKeyAuth: [] tags: - name: projects description: Manage projects and files. - name: agents description: Manage agent primitives. - name: execution description: Manage conversations and runs. - name: evaluations description: Manage evaluations and results. - name: ai-gateway description: Access models and inference. - name: mcp description: Discover tools and authorization. - name: integrations description: Manage connections and integrations. - name: knowledge description: Manage documents and search. - name: deployments description: Manage releases and deployments. - name: runtime description: Manage environments and infrastructure. - name: observability description: Monitor activity and performance. - name: identity-access description: Manage identity and access. - name: billing-usage description: Manage billing and usage. - name: platform description: Inspect health and API metadata. - name: projects/Projects - name: projects/Projects/Favorites - name: projects/Projects/Account Projects - name: projects/Projects/Projects - name: projects/Projects/Project Labels - name: projects/Projects/Project templates - name: projects/Files - name: projects/Files/Files - name: projects/Files/File Chunks - name: projects/Files/Branch File Versions - name: projects/Files/Branch Files - name: projects/Files/Environment Files - name: projects/Files/File Versions - name: projects/Files/Branch File Drafts - name: projects/Files/Release Files - name: projects/Files/Sandbox Files - name: projects/Files/File Search - name: projects/Branches - name: projects/Branches/Branches - name: projects/Branches/Branch Policies - name: projects/Branches/Branch Approvals - name: projects/Branches/Branch Status Checks - name: projects/Branches/Project Commits - name: projects/Branches/Branch Merges - name: projects/Uploads - name: projects/Uploads/Upload Folders - name: projects/Uploads/Upload Grants - name: projects/Uploads/Project Uploads - name: projects/Uploads/Upload Visibility - name: agents/Agents - name: agents/Agents/Agents - name: agents/Agents/Agent Labels - name: agents/Agents/Agent templates - name: agents/Agents/Agent Tool References - name: agents/Agents/Agent Avatars - name: agents/Agents/Agent Capabilities - name: agents/Agents/Agent Installation - name: agents/Prompts - name: agents/Prompts/Project prompts - name: agents/Tools - name: agents/Tools/Project tools - name: agents/Skills - name: agents/Skills/Project skills - name: agents/Resources - name: agents/Resources/Project resources - name: agents/Tasks - name: agents/Tasks/Tasks - name: agents/Workflows - name: agents/Workflows/Workflows - name: execution/Conversations - name: execution/Conversations/Conversations - name: execution/Conversations/Conversation messages - name: execution/Conversations/Conversation participants - name: execution/Conversations/Conversation read state - name: execution/Triggers - name: execution/Triggers/Project schedules - name: execution/Triggers/Webhooks - name: execution/Triggers/Webhook events - name: execution/Runs - name: execution/Runs/Run Input Requests - name: execution/Runs/Runs - name: execution/Runs/Runtime - name: execution/Runs/Child Runs - name: execution/Runs/Conversation Runs - name: execution/Runs/Project Runs - name: execution/Runs/Webhook Runs - name: execution/Runs/Run Events - name: execution/Runs/Run Actions - name: execution/Runs/Run Artifacts - name: execution/Executors - name: execution/Executors/Connected agents - name: execution/Executors/Agent workers - name: evaluations/Evaluations - name: evaluations/Evaluations/Evaluations - name: evaluations/Evaluations/Evaluation Runs - name: ai-gateway/Models - name: ai-gateway/Models/Model discovery - name: ai-gateway/Models/Inference Models - name: ai-gateway/Models/Project inference policy - name: ai-gateway/Models/Account inference policy - name: ai-gateway/Inference - name: ai-gateway/Inference/OpenAI Chat Completions - name: ai-gateway/Inference/Embeddings - name: ai-gateway/Inference/OpenAI Responses - name: ai-gateway/Inference/Proxy metadata - name: ai-gateway/Inference/Anthropic Messages - name: ai-gateway/Inference/Provider gateway - name: ai-gateway/Inference/Gemini inference - name: ai-gateway/Inference/Image generation - name: mcp/Tools - name: mcp/Tools/MCP discovery - name: mcp/Authorization - name: mcp/Authorization/Protected resource discovery - name: integrations/Integrations - name: integrations/Integrations/Integration tools - name: integrations/Integrations/Integration catalog - name: integrations/Integrations/Project integrations - name: integrations/Connections - name: integrations/Connections/Connections - name: integrations/Channels - name: integrations/Channels/Channels - name: integrations/Channels/Setup lookups - name: integrations/External storage - name: integrations/External storage/External Files - name: knowledge/Documents - name: knowledge/Documents/Project knowledge - name: knowledge/Documents/Retrieval documents - name: knowledge/Search - name: knowledge/Search/Search - name: knowledge/Embeddings - name: knowledge/Embeddings/Project embeddings - name: deployments/Releases - name: deployments/Releases/Releases - name: deployments/Releases/Release Versions - name: deployments/Releases/Release Source Manifests - name: deployments/Deployments - name: deployments/Deployments/Project deployments - name: deployments/Artifacts - name: deployments/Artifacts/Dependencies - name: deployments/Artifacts/Release Asset Manifests - name: deployments/Artifacts/Style artifacts - name: runtime/Environments - name: runtime/Environments/Environments - name: runtime/Environments/Environment Domains - name: runtime/Environments/Environment variables - name: runtime/Environments/Project Domains - name: runtime/Environments/Environment Variable Keys - name: runtime/Servers - name: runtime/Servers/Environment Servers - name: runtime/Servers/Project servers - name: runtime/Sandboxes - name: runtime/Sandboxes/Sandbox Lifecycle - name: runtime/Sandboxes/Sandbox Commands - name: runtime/Sandboxes/Sandbox Environment - name: runtime/Sandboxes/Sandbox Health - name: runtime/Sandboxes/Sandbox Terminal - name: runtime/Cache - name: runtime/Cache/Project Cache - name: runtime/Cache/User Cache - name: observability/Logs - name: observability/Logs/Log entries - name: observability/Traces - name: observability/Traces/Trace spans - name: observability/Traces/Project traces - name: observability/Traces/Trace Search - name: observability/Metrics - name: observability/Metrics/Metric series - name: observability/Alerts - name: observability/Alerts/Project alerts - name: observability/Error types - name: observability/Error types/Error types - name: identity-access/Users - name: identity-access/Users/Account users - name: identity-access/Users/Project users - name: identity-access/Users/Current user - name: identity-access/Accounts - name: identity-access/Accounts/Accounts - name: identity-access/Invitations - name: identity-access/Invitations/Invitations - name: identity-access/Permissions - name: identity-access/Permissions/Feature gates - name: identity-access/Permissions/Project Ownership - name: identity-access/API keys - name: identity-access/API keys/API keys - name: identity-access/Authentication - name: identity-access/Authentication/Sign-in - name: identity-access/Authentication/Tokens - name: identity-access/Authorization - name: identity-access/Authorization/Authorized apps - name: identity-access/Authorization/General OAuth - name: identity-access/Authorization/Consent - name: billing-usage/Subscriptions - name: billing-usage/Subscriptions/Subscriptions - name: billing-usage/Subscriptions/Seats - name: billing-usage/Billing - name: billing-usage/Billing/Invoices - name: billing-usage/Billing/Payments - name: billing-usage/Billing/Payment Methods - name: billing-usage/Billing/Billing Details - name: billing-usage/Billing/Account billing - name: billing-usage/Credits - name: billing-usage/Credits/Credits - name: billing-usage/Budgets - name: billing-usage/Budgets/Budgets - name: billing-usage/Usage - name: billing-usage/Usage/API key usage - name: billing-usage/Usage/Account usage - name: billing-usage/Usage/Project usage - name: billing-usage/Analytics - name: billing-usage/Analytics/Conversation Analytics - name: billing-usage/Analytics/Run Analytics - name: platform/Other - name: platform/Other/API metadata paths: /runs/{run_id}/events: get: tags: - execution/Runs/Run Events summary: List run events description: List run events. operationId: listRunEvents parameters: - schema: type: string format: uuid required: true example: 11111111-1111-4111-8111-111111111111 name: run_id in: path - schema: type: string description: >- The previous page’s `page_info.next` event ID, excluded from the next page. With `sort_order=asc`, returns larger IDs; with `sort_order=desc`, returns smaller IDs. If omitted, starts at the oldest event for ascending order or the newest for descending order. required: false description: >- Opaque page_info.next cursor; reuse with unchanged filters and ordering. name: cursor in: query - schema: type: integer minimum: 1 maximum: 100 default: 20 description: >- Maximum number of records in a page, from 1 to 100. Defaults to 20. format: int32 required: false description: Maximum number of records in a page, from 1 to 100. Defaults to 20. name: limit in: query - schema: type: string enum: - asc - desc default: asc description: >- Event order. `asc` returns oldest first; `desc` returns newest first. Defaults to `asc`. required: false name: sort_order in: query - schema: type: - integer - 'null' minimum: 0 maximum: 9007199254740991 description: >- Deprecated. Use `cursor`. Accepted as an ascending cursor; 0 means no cursor. required: false name: after_event_id in: query - schema: type: string enum: - fact - delta description: >- Event class to include: `fact` for state changes or `delta` for streaming fragments. If omitted, returns both. required: false description: The event class associated with this record. name: event_class in: query - schema: type: array items: type: string maxItems: 32 required: false description: >- Filter by event_type. Repeat the query parameter for multiple values; comma-separated values remain a compatibility alias. Values within this filter use OR; different filters use AND. style: form explode: true name: event_type in: query - schema: type: string enum: - 'true' - 'false' description: >- If true, returns only events with `is_error: true`. If false, returns other events. If omitted, returns both. required: false name: is_error in: query - schema: type: string format: date-time description: >- Only events created at or after this instant (ISO 8601 with a UTC offset, inclusive). A summary bucket start can be sent as is. required: false name: start in: query - schema: type: string format: date-time description: >- Only events created before this instant (ISO 8601 with a UTC offset, exclusive). Must be later than start. A summary bucket end can be sent as is. required: false name: end in: query - schema: type: string minLength: 1 description: >- Only events whose envelope span_id, as served to the caller, is exactly this value (tool:, message:, step:, input_request:, run:, with a non-empty ). required: false name: span_id in: query - schema: type: string minLength: 1 description: >- Only events whose envelope turn_id, as served to the caller, is exactly this value (message:, with a non-empty ). required: false name: turn_id in: query - schema: type: string minLength: 1 maxLength: 200 description: >- Case-insensitive substring of the event payload JSON as served to the caller (1-200 characters after trimming, matched literally). required: false name: search in: query - schema: type: string enum: - 'true' - 'false' default: 'false' description: >- If true, includes events from readable descendant runs, up to 16 generations. Results share one `event_id` order and cursor. Each event retains its `run_id` and the payload visibility permitted for that run. Runs the caller cannot read are excluded. Defaults to false. If at least one descendant is included, task or workflow runs without stored events do not contribute synthetic lifecycle events. Event IDs are allocated before commit. During active writes, ascending pagination can pass an ID that another run commits later. required: false name: include_descendants in: query responses: '200': description: >- Run events. Editors read diagnostic payloads; viewers read public ones. content: application/json: schema: $ref: '#/components/schemas/ListRunEventsResponse' examples: example: summary: Example response value: data: - event_id: 42 event_type: MODEL_CALL_COMPLETED payload: type: MODEL_CALL_COMPLETED provider: example-provider model: example-model inputTokens: 120 outputTokens: 30 cacheCreationTokens: 0 cacheReadTokens: 0 totalTokens: 150 costCredits: '0.001' latencyMs: 800 usageCaptureStatus: complete providerRequestId: request_example modelCallContextEventId: null is_error: false created_at: '2026-10-02T10:00:00Z' run_id: 11111111-1111-4111-8111-111111111111 event_class: fact span_id: span_example parent_span_id: null turn_id: null origin_event_type: MODEL_CALL_COMPLETED origin_custom_name: null unrecoverable_fields: [] page_info: next: null '400': description: Bad request content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/TargetRunProblem' - properties: status: const: 400 '401': description: Unauthorized content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/TargetRunProblem' - properties: status: const: 401 '403': description: Forbidden content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/TargetRunProblem' - properties: status: const: 403 '404': description: Not found content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/TargetRunProblem' - properties: status: const: 404 '429': description: Rate limit exceeded headers: Retry-After: schema: type: integer format: int32 minimum: 1 content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/TargetRunProblem' - properties: status: const: 429 '503': description: Service unavailable content: application/problem+json: schema: allOf: - $ref: '#/components/schemas/TargetRunProblem' - properties: status: const: 503 security: - bearerAuth: [] - apiKeyAuth: [] - runExecutionAuth: [] components: schemas: ListRunEventsResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/RunEvent' page_info: $ref: '#/components/schemas/RunsPageInfo' required: - data - page_info TargetRunProblem: type: object properties: type: type: string description: Problem type URI reference. title: type: string status: type: integer minimum: 400 maximum: 599 format: int64 code: type: string minLength: 1 maxLength: 128 cause: type: string enum: - schedule_concurrency_forbidden - schedule_fire_in_progress - schedule_run_limit_reached description: Schedule admission refusal. detail: type: string instance: type: string errors: type: array items: type: object properties: field: type: string message: type: string required: - field - message required: - type - title - status - code RunEvent: oneOf: - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - RUN_STARTED payload: anyOf: - $ref: '#/components/schemas/RunStartedPayload' - type: object properties: type: type: string enum: - RUN_STARTED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - RUN_FINISHED payload: anyOf: - $ref: '#/components/schemas/RunFinishedPayload' - type: object properties: type: type: string enum: - RUN_FINISHED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - RUN_ERROR payload: anyOf: - $ref: '#/components/schemas/RunErrorPayload' - type: object properties: type: type: string enum: - RUN_ERROR required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - TEXT_MESSAGE_START payload: anyOf: - $ref: '#/components/schemas/TextMessageStartPayload' - type: object properties: type: type: string enum: - TEXT_MESSAGE_START required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - TEXT_MESSAGE_CONTENT payload: anyOf: - $ref: '#/components/schemas/TextMessageContentPayload' - type: object properties: type: type: string enum: - TEXT_MESSAGE_CONTENT required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - TEXT_MESSAGE_END payload: anyOf: - $ref: '#/components/schemas/TextMessageEndPayload' - type: object properties: type: type: string enum: - TEXT_MESSAGE_END required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - TOOL_CALL_START payload: anyOf: - $ref: '#/components/schemas/ToolCallStartPayload' - type: object properties: type: type: string enum: - TOOL_CALL_START required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - TOOL_CALL_ARGS payload: anyOf: - $ref: '#/components/schemas/ToolCallArgsPayload' - type: object properties: type: type: string enum: - TOOL_CALL_ARGS required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - TOOL_CALL_CHUNK payload: anyOf: - $ref: '#/components/schemas/ToolCallChunkPayload' - type: object properties: type: type: string enum: - TOOL_CALL_CHUNK required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - TOOL_CALL_END payload: anyOf: - $ref: '#/components/schemas/ToolCallEndPayload' - type: object properties: type: type: string enum: - TOOL_CALL_END required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - TOOL_CALL_RESULT payload: anyOf: - $ref: '#/components/schemas/ToolCallResultPayload' - type: object properties: type: type: string enum: - TOOL_CALL_RESULT required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - STATE_SNAPSHOT payload: anyOf: - $ref: '#/components/schemas/StateSnapshotPayload' - type: object properties: type: type: string enum: - STATE_SNAPSHOT required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - STATE_DELTA payload: anyOf: - $ref: '#/components/schemas/StateDeltaPayload' - type: object properties: type: type: string enum: - STATE_DELTA required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - MESSAGES_SNAPSHOT payload: anyOf: - $ref: '#/components/schemas/MessagesSnapshotPayload' - type: object properties: type: type: string enum: - MESSAGES_SNAPSHOT required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - STEP_STARTED payload: anyOf: - $ref: '#/components/schemas/StepStartedPayload' - type: object properties: type: type: string enum: - STEP_STARTED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - STEP_FINISHED payload: anyOf: - $ref: '#/components/schemas/StepFinishedPayload' - type: object properties: type: type: string enum: - STEP_FINISHED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - REASONING_START payload: anyOf: - $ref: '#/components/schemas/ReasoningStartPayload' - type: object properties: type: type: string enum: - REASONING_START required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - REASONING_MESSAGE_START payload: anyOf: - $ref: '#/components/schemas/ReasoningMessageStartPayload' - type: object properties: type: type: string enum: - REASONING_MESSAGE_START required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - REASONING_MESSAGE_CONTENT payload: anyOf: - $ref: '#/components/schemas/ReasoningMessageContentPayload' - type: object properties: type: type: string enum: - REASONING_MESSAGE_CONTENT required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - REASONING_MESSAGE_END payload: anyOf: - $ref: '#/components/schemas/ReasoningMessageEndPayload' - type: object properties: type: type: string enum: - REASONING_MESSAGE_END required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - REASONING_CONTENT payload: anyOf: - $ref: '#/components/schemas/ReasoningContentPayload' - type: object properties: type: type: string enum: - REASONING_CONTENT required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - REASONING_END payload: anyOf: - $ref: '#/components/schemas/ReasoningEndPayload' - type: object properties: type: type: string enum: - REASONING_END required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - ACTIVITY_SNAPSHOT payload: anyOf: - $ref: '#/components/schemas/ActivitySnapshotPayload' - type: object properties: type: type: string enum: - ACTIVITY_SNAPSHOT required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - ACTIVITY_DELTA payload: anyOf: - $ref: '#/components/schemas/ActivityDeltaPayload' - type: object properties: type: type: string enum: - ACTIVITY_DELTA required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_AUTHORIZATION_SEALED payload: anyOf: - $ref: '#/components/schemas/AgentRunAuthorizationSealedPayload' - $ref: >- #/components/schemas/AgentRunAuthorizationSealedPayloadRedacted is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_REQUEST_ENQUEUED payload: anyOf: - $ref: '#/components/schemas/AgentRunRequestEnqueuedPayload' - type: object properties: type: type: string enum: - AGENT_RUN_REQUEST_ENQUEUED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_DEFAULT_CHAT_START_ENQUEUED payload: anyOf: - $ref: '#/components/schemas/AgentRunDefaultChatStartEnqueuedPayload' - type: object properties: type: type: string enum: - AGENT_RUN_DEFAULT_CHAT_START_ENQUEUED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_TOOL_RESULT_SUBMITTED payload: anyOf: - $ref: '#/components/schemas/AgentRunToolResultSubmittedPayload' - type: object properties: type: type: string enum: - AGENT_RUN_TOOL_RESULT_SUBMITTED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_TOOL_RESULT_DELIVERY_FAILED payload: anyOf: - $ref: '#/components/schemas/AgentRunToolResultDeliveryFailedPayload' - type: object properties: type: type: string enum: - AGENT_RUN_TOOL_RESULT_DELIVERY_FAILED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_INTEGRATION_CONNECTION_REFUSED payload: anyOf: - $ref: >- #/components/schemas/AgentRunIntegrationConnectionRefusedPayload - type: object properties: type: type: string enum: - AGENT_RUN_INTEGRATION_CONNECTION_REFUSED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_RUNTIME_OWNER_BOUND payload: anyOf: - $ref: '#/components/schemas/AgentRunRuntimeOwnerBoundPayload' - type: object properties: type: type: string enum: - AGENT_RUN_RUNTIME_OWNER_BOUND required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_RUNTIME_INVOKE_RETRIED payload: anyOf: - $ref: '#/components/schemas/AgentRunRuntimeInvokeRetriedPayload' - type: object properties: type: type: string enum: - AGENT_RUN_RUNTIME_INVOKE_RETRIED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_CONTEXT_COMPACTED payload: anyOf: - $ref: '#/components/schemas/AgentRunContextCompactedPayload' - $ref: '#/components/schemas/AgentRunContextCompactedPayloadRedacted' is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_TOOL_EXPOSURE_CHECKPOINTED payload: anyOf: - $ref: '#/components/schemas/AgentRunToolExposureCheckpointedPayload' - $ref: >- #/components/schemas/AgentRunToolExposureCheckpointedPayloadRedacted is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_PROVIDER_REPLAY_CHECKPOINTED payload: anyOf: - $ref: >- #/components/schemas/AgentRunProviderReplayCheckpointedPayload - $ref: >- #/components/schemas/AgentRunProviderReplayCheckpointedPayloadRedacted is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_PROVIDER_REPLAY_TURN_STARTED payload: anyOf: - $ref: >- #/components/schemas/AgentRunProviderReplayTurnStartedPayload - $ref: >- #/components/schemas/AgentRunProviderReplayTurnStartedPayloadRedacted is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_PROVIDER_REPLAY_TURN_FINISHED payload: anyOf: - $ref: >- #/components/schemas/AgentRunProviderReplayTurnFinishedPayload - $ref: >- #/components/schemas/AgentRunProviderReplayTurnFinishedPayloadRedacted is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_MODEL_CALL_CONTEXT_RECORDED payload: anyOf: - $ref: >- #/components/schemas/AgentRunModelCallContextRecordedPayloadRead - $ref: >- #/components/schemas/AgentRunModelCallContextRecordedPayloadRedacted is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_CONTROL_PLANE_DISPATCH_ACCEPTED payload: anyOf: - $ref: >- #/components/schemas/AgentRunControlPlaneDispatchAcceptedPayloadRead - $ref: >- #/components/schemas/AgentRunControlPlaneDispatchAcceptedPayloadRedacted is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_DETACHED_ACCEPTED payload: anyOf: - $ref: '#/components/schemas/AgentRunDetachedAcceptedPayload' - $ref: '#/components/schemas/AgentRunDetachedAcceptedPayloadRedacted' is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_INVOKE_AGENT_BILLING_MODE_RETAINED payload: anyOf: - $ref: >- #/components/schemas/AgentRunInvokeAgentBillingModeRetainedPayload - $ref: >- #/components/schemas/AgentRunInvokeAgentBillingModeRetainedPayloadRedacted is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_BILLING_USAGE_RETAINED payload: anyOf: - $ref: '#/components/schemas/AgentRunBillingUsageRetainedPayload' - $ref: >- #/components/schemas/AgentRunBillingUsageRetainedPayloadRedacted is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_REPLAYED_UPLOADS_SEALED payload: anyOf: - $ref: '#/components/schemas/AgentRunReplayedUploadsSealedPayload' - $ref: >- #/components/schemas/AgentRunReplayedUploadsSealedPayloadRedacted is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - TOOL_CALL_STATUS_CHANGED payload: anyOf: - $ref: '#/components/schemas/ToolCallStatusChangedPayload' - type: object properties: type: type: string enum: - TOOL_CALL_STATUS_CHANGED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - INPUT_REQUEST_CREATED payload: anyOf: - $ref: '#/components/schemas/InputRequestCreatedPayload' - type: object properties: type: type: string enum: - INPUT_REQUEST_CREATED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - INPUT_REQUEST_UPDATED payload: anyOf: - $ref: '#/components/schemas/InputRequestUpdatedPayload' - type: object properties: type: type: string enum: - INPUT_REQUEST_UPDATED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - CHILD_RUN_STATUS_CHANGED payload: anyOf: - $ref: '#/components/schemas/ChildRunStatusChangedPayload' - type: object properties: type: type: string enum: - CHILD_RUN_STATUS_CHANGED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - MODEL_CALL_COMPLETED payload: anyOf: - $ref: '#/components/schemas/ModelCallCompletedPayload' - type: object properties: type: type: string enum: - MODEL_CALL_COMPLETED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - RUN_PARKED payload: anyOf: - $ref: '#/components/schemas/RunParkedPayload' - type: object properties: type: type: string enum: - RUN_PARKED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - RUN_LOG_CAPTURED payload: anyOf: - $ref: '#/components/schemas/RunLogCapturedPayload' - type: object properties: type: type: string enum: - RUN_LOG_CAPTURED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - STREAM_HEARTBEAT_EMITTED payload: anyOf: - $ref: '#/components/schemas/StreamHeartbeatEmittedPayload' - type: object properties: type: type: string enum: - STREAM_HEARTBEAT_EMITTED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - URL_CITED payload: anyOf: - $ref: '#/components/schemas/UrlCitedPayload' - type: object properties: type: type: string enum: - URL_CITED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - DOCUMENT_CITED payload: anyOf: - $ref: '#/components/schemas/DocumentCitedPayload' - type: object properties: type: type: string enum: - DOCUMENT_CITED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - FILE_ATTACHED payload: anyOf: - $ref: '#/components/schemas/FileAttachedPayload' - type: object properties: type: type: string enum: - FILE_ATTACHED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - FILES_CHANGED payload: anyOf: - $ref: '#/components/schemas/FilesChangedPayload' - type: object properties: type: type: string enum: - FILES_CHANGED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - RUNTIME_EVENT_RECORDED payload: anyOf: - $ref: '#/components/schemas/RuntimeEventRecordedPayload' - type: object properties: type: type: string enum: - RUNTIME_EVENT_RECORDED required: - type additionalProperties: false is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_CONTROL_PLANE_DISPATCH_RECEIPT payload: anyOf: - $ref: >- #/components/schemas/AgentRunControlPlaneDispatchReceiptPayload - $ref: >- #/components/schemas/AgentRunControlPlaneDispatchReceiptPayloadRedacted is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_TOOL_EXPOSURE_CHECKPOINT payload: anyOf: - $ref: '#/components/schemas/AgentRunToolExposureCheckpointPayload' - $ref: >- #/components/schemas/AgentRunToolExposureCheckpointPayloadRedacted is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_PROVIDER_REPLAY_CHECKPOINT payload: anyOf: - $ref: '#/components/schemas/AgentRunProviderReplayCheckpointPayload' - $ref: >- #/components/schemas/AgentRunProviderReplayCheckpointPayloadRedacted is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string enum: - AGENT_RUN_MODEL_CALL_CONTEXT payload: anyOf: - $ref: '#/components/schemas/AgentRunModelCallContextPayload' - $ref: '#/components/schemas/AgentRunModelCallContextPayloadRedacted' is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false - type: object properties: event_id: type: integer minimum: 0 event_type: type: string not: enum: - RUN_STARTED - RUN_FINISHED - RUN_ERROR - TEXT_MESSAGE_START - TEXT_MESSAGE_CONTENT - TEXT_MESSAGE_END - TOOL_CALL_START - TOOL_CALL_ARGS - TOOL_CALL_CHUNK - TOOL_CALL_END - TOOL_CALL_RESULT - STATE_SNAPSHOT - STATE_DELTA - MESSAGES_SNAPSHOT - STEP_STARTED - STEP_FINISHED - REASONING_START - REASONING_MESSAGE_START - REASONING_MESSAGE_CONTENT - REASONING_MESSAGE_END - REASONING_CONTENT - REASONING_END - ACTIVITY_SNAPSHOT - ACTIVITY_DELTA - AGENT_RUN_AUTHORIZATION_SEALED - AGENT_RUN_REQUEST_ENQUEUED - AGENT_RUN_DEFAULT_CHAT_START_ENQUEUED - AGENT_RUN_TOOL_RESULT_SUBMITTED - AGENT_RUN_TOOL_RESULT_DELIVERY_FAILED - AGENT_RUN_INTEGRATION_CONNECTION_REFUSED - AGENT_RUN_RUNTIME_OWNER_BOUND - AGENT_RUN_RUNTIME_INVOKE_RETRIED - AGENT_RUN_CONTEXT_COMPACTED - AGENT_RUN_TOOL_EXPOSURE_CHECKPOINTED - AGENT_RUN_PROVIDER_REPLAY_CHECKPOINTED - AGENT_RUN_PROVIDER_REPLAY_TURN_STARTED - AGENT_RUN_PROVIDER_REPLAY_TURN_FINISHED - AGENT_RUN_MODEL_CALL_CONTEXT_RECORDED - AGENT_RUN_CONTROL_PLANE_DISPATCH_ACCEPTED - AGENT_RUN_DETACHED_ACCEPTED - AGENT_RUN_INVOKE_AGENT_BILLING_MODE_RETAINED - AGENT_RUN_BILLING_USAGE_RETAINED - AGENT_RUN_REPLAYED_UPLOADS_SEALED - TOOL_CALL_STATUS_CHANGED - INPUT_REQUEST_CREATED - INPUT_REQUEST_UPDATED - CHILD_RUN_STATUS_CHANGED - MODEL_CALL_COMPLETED - RUN_PARKED - RUN_LOG_CAPTURED - STREAM_HEARTBEAT_EMITTED - URL_CITED - DOCUMENT_CITED - FILE_ATTACHED - FILES_CHANGED - RUNTIME_EVENT_RECORDED - AGENT_RUN_CONTROL_PLANE_DISPATCH_RECEIPT - AGENT_RUN_TOOL_EXPOSURE_CHECKPOINT - AGENT_RUN_PROVIDER_REPLAY_CHECKPOINT - AGENT_RUN_MODEL_CALL_CONTEXT payload: description: Payload of an unrecognized historical or future event. is_error: type: boolean created_at: type: string run_id: type: string format: uuid description: Run identifier associated with the record. event_class: type: string enum: - fact - delta description: The event class associated with this record. span_id: type: string minLength: 1 description: The span id associated with this record. parent_span_id: type: - string - 'null' minLength: 1 description: The parent span id associated with this record. turn_id: type: - string - 'null' minLength: 1 description: The turn id associated with this record. origin_event_type: type: string minLength: 1 description: The origin event type associated with this record. origin_custom_name: type: - string - 'null' minLength: 1 description: The origin custom name associated with this record. unrecoverable_fields: type: array items: type: string minLength: 1 description: One unrecoverable field item associated with this record. description: List of unrecoverable fields associated with this record. required: - event_id - event_type - payload - is_error - created_at - run_id - event_class - span_id - parent_span_id - turn_id - origin_event_type - origin_custom_name - unrecoverable_fields additionalProperties: false RunsPageInfo: type: object properties: next: type: - string - 'null' required: - next description: Opaque cursor for the next page; null means there are no more results. RunStartedPayload: type: object properties: type: type: string enum: - RUN_STARTED runId: type: string minLength: 1 required: - type allOf: - type: object properties: type: type: string enum: - RUN_STARTED required: - type RunFinishedPayload: type: object properties: type: type: string enum: - RUN_FINISHED runId: type: string minLength: 1 metadata: type: object additionalProperties: {} required: - type allOf: - type: object properties: type: type: string enum: - RUN_FINISHED required: - type RunErrorPayload: type: object properties: type: type: string enum: - RUN_ERROR runId: type: string minLength: 1 code: type: string minLength: 1 message: type: string metadata: type: object additionalProperties: {} required: - type allOf: - type: object properties: type: type: string enum: - RUN_ERROR required: - type TextMessageStartPayload: type: object properties: type: type: string enum: - TEXT_MESSAGE_START messageId: type: string minLength: 1 contentId: type: string minLength: 1 role: type: string required: - type - messageId - contentId allOf: - type: object properties: type: type: string enum: - TEXT_MESSAGE_START messageId: type: string minLength: 1 contentId: type: string minLength: 1 role: type: string required: - type - messageId - contentId TextMessageContentPayload: type: object properties: type: type: string enum: - TEXT_MESSAGE_CONTENT messageId: type: string minLength: 1 contentId: type: string minLength: 1 delta: type: string required: - type - messageId - delta allOf: - type: object properties: type: type: string enum: - TEXT_MESSAGE_CONTENT messageId: type: string minLength: 1 contentId: type: string minLength: 1 delta: type: string required: - type - messageId - contentId - delta TextMessageEndPayload: type: object properties: type: type: string enum: - TEXT_MESSAGE_END messageId: type: string minLength: 1 contentId: type: string minLength: 1 required: - type - messageId allOf: - type: object properties: type: type: string enum: - TEXT_MESSAGE_END messageId: type: string minLength: 1 contentId: type: string minLength: 1 required: - type - messageId - contentId ToolCallStartPayload: type: object properties: type: type: string enum: - TOOL_CALL_START toolCallId: type: string minLength: 1 toolCallName: type: string minLength: 1 parentMessageId: type: string minLength: 1 required: - type - toolCallId - toolCallName allOf: - type: object properties: type: type: string enum: - TOOL_CALL_START toolCallId: type: string minLength: 1 toolCallName: type: string minLength: 1 required: - type - toolCallId - toolCallName ToolCallArgsPayload: type: object properties: type: type: string enum: - TOOL_CALL_ARGS toolCallId: type: string minLength: 1 delta: type: string required: - type - toolCallId - delta allOf: - type: object properties: type: type: string enum: - TOOL_CALL_ARGS toolCallId: type: string minLength: 1 delta: type: string required: - type - toolCallId - delta ToolCallChunkPayload: type: object properties: type: type: string enum: - TOOL_CALL_CHUNK toolCallId: type: string minLength: 1 delta: type: string required: - type - toolCallId - delta allOf: - type: object properties: type: type: string enum: - TOOL_CALL_CHUNK toolCallId: type: string minLength: 1 delta: type: string required: - type - toolCallId - delta ToolCallEndPayload: type: object properties: type: type: string enum: - TOOL_CALL_END toolCallId: type: string minLength: 1 required: - type - toolCallId allOf: - type: object properties: type: type: string enum: - TOOL_CALL_END toolCallId: type: string minLength: 1 required: - type - toolCallId ToolCallResultPayload: type: object properties: type: type: string enum: - TOOL_CALL_RESULT toolCallId: type: string minLength: 1 messageId: type: string minLength: 1 parentMessageId: type: string minLength: 1 content: {} isError: type: - boolean - 'null' role: type: string enum: - tool required: - type - toolCallId - isError allOf: - type: object properties: type: type: string enum: - TOOL_CALL_RESULT messageId: type: string minLength: 1 parentMessageId: type: string minLength: 1 toolCallId: type: string minLength: 1 input: {} content: {} result: {} role: type: string enum: - tool isError: type: - boolean - 'null' required: - type - toolCallId StateSnapshotPayload: type: object properties: type: type: string enum: - STATE_SNAPSHOT snapshot: type: object additionalProperties: {} required: - type - snapshot allOf: - type: object properties: type: type: string enum: - STATE_SNAPSHOT snapshot: type: object additionalProperties: {} required: - type - snapshot StateDeltaPayload: type: object properties: type: type: string enum: - STATE_DELTA delta: {} required: - type allOf: - type: object properties: type: type: string enum: - STATE_DELTA delta: anyOf: - type: object additionalProperties: {} - type: array items: type: object properties: op: type: string enum: - add - remove - replace - move - copy - test path: type: string minLength: 1 from: type: string minLength: 1 value: {} required: - op - path required: - type - delta MessagesSnapshotPayload: type: object properties: type: type: string enum: - MESSAGES_SNAPSHOT messages: type: array items: type: object additionalProperties: {} required: - type - messages allOf: - type: object properties: type: type: string enum: - MESSAGES_SNAPSHOT messages: type: array items: type: object properties: id: type: string minLength: 1 role: type: string minLength: 1 parts: type: array items: type: object properties: type: type: string minLength: 1 required: - type content: {} required: - type - messages StepStartedPayload: type: object properties: type: type: string enum: - STEP_STARTED stepId: type: string minLength: 1 stepName: type: string minLength: 1 runtime: type: string minLength: 1 required: - type allOf: - type: object properties: type: type: string enum: - STEP_STARTED required: - type StepFinishedPayload: type: object properties: type: type: string enum: - STEP_FINISHED stepId: type: string minLength: 1 stepName: type: string minLength: 1 runtime: type: string minLength: 1 status: type: string minLength: 1 required: - type allOf: - type: object properties: type: type: string enum: - STEP_FINISHED required: - type ReasoningStartPayload: type: object properties: type: type: string enum: - REASONING_START messageId: type: string minLength: 1 required: - type allOf: - type: object properties: type: type: string enum: - REASONING_START required: - type ReasoningMessageStartPayload: type: object properties: type: type: string enum: - REASONING_MESSAGE_START messageId: type: string minLength: 1 required: - type - messageId allOf: - type: object properties: type: type: string enum: - REASONING_MESSAGE_START required: - type ReasoningMessageContentPayload: type: object properties: type: type: string enum: - REASONING_MESSAGE_CONTENT messageId: type: string minLength: 1 delta: type: string required: - type - messageId - delta allOf: - type: object properties: type: type: string enum: - REASONING_MESSAGE_CONTENT required: - type ReasoningMessageEndPayload: type: object properties: type: type: string enum: - REASONING_MESSAGE_END messageId: type: string minLength: 1 required: - type - messageId allOf: - type: object properties: type: type: string enum: - REASONING_MESSAGE_END required: - type ReasoningContentPayload: type: object properties: type: type: string enum: - REASONING_CONTENT messageId: type: string minLength: 1 delta: type: string required: - type - delta allOf: - type: object properties: type: type: string enum: - REASONING_CONTENT required: - type ReasoningEndPayload: type: object properties: type: type: string enum: - REASONING_END messageId: type: string minLength: 1 required: - type allOf: - type: object properties: type: type: string enum: - REASONING_END required: - type ActivitySnapshotPayload: type: object properties: type: type: string enum: - ACTIVITY_SNAPSHOT required: - type allOf: - type: object properties: type: type: string enum: - ACTIVITY_SNAPSHOT required: - type ActivityDeltaPayload: type: object properties: type: type: string enum: - ACTIVITY_DELTA required: - type allOf: - type: object properties: type: type: string enum: - ACTIVITY_DELTA required: - type AgentRunAuthorizationSealedPayload: type: object properties: type: type: string enum: - AGENT_RUN_AUTHORIZATION_SEALED required: - type AgentRunAuthorizationSealedPayloadRedacted: type: object properties: type: type: string enum: - AGENT_RUN_AUTHORIZATION_SEALED required: - type additionalProperties: false AgentRunRequestEnqueuedPayload: type: object properties: type: type: string enum: - AGENT_RUN_REQUEST_ENQUEUED required: - type AgentRunDefaultChatStartEnqueuedPayload: type: object properties: type: type: string enum: - AGENT_RUN_DEFAULT_CHAT_START_ENQUEUED required: - type AgentRunToolResultSubmittedPayload: type: object properties: type: type: string enum: - AGENT_RUN_TOOL_RESULT_SUBMITTED required: - type AgentRunToolResultDeliveryFailedPayload: type: object properties: type: type: string enum: - AGENT_RUN_TOOL_RESULT_DELIVERY_FAILED required: - type AgentRunIntegrationConnectionRefusedPayload: type: object properties: type: type: string enum: - AGENT_RUN_INTEGRATION_CONNECTION_REFUSED integration: type: string minLength: 1 toolName: type: string minLength: 1 message: type: string minLength: 1 required: - type - integration - toolName - message AgentRunRuntimeOwnerBoundPayload: type: object properties: type: type: string enum: - AGENT_RUN_RUNTIME_OWNER_BOUND required: - type AgentRunRuntimeInvokeRetriedPayload: type: object properties: type: type: string enum: - AGENT_RUN_RUNTIME_INVOKE_RETRIED required: - type AgentRunContextCompactedPayload: type: object properties: type: type: string enum: - AGENT_RUN_CONTEXT_COMPACTED required: - type allOf: - type: object properties: type: type: string enum: - AGENT_RUN_CONTEXT_COMPACTED summary: type: object properties: text: type: string minLength: 1 required: - text firstKeptEntryId: type: string minLength: 1 tokensBefore: type: integer minimum: 0 tokensAfter: type: integer minimum: 0 tokenBudget: type: integer exclusiveMinimum: 0 reserveTokens: type: integer minimum: 0 reason: type: string enum: - context_window - transport_body elapsedMs: type: number minimum: 0 emittedAt: type: integer minimum: 0 required: - type - summary - firstKeptEntryId - tokensBefore - tokensAfter - tokenBudget - reserveTokens - reason additionalProperties: false AgentRunContextCompactedPayloadRedacted: type: object properties: type: type: string enum: - AGENT_RUN_CONTEXT_COMPACTED required: - type additionalProperties: false AgentRunToolExposureCheckpointedPayload: type: object properties: type: type: string enum: - AGENT_RUN_TOOL_EXPOSURE_CHECKPOINTED required: - type allOf: - type: object properties: type: type: string enum: - AGENT_RUN_TOOL_EXPOSURE_CHECKPOINTED version: anyOf: - type: number enum: - 1 - type: number enum: - 2 authorizedCatalogFingerprint: type: string minLength: 1 maxLength: 256 loadedToolNames: type: array items: type: string minLength: 1 maxLength: 128 pattern: ^[a-zA-Z][a-zA-Z0-9._:-]*$ elapsedMs: type: number minimum: 0 emittedAt: type: integer minimum: 0 required: - type - version - loadedToolNames additionalProperties: false AgentRunToolExposureCheckpointedPayloadRedacted: type: object properties: type: type: string enum: - AGENT_RUN_TOOL_EXPOSURE_CHECKPOINTED required: - type additionalProperties: false AgentRunProviderReplayCheckpointedPayload: type: object properties: type: type: string enum: - AGENT_RUN_PROVIDER_REPLAY_CHECKPOINTED required: - type allOf: - type: object properties: type: type: string enum: - AGENT_RUN_PROVIDER_REPLAY_CHECKPOINTED version: type: number enum: - 1 messageId: type: string minLength: 1 maxLength: 256 provider: type: string enum: - anthropic - openai-responses providerBlocks: type: array items: type: object properties: type: type: string enum: - provider-block provider: type: string enum: - anthropic - openai-responses block: type: object additionalProperties: {} required: - type - provider - block additionalProperties: false minItems: 1 maxItems: 100 providerBlockPositions: type: array items: type: integer minimum: 0 maximum: 10000 minItems: 1 maxItems: 100 providerMessageBlockCounts: type: array items: type: integer minimum: 1 maximum: 100 minItems: 1 maxItems: 100 totalPartCount: type: integer minimum: 1 maximum: 10000 elapsedMs: type: number minimum: 0 emittedAt: type: integer minimum: 0 required: - type - version - messageId - provider - providerBlocks - providerBlockPositions - totalPartCount additionalProperties: false AgentRunProviderReplayCheckpointedPayloadRedacted: type: object properties: type: type: string enum: - AGENT_RUN_PROVIDER_REPLAY_CHECKPOINTED required: - type additionalProperties: false AgentRunProviderReplayTurnStartedPayload: type: object properties: type: type: string enum: - AGENT_RUN_PROVIDER_REPLAY_TURN_STARTED required: - type AgentRunProviderReplayTurnStartedPayloadRedacted: type: object properties: type: type: string enum: - AGENT_RUN_PROVIDER_REPLAY_TURN_STARTED required: - type additionalProperties: false AgentRunProviderReplayTurnFinishedPayload: type: object properties: type: type: string enum: - AGENT_RUN_PROVIDER_REPLAY_TURN_FINISHED required: - type AgentRunProviderReplayTurnFinishedPayloadRedacted: type: object properties: type: type: string enum: - AGENT_RUN_PROVIDER_REPLAY_TURN_FINISHED required: - type additionalProperties: false AgentRunModelCallContextRecordedPayloadRead: anyOf: - type: object properties: type: type: string enum: - AGENT_RUN_MODEL_CALL_CONTEXT_RECORDED - AGENT_RUN_MODEL_CALL_CONTEXT model: type: object properties: id: type: string minLength: 1 modelProvider: type: string minLength: 1 required: - id additionalProperties: false request: type: object properties: maxOutputTokens: type: number minimum: 0 temperature: type: number topP: type: number topK: type: number stopSequences: type: array items: type: string seed: type: number presencePenalty: type: number frequencyPenalty: type: number parallelToolCalls: type: boolean reasoning: type: object properties: enabled: type: boolean effort: type: string enum: - low - medium - high - max budgetTokens: type: integer minimum: 0 additionalProperties: false additionalProperties: false messages: type: array items: oneOf: - type: object properties: role: type: string enum: - system content: type: string providerOptions: type: object additionalProperties: type: object properties: cacheControl: type: object properties: type: type: string enum: - ephemeral ttl: type: string enum: - 5m - 1h required: - type additionalProperties: false required: - cacheControl additionalProperties: false required: - role - content additionalProperties: false - type: object properties: role: type: string enum: - user content: type: array items: anyOf: - type: object properties: type: type: string enum: - text text: type: string required: - type - text additionalProperties: false - type: object properties: type: type: string enum: - image - file mediaType: type: string url: type: string filename: type: string required: - type - mediaType - url additionalProperties: false required: - role - content additionalProperties: false - type: object properties: role: type: string enum: - assistant content: type: array items: anyOf: - type: object properties: type: type: string enum: - text text: type: string required: - type - text additionalProperties: false - type: object properties: type: type: string enum: - tool-call toolCallId: type: string toolName: type: string input: {} providerExecuted: type: boolean required: - type - toolCallId - toolName - input additionalProperties: false required: - role - content additionalProperties: false - type: object properties: role: type: string enum: - tool content: type: array items: type: object properties: type: type: string enum: - tool-result toolCallId: type: string toolName: type: string output: type: object properties: type: type: string enum: - json value: {} required: - type - value additionalProperties: false required: - type - toolCallId - toolName - output additionalProperties: false required: - role - content additionalProperties: false tools: type: array items: anyOf: - type: object properties: type: type: string enum: - function name: type: string description: type: string inputSchema: {} required: - type - name - inputSchema additionalProperties: false - type: object properties: type: type: string enum: - provider name: type: string id: type: string args: type: object additionalProperties: {} required: - type - name - id - args additionalProperties: false elapsedMs: type: number minimum: 0 emittedAt: type: integer minimum: 0 required: - type - messages additionalProperties: false - type: object properties: type: type: string enum: - AGENT_RUN_MODEL_CALL_CONTEXT_RECORDED - AGENT_RUN_MODEL_CALL_CONTEXT model: type: object properties: id: type: string minLength: 1 modelProvider: type: string minLength: 1 required: - id additionalProperties: false request: type: object properties: maxOutputTokens: type: number minimum: 0 temperature: type: number topP: type: number topK: type: number stopSequences: type: array items: type: string seed: type: number presencePenalty: type: number frequencyPenalty: type: number parallelToolCalls: type: boolean reasoning: type: object properties: enabled: type: boolean effort: type: string enum: - low - medium - high - max budgetTokens: type: integer minimum: 0 additionalProperties: false additionalProperties: false messages: type: array items: oneOf: - type: object properties: role: type: string enum: - system content: type: string providerOptions: type: object additionalProperties: type: object properties: cacheControl: type: object properties: type: type: string enum: - ephemeral ttl: type: string enum: - 5m - 1h required: - type additionalProperties: false required: - cacheControl additionalProperties: false required: - role - content additionalProperties: false - type: object properties: role: type: string enum: - user content: type: array items: anyOf: - type: object properties: type: type: string enum: - text text: type: string required: - type - text additionalProperties: false - type: object properties: type: type: string enum: - image - file mediaType: type: string url: type: string filename: type: string required: - type - mediaType - url additionalProperties: false required: - role - content additionalProperties: false - type: object properties: role: type: string enum: - assistant content: type: array items: anyOf: - type: object properties: type: type: string enum: - text text: type: string required: - type - text additionalProperties: false - type: object properties: type: type: string enum: - tool-call toolCallId: type: string toolName: type: string input: {} providerExecuted: type: boolean required: - type - toolCallId - toolName - input additionalProperties: false required: - role - content additionalProperties: false - type: object properties: role: type: string enum: - tool content: type: array items: type: object properties: type: type: string enum: - tool-result toolCallId: type: string toolName: type: string output: type: object properties: type: type: string enum: - json value: {} required: - type - value additionalProperties: false required: - type - toolCallId - toolName - output additionalProperties: false required: - role - content additionalProperties: false tools: type: array items: anyOf: - type: object properties: type: type: string enum: - function name: type: string description: type: string inputSchema: {} required: - type - name - inputSchema additionalProperties: false - type: object properties: type: type: string enum: - provider name: type: string id: type: string args: type: object additionalProperties: {} required: - type - name - id - args additionalProperties: false elapsedMs: type: number minimum: 0 emittedAt: type: integer minimum: 0 modelCallId: type: string format: uuid required: - type - messages - modelCallId additionalProperties: false AgentRunModelCallContextRecordedPayloadRedacted: type: object properties: type: type: string enum: - AGENT_RUN_MODEL_CALL_CONTEXT_RECORDED required: - type additionalProperties: false AgentRunControlPlaneDispatchAcceptedPayloadRead: anyOf: - type: object properties: type: type: string enum: - AGENT_RUN_CONTROL_PLANE_DISPATCH_ACCEPTED requestHash: type: string pattern: ^[A-Za-z0-9_-]{43}$ required: - type - requestHash additionalProperties: false - type: object properties: type: type: string enum: - AGENT_RUN_CONTROL_PLANE_DISPATCH_ACCEPTED version: type: number enum: - 2 state: type: string enum: - intent_recorded runId: type: string minLength: 1 maxLength: 128 pattern: ^[a-zA-Z0-9_-]+$ projectId: type: string format: uuid leaseOwner: type: string pattern: >- ^agent-run-detached:[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$ dispatchAttemptId: type: string format: uuid transportRecoveryAttempt: type: integer minimum: 0 resumesDispatchAttemptId: type: string format: uuid requestHash: type: string pattern: ^[A-Za-z0-9_-]{43}$ leaseExpiresAt: type: string format: date-time required: - type - version - state - runId - projectId - leaseOwner - dispatchAttemptId - transportRecoveryAttempt - requestHash - leaseExpiresAt additionalProperties: false AgentRunControlPlaneDispatchAcceptedPayloadRedacted: type: object properties: type: type: string enum: - AGENT_RUN_CONTROL_PLANE_DISPATCH_ACCEPTED required: - type additionalProperties: false AgentRunDetachedAcceptedPayload: type: object properties: type: type: string enum: - AGENT_RUN_DETACHED_ACCEPTED leaseOwner: type: string minLength: 1 dispatchAttemptId: type: string format: uuid required: - type - leaseOwner - dispatchAttemptId AgentRunDetachedAcceptedPayloadRedacted: type: object properties: type: type: string enum: - AGENT_RUN_DETACHED_ACCEPTED required: - type additionalProperties: false AgentRunInvokeAgentBillingModeRetainedPayload: type: object properties: type: type: string enum: - AGENT_RUN_INVOKE_AGENT_BILLING_MODE_RETAINED required: - type AgentRunInvokeAgentBillingModeRetainedPayloadRedacted: type: object properties: type: type: string enum: - AGENT_RUN_INVOKE_AGENT_BILLING_MODE_RETAINED required: - type additionalProperties: false AgentRunBillingUsageRetainedPayload: type: object properties: type: type: string enum: - AGENT_RUN_BILLING_USAGE_RETAINED required: - type AgentRunBillingUsageRetainedPayloadRedacted: type: object properties: type: type: string enum: - AGENT_RUN_BILLING_USAGE_RETAINED required: - type additionalProperties: false AgentRunReplayedUploadsSealedPayload: type: object properties: type: type: string enum: - AGENT_RUN_REPLAYED_UPLOADS_SEALED required: - type AgentRunReplayedUploadsSealedPayloadRedacted: type: object properties: type: type: string enum: - AGENT_RUN_REPLAYED_UPLOADS_SEALED required: - type additionalProperties: false ToolCallStatusChangedPayload: type: object properties: type: type: string enum: - TOOL_CALL_STATUS_CHANGED toolCallId: type: string minLength: 1 status: type: string minLength: 1 toolCallName: type: - string - 'null' minLength: 1 required: - type - toolCallId - status - toolCallName allOf: - type: object properties: type: type: string enum: - TOOL_CALL_STATUS_CHANGED toolCallId: type: string minLength: 1 status: type: string minLength: 1 toolCallName: type: - string - 'null' minLength: 1 required: - type - toolCallId - status - toolCallName InputRequestCreatedPayload: type: object properties: type: type: string enum: - INPUT_REQUEST_CREATED inputRequest: type: object properties: id: type: string minLength: 1 required: - id required: - type - inputRequest allOf: - type: object properties: type: type: string enum: - INPUT_REQUEST_CREATED inputRequest: type: object properties: id: type: string minLength: 1 required: - id required: - type - inputRequest InputRequestUpdatedPayload: type: object properties: type: type: string enum: - INPUT_REQUEST_UPDATED inputRequest: type: object properties: id: type: string minLength: 1 required: - id required: - type - inputRequest allOf: - type: object properties: type: type: string enum: - INPUT_REQUEST_UPDATED inputRequest: type: object properties: id: type: string minLength: 1 required: - id required: - type - inputRequest ChildRunStatusChangedPayload: type: object properties: type: type: string enum: - CHILD_RUN_STATUS_CHANGED toolCallId: type: string minLength: 1 childRunId: type: string minLength: 1 status: type: string minLength: 1 childConversationId: type: - string - 'null' minLength: 1 childMessageId: type: - string - 'null' minLength: 1 childAgentId: type: - string - 'null' minLength: 1 description: type: string minLength: 1 required: - type - toolCallId - childRunId - status allOf: - type: object properties: type: type: string enum: - CHILD_RUN_STATUS_CHANGED toolCallId: type: string minLength: 1 childRunId: type: string minLength: 1 status: type: string minLength: 1 childConversationId: type: - string - 'null' minLength: 1 childMessageId: type: - string - 'null' minLength: 1 childAgentId: type: - string - 'null' minLength: 1 description: type: string minLength: 1 required: - type - toolCallId - childRunId - status ModelCallCompletedPayload: type: object properties: type: type: string enum: - MODEL_CALL_COMPLETED provider: type: string minLength: 1 model: type: string minLength: 1 inputTokens: type: integer minimum: 0 outputTokens: type: integer minimum: 0 cacheCreationTokens: type: integer minimum: 0 cacheReadTokens: type: integer minimum: 0 totalTokens: type: integer minimum: 0 costCredits: type: string minLength: 1 latencyMs: type: - integer - 'null' minimum: 0 usageCaptureStatus: type: string enum: - complete - partial - missing providerRequestId: type: - string - 'null' minLength: 1 modelCallContextEventId: type: - integer - 'null' exclusiveMinimum: 0 required: - type - provider - model - inputTokens - outputTokens - cacheCreationTokens - cacheReadTokens - totalTokens - costCredits - latencyMs - usageCaptureStatus - providerRequestId - modelCallContextEventId allOf: - type: object properties: type: type: string enum: - MODEL_CALL_COMPLETED provider: type: string minLength: 1 model: type: string minLength: 1 inputTokens: type: integer minimum: 0 outputTokens: type: integer minimum: 0 cacheCreationTokens: type: integer minimum: 0 cacheReadTokens: type: integer minimum: 0 totalTokens: type: integer minimum: 0 costCredits: type: string minLength: 1 latencyMs: type: - integer - 'null' minimum: 0 usageCaptureStatus: type: string enum: - complete - partial - missing providerRequestId: type: - string - 'null' minLength: 1 modelCallContextEventId: type: - integer - 'null' exclusiveMinimum: 0 required: - type - provider - model - inputTokens - outputTokens - cacheCreationTokens - cacheReadTokens - totalTokens - costCredits - latencyMs - usageCaptureStatus - providerRequestId - modelCallContextEventId RunParkedPayload: type: object properties: type: type: string enum: - RUN_PARKED runId: type: string minLength: 1 reason: type: string minLength: 1 lastEventId: type: integer minimum: 0 required: - type - runId - reason - lastEventId allOf: - type: object properties: type: type: string enum: - RUN_PARKED runId: type: string minLength: 1 reason: type: string minLength: 1 lastEventId: type: integer minimum: 0 required: - type - runId - reason - lastEventId RunLogCapturedPayload: type: object properties: type: type: string enum: - RUN_LOG_CAPTURED logs: type: string required: - type - logs allOf: - type: object properties: type: type: string enum: - RUN_LOG_CAPTURED logs: type: string required: - type - logs StreamHeartbeatEmittedPayload: type: object properties: type: type: string enum: - STREAM_HEARTBEAT_EMITTED runId: type: string minLength: 1 lastEventId: type: integer minimum: 0 required: - type - runId - lastEventId allOf: - type: object properties: type: type: string enum: - STREAM_HEARTBEAT_EMITTED runId: type: string minLength: 1 lastEventId: type: integer minimum: 0 required: - type - runId - lastEventId UrlCitedPayload: type: object properties: type: type: string enum: - URL_CITED url: type: string minLength: 1 sourceId: type: string minLength: 1 title: type: string minLength: 1 required: - type - url - sourceId allOf: - type: object properties: type: type: string enum: - URL_CITED url: type: string minLength: 1 sourceId: type: string minLength: 1 title: type: string minLength: 1 required: - type - url - sourceId DocumentCitedPayload: type: object properties: type: type: string enum: - DOCUMENT_CITED mediaType: type: string minLength: 1 sourceId: type: string minLength: 1 title: type: string minLength: 1 filename: type: string minLength: 1 required: - type - mediaType - sourceId allOf: - type: object properties: type: type: string enum: - DOCUMENT_CITED mediaType: type: string minLength: 1 sourceId: type: string minLength: 1 title: type: string minLength: 1 filename: type: string minLength: 1 required: - type - mediaType - sourceId FileAttachedPayload: type: object properties: type: type: string enum: - FILE_ATTACHED mediaType: type: string minLength: 1 url: type: string minLength: 1 filename: type: string minLength: 1 required: - type - mediaType allOf: - type: object properties: type: type: string enum: - FILE_ATTACHED mediaType: type: string minLength: 1 url: type: string minLength: 1 filename: type: string minLength: 1 required: - type - mediaType FilesChangedPayload: type: object properties: type: type: string enum: - FILES_CHANGED id: type: - string - 'null' minLength: 1 status: type: - string - 'null' minLength: 1 changes: {} required: - type - id - status - changes allOf: - type: object properties: type: type: string enum: - FILES_CHANGED id: type: - string - 'null' minLength: 1 status: type: - string - 'null' minLength: 1 changes: {} required: - type - id - status - changes RuntimeEventRecordedPayload: type: object properties: type: type: string enum: - RUNTIME_EVENT_RECORDED runtime: type: string minLength: 1 kind: type: string minLength: 1 value: {} required: - type - runtime - kind - value allOf: - type: object properties: type: type: string enum: - RUNTIME_EVENT_RECORDED runtime: type: string minLength: 1 kind: type: string minLength: 1 value: {} required: - type - runtime - kind - value AgentRunControlPlaneDispatchReceiptPayload: type: object properties: type: type: string enum: - AGENT_RUN_CONTROL_PLANE_DISPATCH_RECEIPT required: - type allOf: - type: object properties: type: type: string enum: - AGENT_RUN_CONTROL_PLANE_DISPATCH_RECEIPT requestHash: type: string pattern: ^[A-Za-z0-9_-]{43}$ required: - type - requestHash additionalProperties: false AgentRunControlPlaneDispatchReceiptPayloadRedacted: type: object properties: type: type: string enum: - AGENT_RUN_CONTROL_PLANE_DISPATCH_RECEIPT required: - type additionalProperties: false AgentRunToolExposureCheckpointPayload: type: object properties: type: type: string enum: - AGENT_RUN_TOOL_EXPOSURE_CHECKPOINT required: - type allOf: - type: object properties: type: type: string enum: - AGENT_RUN_TOOL_EXPOSURE_CHECKPOINT version: anyOf: - type: number enum: - 1 - type: number enum: - 2 authorizedCatalogFingerprint: type: string minLength: 1 maxLength: 256 loadedToolNames: type: array items: type: string minLength: 1 maxLength: 128 pattern: ^[a-zA-Z][a-zA-Z0-9._:-]*$ elapsedMs: type: number minimum: 0 emittedAt: type: integer minimum: 0 required: - type - version - loadedToolNames additionalProperties: false AgentRunToolExposureCheckpointPayloadRedacted: type: object properties: type: type: string enum: - AGENT_RUN_TOOL_EXPOSURE_CHECKPOINT required: - type additionalProperties: false AgentRunProviderReplayCheckpointPayload: type: object properties: type: type: string enum: - AGENT_RUN_PROVIDER_REPLAY_CHECKPOINT required: - type allOf: - type: object properties: type: type: string enum: - AGENT_RUN_PROVIDER_REPLAY_CHECKPOINT version: type: number enum: - 1 messageId: type: string minLength: 1 maxLength: 256 provider: type: string enum: - anthropic - openai-responses providerBlocks: type: array items: type: object properties: type: type: string enum: - provider-block provider: type: string enum: - anthropic - openai-responses block: type: object additionalProperties: {} required: - type - provider - block additionalProperties: false minItems: 1 maxItems: 100 providerBlockPositions: type: array items: type: integer minimum: 0 maximum: 10000 minItems: 1 maxItems: 100 providerMessageBlockCounts: type: array items: type: integer minimum: 1 maximum: 100 minItems: 1 maxItems: 100 totalPartCount: type: integer minimum: 1 maximum: 10000 elapsedMs: type: number minimum: 0 emittedAt: type: integer minimum: 0 required: - type - version - messageId - provider - providerBlocks - providerBlockPositions - totalPartCount additionalProperties: false AgentRunProviderReplayCheckpointPayloadRedacted: type: object properties: type: type: string enum: - AGENT_RUN_PROVIDER_REPLAY_CHECKPOINT required: - type additionalProperties: false AgentRunModelCallContextPayload: type: object properties: type: type: string enum: - AGENT_RUN_MODEL_CALL_CONTEXT required: - type allOf: - type: object properties: type: type: string enum: - AGENT_RUN_MODEL_CALL_CONTEXT model: type: object properties: id: type: string minLength: 1 modelProvider: type: string minLength: 1 required: - id additionalProperties: false request: type: object properties: maxOutputTokens: type: number minimum: 0 temperature: type: number topP: type: number topK: type: number stopSequences: type: array items: type: string seed: type: number presencePenalty: type: number frequencyPenalty: type: number parallelToolCalls: type: boolean reasoning: type: object properties: enabled: type: boolean effort: type: string enum: - low - medium - high - max budgetTokens: type: integer minimum: 0 additionalProperties: false additionalProperties: false messages: type: array items: oneOf: - type: object properties: role: type: string enum: - system content: type: string providerOptions: type: object additionalProperties: type: object properties: cacheControl: type: object properties: type: type: string enum: - ephemeral ttl: type: string enum: - 5m - 1h required: - type additionalProperties: false required: - cacheControl additionalProperties: false required: - role - content additionalProperties: false - type: object properties: role: type: string enum: - user content: type: array items: anyOf: - type: object properties: type: type: string enum: - text text: type: string required: - type - text additionalProperties: false - type: object properties: type: type: string enum: - image - file mediaType: type: string url: type: string filename: type: string required: - type - mediaType - url additionalProperties: false required: - role - content additionalProperties: false - type: object properties: role: type: string enum: - assistant content: type: array items: anyOf: - type: object properties: type: type: string enum: - text text: type: string required: - type - text additionalProperties: false - type: object properties: type: type: string enum: - tool-call toolCallId: type: string toolName: type: string input: {} providerExecuted: type: boolean required: - type - toolCallId - toolName - input additionalProperties: false required: - role - content additionalProperties: false - type: object properties: role: type: string enum: - tool content: type: array items: type: object properties: type: type: string enum: - tool-result toolCallId: type: string toolName: type: string output: type: object properties: type: type: string enum: - json value: {} required: - type - value additionalProperties: false required: - type - toolCallId - toolName - output additionalProperties: false required: - role - content additionalProperties: false tools: type: array items: anyOf: - type: object properties: type: type: string enum: - function name: type: string description: type: string inputSchema: {} required: - type - name - inputSchema additionalProperties: false - type: object properties: type: type: string enum: - provider name: type: string id: type: string args: type: object additionalProperties: {} required: - type - name - id - args additionalProperties: false elapsedMs: type: number minimum: 0 emittedAt: type: integer minimum: 0 modelCallId: type: string format: uuid required: - type - messages additionalProperties: false AgentRunModelCallContextPayloadRedacted: type: object properties: type: type: string enum: - AGENT_RUN_MODEL_CALL_CONTEXT required: - type additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT or API Key description: >- Use a JWT bearer token or a Veryfront API key in the `Authorization` header. apiKeyAuth: type: apiKey in: header name: X-API-Key description: Alternative API key header for `vf__` tokens. runExecutionAuth: type: http scheme: bearer bearerFormat: JWT description: >- Server-issued credential bound to project, run, registered runtime, execution generation, audience, expiry, and explicitly allowed operations; user/API-key editor access is insufficient. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.