> ## Documentation Index > Fetch the complete documentation index at: https://checkfu.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Get one AgentDeploymentRevision > Returns one immutable AgentDeploymentRevision by deployment ID and positive integer revision number. Use it to read exactly what a Session admitted rather than what the deployment head points at today. Checkfu support posture: alpha; hosted. Required evidence journey: agent-definition. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities. ## OpenAPI ````yaml /openapi.json get /v1/agent-deployments/{agent_deployment_id}/revisions/{revision_number} openapi: 3.1.0 info: title: Checkfu API version: '2026-08-27' 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-27); 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: harnesses - name: harnessRuntime - name: sandboxProfiles - name: computerProfiles - name: permissionAssignments - name: actionPolicies - name: files - name: memoryStores - name: dreams - name: modelCredentials - name: modelRoutingProfiles - name: blueprintInstallations - name: toolSources - name: skills - name: skillSources - name: agentSources - name: skillProposals - name: instructionProposals - name: catalog - name: concepts - name: support - name: connections - name: connectionVaults - name: connectionAssignments - name: connectedRuntimes - name: projects - name: collaboration - name: automationGraphs - name: automations - name: actionApprovals - name: standingApprovals - name: usage - name: models - name: outcomes - name: budgets - name: billing - name: sessions - name: audit - name: sessionExports - name: runs - name: runnerPools - name: transcripts - name: sessionWatches - name: sessionHandoffs - name: sessionCapsules - name: sessionTrajectories - name: webhookEndpoints - name: integrationGateway - name: agentDeployments - name: workEnvironments - name: computers - name: computerScreens - name: computerBrowserObservations - name: computerBrowserActions - name: environments - name: vaults - name: apiMcp - name: a2a paths: /v1/agent-deployments/{agent_deployment_id}/revisions/{revision_number}: get: tags: - agentDeployments summary: Get one AgentDeploymentRevision description: >- Returns one immutable AgentDeploymentRevision by deployment ID and positive integer revision number. Use it to read exactly what a Session admitted rather than what the deployment head points at today. Checkfu support posture: alpha; hosted. Required evidence journey: agent-definition. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities. operationId: agentDeployments.getAgentDeploymentRevision parameters: - name: agent_deployment_id in: path schema: $ref: '#/components/schemas/AgentDeploymentId' required: true - name: revision_number in: path schema: type: string required: true - name: checkfu-version in: header schema: type: string enum: - '2026-08-27' required: true responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/Objects_439' 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: type: object required: - error 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 additionalProperties: false '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' '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' security: - bearerAuth: [] components: schemas: AgentDeploymentId: type: string allOf: - pattern: ^adep_[0-9a-f]{32}$ Objects_439: type: object properties: id: $ref: '#/components/schemas/AgentDeploymentRevisionId' agent_deployment_id: $ref: '#/components/schemas/AgentDeploymentId' workspace_id: $ref: '#/components/schemas/WorkspaceId' revision_number: type: integer allOf: - exclusiveMinimum: 0 agent_id: $ref: '#/components/schemas/AgentId' agent_release_number: type: integer allOf: - exclusiveMinimum: 0 model_routing_profile_id: $ref: '#/components/schemas/ModelRoutingProfileId' model_routing_profile_revision_number: type: integer allOf: - exclusiveMinimum: 0 execution_target: $ref: '#/components/schemas/AgentDeploymentExecutionTarget' skill_selections: $ref: '#/components/schemas/Arrays_55' connection_binding_selections: $ref: '#/components/schemas/Arrays_56' roster_snapshot: $ref: '#/components/schemas/Union_401' resolved_configuration_sha256: type: string allOf: - pattern: ^sha256:[0-9a-f]{64}$ published_by: $ref: '#/components/schemas/Union_90' published_at: type: string required: - id - agent_deployment_id - workspace_id - revision_number - agent_id - agent_release_number - model_routing_profile_id - model_routing_profile_revision_number - execution_target - skill_selections - connection_binding_selections - roster_snapshot - resolved_configuration_sha256 - published_by - published_at additionalProperties: false WorkspaceId: type: string allOf: - pattern: ^wrkspc_[0-9a-f]{32}$ 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. 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. AgentDeploymentRevisionId: type: string allOf: - pattern: ^adrev_[0-9a-f]{32}$ AgentId: type: string allOf: - pattern: ^agent_[0-9a-f]{32}$ ModelRoutingProfileId: type: string allOf: - pattern: ^mrp_[0-9a-f]{32}$ AgentDeploymentExecutionTarget: anyOf: - type: object properties: type: type: string enum: - managed harness_profile_id: $ref: '#/components/schemas/HarnessProfileId' harness_profile_revision_number: type: integer allOf: - exclusiveMinimum: 0 sandbox_profile_id: $ref: '#/components/schemas/SandboxProfileId' sandbox_profile_revision_number: type: integer allOf: - exclusiveMinimum: 0 runner_pool_id: anyOf: - $ref: '#/components/schemas/RunnerPoolId' - type: 'null' harness_topology: type: string enum: - colocated - split required: - type - harness_profile_id - harness_profile_revision_number - sandbox_profile_id - sandbox_profile_revision_number - runner_pool_id - harness_topology additionalProperties: false - type: object properties: type: type: string enum: - connected connected_harness_id: $ref: '#/components/schemas/ConnectedRuntimeId' expected_capability_set_sha256: type: string allOf: - pattern: ^sha256:[0-9a-f]{64}$ harness_topology: type: string enum: - connected required: - type - connected_harness_id - expected_capability_set_sha256 - harness_topology additionalProperties: false description: a managed or connected execution target Arrays_55: type: array items: type: object properties: skill_id: $ref: '#/components/schemas/SkillId' skill_revision_number: type: integer allOf: - exclusiveMinimum: 0 required: - skill_id - skill_revision_number additionalProperties: false Arrays_56: type: array items: type: object properties: agent_deployment_connection_binding_id: $ref: '#/components/schemas/AgentDeploymentConnectionBindingId' binding_revision_number: type: integer allOf: - exclusiveMinimum: 0 required: - agent_deployment_connection_binding_id - binding_revision_number additionalProperties: false Union_401: anyOf: - $ref: '#/components/schemas/Objects_438' - type: 'null' Union_90: anyOf: - type: object properties: kind: type: string enum: - system required: - kind additionalProperties: false - type: object properties: kind: type: string enum: - api_key id: $ref: '#/components/schemas/ApiKeyId' required: - kind - id additionalProperties: false - type: object properties: kind: type: string enum: - principal id: $ref: '#/components/schemas/PrincipalId' authenticated_by: $ref: '#/components/schemas/ApiKeyId' required: - kind - id additionalProperties: false - type: object properties: kind: type: string enum: - console_user id: type: string allOf: - minLength: 1 authenticated_by: $ref: '#/components/schemas/ApiKeyId' required: - kind - id additionalProperties: false - type: object properties: kind: type: string enum: - operator id: type: string allOf: - minLength: 1 required: - kind - id additionalProperties: false HarnessProfileId: type: string allOf: - pattern: ^hprof_[0-9a-f]{32}$ SandboxProfileId: type: string allOf: - pattern: ^sprof_[0-9a-f]{32}$ RunnerPoolId: type: string allOf: - pattern: ^rpool_[0-9a-f]{32}$ ConnectedRuntimeId: type: string allOf: - pattern: ^crt_[0-9a-f]{32}$ SkillId: type: string allOf: - pattern: ^skl_[0-9a-f]{32}$ AgentDeploymentConnectionBindingId: type: string allOf: - pattern: ^adcb_[0-9a-f]{32}$ Objects_438: type: object properties: entries: $ref: '#/components/schemas/UniqueAgentRosterSnapshotPositions' required: - entries additionalProperties: false ApiKeyId: type: string allOf: - pattern: ^akey_[0-9a-f]{32}$ PrincipalId: type: string allOf: - pattern: ^prin_[0-9a-f]{32}$ UniqueAgentRosterSnapshotPositions: type: array items: type: object properties: position: type: integer allOf: - exclusiveMinimum: 0 member_agent_id: $ref: '#/components/schemas/AgentId' member_agent_release_number: type: integer allOf: - exclusiveMinimum: 0 member_agent_deployment_id: $ref: '#/components/schemas/AgentDeploymentId' member_agent_deployment_revision_number: type: integer allOf: - exclusiveMinimum: 0 required: - position - member_agent_id - member_agent_release_number - member_agent_deployment_id - member_agent_deployment_revision_number additionalProperties: false allOf: - minItems: 1 - maxItems: 20 securitySchemes: bearerAuth: type: http scheme: bearer ````