> ## 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 an installed Agent's public A2A v1 Agent Card > Projects the active AgentInstallation, SurfaceScope, exact published AgentRelease, and active Skills into an A2A v1 Agent Card. The card is public and cacheable; invoking or observing tasks still requires an audience-bound Principal credential and live PermissionAssignments. Checkfu support posture: preview; hosted. Required evidence journey: a2a-serve. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities. ## OpenAPI ````yaml /openapi.json get /a2a/v1/workspaces/{workspace}/agent-installations/{installation}/surface-scopes/{surface}/agent-card.json 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: webhookEndpoints - name: integrationGateway - name: agentDeployments - name: workEnvironments - name: computers - name: computerScreens - name: computerBrowserObservations - name: computerBrowserActions - name: environments - name: vaults - name: apiMcp - name: a2a paths: /a2a/v1/workspaces/{workspace}/agent-installations/{installation}/surface-scopes/{surface}/agent-card.json: get: tags: - a2a summary: Get an installed Agent's public A2A v1 Agent Card description: >- Projects the active AgentInstallation, SurfaceScope, exact published AgentRelease, and active Skills into an A2A v1 Agent Card. The card is public and cacheable; invoking or observing tasks still requires an audience-bound Principal credential and live PermissionAssignments. Checkfu support posture: preview; hosted. Required evidence journey: a2a-serve. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities. operationId: a2a.getAgentCard parameters: - name: workspace in: path required: true schema: type: string pattern: ^wrkspc_[0-9a-f]{32}$ - name: installation in: path required: true schema: type: string pattern: ^aini_[0-9a-f]{32}$ - name: surface in: path required: true schema: type: string pattern: ^surf_[0-9a-f]{32}$ responses: '200': description: A2A v1 Agent Card headers: a2a-version: schema: type: string enum: - '1.0' etag: schema: type: string content: application/json: schema: $ref: '#/components/schemas/A2aAgentCardIdentity' '304': description: The supplied ETag still names the current projection '404': description: Typed Checkfu wire error content: application/json: schema: type: object required: - error 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 additionalProperties: false '500': description: Typed Checkfu wire error content: application/json: schema: type: object required: - error 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 additionalProperties: false security: [] components: schemas: A2aAgentCardIdentity: type: object properties: name: type: string allOf: - maxLength: 1024 - minLength: 1 description: type: string allOf: - maxLength: 16384 - minLength: 1 supportedInterfaces: type: array prefixItems: - $ref: '#/components/schemas/Inline4_Objects_' minItems: 1 items: $ref: '#/components/schemas/Inline4_Objects_' allOf: - maxItems: 32 provider: type: object properties: url: $ref: '#/components/schemas/A2aHttpsUrl' organization: type: string allOf: - maxLength: 1024 - minLength: 1 required: - url - organization additionalProperties: false version: type: string allOf: - maxLength: 1024 - minLength: 1 documentationUrl: $ref: '#/components/schemas/A2aHttpsUrl' capabilities: type: object properties: streaming: $ref: '#/components/schemas/Inline4_Union_' pushNotifications: $ref: '#/components/schemas/Inline4_Union_' extensions: type: array items: type: object properties: uri: $ref: '#/components/schemas/A2aUri' description: $ref: '#/components/schemas/Inline4_Union_1' required: $ref: '#/components/schemas/Inline4_Union_' params: $ref: '#/components/schemas/Inline4_Union_2' required: - uri additionalProperties: false allOf: - maxItems: 64 extendedAgentCard: $ref: '#/components/schemas/Inline4_Union_' additionalProperties: false securitySchemes: type: object additionalProperties: $ref: '#/components/schemas/A2aSecurityScheme' allOf: - propertyNames: type: string allOf: - minLength: 1 - maxLength: 512 securityRequirements: type: array items: $ref: '#/components/schemas/Inline4_Objects_2' allOf: - maxItems: 32 defaultInputModes: type: array prefixItems: - type: string allOf: - minLength: 1 - maxLength: 256 - pattern: ^[^\s/]+\/[^\s/]+(?:\s*;.*)?$ minItems: 1 items: type: string allOf: - minLength: 1 - maxLength: 256 - pattern: ^[^\s/]+\/[^\s/]+(?:\s*;.*)?$ allOf: - maxItems: 64 defaultOutputModes: type: array prefixItems: - type: string allOf: - minLength: 1 - maxLength: 256 - pattern: ^[^\s/]+\/[^\s/]+(?:\s*;.*)?$ minItems: 1 items: type: string allOf: - minLength: 1 - maxLength: 256 - pattern: ^[^\s/]+\/[^\s/]+(?:\s*;.*)?$ allOf: - maxItems: 64 skills: type: array prefixItems: - $ref: '#/components/schemas/Inline4_Objects_3' minItems: 1 items: $ref: '#/components/schemas/Inline4_Objects_3' allOf: - maxItems: 256 signatures: type: array items: type: object properties: protected: type: string allOf: - minLength: 1 - maxLength: 16384 - pattern: ^[A-Za-z0-9_-]+$ signature: type: string allOf: - minLength: 1 - maxLength: 16384 - pattern: ^[A-Za-z0-9_-]+$ header: $ref: '#/components/schemas/Inline4_Union_2' required: - protected - signature additionalProperties: false allOf: - maxItems: 16 iconUrl: $ref: '#/components/schemas/A2aHttpsUrl' required: - name - description - supportedInterfaces - version - capabilities - defaultInputModes - defaultOutputModes - skills additionalProperties: false Inline4_Objects_: type: object properties: url: $ref: '#/components/schemas/A2aHttpsEndpointUrl' protocolBinding: type: string allOf: - minLength: 1 - maxLength: 128 tenant: type: string allOf: - minLength: 1 - maxLength: 512 protocolVersion: type: string allOf: - minLength: 1 - maxLength: 32 required: - url - protocolBinding - protocolVersion additionalProperties: false A2aHttpsUrl: type: string allOf: - maxLength: 2048 Inline4_Union_: anyOf: - type: boolean - type: 'null' A2aUri: type: string allOf: - minLength: 1 - maxLength: 2048 Inline4_Union_1: anyOf: - type: string allOf: - maxLength: 16384 - type: 'null' Inline4_Union_2: anyOf: - type: object additionalProperties: $ref: '#/components/schemas/A2aJsonValue' allOf: - maxProperties: 256 - x-checkfu-json-budget: maximumBytes: 1048576 maximumDepth: 64 maximumNodes: 100000 maximumInspectionWork: 100000 - type: 'null' A2aSecurityScheme: type: object properties: apiKeySecurityScheme: type: object properties: description: $ref: '#/components/schemas/Inline4_Union_1' location: type: string enum: - query - header - cookie name: type: string allOf: - maxLength: 1024 - minLength: 1 required: - location - name additionalProperties: false httpAuthSecurityScheme: type: object properties: description: $ref: '#/components/schemas/Inline4_Union_1' scheme: type: string allOf: - minLength: 1 - maxLength: 256 - pattern: ^[!#$%&'*+.^_\x60|~0-9A-Za-z-]+$ bearerFormat: type: string allOf: - maxLength: 1024 - minLength: 1 required: - scheme additionalProperties: false oauth2SecurityScheme: type: object properties: description: $ref: '#/components/schemas/Inline4_Union_1' flows: $ref: '#/components/schemas/A2aOAuthFlows' oauth2MetadataUrl: $ref: '#/components/schemas/Inline4_Union_3' required: - flows additionalProperties: false openIdConnectSecurityScheme: type: object properties: description: $ref: '#/components/schemas/Inline4_Union_1' openIdConnectUrl: $ref: '#/components/schemas/A2aHttpsEndpointUrl' required: - openIdConnectUrl additionalProperties: false mtlsSecurityScheme: type: object properties: description: $ref: '#/components/schemas/Inline4_Union_1' additionalProperties: false additionalProperties: false Inline4_Objects_2: type: object properties: schemes: type: object additionalProperties: type: object properties: list: type: array items: type: string allOf: - minLength: 1 - maxLength: 512 allOf: - maxItems: 64 additionalProperties: false allOf: - propertyNames: type: string allOf: - minLength: 1 - maxLength: 512 required: - schemes additionalProperties: false Inline4_Objects_3: type: object properties: id: type: string allOf: - minLength: 1 - maxLength: 512 name: type: string allOf: - maxLength: 1024 - minLength: 1 description: type: string allOf: - maxLength: 16384 - minLength: 1 tags: type: array prefixItems: - type: string allOf: - minLength: 1 - maxLength: 512 minItems: 1 items: type: string allOf: - minLength: 1 - maxLength: 512 allOf: - maxItems: 256 examples: type: array items: type: string allOf: - maxLength: 16384 allOf: - maxItems: 64 inputModes: $ref: '#/components/schemas/Inline4_Union_4' outputModes: $ref: '#/components/schemas/Inline4_Union_4' securityRequirements: type: array items: $ref: '#/components/schemas/Inline4_Objects_2' allOf: - maxItems: 32 required: - id - name - description - tags additionalProperties: false A2aHttpsEndpointUrl: type: string allOf: - maxLength: 2048 A2aJsonValue: x-checkfu-json-budget: maximumBytes: 1048576 maximumDepth: 64 maximumNodes: 100000 maximumInspectionWork: 100000 description: >- A JSON value bounded to 1 MiB, depth 64, 100,000 nodes, and 100,000 inspected own keys. A2aOAuthFlows: type: object properties: authorizationCode: type: object properties: authorizationUrl: $ref: '#/components/schemas/A2aHttpsEndpointUrl' tokenUrl: $ref: '#/components/schemas/A2aHttpsEndpointUrl' refreshUrl: $ref: '#/components/schemas/Inline4_Union_3' scopes: $ref: '#/components/schemas/Inline4_Objects_1' pkceRequired: $ref: '#/components/schemas/Inline4_Union_' required: - authorizationUrl - tokenUrl - scopes additionalProperties: false clientCredentials: type: object properties: tokenUrl: $ref: '#/components/schemas/A2aHttpsEndpointUrl' refreshUrl: $ref: '#/components/schemas/Inline4_Union_3' scopes: $ref: '#/components/schemas/Inline4_Objects_1' required: - tokenUrl - scopes additionalProperties: false implicit: type: object properties: authorizationUrl: $ref: '#/components/schemas/A2aHttpsEndpointUrl' refreshUrl: $ref: '#/components/schemas/Inline4_Union_3' scopes: $ref: '#/components/schemas/Inline4_Objects_1' required: - authorizationUrl - scopes additionalProperties: false password: type: object properties: tokenUrl: $ref: '#/components/schemas/A2aHttpsEndpointUrl' refreshUrl: $ref: '#/components/schemas/Inline4_Union_3' scopes: $ref: '#/components/schemas/Inline4_Objects_1' required: - tokenUrl - scopes additionalProperties: false deviceCode: type: object properties: deviceAuthorizationUrl: $ref: '#/components/schemas/A2aHttpsEndpointUrl' tokenUrl: $ref: '#/components/schemas/A2aHttpsEndpointUrl' refreshUrl: $ref: '#/components/schemas/Inline4_Union_3' scopes: $ref: '#/components/schemas/Inline4_Objects_1' required: - deviceAuthorizationUrl - tokenUrl - scopes additionalProperties: false additionalProperties: false Inline4_Union_3: anyOf: - $ref: '#/components/schemas/A2aHttpsEndpointUrl' - type: 'null' Inline4_Union_4: anyOf: - type: array items: type: string allOf: - minLength: 1 - maxLength: 256 - pattern: ^[^\s/]+\/[^\s/]+(?:\s*;.*)?$ allOf: - maxItems: 64 - type: 'null' Inline4_Objects_1: type: object additionalProperties: type: string allOf: - maxLength: 16384 allOf: - propertyNames: type: string allOf: - minLength: 1 - maxLength: 512 securitySchemes: bearerAuth: type: http scheme: bearer ````