> ## 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.

# List Blueprint installations

> List BlueprintInstallation reconciliation records for the selected Workspace. Installations record resolved authority and ownership but are never consulted on the run path. Pages with the shared list cursor.

Checkfu support posture: alpha; hosted. Required evidence journey: blueprint-authority. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities.



## OpenAPI

````yaml /openapi.json get /v1/blueprint-installations
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: sessionTemplates
  - name: sessions
  - name: audit
  - name: sessionExports
  - name: runs
  - name: runnerPools
  - name: transcripts
  - name: sessionSelection
  - name: sessionWatches
  - name: webhookEndpoints
  - name: sessionClient
  - name: integrationGateway
  - name: agentDeployments
  - name: workEnvironments
  - name: computers
  - name: computerScreens
  - name: computerBrowserObservations
  - name: computerBrowserActions
  - name: environments
  - name: vaults
  - name: apiMcp
  - name: a2a
paths:
  /v1/blueprint-installations:
    get:
      tags:
        - blueprintInstallations
      summary: List Blueprint installations
      description: >-
        List BlueprintInstallation reconciliation records for the selected
        Workspace. Installations record resolved authority and ownership but are
        never consulted on the run path. Pages with the shared list cursor.


        Checkfu support posture: alpha; hosted. Required evidence journey:
        blueprint-authority. Deployment-specific readiness and the latest proven
        release are available from GET /v1/support/capabilities.
      operationId: blueprintInstallations.listBlueprintInstallations
      parameters:
        - name: checkfu-version
          in: header
          schema:
            type: string
            enum:
              - '2026-08-27'
          required: true
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
          required: false
        - name: page
          in: query
          schema:
            type: string
            allOf:
              - pattern: ^c1_[0-9a-z]+$
          required: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Objects_78'
                  next_page:
                    anyOf:
                      - type: string
                      - type: 'null'
                required:
                  - data
                  - next_page
                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/ValidationMalformedError'
        '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'
        '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:
    Objects_78:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/BlueprintInstallationId'
        workspace_id:
          $ref: '#/components/schemas/WorkspaceId'
        blueprint_name:
          type: string
          allOf:
            - minLength: 1
            - maxLength: 94
        agent_blueprint_release_id:
          $ref: '#/components/schemas/Union_132'
        applied_version:
          type: integer
          allOf:
            - exclusiveMinimum: 0
        release_hash:
          type: string
          allOf:
            - pattern: ^sha256:[0-9a-f]{64}$
        lifecycle:
          $ref: '#/components/schemas/Union_133'
        resolved_resources:
          $ref: '#/components/schemas/Arrays_25'
        missing_inputs:
          $ref: '#/components/schemas/Arrays_26'
        history:
          $ref: '#/components/schemas/Arrays_27'
        provenance:
          type: string
          enum:
            - client_asserted
            - reconciled
        version:
          type: integer
          allOf:
            - exclusiveMinimum: 0
              description: Optimistic-write token for the record itself.
        created_at:
          type: string
        updated_at:
          type: string
      required:
        - id
        - workspace_id
        - blueprint_name
        - agent_blueprint_release_id
        - applied_version
        - release_hash
        - lifecycle
        - resolved_resources
        - missing_inputs
        - history
        - version
        - created_at
        - updated_at
      additionalProperties: false
    WorkspaceId:
      type: string
      allOf:
        - pattern: ^wrkspc_[0-9a-f]{32}$
    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.
    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.
    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.
    BlueprintInstallationId:
      type: string
      allOf:
        - pattern: ^bins_[0-9a-f]{32}$
    Union_132:
      anyOf:
        - $ref: '#/components/schemas/AgentBlueprintReleaseId_1'
        - type: 'null'
    Union_133:
      type: string
      enum:
        - planned
        - applied
        - upgraded
        - drifted
        - uninstalled
    Arrays_25:
      type: array
      items:
        type: object
        properties:
          resource_kind:
            type: string
            allOf:
              - minLength: 1
          logical_name:
            type: string
            allOf:
              - minLength: 1
          resource_id:
            anyOf:
              - type: string
                allOf:
                  - minLength: 1
              - type: 'null'
          ownership:
            type: string
            enum:
              - created
              - reused
          management:
            type: string
            enum:
              - adopted
          manage_mode:
            type: string
            enum:
              - reconcile
              - replace
              - none
          config_hash:
            anyOf:
              - type: string
                allOf:
                  - minLength: 1
              - type: 'null'
        required:
          - resource_kind
          - logical_name
          - resource_id
          - ownership
          - config_hash
        additionalProperties: false
    Arrays_26:
      type: array
      items:
        type: string
        allOf:
          - minLength: 1
      description: >-
        Credential or human-input steps still owed before the install is
        complete.
    Arrays_27:
      type: array
      items:
        type: object
        properties:
          operation_id:
            type: string
            allOf:
              - minLength: 1
          kind:
            type: string
            enum:
              - plan
              - apply
              - upgrade
              - rollback
              - uninstall
          release_hash:
            type: string
            allOf:
              - pattern: ^sha256:[0-9a-f]{64}$
          at:
            type: string
        required:
          - operation_id
          - kind
          - release_hash
          - at
        additionalProperties: false
    AgentBlueprintReleaseId_1:
      type: string
      allOf:
        - pattern: ^abrel_[0-9a-f]{32}$
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````