> ## Documentation Index > Fetch the complete documentation index at: https://docs.checkfu.com/llms.txt > Use this file to discover all available pages before exploring further. # Send Session events > Sends exactly one flattened event in an events array and returns its durable accepted identity in data. ## OpenAPI ````yaml /openapi.json post /v1/sessions/{id}/events openapi: 3.1.0 info: title: Checkfu API version: '2026-08-31' description: >- Authentication is declared per operation: API-key, runtime, or connector bearer; Automation signature; or credential-free pairing redemption. Every general Checkfu REST request requires the dated `Checkfu-Version` header (one of: 2026-08-31); the three MCP JSON-RPC transports use `MCP-Protocol-Version`, A2A uses `A2A-Version`, and the provider OAuth callback carries neither Checkfu header. API keys resolve one Workspace without a request selector; authenticated responses identify it with `Checkfu-Workspace-Id`. servers: - url: https://api.checkfu.com security: - bearerAuth: [] tags: - name: organizations - name: sourceRepositories - name: tenants - name: workspaces - name: principals - name: principalGroups - name: principalAccessCredentials - name: apiKeys - name: agents - name: harnessRuntime - name: permissionAssignments - name: actionPolicies - name: files - name: memoryStores - name: modelCredentials - name: modelRoutingProfiles - name: toolSources - name: skills - name: skillSources - name: agentBlueprints - name: skillProposals - name: instructionProposals - name: catalog - name: concepts - name: support - name: connections - name: connectionAssignments - name: connectedRuntimes - name: fileTrees - name: collaboration - name: automationGraphs - name: automations - name: actionApprovals - name: standingApprovals - name: workloadReviewPolicies - name: usage - name: models - name: budgets - name: billing - name: sessions - name: audit - name: sessionExports - name: runs - name: runnerPools - name: transcripts - name: sessionWatches - name: sessionCapsules - name: sessionTrajectories - name: webhookEndpoints - name: integrationGateway - name: environments - name: vaults - name: apiMcp - name: a2a paths: /v1/sessions/{id}/events: post: tags: - sessions summary: Send Session events description: >- Sends exactly one flattened event in an events array and returns its durable accepted identity in data. Text, image and document input blocks retain existing byte and source-authority bounds. Interrupt acceptance records cancellation intent; observe the original input result for actual settlement. Tool confirmations and custom results name the emitted public tool-use event ID, never a native call ID; custom result content and is_error remain typed. General human approvals cannot be answered through model-callable tools. System messages require existing privileged authority. Exact idempotent replay returns the original acceptance. Checkfu support posture: alpha; hosted. Required evidence journey: session-turn. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities. operationId: sessions.sendSessionEvents parameters: - name: id in: path schema: $ref: '#/components/schemas/SessionId' required: true - name: checkfu-version in: header schema: type: string enum: - '2026-08-31' required: true - name: idempotency-key in: header schema: type: string allOf: - maxLength: 255 required: false requestBody: content: application/json: schema: $ref: '#/components/schemas/SendSessionEventsParams' required: true responses: '200': description: Success content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/Union_342' required: - data additionalProperties: false headers: checkfu-workspace-id: description: The Workspace resolved from the authenticated bearer credential. required: true schema: $ref: '#/components/schemas/WorkspaceId' '400': description: Typed Checkfu wire error content: application/json: schema: $ref: '#/components/schemas/SessionDriveBadRequestError' '401': description: Typed Checkfu wire error content: application/json: schema: type: object required: - error properties: error: type: object required: - type - message - more properties: type: type: string enum: - auth.invalid_key message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#auth-invalid-key description: >- Stable public documentation and remedy for this error type. additionalProperties: false additionalProperties: false '403': description: >- The organization, tenant, or workspace backing this key is administratively disabled. | Deployment governance or retention policy denied the request. content: application/json: schema: anyOf: - type: object required: - error properties: error: type: object properties: type: type: string enum: - auth.disabled_tenancy message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#auth-disabled-tenancy description: >- Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false additionalProperties: false - $ref: '#/components/schemas/PolicyDeniedError' '404': description: >- The requested resource does not exist in the resolved deployment boundary. content: application/json: schema: $ref: '#/components/schemas/ValidationNotFoundError' '409': description: >- The request conflicts with the resource's current state. | The operation is illegal for the resource's current lifecycle state. | Session history required by the operation has been removed or is unavailable. | An idempotent mutation conflicts with a completed or in-progress request for the same key. content: application/json: schema: anyOf: - $ref: '#/components/schemas/ValidationConflictError' - $ref: '#/components/schemas/RuntimeInvalidTransitionError' - $ref: '#/components/schemas/RuntimeSessionHistoryUnavailableError' - $ref: '#/components/schemas/IdempotencyConflictError' '422': description: >- No model candidate satisfies the deployment's routing constraints. | The harness does not satisfy the required protocol or capability set. content: application/json: schema: anyOf: - $ref: '#/components/schemas/ModelNoEligibleModelError' - $ref: '#/components/schemas/RuntimeHarnessIncompatibleError' '429': description: Typed Checkfu wire error headers: retry-after: description: >- Delay in seconds for rate limits or deployment quotas with a known release or UTC reset boundary required: false schema: type: integer minimum: 1 content: application/json: schema: type: object required: - error properties: error: type: object required: - type - message - more properties: type: type: string enum: - budget.exceeded message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#budget-exceeded description: >- Stable public documentation and remedy for this error type. additionalProperties: false additionalProperties: false '500': description: >- An unexpected internal failure occurred; the message contains an opaque incident reference. content: application/json: schema: $ref: '#/components/schemas/RuntimeInternalError' '503': description: >- Authorization could not be evaluated. Retry the same request. | No eligible Runner can currently claim the work. | Platform-managed model credentials are temporarily unavailable. content: application/json: schema: anyOf: - $ref: '#/components/schemas/AuthorizationUnavailableError' - $ref: '#/components/schemas/RuntimeRunnerUnavailableError' - $ref: '#/components/schemas/ModelPlatformSupplyUnavailableError' security: - bearerAuth: [] components: schemas: SessionId: type: string pattern: ^sess_[0-9a-f]{32}$ SendSessionEventsParams: type: object properties: events: type: array items: $ref: '#/components/schemas/SendSessionEvent' allOf: - minItems: 1 - maxItems: 50 required: - events additionalProperties: false Union_342: anyOf: - $ref: '#/components/schemas/Objects_180' - $ref: '#/components/schemas/Objects_181' - $ref: '#/components/schemas/Objects_182' - $ref: '#/components/schemas/Objects_183' - $ref: '#/components/schemas/Objects_184' - $ref: '#/components/schemas/Objects_185' - $ref: '#/components/schemas/Objects_186' - $ref: '#/components/schemas/Objects_187' - $ref: '#/components/schemas/Objects_189' - $ref: '#/components/schemas/Objects_190' - $ref: '#/components/schemas/Objects_191' - $ref: '#/components/schemas/Objects_192' - $ref: '#/components/schemas/Objects_193' - $ref: '#/components/schemas/Objects_197' - $ref: '#/components/schemas/Objects_198' - $ref: '#/components/schemas/Objects_199' - $ref: '#/components/schemas/Objects_200' - $ref: '#/components/schemas/Objects_201' - $ref: '#/components/schemas/Objects_202' - $ref: '#/components/schemas/Objects_205' - $ref: '#/components/schemas/Objects_206' - $ref: '#/components/schemas/Objects_208' - $ref: '#/components/schemas/Objects_209' - $ref: '#/components/schemas/Objects_210' - $ref: '#/components/schemas/Objects_211' - $ref: '#/components/schemas/Objects_212' - $ref: '#/components/schemas/Objects_213' - $ref: '#/components/schemas/Objects_214' - $ref: '#/components/schemas/Objects_215' - $ref: '#/components/schemas/Objects_216' - $ref: '#/components/schemas/Objects_219' - $ref: '#/components/schemas/Objects_220' - $ref: '#/components/schemas/Objects_221' - $ref: '#/components/schemas/Objects_222' - $ref: '#/components/schemas/Objects_223' - $ref: '#/components/schemas/Objects_224' - $ref: '#/components/schemas/Objects_225' - $ref: '#/components/schemas/Objects_226' - $ref: '#/components/schemas/Objects_227' - $ref: '#/components/schemas/Objects_228' - $ref: '#/components/schemas/Objects_229' - $ref: '#/components/schemas/Objects_231' - $ref: '#/components/schemas/Objects_232' - $ref: '#/components/schemas/Objects_233' - $ref: '#/components/schemas/Objects_234' - $ref: '#/components/schemas/Objects_235' - $ref: '#/components/schemas/Objects_236' - $ref: '#/components/schemas/Objects_237' - $ref: '#/components/schemas/Objects_238' - $ref: '#/components/schemas/Objects_239' - $ref: '#/components/schemas/Objects_241' - $ref: '#/components/schemas/Objects_242' - $ref: '#/components/schemas/Objects_243' - $ref: '#/components/schemas/Objects_244' - $ref: '#/components/schemas/Objects_245' - $ref: '#/components/schemas/Objects_246' - $ref: '#/components/schemas/Objects_247' - $ref: '#/components/schemas/Objects_248' - $ref: '#/components/schemas/Objects_249' - $ref: '#/components/schemas/Objects_250' - $ref: '#/components/schemas/Objects_251' - $ref: '#/components/schemas/Objects_252' - $ref: '#/components/schemas/Objects_253' - $ref: '#/components/schemas/Objects_254' - $ref: '#/components/schemas/Objects_255' - $ref: '#/components/schemas/Objects_256' - $ref: '#/components/schemas/Objects_257' - $ref: '#/components/schemas/Objects_258' - $ref: '#/components/schemas/Objects_259' - $ref: '#/components/schemas/Objects_260' - $ref: '#/components/schemas/Objects_261' - $ref: '#/components/schemas/Objects_263' WorkspaceId: type: string pattern: ^wrkspc_[0-9a-f]{32}$ SessionDriveBadRequestError: anyOf: - $ref: '#/components/schemas/ValidationMalformedError' - $ref: '#/components/schemas/ValidationPromptIntegrityReviewRequiredError' description: >- A Session drive request was malformed or requires explicit prompt-integrity review. PolicyDeniedError: type: object properties: error: type: object properties: type: type: string enum: - policy.denied message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#policy-denied description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: Deployment governance or retention policy denied the request. ValidationNotFoundError: type: object properties: error: type: object properties: type: type: string enum: - validation.not_found message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#validation-not-found description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- The requested resource does not exist in the resolved deployment boundary. ValidationConflictError: type: object properties: error: type: object properties: type: type: string enum: - validation.conflict message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#validation-conflict description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: The request conflicts with the resource's current state. RuntimeInvalidTransitionError: type: object properties: error: type: object properties: type: type: string enum: - runtime.invalid_transition message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#runtime-invalid-transition description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: The operation is illegal for the resource's current lifecycle state. RuntimeSessionHistoryUnavailableError: type: object properties: error: type: object properties: type: type: string enum: - runtime.session_history_unavailable message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#runtime-session-history-unavailable description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- Session history required by the operation has been removed or is unavailable. IdempotencyConflictError: anyOf: - $ref: '#/components/schemas/ValidationIdempotencyConflictError' - $ref: '#/components/schemas/ValidationIdempotencyInProgressError' description: >- An idempotent mutation conflicts with a completed or in-progress request for the same key. ModelNoEligibleModelError: type: object properties: error: type: object properties: type: type: string enum: - model.no_eligible_model message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#model-no-eligible-model description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: No model candidate satisfies the deployment's routing constraints. RuntimeHarnessIncompatibleError: type: object properties: error: type: object properties: type: type: string enum: - runtime.harness_incompatible message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#runtime-harness-incompatible description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: The harness does not satisfy the required protocol or capability set. RuntimeInternalError: type: object properties: error: type: object properties: type: type: string enum: - runtime.internal message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#runtime-internal description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- An unexpected internal failure occurred; the message contains an opaque incident reference. AuthorizationUnavailableError: type: object properties: error: type: object properties: type: type: string enum: - auth.authorization_unavailable message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#auth-authorization-unavailable description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: Authorization could not be evaluated. Retry the same request. RuntimeRunnerUnavailableError: type: object properties: error: type: object properties: type: type: string enum: - runtime.runner_unavailable message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#runtime-runner-unavailable description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: No eligible Runner can currently claim the work. ModelPlatformSupplyUnavailableError: type: object properties: error: type: object properties: type: type: string enum: - model.platform_supply_unavailable message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#model-platform-supply-unavailable description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: Platform-managed model credentials are temporarily unavailable. SendSessionEvent: anyOf: - type: object properties: type: type: string enum: - user.message content: $ref: '#/components/schemas/MessageContentBlocks' run_delivery: type: string enum: - next_run connected_runtime: $ref: '#/components/schemas/ConnectedRuntimeId' host_context: type: object properties: source: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ data: $ref: '#/components/schemas/HostContextData' required: - source - data additionalProperties: false prompt_integrity_disposition: type: string enum: - accepted_normalization - preserved_original required: - type - content additionalProperties: false - type: object properties: type: type: string enum: - user.interrupt target_event: $ref: '#/components/schemas/EventId' mode: type: string enum: - cooperative required: - type additionalProperties: false - type: object properties: type: type: string enum: - user.tool_confirmation tool_use_id: $ref: '#/components/schemas/EventId' result: type: string enum: - allow - deny deny_message: anyOf: - type: string - type: 'null' required: - type - tool_use_id - result additionalProperties: false - type: object properties: type: type: string enum: - user.custom_tool_result custom_tool_use_id: $ref: '#/components/schemas/EventId' content: type: array items: $ref: '#/components/schemas/Union_313' is_error: anyOf: - type: boolean - type: 'null' required: - type - custom_tool_use_id additionalProperties: false - type: object properties: type: type: string enum: - system.message content: type: array items: type: object properties: type: type: string enum: - text text: type: string required: - type - text additionalProperties: false required: - type - content additionalProperties: false - type: object properties: type: type: string enum: - user.question_answer question: $ref: '#/components/schemas/QuestionId' answers: $ref: '#/components/schemas/ManagedQuestionAnswers' prompt_integrity_disposition: type: string enum: - accepted_normalization - preserved_original required: - type - question - answers additionalProperties: false Objects_180: type: object properties: content: type: array items: $ref: '#/components/schemas/Union_67' attachments: type: array items: type: string prompt_integrity: type: object properties: analyzer_version: type: string enum: - unicode-17.0.0-uts39-r32-checkfu-1 disposition: $ref: '#/components/schemas/Union_308' original_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ findings: type: array items: $ref: '#/components/schemas/Union_309' allOf: - minItems: 1 - maxItems: 256 required: - analyzer_version - disposition - original_digest - findings additionalProperties: false connected_runtime: $ref: '#/components/schemas/ConnectedRuntimeId' run_delivery: type: string enum: - next_run host_context: type: object properties: source: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ data: $ref: '#/components/schemas/HostContextData' required: - source - data additionalProperties: false authored_by: $ref: '#/components/schemas/Union_312' caused_by: $ref: '#/components/schemas/Union_274' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - user.message processed_at: anyOf: - type: string - type: 'null' required: - content - authored_by - caused_by - id - session_id - sequence - created_at - type additionalProperties: false Objects_181: type: object properties: target_event: $ref: '#/components/schemas/EventId' mode: type: string enum: - cooperative authored_by: $ref: '#/components/schemas/Union_312' caused_by: $ref: '#/components/schemas/Union_274' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - user.interrupt processed_at: anyOf: - type: string - type: 'null' required: - authored_by - caused_by - id - session_id - sequence - created_at - type additionalProperties: false Objects_182: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - user.custom_tool_result custom_tool_use_id: $ref: '#/components/schemas/EventId' content: type: array items: $ref: '#/components/schemas/Union_313' is_error: type: boolean processed_at: anyOf: - type: string - type: 'null' required: - id - session_id - sequence - created_at - type - custom_tool_use_id - content - is_error additionalProperties: false Objects_183: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - user.tool_confirmation tool_use_id: $ref: '#/components/schemas/EventId' result: type: string enum: - allow - deny deny_message: type: string processed_at: anyOf: - type: string - type: 'null' required: - id - session_id - sequence - created_at - type - tool_use_id - result additionalProperties: false Objects_184: type: object properties: question: $ref: '#/components/schemas/QuestionId' answers: $ref: '#/components/schemas/ManagedQuestionAnswers' prompt_integrity: type: object properties: analyzer_version: type: string enum: - unicode-17.0.0-uts39-r32-checkfu-1 disposition: $ref: '#/components/schemas/Union_308' original_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ findings: type: array items: $ref: '#/components/schemas/Union_309' allOf: - minItems: 1 - maxItems: 256 required: - analyzer_version - disposition - original_digest - findings additionalProperties: false authored_by: $ref: '#/components/schemas/Union_312' caused_by: $ref: '#/components/schemas/Union_274' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - user.question_answer processed_at: anyOf: - type: string - type: 'null' required: - question - answers - authored_by - caused_by - id - session_id - sequence - created_at - type additionalProperties: false Objects_185: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - agent.message content: type: array items: type: object properties: type: type: string enum: - text text: type: string required: - type - text additionalProperties: false processed_at: type: string required: - id - session_id - sequence - created_at - type - content - processed_at additionalProperties: false Objects_186: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - agent.message withheld: type: object properties: reason: type: string enum: - screen_block - screen_failed required: - reason additionalProperties: false processed_at: type: string required: - id - session_id - sequence - created_at - type - withheld - processed_at additionalProperties: false Objects_187: type: object properties: verdict: type: string enum: - pass - block withheld_reason: type: string enum: - screen_block - screen_failed reason: type: string allOf: - maxLength: 512 content_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ route: $ref: '#/components/schemas/Objects_188' usage: $ref: '#/components/schemas/Objects_85' subagent: $ref: '#/components/schemas/SubagentId' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - message.screened processed_at: type: string required: - verdict - content_digest - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_189: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - agent.thinking processed_at: type: string required: - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_190: type: object properties: question: $ref: '#/components/schemas/QuestionId' items: $ref: '#/components/schemas/ManagedQuestionItems' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - agent.question processed_at: type: string required: - question - items - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_191: type: object properties: subagent: $ref: '#/components/schemas/SubagentId' name: type: string allOf: - minLength: 1 description: type: string parent_subagent: $ref: '#/components/schemas/SubagentId' tool_use_id: type: string id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - agent.subagent_started processed_at: type: string required: - subagent - name - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_192: type: object properties: subagent: $ref: '#/components/schemas/SubagentId' disposition: $ref: '#/components/schemas/Union_316' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - agent.subagent_completed processed_at: type: string required: - subagent - disposition - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_193: type: object properties: type: type: string enum: - session.admitted acted_as: $ref: '#/components/schemas/PrincipalId' material: type: object properties: session_id: $ref: '#/components/schemas/SessionId' workspace: $ref: '#/components/schemas/Objects_194' configuration: $ref: '#/components/schemas/Objects_195' delivery_screen: anyOf: - type: object properties: model_routing_profile_key: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ tier: $ref: '#/components/schemas/Union_128' instructions: type: string allOf: - minLength: 1 - maxLength: 4096 failure: type: string enum: - fail_open - fail_closed required: - model_routing_profile_key - instructions additionalProperties: false - type: object properties: evaluation: $ref: '#/components/schemas/Objects_127' rule: $ref: '#/components/schemas/Union_229' failure: type: string enum: - fail_open - fail_closed required: - evaluation - rule additionalProperties: false model_routing: $ref: '#/components/schemas/SessionModelRoutingAccessCoverage' context_boundary: $ref: '#/components/schemas/Union_321' required: - session_id - workspace - configuration - context_boundary additionalProperties: false admitted_at: $ref: '#/components/schemas/CurrentTimestamp' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string processed_at: type: string required: - type - material - admitted_at - id - session_id - sequence - created_at - processed_at additionalProperties: false Objects_197: type: object properties: source_session: $ref: '#/components/schemas/SessionId' through_event: $ref: '#/components/schemas/EventId' through_sequence: type: integer exclusiveMinimum: 0 source_status: $ref: '#/components/schemas/Union_322' abandoned_run: anyOf: - $ref: '#/components/schemas/RunId' - type: 'null' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - session.forked processed_at: type: string required: - source_session - through_event - through_sequence - source_status - abandoned_run - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_198: type: object properties: content: type: array items: $ref: '#/components/schemas/Objects_40' authored_by: $ref: '#/components/schemas/Union_312' caused_by: $ref: '#/components/schemas/Union_274' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - system.message processed_at: anyOf: - type: string - type: 'null' required: - content - authored_by - caused_by - id - session_id - sequence - created_at - type additionalProperties: false Objects_199: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - session.archived processed_at: type: string required: - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_200: type: object properties: run: $ref: '#/components/schemas/RunId' resources: $ref: '#/components/schemas/Arrays_47' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - session.resources_resolved processed_at: type: string required: - run - resources - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_201: type: object properties: strategy: $ref: '#/components/schemas/Union_323' tokens_before: type: integer minimum: 0 tokens_after: type: integer minimum: 0 id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - session.compacted processed_at: type: string required: - strategy - tokens_before - tokens_after - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_202: type: object properties: through_sequence: type: integer exclusiveMinimum: 0 condensed: $ref: '#/components/schemas/Objects_203' kept: $ref: '#/components/schemas/Objects_204' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - session.context_condensed processed_at: type: string required: - through_sequence - condensed - kept - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_205: type: object properties: store: $ref: '#/components/schemas/MemoryStoreId' requested: $ref: '#/components/schemas/Union_235' effective: $ref: '#/components/schemas/Union_235' selection: anyOf: - type: object properties: kind: type: string enum: - ref ref: $ref: '#/components/schemas/Union_118' required: - kind - ref additionalProperties: false - type: object properties: kind: type: string enum: - version version: $ref: '#/components/schemas/Union_112' required: - kind - version additionalProperties: false instructions: type: string allOf: - minLength: 1 - maxLength: 4096 mount_path: $ref: '#/components/schemas/MountPath' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - memory.mount_resolved processed_at: type: string required: - store - requested - effective - mount_path - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_206: type: object properties: store: $ref: '#/components/schemas/MemoryStoreId' version: $ref: '#/components/schemas/Union_112' method: $ref: '#/components/schemas/Union_324' detail: $ref: '#/components/schemas/Objects_207' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - memory.accessed processed_at: type: string required: - store - version - method - detail - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_208: type: object properties: scope: type: string enum: - mounted_stores method: type: string enum: - mount store_count: type: integer exclusiveMinimum: 0 document_count: type: integer exclusiveMinimum: 0 id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - memory.accessed processed_at: type: string required: - scope - method - store_count - document_count - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_209: type: object properties: store: $ref: '#/components/schemas/MemoryStoreId' working_ref: $ref: '#/components/schemas/Union_118' base_version: $ref: '#/components/schemas/Union_112' new_version: $ref: '#/components/schemas/Union_112' tree_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ diff_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ changed_paths: $ref: '#/components/schemas/Arrays_48' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - memory.change_checkpointed processed_at: type: string required: - store - working_ref - base_version - new_version - tree_hash - diff_hash - changed_paths - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_210: type: object properties: proposal: $ref: '#/components/schemas/MemoryProposalId' store: $ref: '#/components/schemas/MemoryStoreId' base_version: $ref: '#/components/schemas/Union_112' head_version: $ref: '#/components/schemas/Union_112' diff_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - memory.proposal_created processed_at: type: string required: - proposal - store - base_version - head_version - diff_hash - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_211: type: object properties: proposal: $ref: '#/components/schemas/MemoryProposalId' decision: $ref: '#/components/schemas/Union_325' responder: $ref: '#/components/schemas/Union_326' canonical_version: anyOf: - $ref: '#/components/schemas/MemoryVersionId' - $ref: '#/components/schemas/MemorySnapshotId' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - memory.proposal_resolved processed_at: type: string required: - proposal - decision - responder - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_212: type: object properties: run: $ref: '#/components/schemas/CurationRunId' store: $ref: '#/components/schemas/MemoryStoreId' cursor_from: type: integer minimum: 0 cursor_to: type: integer minimum: 0 source_event_count: type: integer minimum: 0 source_artifact_count: type: integer minimum: 0 output_version: $ref: '#/components/schemas/Union_112' proposal: $ref: '#/components/schemas/MemoryProposalId' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - memory.curated processed_at: type: string required: - run - store - cursor_from - cursor_to - source_event_count - source_artifact_count - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_213: type: object properties: store: $ref: '#/components/schemas/MemoryStoreId' operation: type: string allOf: - minLength: 1 - maxLength: 255 version_count: type: integer minimum: 0 path_count: type: integer minimum: 0 hash_count: type: integer minimum: 0 id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - memory.redacted processed_at: type: string required: - store - operation - version_count - path_count - hash_count - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_214: type: object properties: binding: type: string model: type: string tier: type: string reason: type: string id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - model.routed processed_at: type: string required: - binding - model - tier - reason - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_215: type: object properties: run: $ref: '#/components/schemas/RunId' request_id: type: string allOf: - minLength: 1 - maxLength: 255 binding: type: string provider: type: string model: type: string input_tokens: type: integer minimum: 0 cached_input_tokens: type: integer minimum: 0 cache_write_input_tokens: type: integer minimum: 0 output_tokens: type: integer minimum: 0 reasoning_output_tokens: type: integer minimum: 0 total_tokens: type: integer minimum: 0 unit: type: string enum: - image - video_second - compute_second quantity_millionths: type: integer minimum: 0 id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - model.usage_recorded processed_at: type: string required: - run - request_id - binding - provider - model - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_216: type: object properties: run: $ref: '#/components/schemas/RunId' action: $ref: '#/components/schemas/Union_327' cost: $ref: '#/components/schemas/Objects_159' members: $ref: '#/components/schemas/RunRequiresActionSetMembersUniqueness' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - run.requires_action processed_at: type: string required: - run - action - cost - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_219: type: object properties: run: $ref: '#/components/schemas/RunId' approval: $ref: '#/components/schemas/ActionApprovalId' action: $ref: '#/components/schemas/Objects_217' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - run.action_authorized processed_at: type: string required: - run - approval - action - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_220: type: object properties: run: $ref: '#/components/schemas/RunId' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - run.resumed processed_at: type: string required: - run - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_221: type: object properties: run: $ref: '#/components/schemas/RunId' stop_reason: $ref: '#/components/schemas/Union_278' cost: $ref: '#/components/schemas/Objects_159' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - run.completed processed_at: type: string required: - run - stop_reason - cost - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_222: type: object properties: run: $ref: '#/components/schemas/RunId' stop_reason: $ref: '#/components/schemas/Union_278' cost: type: 'null' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - run.completed processed_at: type: string required: - run - stop_reason - cost - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_223: type: object properties: run: $ref: '#/components/schemas/RunId' error: $ref: '#/components/schemas/Objects_145' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - run.failed processed_at: type: string required: - run - error - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_224: type: object properties: run: $ref: '#/components/schemas/RunId' error: $ref: '#/components/schemas/Objects_145' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - run.failed processed_at: type: string required: - run - error - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_225: type: object properties: run: $ref: '#/components/schemas/RunId' reason: type: string id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - run.canceled processed_at: type: string required: - run - reason - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_226: type: object properties: budget_id: $ref: '#/components/schemas/BudgetId' budget_version: $ref: '#/components/schemas/BudgetPositiveSafeInteger' limit: $ref: '#/components/schemas/BudgetPositiveSafeInteger' metric: $ref: '#/components/schemas/Union_192' breach_action: $ref: '#/components/schemas/BudgetBreachAction' window_started_at: $ref: '#/components/schemas/CurrentTimestamp' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - session.budget_reached processed_at: type: string required: - budget_id - budget_version - limit - metric - breach_action - window_started_at - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_227: type: object properties: run: $ref: '#/components/schemas/RunId' event: $ref: '#/components/schemas/EventId' disposition: $ref: '#/components/schemas/Union_328' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - run.input_delivered processed_at: type: string required: - run - event - disposition - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_228: type: object properties: run: $ref: '#/components/schemas/RunId' phase: $ref: '#/components/schemas/Union_79' ordinal: type: integer allOf: - minimum: 0 - exclusiveMaximum: 16 outcome: $ref: '#/components/schemas/Union_329' on_failure: $ref: '#/components/schemas/Union_80' exit_code: $ref: '#/components/schemas/Union_330' duration_ms: type: integer allOf: - minimum: 0 - maximum: 3600000 output: $ref: '#/components/schemas/SandboxLifecycleHookOutput' output_truncated: type: boolean id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - run.lifecycle_hook processed_at: type: string required: - run - phase - ordinal - outcome - on_failure - exit_code - duration_ms - output - output_truncated - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_229: type: object properties: review: $ref: '#/components/schemas/FlowReviewId' automation: $ref: '#/components/schemas/AutomationId' firing: $ref: '#/components/schemas/AutomationFiringId' originating_event: $ref: '#/components/schemas/EventId' spec: $ref: '#/components/schemas/Objects_126' model_release: $ref: '#/components/schemas/Objects_230' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - flow_review.requested processed_at: type: string required: - review - automation - firing - originating_event - spec - model_release - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_231: type: object properties: review: $ref: '#/components/schemas/FlowReviewId' automation: $ref: '#/components/schemas/AutomationId' firing: $ref: '#/components/schemas/AutomationFiringId' session: $ref: '#/components/schemas/SessionId' originating_event: $ref: '#/components/schemas/EventId' source_run: $ref: '#/components/schemas/RunId' from_sequence: type: integer exclusiveMinimum: 0 through_sequence: type: integer exclusiveMinimum: 0 terminal_source_event: $ref: '#/components/schemas/EventId' evidence_format: type: string enum: - flow-review-evidence-v1 evidence_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - flow_review.started processed_at: type: string required: - review - automation - firing - session - originating_event - source_run - from_sequence - through_sequence - terminal_source_event - evidence_format - evidence_digest - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_232: type: object properties: review: $ref: '#/components/schemas/FlowReviewId' result: type: string enum: - passed - concerns criteria: $ref: '#/components/schemas/Arrays_49' evidence_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ through_event_id: $ref: '#/components/schemas/EventId' route: $ref: '#/components/schemas/Objects_84' usage: $ref: '#/components/schemas/Objects_85' evaluated_at: type: string id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - flow_review.completed processed_at: type: string required: - review - result - criteria - evidence_digest - through_event_id - route - usage - evaluated_at - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_233: type: object properties: review: $ref: '#/components/schemas/FlowReviewId' reason: $ref: '#/components/schemas/Union_269' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - flow_review.unavailable processed_at: type: string required: - review - reason - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_234: type: object properties: watch: $ref: '#/components/schemas/WatchId' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - watch.created processed_at: type: string required: - watch - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_235: type: object properties: watch: $ref: '#/components/schemas/WatchId' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - watch.updated processed_at: type: string required: - watch - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_236: type: object properties: watch: $ref: '#/components/schemas/WatchId' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - watch.removed processed_at: type: string required: - watch - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_237: type: object properties: watch: $ref: '#/components/schemas/WatchId' source_state_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - watch.woken processed_at: type: string required: - watch - source_state_hash - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_238: type: object properties: watch: $ref: '#/components/schemas/WatchId' reason: $ref: '#/components/schemas/Union_331' source_state_hash: type: string pattern: ^sha256:[0-9a-f]{64}$ id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - watch.suppressed processed_at: type: string required: - watch - reason - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_239: type: object properties: run: $ref: '#/components/schemas/RunId' mount: $ref: '#/components/schemas/MountId' file_tree: $ref: '#/components/schemas/FileTreeId' capture: $ref: '#/components/schemas/FileTreeCaptureId' result: $ref: '#/components/schemas/Objects_240' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - file_tree.writeback_captured processed_at: type: string required: - run - mount - file_tree - capture - result - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_241: type: object properties: run: $ref: '#/components/schemas/RunId' mount: $ref: '#/components/schemas/MountId' file_tree: $ref: '#/components/schemas/FileTreeId' capture: $ref: '#/components/schemas/FileTreeCaptureId' branch: $ref: '#/components/schemas/GitBranchName' connection: $ref: '#/components/schemas/ConnectionId' generation: type: integer exclusiveMinimum: 0 id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - file_tree.writeback_started processed_at: type: string required: - run - mount - file_tree - capture - branch - connection - generation - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_242: type: object properties: run: $ref: '#/components/schemas/RunId' mount: $ref: '#/components/schemas/MountId' file_tree: $ref: '#/components/schemas/FileTreeId' capture: $ref: '#/components/schemas/FileTreeCaptureId' proved_at: type: string id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - file_tree.writeback_no_changes processed_at: type: string required: - run - mount - file_tree - capture - proved_at - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_243: type: object properties: run: $ref: '#/components/schemas/RunId' mount: $ref: '#/components/schemas/MountId' file_tree: $ref: '#/components/schemas/FileTreeId' capture: $ref: '#/components/schemas/FileTreeCaptureId' result: $ref: '#/components/schemas/Objects_240' acted_as: $ref: '#/components/schemas/PrincipalId' connection: $ref: '#/components/schemas/ConnectionId' branch: $ref: '#/components/schemas/GitBranchName' commit: type: string pattern: ^(?:[0-9a-f]{40}|[0-9a-f]{64})$ pull_request_number: type: integer exclusiveMinimum: 0 pull_request_url: type: string allOf: - pattern: ^https:\/\/\S+$ - maxLength: 2048 version: type: integer exclusiveMinimum: 0 base_version: type: integer exclusiveMinimum: 0 watch: $ref: '#/components/schemas/WatchId' signature: anyOf: - type: object properties: state: type: string enum: - signed key_id: type: string allOf: - minLength: 8 - maxLength: 64 - pattern: ^[0-9A-F]+$ required: - state - key_id additionalProperties: false - type: object properties: state: type: string enum: - skipped reason: type: string enum: - signing_unconfigured - signing_unavailable - provider_unsupported required: - state - reason additionalProperties: false id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - file_tree.writeback_succeeded processed_at: type: string required: - run - mount - file_tree - capture - result - acted_as - connection - branch - commit - pull_request_number - pull_request_url - version - base_version - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_244: type: object properties: run: $ref: '#/components/schemas/RunId' mount: $ref: '#/components/schemas/MountId' file_tree: $ref: '#/components/schemas/FileTreeId' capture: $ref: '#/components/schemas/FileTreeCaptureId' result: $ref: '#/components/schemas/Objects_240' acted_as: $ref: '#/components/schemas/PrincipalId' connection: $ref: '#/components/schemas/ConnectionId' branch: $ref: '#/components/schemas/GitBranchName' reason: $ref: '#/components/schemas/Union_333' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - file_tree.writeback_conflicted processed_at: type: string required: - run - mount - file_tree - capture - result - acted_as - connection - branch - reason - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_245: type: object properties: run: $ref: '#/components/schemas/RunId' mount: $ref: '#/components/schemas/MountId' file_tree: $ref: '#/components/schemas/FileTreeId' capture: $ref: '#/components/schemas/FileTreeCaptureId' reason: $ref: '#/components/schemas/Union_334' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - file_tree.writeback_failed processed_at: type: string required: - run - mount - file_tree - capture - reason - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_246: type: object properties: run: $ref: '#/components/schemas/RunId' mount: $ref: '#/components/schemas/MountId' file_tree: $ref: '#/components/schemas/FileTreeId' capture: $ref: '#/components/schemas/FileTreeCaptureId' result: $ref: '#/components/schemas/Objects_240' acted_as: $ref: '#/components/schemas/PrincipalId' connection: $ref: '#/components/schemas/ConnectionId' branch: $ref: '#/components/schemas/GitBranchName' reason: $ref: '#/components/schemas/Union_335' id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - file_tree.writeback_failed processed_at: type: string required: - run - mount - file_tree - capture - result - acted_as - connection - branch - reason - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_247: type: object properties: session_thread_id: $ref: '#/components/schemas/SessionThreadId' run: $ref: '#/components/schemas/RunId' execution_generation: type: string allOf: - minLength: 1 base_file_tree_id: anyOf: - $ref: '#/components/schemas/FileTreeId' - type: 'null' capture_sequence: type: integer exclusiveMinimum: 0 manifest_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ file_count: type: integer minimum: 0 total_bytes: type: integer minimum: 0 id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - session.capture_acknowledged processed_at: type: string required: - session_thread_id - run - execution_generation - base_file_tree_id - capture_sequence - manifest_digest - file_count - total_bytes - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_248: type: object properties: delivery: $ref: '#/components/schemas/WebhookDeliveryId' endpoint: $ref: '#/components/schemas/WebhookEndpointId' provider_coordinate: $ref: '#/components/schemas/EventId' delivery_grade: type: string enum: - at_most_once_on_ambiguity reason: type: string enum: - acknowledgement_lost id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string type: type: string enum: - session.delivery_ambiguous processed_at: type: string required: - delivery - endpoint - provider_coordinate - delivery_grade - reason - id - session_id - sequence - created_at - type - processed_at additionalProperties: false Objects_249: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string processed_at: type: string type: type: string enum: - session.status_idle status: type: string enum: - idle required: - id - session_id - sequence - created_at - processed_at - type - status additionalProperties: false Objects_250: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string processed_at: type: string type: type: string enum: - session.status_running status: type: string enum: - running required: - id - session_id - sequence - created_at - processed_at - type - status additionalProperties: false Objects_251: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string processed_at: type: string type: type: string enum: - session.status_terminated status: type: string enum: - terminated required: - id - session_id - sequence - created_at - processed_at - type - status additionalProperties: false Objects_252: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string processed_at: type: string type: type: string enum: - agent.tool_progress tool_use_id: $ref: '#/components/schemas/EventId' output: $ref: '#/components/schemas/NativeToolProgressOutput' required: - id - session_id - sequence - created_at - processed_at - type - tool_use_id - output additionalProperties: false Objects_253: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string processed_at: type: string type: type: string enum: - agent.custom_tool_use name: type: string input: $ref: '#/components/schemas/JsonValue' required: - id - session_id - sequence - created_at - processed_at - type - name - input additionalProperties: false Objects_254: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string processed_at: type: string type: type: string enum: - agent.mcp_tool_use name: type: string mcp_server_name: type: string input: $ref: '#/components/schemas/JsonValue' required: - id - session_id - sequence - created_at - processed_at - type - name - mcp_server_name - input additionalProperties: false Objects_255: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string processed_at: type: string type: type: string enum: - agent.tool_use name: type: string input: $ref: '#/components/schemas/JsonValue' required: - id - session_id - sequence - created_at - processed_at - type - name - input additionalProperties: false Objects_256: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string processed_at: type: string type: type: string enum: - agent.mcp_tool_result mcp_tool_use_id: $ref: '#/components/schemas/EventId' content: type: array items: $ref: '#/components/schemas/Union_313' is_error: type: boolean required: - id - session_id - sequence - created_at - processed_at - type - mcp_tool_use_id - content - is_error additionalProperties: false Objects_257: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string processed_at: type: string type: type: string enum: - agent.tool_result tool_use_id: $ref: '#/components/schemas/EventId' content: type: array items: $ref: '#/components/schemas/Union_313' is_error: type: boolean required: - id - session_id - sequence - created_at - processed_at - type - tool_use_id - content - is_error additionalProperties: false Objects_258: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string processed_at: type: string type: type: string enum: - action_approval.pending approval: $ref: '#/components/schemas/ActionApprovalId' required: - id - session_id - sequence - created_at - processed_at - type - approval additionalProperties: false Objects_259: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string processed_at: type: string type: type: string enum: - action_approval.resolved approval: $ref: '#/components/schemas/ActionApprovalId' decision: type: string enum: - approve - deny required: - id - session_id - sequence - created_at - processed_at - type - approval - decision additionalProperties: false Objects_260: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string processed_at: type: string type: type: string enum: - session.updated agent: $ref: '#/components/schemas/ManagedAgentsSessionAgent' title: anyOf: - type: string - type: 'null' metadata: anyOf: - $ref: '#/components/schemas/ResourceMetadata' - type: 'null' vault_ids: type: array items: $ref: '#/components/schemas/VaultId' changed_fields: type: array items: type: string required: - id - session_id - sequence - created_at - processed_at - type additionalProperties: false Objects_261: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string processed_at: type: string type: type: string enum: - run.created run: $ref: '#/components/schemas/RunId' trigger: type: object properties: kind: type: string enum: - api - automation - question - watch - action_approval required: - kind additionalProperties: false input_id: $ref: '#/components/schemas/EventId' continued_from_run_id: $ref: '#/components/schemas/RunId' connected_runtime: $ref: '#/components/schemas/Objects_262' required: - id - session_id - sequence - created_at - processed_at - type - run - trigger additionalProperties: false Objects_263: type: object properties: id: $ref: '#/components/schemas/EventId' session_id: $ref: '#/components/schemas/SessionId' sequence: type: integer exclusiveMinimum: 0 created_at: type: string processed_at: type: string type: type: string enum: - run.started run: $ref: '#/components/schemas/RunId' required: - id - session_id - sequence - created_at - processed_at - type - run additionalProperties: false ValidationMalformedError: type: object properties: error: type: object properties: type: type: string enum: - validation.malformed message: type: string more: type: string enum: - https://docs.checkfu.com/reference/errors#validation-malformed description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- The request could not be decoded or violated a declared input constraint. ValidationPromptIntegrityReviewRequiredError: type: object properties: error: type: object properties: type: type: string enum: - validation.prompt_integrity_review_required message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#validation-prompt-integrity-review-required description: Stable public documentation and remedy for this error type. review: type: object properties: analyzer_version: type: string enum: - unicode-17.0.0-uts39-r32-checkfu-1 normalized: type: string findings: type: array items: $ref: '#/components/schemas/Union_309' allOf: - minItems: 1 - maxItems: 256 required: - analyzer_version - normalized - findings additionalProperties: false required: - type - message - more - review additionalProperties: false required: - error additionalProperties: false description: The request contains deceptive Unicode and requires an explicit review. ValidationIdempotencyConflictError: type: object properties: error: type: object properties: type: type: string enum: - validation.idempotency_conflict message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#validation-idempotency-conflict description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: The Idempotency-Key is already bound to a different request. ValidationIdempotencyInProgressError: type: object properties: error: type: object properties: type: type: string enum: - validation.idempotency_in_progress message: type: string more: type: string enum: - >- https://docs.checkfu.com/reference/errors#validation-idempotency-in-progress description: Stable public documentation and remedy for this error type. required: - type - message - more additionalProperties: false required: - error additionalProperties: false description: >- An identical idempotent request is still in progress and may be retried later. MessageContentBlocks: type: array items: $ref: '#/components/schemas/Union_67' allOf: - minItems: 1 - maxItems: 32 ConnectedRuntimeId: type: string pattern: ^crt_[0-9a-f]{32}$ HostContextData: type: object additionalProperties: type: string allOf: - maxLength: 4096 allOf: - propertyNames: type: string allOf: - minLength: 1 - maxLength: 128 EventId: type: string pattern: ^evt_[0-9a-f]{32}$ Union_313: anyOf: - $ref: '#/components/schemas/Union_67' - type: object properties: type: type: string enum: - search_result source: type: string title: type: string content: type: array items: type: object properties: type: type: string enum: - text text: type: string required: - type - text additionalProperties: false citations: type: object properties: enabled: type: boolean required: - enabled additionalProperties: false required: - type - source - title - content - citations additionalProperties: false QuestionId: type: string pattern: ^qst_[0-9a-f]{32}$ ManagedQuestionAnswers: type: array items: type: object properties: id: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_-]+$ values: type: array items: type: string allOf: - minLength: 1 - maxLength: 4096 allOf: - minItems: 1 - maxItems: 32 required: - id - values additionalProperties: false allOf: - minItems: 1 - maxItems: 4 Union_67: anyOf: - $ref: '#/components/schemas/Objects_40' - type: object properties: type: type: string enum: - image source: anyOf: - type: object properties: type: type: string enum: - base64 media_type: type: string enum: - image/png - image/jpeg - image/gif - image/webp data: $ref: '#/components/schemas/MessageContentBase64Data' required: - type - media_type - data additionalProperties: false - type: object properties: type: type: string enum: - url url: type: string allOf: - minLength: 1 - maxLength: 2048 required: - type - url additionalProperties: false - type: object properties: type: type: string enum: - file file_id: $ref: '#/components/schemas/FileId' required: - type - file_id additionalProperties: false required: - type - source additionalProperties: false - type: object properties: type: type: string enum: - document source: anyOf: - type: object properties: type: type: string enum: - base64 media_type: type: string enum: - application/pdf data: $ref: '#/components/schemas/MessageContentBase64Data' required: - type - media_type - data additionalProperties: false - type: object properties: type: type: string enum: - text media_type: type: string enum: - text/plain data: $ref: '#/components/schemas/MessageContentPlainTextData' required: - type - media_type - data additionalProperties: false - type: object properties: type: type: string enum: - url url: type: string allOf: - minLength: 1 - maxLength: 2048 required: - type - url additionalProperties: false - type: object properties: type: type: string enum: - file file_id: $ref: '#/components/schemas/FileId' required: - type - file_id additionalProperties: false title: type: string allOf: - minLength: 1 - maxLength: 1024 context: type: string allOf: - minLength: 1 - maxLength: 4096 required: - type - source additionalProperties: false Union_308: type: string enum: - accepted_normalization - preserved_original Union_309: anyOf: - type: object properties: kind: type: string enum: - mixed_script_confusable utf16_offset: type: integer minimum: 0 code_point: type: string pattern: ^U\+[0-9A-F]{4,6}$ replacement: type: string allOf: - maxLength: 5 answer_id: type: string value_index: type: integer minimum: 0 required: - kind - utf16_offset - code_point - replacement additionalProperties: false - type: object properties: kind: type: string enum: - bidirectional_control utf16_offset: type: integer minimum: 0 code_point: type: string pattern: ^U\+[0-9A-F]{4,6}$ answer_id: type: string value_index: type: integer minimum: 0 required: - kind - utf16_offset - code_point additionalProperties: false Union_312: anyOf: - $ref: '#/components/schemas/PrincipalId' - $ref: '#/components/schemas/ApiKeyId' - $ref: '#/components/schemas/AutomationId' - $ref: '#/components/schemas/AgentPlacementId' Union_274: anyOf: - anyOf: - type: object properties: kind: type: string enum: - api request_id: type: string allOf: - minLength: 1 - maxLength: 512 required: - kind additionalProperties: false - type: object properties: kind: type: string enum: - external_event external_installation_id: $ref: '#/components/schemas/CollaborationInstallationId' external_event_id: type: string allOf: - minLength: 1 - maxLength: 512 required: - kind - external_installation_id - external_event_id additionalProperties: false - type: object properties: kind: type: string enum: - automation automation: $ref: '#/components/schemas/AutomationId' required: - kind - automation additionalProperties: false - type: object properties: kind: type: string enum: - watch watch: $ref: '#/components/schemas/WatchId' source_state_hash: type: string allOf: - minLength: 1 - maxLength: 512 required: - kind - watch - source_state_hash additionalProperties: false - type: object properties: kind: type: string enum: - action_approval approval: $ref: '#/components/schemas/NonBrowserActionApprovalId' required: - kind - approval additionalProperties: false Objects_188: type: object properties: model_routing_profile_key: type: string model: type: string tier: type: string reason: type: string access_source: $ref: '#/components/schemas/Union_156' required: - model_routing_profile_key - model - tier - reason - access_source additionalProperties: false Objects_85: type: object properties: input_tokens: type: integer minimum: 0 cached_input_tokens: type: integer minimum: 0 cache_write_input_tokens: type: integer minimum: 0 output_tokens: type: integer minimum: 0 reasoning_output_tokens: type: integer minimum: 0 total_tokens: type: integer minimum: 0 required: - input_tokens - cached_input_tokens - cache_write_input_tokens - output_tokens - reasoning_output_tokens - total_tokens additionalProperties: false SubagentId: type: string pattern: ^subg_[0-9a-f]{32}$ ManagedQuestionItems: type: array items: type: object properties: id: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[A-Za-z0-9_-]+$ prompt: type: string allOf: - minLength: 1 - maxLength: 4096 header: type: string allOf: - minLength: 1 - maxLength: 4096 options: type: array items: type: object properties: label: type: string allOf: - minLength: 1 - maxLength: 4096 description: type: string allOf: - minLength: 1 - maxLength: 4096 required: - label additionalProperties: false allOf: - maxItems: 32 allow_multiple: type: boolean required: - id - prompt - options - allow_multiple additionalProperties: false allOf: - minItems: 1 - maxItems: 4 Union_316: type: string enum: - completed - failed - canceled - lost PrincipalId: type: string pattern: ^prin_[0-9a-f]{32}$ Objects_194: type: object properties: workspace_id: $ref: '#/components/schemas/WorkspaceId' retention_policy: $ref: '#/components/schemas/Union_317' model_provider_policy: type: object properties: denied_providers: type: array items: type: string allOf: - minLength: 1 - maxLength: 255 allOf: - maxItems: 256 - uniqueItems: true required: - denied_providers additionalProperties: false quota_policy: type: object properties: max_concurrent_runs: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 monthly_tokens: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740991 monthly_sandbox_seconds: type: integer allOf: - exclusiveMinimum: 0 - maximum: 9007199254740 additionalProperties: false required: - workspace_id - retention_policy - model_provider_policy - quota_policy additionalProperties: false Objects_195: type: object properties: agent: $ref: '#/components/schemas/ManagedAgentsSessionAgent' environment: $ref: '#/components/schemas/Environment' required: - agent - environment additionalProperties: false Union_128: type: string enum: - default - planning - tool_loop Objects_127: type: object properties: schema_version: type: number enum: - 1 model_routing_profile_key: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ tier: $ref: '#/components/schemas/Union_128' timeout_ms: type: number allOf: - minimum: 100 - maximum: 30000 questions: $ref: '#/components/schemas/TypedCheckQuestions_1' required: - schema_version - model_routing_profile_key - questions additionalProperties: false Union_229: anyOf: - $ref: '#/components/schemas/CheckBooleanRuleThresholds' - $ref: '#/components/schemas/Objects_128' - $ref: '#/components/schemas/CheckScoreTailRuleThresholds' - type: object properties: type: type: string enum: - all rules: type: array items: anyOf: - $ref: '#/components/schemas/CheckBooleanRuleThresholds' - $ref: '#/components/schemas/Objects_128' - $ref: '#/components/schemas/CheckScoreTailRuleThresholds' allOf: - minItems: 1 - maxItems: 8 required: - type - rules additionalProperties: false SessionModelRoutingAccessCoverage: type: object properties: original_published_profile: type: object properties: id: $ref: '#/components/schemas/ModelRoutingProfileId' version_id: $ref: '#/components/schemas/ModelRoutingProfileVersionId' version: type: integer exclusiveMinimum: 0 content_sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - id - version_id - version - content_sha256 additionalProperties: false routing_policy: $ref: '#/components/schemas/Union_127' eligible_candidates: type: array prefixItems: - $ref: '#/components/schemas/Objects_196' minItems: 1 items: $ref: '#/components/schemas/Objects_196' access_intents: type: array prefixItems: - $ref: '#/components/schemas/Union_320' minItems: 1 items: $ref: '#/components/schemas/Union_320' required: - routing_policy - eligible_candidates - access_intents additionalProperties: false Union_321: type: string enum: - private - shared CurrentTimestamp: type: string allOf: - maxLength: 24 - pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ x-checkfu-current-timestamp: true description: A canonical UTC ISO-8601 timestamp with millisecond precision. Union_322: type: string enum: - pending - provisioning - running - reconciling - waiting - idle - paused - completed - failed - canceled RunId: type: string pattern: ^run_[0-9a-f]{32}$ Objects_40: type: object properties: type: type: string enum: - text text: $ref: '#/components/schemas/MessageContentPlainTextData' required: - type - text additionalProperties: false Arrays_47: type: array items: anyOf: - anyOf: - type: object properties: id: $ref: '#/components/schemas/MountId' kind: type: string enum: - file_tree file_tree_id: $ref: '#/components/schemas/FileTreeId' mount_path: $ref: '#/components/schemas/MountPath' version_policy: $ref: '#/components/schemas/Union_232' version: type: integer exclusiveMinimum: 0 content_sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ access: $ref: '#/components/schemas/Union_233' writeback: type: 'null' resolution: $ref: '#/components/schemas/Union_185' required: - id - kind - file_tree_id - mount_path - version_policy - version - content_sha256 - access - resolution additionalProperties: false - type: object properties: id: $ref: '#/components/schemas/MountId' kind: type: string enum: - file_tree file_tree_id: $ref: '#/components/schemas/FileTreeId' mount_path: $ref: '#/components/schemas/MountPath' version_policy: $ref: '#/components/schemas/Union_232' version: type: integer exclusiveMinimum: 0 content_sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ access: type: string enum: - read_write writeback: $ref: '#/components/schemas/Objects_129' resolution: $ref: '#/components/schemas/Objects_105' required: - id - kind - file_tree_id - mount_path - version_policy - version - content_sha256 - access - writeback - resolution additionalProperties: false - type: object properties: id: $ref: '#/components/schemas/MountId' kind: type: string enum: - file file_id: $ref: '#/components/schemas/FileId' mount_path: $ref: '#/components/schemas/MountPath' access: type: string enum: - read_only sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ bytes: type: integer minimum: 0 required: - id - kind - file_id - mount_path - access - sha256 - bytes additionalProperties: false - $ref: '#/components/schemas/MemoryStoreResourceBinding' - $ref: '#/components/schemas/ResolvedSkillsResourceBindingIntegrity' Union_323: type: string enum: - native - platform_summarize - truncate Objects_203: type: object properties: user_messages: type: integer minimum: 0 agent_messages: type: integer minimum: 0 required: - user_messages - agent_messages additionalProperties: false Objects_204: type: object properties: user_messages: type: integer minimum: 0 agent_messages: type: integer minimum: 0 content_length: type: integer minimum: 0 required: - user_messages - agent_messages - content_length additionalProperties: false MemoryStoreId: type: string pattern: ^memstore_[0-9a-f]{32}$ Union_235: type: string enum: - read_only - read_write Union_118: anyOf: - type: object properties: kind: type: string enum: - canonical required: - kind additionalProperties: false - type: object properties: kind: type: string enum: - session session: $ref: '#/components/schemas/SessionId' required: - kind - session additionalProperties: false - type: object properties: kind: type: string enum: - proposal proposal: $ref: '#/components/schemas/MemoryProposalId' required: - kind - proposal additionalProperties: false - type: object properties: kind: type: string enum: - curation run: $ref: '#/components/schemas/CurationRunId' required: - kind - run additionalProperties: false Union_112: anyOf: - $ref: '#/components/schemas/MemoryVersionId' - $ref: '#/components/schemas/MemorySnapshotId' MountPath: type: string allOf: - minLength: 2 - maxLength: 1024 Union_324: type: string enum: - mount - search - tool Objects_207: type: object properties: kind: type: string enum: - full documents: type: array items: type: object properties: path: $ref: '#/components/schemas/MemoryPath' content_sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - path - content_sha256 additionalProperties: false allOf: - minItems: 1 required: - kind - documents additionalProperties: false Arrays_48: type: array items: $ref: '#/components/schemas/MemoryPath' allOf: - minItems: 1 MemoryProposalId: type: string pattern: ^mprop_[0-9a-f]{32}$ Union_325: type: string enum: - approved - rejected - superseded Union_326: anyOf: - $ref: '#/components/schemas/Union_114' - type: 'null' MemoryVersionId: type: string pattern: ^memver_[0-9a-f]{32}$ MemorySnapshotId: type: string pattern: ^memsnap_[0-9a-f]{32}$ CurationRunId: type: string pattern: ^mcur_[0-9a-f]{32}$ Union_327: anyOf: - $ref: '#/components/schemas/Objects_217' - $ref: '#/components/schemas/Objects_218' - type: object properties: kind: type: string enum: - question question: $ref: '#/components/schemas/QuestionId' items: $ref: '#/components/schemas/ManagedQuestionItems' required: - kind - question - items additionalProperties: false Objects_159: type: object properties: tokens: type: integer minimum: 0 tool_calls: type: integer minimum: 0 active_ms: type: integer minimum: 0 additionalProperties: false RunRequiresActionSetMembersUniqueness: type: array items: type: object properties: approval: $ref: '#/components/schemas/NonBrowserActionApprovalId' tool_use_id: type: string allOf: - minLength: 1 required: - approval - tool_use_id additionalProperties: false allOf: - minItems: 1 - maxItems: 16 - x-checkfu-approval-set-members: true description: one park names each approval and tool use at most once ActionApprovalId: anyOf: - $ref: '#/components/schemas/NonBrowserActionApprovalId' - $ref: '#/components/schemas/BrowserActionApprovalId' description: >- an ActionApprovalId of the form approval_<32 hex chars> or bapproval_<32 hex chars> Objects_217: type: object properties: kind: type: string enum: - custom_tool tool_use_id: type: string required: - kind - tool_use_id additionalProperties: false Union_278: type: string enum: - end_turn - requires_action - interrupted - retries_exhausted - max_tokens - max_turn_requests - refusal - error - budget_reached Objects_145: type: object properties: type: $ref: '#/components/schemas/Union_208' message: type: string more: type: string pattern: ^https:\/\/docs\.checkfu\.com\/reference\/errors#[a-z0-9-]+$ required: - type - message additionalProperties: false BudgetId: type: string pattern: ^bgt_[0-9a-f]{32}$ BudgetPositiveSafeInteger: type: integer exclusiveMinimum: 0 Union_192: type: string enum: - model_tokens - model_spend - session_runtime_ms - web_search_requests - total_spend BudgetBreachAction: type: string enum: - block_admission - interrupt_turn - pause_session description: The decided hard-threshold action for one reached Budget cap. Union_328: type: string enum: - delivered - queued - refused Union_79: type: string enum: - post_materialize - pre_writeback Union_329: type: string enum: - passed - failed - timed_out - slot_unavailable - skipped Union_80: type: string enum: - abort - continue Union_330: anyOf: - type: integer allOf: - minimum: 0 maximum: 255 - type: 'null' SandboxLifecycleHookOutput: type: string allOf: - maxLength: 8192 FlowReviewId: type: string pattern: ^flrev_[0-9a-f]{32}$ AutomationId: type: string pattern: ^auto_[0-9a-f]{32}$ AutomationFiringId: type: string pattern: ^afire_[0-9a-f]{32}$ Objects_126: type: object properties: model_routing_profile_key: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ tier: $ref: '#/components/schemas/Union_128' criteria: $ref: '#/components/schemas/UniqueFlowReviewCriteria' required: - model_routing_profile_key - criteria additionalProperties: false Objects_230: type: object properties: model_routing_profile_id: $ref: '#/components/schemas/ModelRoutingProfileId' key: type: string version: type: integer exclusiveMinimum: 0 access: type: string enum: - harness_owned routing_policy: $ref: '#/components/schemas/Union_127' eligible_candidates: type: array prefixItems: - $ref: '#/components/schemas/Objects_152' minItems: 1 items: $ref: '#/components/schemas/Objects_152' access_sources: type: array items: $ref: '#/components/schemas/Objects_47' required: - model_routing_profile_id - key - version - routing_policy - eligible_candidates additionalProperties: false Arrays_49: type: array items: $ref: '#/components/schemas/Objects_158' allOf: - minItems: 1 - maxItems: 16 Objects_84: type: object properties: model_routing_profile_key: type: string model: type: string tier: type: string reason: type: string access_source: $ref: '#/components/schemas/Union_156' required: - model_routing_profile_key - model - tier - reason - access_source additionalProperties: false Union_269: type: string enum: - evidence_unavailable - evidence_unsupported - evidence_too_large - source_erased - reviewer_unavailable WatchId: type: string pattern: ^wch_[0-9a-f]{32}$ Union_331: type: string enum: - duplicate - self_authored - stale_hint - unsafe_content MountId: type: string pattern: ^mnt_[0-9a-f]{32}$ FileTreeId: type: string pattern: ^ftree_[0-9a-f]{32}$ FileTreeCaptureId: type: string pattern: ^ftcap_[0-9a-f]{32}$ Objects_240: type: object properties: kind: type: string enum: - changes capture_id: $ref: '#/components/schemas/FileTreeCaptureId' manifest_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ operation_count: type: integer allOf: - exclusiveMinimum: 0 - maximum: 2048 put_count: type: integer allOf: - minimum: 0 - maximum: 1024 reserved_bytes: type: integer allOf: - minimum: 0 - maximum: 20971520 sealed_at: $ref: '#/components/schemas/FileTreeCaptureTimestamp' required: - kind - capture_id - manifest_digest - operation_count - put_count - reserved_bytes - sealed_at additionalProperties: false GitBranchName: type: string allOf: - minLength: 1 - maxLength: 255 ConnectionId: type: string pattern: ^conn_[0-9a-f]{32}$ Union_333: type: string enum: - destination_diverged - destination_unowned - pull_request_ambiguous - stale_base Union_334: type: string enum: - ineligible_mount - nested_mount - listing_failed - listing_invalid - incomplete_listing - invalid_path - unsupported_entry - duplicate_path - path_conflict - file_limit - file_too_large - tree_too_large - operation_limit - read_failed - missing_body - body_size_mismatch - body_digest_mismatch - digest_unavailable - manifest_invalid - capture_unavailable - capture_invalid - authority_lost - retention_refused - transfer_unavailable Union_335: type: string enum: - authority_lost - capture_invalid - protected_path - provider_budget - provider_rejected - provider_weather_exhausted - session_ineligible SessionThreadId: type: string pattern: ^sthr_[0-9a-f]{32}$ WebhookDeliveryId: type: string pattern: ^wdel_[0-9a-f]{32}$ WebhookEndpointId: type: string pattern: ^whe_[0-9a-f]{32}$ NativeToolProgressOutput: x-checkfu-json-budget: maximumBytes: 262144 maximumDepth: 64 maximumNodes: 100000 maximumInspectionWork: 100000 x-checkfu-unicode-scalar-values: true description: native tool output bounded to 256 KiB of JSON JsonValue: description: >- A value in the JSON data model: null, boolean, finite number, string, array, or object. ManagedAgentsSessionAgent: type: object properties: id: $ref: '#/components/schemas/AgentId' connection_bindings: $ref: '#/components/schemas/Arrays_7' description: $ref: '#/components/schemas/Union_31' harness: $ref: '#/components/schemas/ManagedAgentsHarnessReference' mcp_servers: $ref: '#/components/schemas/Arrays_8' model: $ref: '#/components/schemas/ManagedAgentsModelConfig' name: type: string allOf: - minLength: 1 - maxLength: 255 skills: $ref: '#/components/schemas/Arrays_9' system: $ref: '#/components/schemas/Union_33' tools: $ref: '#/components/schemas/Arrays_10' skill_selection: $ref: '#/components/schemas/ManagedAgentsAgentSkillSelection' type: type: string enum: - agent version: type: integer exclusiveMinimum: 0 required: - id - connection_bindings - description - harness - mcp_servers - model - name - skills - system - tools - type - version additionalProperties: false ResourceMetadata: type: object additionalProperties: type: string allOf: - maxLength: 512 allOf: - propertyNames: type: string allOf: - minLength: 1 - maxLength: 64 - maxProperties: 16 description: at most 16 correlation pairs with keys of 1 to 64 characters VaultId: type: string pattern: ^vlt_[0-9a-f]{32}$ Objects_262: type: object properties: kind: type: string enum: - connected protocol: type: string enum: - acp-v1 runtime: $ref: '#/components/schemas/ConnectedRuntimeId' required: - kind - protocol additionalProperties: false MessageContentBase64Data: type: string allOf: - minLength: 1 - maxLength: 1048576 FileId: type: string pattern: ^file_[0-9a-f]{32}$ MessageContentPlainTextData: type: string allOf: - minLength: 1 ApiKeyId: type: string pattern: ^akey_[0-9a-f]{32}$ AgentPlacementId: type: string pattern: ^aplace_[0-9a-f]{32}$ CollaborationInstallationId: type: string pattern: ^exti_[0-9a-f]{32}$ NonBrowserActionApprovalId: type: string pattern: ^approval_[0-9a-f]{32}$ Union_156: anyOf: - $ref: '#/components/schemas/Objects_47' - $ref: '#/components/schemas/Objects_48' Union_317: anyOf: - type: object properties: mode: type: string enum: - zdr required: - mode additionalProperties: false - type: object properties: mode: type: string enum: - standard default_ttl_seconds: type: integer allOf: - exclusiveMinimum: 0 - maximum: 2147483647 overrides: type: array items: type: object properties: content_class: $ref: '#/components/schemas/Union_318' ttl_seconds: type: integer allOf: - exclusiveMinimum: 0 - maximum: 2147483647 required: - content_class - ttl_seconds additionalProperties: false required: - mode additionalProperties: false Environment: type: object properties: id: $ref: '#/components/schemas/EnvironmentId' archived_at: anyOf: - type: string - type: 'null' config: $ref: '#/components/schemas/EnvironmentConfig' created_at: type: string description: anyOf: - type: string - type: 'null' metadata: $ref: '#/components/schemas/ResourceMetadata' name: type: string type: type: string enum: - environment updated_at: type: string scope: $ref: '#/components/schemas/EnvironmentScope' required: - id - archived_at - config - created_at - description - metadata - name - type - updated_at additionalProperties: false TypedCheckQuestions_1: type: array items: anyOf: - type: object properties: key: $ref: '#/components/schemas/CheckQuestionKey' type: type: string enum: - boolean instructions: type: string allOf: - minLength: 1 - maxLength: 4096 true_description: $ref: '#/components/schemas/CheckDescription_1' false_description: $ref: '#/components/schemas/CheckDescription_1' required: - key - type - instructions additionalProperties: false - type: object properties: key: $ref: '#/components/schemas/CheckQuestionKey' type: type: string enum: - choice instructions: type: string allOf: - minLength: 1 - maxLength: 4096 options: $ref: '#/components/schemas/CheckChoiceOptions_1' required: - key - type - instructions - options additionalProperties: false - type: object properties: key: $ref: '#/components/schemas/CheckQuestionKey' type: type: string enum: - score instructions: type: string allOf: - minLength: 1 - maxLength: 4096 levels: $ref: '#/components/schemas/CheckScoreLevels_1' required: - key - type - instructions - levels additionalProperties: false allOf: - minItems: 1 - maxItems: 8 CheckBooleanRuleThresholds: type: object properties: type: type: string enum: - boolean question_key: $ref: '#/components/schemas/CheckQuestionKey' expected: type: boolean false_max: type: number allOf: - minimum: 0 - maximum: 1 true_min: type: number allOf: - minimum: 0 - maximum: 1 required: - type - question_key - expected - false_max - true_min additionalProperties: false Objects_128: type: object properties: type: type: string enum: - choice_matches question_key: $ref: '#/components/schemas/CheckQuestionKey' option_keys: $ref: '#/components/schemas/CheckChoiceMatchesOptions_1' min_probability: type: number allOf: - minimum: 0 - maximum: 1 min_margin: type: number allOf: - minimum: 0 - maximum: 1 required: - type - question_key - option_keys - min_probability - min_margin additionalProperties: false CheckScoreTailRuleThresholds: type: object properties: type: type: string enum: - score_tail question_key: $ref: '#/components/schemas/CheckQuestionKey' at_or_above_level: type: integer minimum: 0 false_max: type: number allOf: - minimum: 0 - maximum: 1 true_min: type: number allOf: - minimum: 0 - maximum: 1 required: - type - question_key - at_or_above_level - false_max - true_min additionalProperties: false ModelRoutingProfileId: type: string pattern: ^mrp_[0-9a-f]{32}$ ModelRoutingProfileVersionId: type: string pattern: ^mrprev_[0-9a-f]{32}$ Union_127: type: string enum: - cheapest_sufficient - pinned - fallback Objects_196: type: object properties: tier: type: string enum: - default provider: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ model: type: string allOf: - minLength: 1 context_window_tokens: type: integer exclusiveMinimum: 0 effort: type: string enum: - low - medium - high - xhigh - max speed: type: string enum: - standard - fast inference_geo: $ref: '#/components/schemas/Union_11' openrouter_max_price: $ref: '#/components/schemas/OpenRouterMaxPrice' native_capabilities: anyOf: - type: object properties: version: type: number enum: - 1 wire_format: type: string enum: - openai_chat max_output_tokens: type: integer exclusiveMinimum: 0 input_modalities: type: array prefixItems: - type: string enum: - text - image minItems: 1 items: type: string enum: - text - image reasoning: type: boolean thinking_levels: $ref: '#/components/schemas/Objects_70' compatibility: type: object properties: supportsStore: type: boolean supportsDeveloperRole: type: boolean supportsReasoningEffort: type: boolean supportsUsageInStreaming: type: boolean supportsFinishReason: type: boolean maxTokensField: type: string enum: - max_tokens - max_completion_tokens requiresToolResultName: type: boolean requiresAssistantAfterToolResult: type: boolean requiresThinkingAsText: type: boolean requiresReasoningContentOnAssistantMessages: type: boolean thinkingFormat: type: string enum: - openai - openrouter - deepseek - together - zai - qwen - string-thinking - ant-ling zaiToolStream: type: boolean supportsStrictMode: type: boolean supportsOpenAIGrammarTools: type: boolean supportsMidConvoSystemMessages: type: boolean supportsMidConvoToolAdditions: type: boolean supportsThinkingTokenBudget: type: boolean thinkingTokenBudgetField: type: string enum: - thinking_token_budget - thinking_budget - thinking_budget_tokens required: - supportsStore - supportsDeveloperRole - supportsReasoningEffort - supportsUsageInStreaming - supportsFinishReason - maxTokensField - requiresToolResultName - requiresAssistantAfterToolResult - requiresThinkingAsText - requiresReasoningContentOnAssistantMessages - thinkingFormat - zaiToolStream - supportsStrictMode - supportsOpenAIGrammarTools - supportsMidConvoSystemMessages - supportsMidConvoToolAdditions - supportsThinkingTokenBudget additionalProperties: false required: - version - wire_format - max_output_tokens - input_modalities - reasoning - thinking_levels - compatibility additionalProperties: false - type: object properties: version: type: number enum: - 1 wire_format: type: string enum: - openai_responses max_output_tokens: type: integer exclusiveMinimum: 0 input_modalities: type: array prefixItems: - type: string enum: - text - image minItems: 1 items: type: string enum: - text - image reasoning: type: boolean thinking_levels: $ref: '#/components/schemas/Objects_70' compatibility: type: object properties: supportsDeveloperRole: type: boolean supportsMidConvoSystemMessages: type: boolean supportsStrictMode: type: boolean supportsOpenAIGrammarTools: type: boolean supportsAdditionalTools: type: boolean supportsToolSearch: type: boolean supportsExplicitPromptCacheMode: type: boolean supportsMaxOutputTokens: type: boolean required: - supportsDeveloperRole - supportsMidConvoSystemMessages - supportsStrictMode - supportsOpenAIGrammarTools - supportsAdditionalTools - supportsToolSearch - supportsExplicitPromptCacheMode - supportsMaxOutputTokens additionalProperties: false required: - version - wire_format - max_output_tokens - input_modalities - reasoning - thinking_levels - compatibility additionalProperties: false - type: object properties: version: type: number enum: - 1 wire_format: type: string enum: - anthropic_messages max_output_tokens: type: integer exclusiveMinimum: 0 input_modalities: type: array prefixItems: - type: string enum: - text - image minItems: 1 items: type: string enum: - text - image reasoning: type: boolean thinking_levels: $ref: '#/components/schemas/Objects_70' compatibility: type: object properties: supportsEagerToolInputStreaming: type: boolean supportsCacheControlOnTools: type: boolean supportsTemperature: type: boolean forceAdaptiveThinking: type: boolean allowEmptySignature: type: boolean supportsStrictTools: type: boolean supportsMidConvoEffort: type: boolean supportsMidConvoSystemMessages: type: boolean supportsMidConvoToolChanges: type: boolean required: - supportsEagerToolInputStreaming - supportsCacheControlOnTools - supportsTemperature - forceAdaptiveThinking - allowEmptySignature - supportsStrictTools - supportsMidConvoEffort - supportsMidConvoSystemMessages - supportsMidConvoToolChanges additionalProperties: false required: - version - wire_format - max_output_tokens - input_modalities - reasoning - thinking_levels - compatibility additionalProperties: false native_sdk_estimation: $ref: '#/components/schemas/Objects_71' required: - tier - provider - model additionalProperties: false Union_320: anyOf: - type: object properties: kind: type: string enum: - platform_supply provider: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ required: - kind - provider additionalProperties: false - type: object properties: kind: type: string enum: - workspace_credential provider: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ model_credential_id: $ref: '#/components/schemas/ModelCredentialId' model_credential_generation_id: $ref: '#/components/schemas/ModelCredentialGenerationId' api_format: $ref: '#/components/schemas/ModelApiFormat' base_url: anyOf: - $ref: '#/components/schemas/PublicModelBaseUrl' - type: 'null' credential_resource_version: type: integer exclusiveMinimum: 0 required: - kind - provider - model_credential_id - model_credential_generation_id additionalProperties: false Union_232: anyOf: - type: object properties: kind: type: string enum: - latest required: - kind additionalProperties: false - type: object properties: kind: type: string enum: - pinned version: type: integer exclusiveMinimum: 0 required: - kind - version additionalProperties: false - type: object properties: kind: type: string enum: - ref ref: $ref: '#/components/schemas/GitReference' required: - kind - ref additionalProperties: false Union_233: type: string enum: - read_only - read_write Union_185: anyOf: - type: object properties: kind: type: string enum: - upload required: - kind additionalProperties: false - $ref: '#/components/schemas/Objects_105' Objects_129: type: object properties: kind: type: string enum: - pull_request commit_message: type: string allOf: - minLength: 1 - maxLength: 4096 pull_request_title: type: string allOf: - minLength: 1 - maxLength: 256 pull_request_body: type: string allOf: - maxLength: 16384 allow_workflow_changes: type: boolean enum: - true required: - kind additionalProperties: false Objects_105: type: object properties: kind: type: string enum: - git provider: type: string enum: - github repository: $ref: '#/components/schemas/GitHubRepository' ref: $ref: '#/components/schemas/GitReference' commit_sha: type: string pattern: ^(?:[0-9a-f]{40}|[0-9a-f]{64})$ tree_sha: type: string pattern: ^(?:[0-9a-f]{40}|[0-9a-f]{64})$ required: - kind - provider - repository - ref - commit_sha additionalProperties: false MemoryStoreResourceBinding: type: object properties: store: $ref: '#/components/schemas/MemoryStoreId' requested: $ref: '#/components/schemas/Union_235' effective: $ref: '#/components/schemas/Union_235' selection: $ref: '#/components/schemas/Union_211' instructions: type: string allOf: - minLength: 1 - maxLength: 4096 mount_path: $ref: '#/components/schemas/MountPath' required: - store - requested - effective additionalProperties: false description: >- Resolved Memory mount whose effective access, instructions and destination enter the Session prompt. ResolvedSkillsResourceBindingIntegrity: type: object properties: kind: type: string enum: - skills mount_path: $ref: '#/components/schemas/MountPath' skills: type: array items: type: object properties: skill_id: $ref: '#/components/schemas/SkillId' name: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ skill_kind: $ref: '#/components/schemas/Union_143' version: type: integer exclusiveMinimum: 0 content_sha256: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - skill_id - name - skill_kind - version - content_sha256 additionalProperties: false allOf: - minItems: 1 required: - kind - mount_path - skills additionalProperties: false MemoryPath: type: string allOf: - maxLength: 1024 Union_114: anyOf: - type: object properties: kind: type: string enum: - principal principal: $ref: '#/components/schemas/PrincipalId' required: - kind - principal additionalProperties: false - type: object properties: kind: type: string enum: - api_key key: $ref: '#/components/schemas/ApiKeyId' required: - kind - key additionalProperties: false - type: object properties: kind: type: string enum: - session_agent session: $ref: '#/components/schemas/SessionId' agent: $ref: '#/components/schemas/AgentId' required: - kind - session - agent additionalProperties: false - type: object properties: kind: type: string enum: - curator run: $ref: '#/components/schemas/CurationRunId' required: - kind - run additionalProperties: false - type: object properties: kind: type: string enum: - platform operation: type: string enum: - import - redaction required: - kind - operation additionalProperties: false Objects_218: type: object properties: kind: type: string enum: - action_approval approval: $ref: '#/components/schemas/ActionApprovalId' tool_use_id: type: string on_approve: type: object properties: kind: type: string enum: - custom_tool required: - kind additionalProperties: false required: - kind - approval - tool_use_id additionalProperties: false BrowserActionApprovalId: type: string pattern: ^bapproval_[0-9a-f]{32}$ Union_208: type: string enum: - validation.malformed - validation.prompt_integrity_review_required - validation.not_found - validation.conflict - automation.source_event_conflict - automation.original_pending - automation.original_unavailable - validation.idempotency_conflict - validation.idempotency_in_progress - validation.payload_too_large - validation.range_too_large - auth.invalid_key - auth.authorization_unavailable - auth.request_admission_unavailable - auth.disabled_tenancy - policy.denied - budget.exceeded - model.no_eligible_model - model.credential_rejected - model.platform_supply_unavailable - model.platform_capacity_reached - billing.entitlement_unavailable - billing.usage_limit_reached - billing.payment_required - billing.seat_activation_unavailable - memory.not_found - memory.conflict - memory.read_only - memory.invalid_path - memory.backend_unavailable - memory.curation_failed - runtime.invalid_transition - runtime.primary_thread - retention.zdr_unsupported - runtime.checkpoint_expired - runtime.session_history_unavailable - runtime.harness_unavailable - runtime.harness_failed - runtime.runner_unavailable - runtime.provider_host_unavailable - runtime.lease_lost - runtime.start_timeout - runtime.allocation_failed - runtime.allocation_not_ready - runtime.provisioning_suspended - runtime.computer_unavailable - runtime.turn_deadline_exceeded - runtime.observation_gap - runtime.observation_conflict - runtime.attestation_invalid - runtime.harness_incompatible - runtime.target_mismatch - runtime.transcript_index_unavailable - runtime.internal UniqueFlowReviewCriteria: type: array items: type: object properties: key: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$ description: $ref: '#/components/schemas/FlowReviewCriterionDescription' severity: type: string enum: - low - medium - high required: - key - description - severity additionalProperties: false allOf: - minItems: 1 - maxItems: 16 Objects_152: type: object properties: tier: $ref: '#/components/schemas/Union_128' provider: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ model: type: string allOf: - minLength: 1 - maxLength: 255 context_window_tokens: type: integer exclusiveMinimum: 0 native_capabilities: anyOf: - type: object properties: version: type: number enum: - 1 wire_format: type: string enum: - openai_chat max_output_tokens: type: integer exclusiveMinimum: 0 input_modalities: type: array prefixItems: - type: string enum: - text - image minItems: 1 items: type: string enum: - text - image reasoning: type: boolean thinking_levels: $ref: '#/components/schemas/Objects_70' compatibility: type: object properties: supportsStore: type: boolean supportsDeveloperRole: type: boolean supportsReasoningEffort: type: boolean supportsUsageInStreaming: type: boolean supportsFinishReason: type: boolean maxTokensField: type: string enum: - max_tokens - max_completion_tokens requiresToolResultName: type: boolean requiresAssistantAfterToolResult: type: boolean requiresThinkingAsText: type: boolean requiresReasoningContentOnAssistantMessages: type: boolean thinkingFormat: type: string enum: - openai - openrouter - deepseek - together - zai - qwen - string-thinking - ant-ling zaiToolStream: type: boolean supportsStrictMode: type: boolean supportsOpenAIGrammarTools: type: boolean supportsMidConvoSystemMessages: type: boolean supportsMidConvoToolAdditions: type: boolean supportsThinkingTokenBudget: type: boolean thinkingTokenBudgetField: type: string enum: - thinking_token_budget - thinking_budget - thinking_budget_tokens required: - supportsStore - supportsDeveloperRole - supportsReasoningEffort - supportsUsageInStreaming - supportsFinishReason - maxTokensField - requiresToolResultName - requiresAssistantAfterToolResult - requiresThinkingAsText - requiresReasoningContentOnAssistantMessages - thinkingFormat - zaiToolStream - supportsStrictMode - supportsOpenAIGrammarTools - supportsMidConvoSystemMessages - supportsMidConvoToolAdditions - supportsThinkingTokenBudget additionalProperties: false required: - version - wire_format - max_output_tokens - input_modalities - reasoning - thinking_levels - compatibility additionalProperties: false - type: object properties: version: type: number enum: - 1 wire_format: type: string enum: - openai_responses max_output_tokens: type: integer exclusiveMinimum: 0 input_modalities: type: array prefixItems: - type: string enum: - text - image minItems: 1 items: type: string enum: - text - image reasoning: type: boolean thinking_levels: $ref: '#/components/schemas/Objects_70' compatibility: type: object properties: supportsDeveloperRole: type: boolean supportsMidConvoSystemMessages: type: boolean supportsStrictMode: type: boolean supportsOpenAIGrammarTools: type: boolean supportsAdditionalTools: type: boolean supportsToolSearch: type: boolean supportsExplicitPromptCacheMode: type: boolean supportsMaxOutputTokens: type: boolean required: - supportsDeveloperRole - supportsMidConvoSystemMessages - supportsStrictMode - supportsOpenAIGrammarTools - supportsAdditionalTools - supportsToolSearch - supportsExplicitPromptCacheMode - supportsMaxOutputTokens additionalProperties: false required: - version - wire_format - max_output_tokens - input_modalities - reasoning - thinking_levels - compatibility additionalProperties: false - type: object properties: version: type: number enum: - 1 wire_format: type: string enum: - anthropic_messages max_output_tokens: type: integer exclusiveMinimum: 0 input_modalities: type: array prefixItems: - type: string enum: - text - image minItems: 1 items: type: string enum: - text - image reasoning: type: boolean thinking_levels: $ref: '#/components/schemas/Objects_70' compatibility: type: object properties: supportsEagerToolInputStreaming: type: boolean supportsCacheControlOnTools: type: boolean supportsTemperature: type: boolean forceAdaptiveThinking: type: boolean allowEmptySignature: type: boolean supportsStrictTools: type: boolean supportsMidConvoEffort: type: boolean supportsMidConvoSystemMessages: type: boolean supportsMidConvoToolChanges: type: boolean required: - supportsEagerToolInputStreaming - supportsCacheControlOnTools - supportsTemperature - forceAdaptiveThinking - allowEmptySignature - supportsStrictTools - supportsMidConvoEffort - supportsMidConvoSystemMessages - supportsMidConvoToolChanges additionalProperties: false required: - version - wire_format - max_output_tokens - input_modalities - reasoning - thinking_levels - compatibility additionalProperties: false native_sdk_estimation: $ref: '#/components/schemas/Objects_71' effort: type: string enum: - minimal - low - medium - high - max speed: type: string enum: - standard - fast inference_geo: $ref: '#/components/schemas/Union_11' openrouter_max_price: $ref: '#/components/schemas/OpenRouterMaxPrice' required: - tier - provider - model additionalProperties: false Objects_47: type: object properties: kind: type: string enum: - workspace_credential provider: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ model_credential_id: $ref: '#/components/schemas/ModelCredentialId' model_credential_generation_id: $ref: '#/components/schemas/ModelCredentialGenerationId' required: - kind - provider - model_credential_id - model_credential_generation_id additionalProperties: false Objects_158: type: object properties: key: type: string allOf: - minLength: 1 - maxLength: 64 - pattern: ^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$ result: type: string enum: - pass - concern - unknown explanation: type: string allOf: - maxLength: 512 event_ids: type: array items: $ref: '#/components/schemas/EventId' allOf: - maxItems: 16 required: - key - result - explanation - event_ids additionalProperties: false FileTreeCaptureTimestamp: type: string allOf: - maxLength: 24 - pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ x-checkfu-current-timestamp: true description: >- A canonical UTC ISO-8601 FileTree capture timestamp with millisecond precision. AgentId: type: string pattern: ^agent_[0-9a-f]{32}$ Arrays_7: type: array items: $ref: '#/components/schemas/ManagedAgentsConnectionBinding' allOf: - maxItems: 20 Union_31: anyOf: - type: string - type: 'null' ManagedAgentsHarnessReference: type: string allOf: - pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})(?:@(?:latest|[1-9][0-9]{0,8}))?$ description: >- a harness catalog name this deployment serves: claude-code, codex, deepseek, openclaw, openclaw-connected, opencode, pi Arrays_8: type: array items: $ref: '#/components/schemas/Union_27' ManagedAgentsModelConfig: type: object properties: id: type: string effort: anyOf: - type: object properties: type: type: string enum: - low required: - type additionalProperties: false - type: object properties: type: type: string enum: - medium required: - type additionalProperties: false - type: object properties: type: type: string enum: - high required: - type additionalProperties: false - type: object properties: type: type: string enum: - xhigh required: - type additionalProperties: false - type: object properties: type: type: string enum: - max required: - type additionalProperties: false inference_geo: type: string enum: - global - us speed: type: string enum: - standard - fast provider: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ model_credential_id: $ref: '#/components/schemas/ModelCredentialId' required: - id additionalProperties: false Arrays_9: type: array items: $ref: '#/components/schemas/Union_32' Union_33: anyOf: - type: string - type: 'null' Arrays_10: type: array items: $ref: '#/components/schemas/ManagedAgentsTool' ManagedAgentsAgentSkillSelection: anyOf: - type: object properties: type: type: string enum: - listed skills: type: array items: $ref: '#/components/schemas/Union_32' allOf: - minItems: 1 - maxItems: 100 required: - type - skills additionalProperties: false - type: object properties: type: type: string enum: - workspace required: - type additionalProperties: false Objects_48: type: object properties: kind: type: string enum: - platform_supply provider: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ usage_entry_id: $ref: '#/components/schemas/UsageEntryId' supply_id: $ref: '#/components/schemas/PlatformSupplyId' credential_generation_id: $ref: '#/components/schemas/SupplyCredentialGenerationId' rate_card_id: $ref: '#/components/schemas/BillingRateCardId' customer_rate_card_id: $ref: '#/components/schemas/BillingRateCardId' rated_at: $ref: '#/components/schemas/PlatformModelRatedAt' required: - kind - provider - usage_entry_id - supply_id - credential_generation_id - rate_card_id - rated_at additionalProperties: false Union_318: type: string enum: - message - thinking - tool_arguments - tool_result - artifact - checkpoint - file_body - memory_document - sandbox_state - wire_frame EnvironmentId: type: string pattern: ^env_[0-9a-f]{32}$ EnvironmentConfig: anyOf: - $ref: '#/components/schemas/CloudConfig' - $ref: '#/components/schemas/SelfHostedConfig' EnvironmentScope: type: string enum: - organization - account CheckQuestionKey: type: string allOf: - minLength: 1 - maxLength: 64 CheckDescription_1: type: string allOf: - minLength: 1 CheckChoiceOptions_1: type: array items: type: object properties: key: $ref: '#/components/schemas/CheckQuestionKey' description: $ref: '#/components/schemas/CheckDescription_1' required: - key - description additionalProperties: false allOf: - minItems: 2 - maxItems: 32 CheckScoreLevels_1: type: array items: $ref: '#/components/schemas/CheckDescription_1' allOf: - minItems: 2 - maxItems: 10 CheckChoiceMatchesOptions_1: type: array items: $ref: '#/components/schemas/CheckQuestionKey' allOf: - minItems: 1 Union_11: type: string enum: - global - us OpenRouterMaxPrice: type: object properties: prompt: type: number allOf: - minimum: 0 - maximum: 1000 completion: type: number allOf: - minimum: 0 - maximum: 1000 required: - prompt - completion additionalProperties: false description: >- maximum OpenRouter prompt and completion prices in USD per million tokens Objects_70: type: object properties: 'off': $ref: '#/components/schemas/Union_131' minimal: $ref: '#/components/schemas/Union_131' low: $ref: '#/components/schemas/Union_131' medium: $ref: '#/components/schemas/Union_131' high: $ref: '#/components/schemas/Union_131' xhigh: $ref: '#/components/schemas/Union_131' max: $ref: '#/components/schemas/Union_131' required: - 'off' - minimal - low - medium - high - xhigh - max additionalProperties: false Objects_71: type: object properties: version: type: number enum: - 1 unit: type: string enum: - usd_per_million_tokens source: type: string enum: - profile_declared input: type: number minimum: 0 output: type: number minimum: 0 cache_read: type: number minimum: 0 cache_write: type: number minimum: 0 required: - version - unit - source - input - output - cache_read - cache_write additionalProperties: false ModelCredentialId: type: string pattern: ^mcred_[0-9a-f]{32}$ ModelCredentialGenerationId: type: string pattern: ^mcgen_[0-9a-f]{32}$ ModelApiFormat: type: string enum: - openai_chat - openai_responses - anthropic_messages description: >- the request format a model endpoint serves: OpenAI Chat Completions, OpenAI Responses, or Anthropic Messages PublicModelBaseUrl: type: string allOf: - maxLength: 2048 GitReference: type: string allOf: - minLength: 1 - maxLength: 1024 - pattern: ^\S+$ GitHubRepository: type: string allOf: - pattern: ^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$ - maxLength: 202 Union_211: anyOf: - type: object properties: kind: type: string enum: - ref ref: $ref: '#/components/schemas/Union_118' required: - kind - ref additionalProperties: false - type: object properties: kind: type: string enum: - version version: $ref: '#/components/schemas/Union_112' required: - kind - version additionalProperties: false SkillId: type: string pattern: ^skl_[0-9a-f]{32}$ Union_143: type: string enum: - instructional - executable FlowReviewCriterionDescription: type: string allOf: - minLength: 1 - maxLength: 1024 ManagedAgentsConnectionBinding: type: object properties: name: type: string allOf: - minLength: 1 - maxLength: 255 connection_id: $ref: '#/components/schemas/ConnectionId' provider: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ provider_package_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ connection_revision_id: $ref: '#/components/schemas/ConnectionRevisionId' capability_snapshot_id: $ref: '#/components/schemas/CapabilitySnapshotId' capability_snapshot_digest: type: string pattern: ^sha256:[0-9a-f]{64}$ tools: type: array items: type: object properties: name: type: string pattern: ^[a-z0-9](?:[a-z0-9._-]{0,93})$ digest: type: string pattern: ^sha256:[0-9a-f]{64}$ required: - name - digest additionalProperties: false allOf: - maxItems: 1000 required: - name - connection_id - provider - provider_package_digest - connection_revision_id - capability_snapshot_id - capability_snapshot_digest - tools additionalProperties: false description: >- Read-only Connection revision, capability snapshot and selected tool digests frozen by this Agent Version; never credentials or supplier handles. Union_27: anyOf: - type: object properties: type: type: string enum: - url name: type: string allOf: - minLength: 1 - maxLength: 255 url: type: string allOf: - minLength: 1 - maxLength: 2048 required: - type - name - url additionalProperties: false - $ref: '#/components/schemas/ManagedAgentsConnectionMcpServerParams' Union_32: anyOf: - type: object properties: type: type: string enum: - anthropic skill_id: type: string version: type: string required: - type - skill_id - version additionalProperties: false - type: object properties: type: type: string enum: - custom skill_id: type: string version: type: string required: - type - skill_id - version additionalProperties: false ManagedAgentsTool: anyOf: - type: object properties: type: type: string enum: - agent_toolset_20260401 configs: type: array items: anyOf: - type: object properties: name: type: string enum: - bash type: type: string enum: - bash enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' required: - name - type - enabled - permission_policy additionalProperties: false - type: object properties: name: type: string enum: - edit type: type: string enum: - edit enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' required: - name - type - enabled - permission_policy additionalProperties: false - type: object properties: name: type: string enum: - glob type: type: string enum: - glob enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' required: - name - type - enabled - permission_policy additionalProperties: false - type: object properties: name: type: string enum: - grep type: type: string enum: - grep enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' required: - name - type - enabled - permission_policy additionalProperties: false - type: object properties: name: type: string enum: - read type: type: string enum: - read enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' required: - name - type - enabled - permission_policy additionalProperties: false - type: object properties: name: type: string enum: - web_fetch type: type: string enum: - web_fetch enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' allowed_domains: $ref: '#/components/schemas/Arrays_6' blocked_domains: $ref: '#/components/schemas/Arrays_6' max_content_tokens: anyOf: - type: integer exclusiveMinimum: 0 - type: 'null' required: - name - type - enabled - permission_policy additionalProperties: false - type: object properties: name: type: string enum: - web_search type: type: string enum: - web_search enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' allowed_domains: $ref: '#/components/schemas/Arrays_6' blocked_domains: $ref: '#/components/schemas/Arrays_6' user_location: anyOf: - $ref: '#/components/schemas/Objects_11' - type: 'null' required: - name - type - enabled - permission_policy additionalProperties: false - type: object properties: name: type: string enum: - write type: type: string enum: - write enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' required: - name - type - enabled - permission_policy additionalProperties: false default_config: $ref: '#/components/schemas/Objects_14' required: - type - configs - default_config additionalProperties: false - type: object properties: type: type: string enum: - mcp_toolset mcp_server_name: type: string allOf: - minLength: 1 - maxLength: 255 configs: type: array items: type: object properties: name: type: string enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' required: - name - enabled - permission_policy additionalProperties: false default_config: $ref: '#/components/schemas/Objects_14' required: - type - mcp_server_name - configs - default_config additionalProperties: false - $ref: '#/components/schemas/Objects_13' UsageEntryId: type: string pattern: ^use_[0-9a-f]{32}$ PlatformSupplyId: type: string pattern: ^sup_[0-9a-f]{32}$ SupplyCredentialGenerationId: type: string pattern: ^sgen_[0-9a-f]{32}$ BillingRateCardId: type: string pattern: ^rate_[0-9a-f]{32}$ PlatformModelRatedAt: type: string allOf: - maxLength: 24 - pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ x-checkfu-current-timestamp: true description: >- A canonical UTC ISO-8601 model-rating instant with millisecond precision. CloudConfig: type: object properties: type: type: string enum: - cloud networking: anyOf: - $ref: '#/components/schemas/UnrestrictedNetwork' - $ref: '#/components/schemas/LimitedNetwork' packages: $ref: '#/components/schemas/Packages' required: - type - networking - packages additionalProperties: false SelfHostedConfig: type: object properties: type: type: string enum: - self_hosted networking: anyOf: - $ref: '#/components/schemas/UnrestrictedNetwork' - $ref: '#/components/schemas/LimitedNetwork' required: - type additionalProperties: false Union_131: anyOf: - type: string allOf: - minLength: 1 - maxLength: 255 - type: 'null' ConnectionRevisionId: type: string pattern: ^crev_[0-9a-f]{32}$ CapabilitySnapshotId: type: string pattern: ^csnap_[0-9a-f]{32}$ ManagedAgentsConnectionMcpServerParams: type: object properties: type: type: string enum: - connection name: type: string allOf: - minLength: 1 - maxLength: 255 connection_id: $ref: '#/components/schemas/ConnectionId' required: - type - name - connection_id additionalProperties: false description: >- An explicit governed Connection account exposed under a named MCP toolset. ManagedAgentsPermissionPolicy: anyOf: - type: object properties: type: type: string enum: - auto required: - type additionalProperties: false - type: object properties: type: type: string enum: - always_allow required: - type additionalProperties: false - type: object properties: type: type: string enum: - always_ask required: - type additionalProperties: false Arrays_6: type: array items: type: string allOf: - minLength: 1 - maxLength: 255 allOf: - minItems: 1 - maxItems: 64 Objects_11: type: object properties: type: type: string enum: - approximate city: anyOf: - type: string - type: 'null' country: anyOf: - $ref: '#/components/schemas/ManagedAgentsIsoCountryCode' - type: 'null' region: anyOf: - type: string - type: 'null' timezone: anyOf: - $ref: '#/components/schemas/ManagedAgentsIanaTimeZone' - type: 'null' required: - type additionalProperties: false Objects_14: type: object properties: enabled: type: boolean permission_policy: $ref: '#/components/schemas/ManagedAgentsPermissionPolicy' required: - enabled - permission_policy additionalProperties: false Objects_13: type: object properties: type: type: string enum: - custom name: type: string allOf: - minLength: 1 - maxLength: 128 - pattern: ^[A-Za-z0-9_-]+$ description: type: string allOf: - minLength: 1 input_schema: $ref: '#/components/schemas/ManagedAgentsCustomToolInputSchema' required: - type - name - description - input_schema additionalProperties: false UnrestrictedNetwork: type: object properties: type: type: string enum: - unrestricted required: - type additionalProperties: false LimitedNetwork: type: object properties: type: type: string enum: - limited allow_mcp_servers: type: boolean allow_package_managers: type: boolean allowed_hosts: type: array items: type: string required: - type - allow_mcp_servers - allow_package_managers - allowed_hosts additionalProperties: false Packages: type: object properties: type: type: string enum: - packages apt: $ref: '#/components/schemas/Arrays_46' cargo: $ref: '#/components/schemas/Arrays_46' gem: $ref: '#/components/schemas/Arrays_46' go: $ref: '#/components/schemas/Arrays_46' npm: $ref: '#/components/schemas/Arrays_46' pip: $ref: '#/components/schemas/Arrays_46' required: - apt - cargo - gem - go - npm - pip additionalProperties: false ManagedAgentsIsoCountryCode: type: string pattern: ^[A-Z]{2}$ ManagedAgentsIanaTimeZone: type: string allOf: - minLength: 1 - maxLength: 255 ManagedAgentsCustomToolInputSchema: type: object properties: type: type: string enum: - object properties: type: object additionalProperties: $ref: '#/components/schemas/JsonValue' required: type: array items: type: string required: - type additionalProperties: $ref: '#/components/schemas/JsonValue' description: JSON Schema for custom tool input parameters. Arrays_46: type: array items: type: string securitySchemes: bearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.