> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudcruise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List secret provider connections

> Lists the workspace's external secret-provider connections (e.g. 1Password). Use a connection `id` from this response as `secret_provider_id` when creating or updating a vault entry. Connections are created and managed from the dashboard; this endpoint is read-only. Authenticated with your CloudCruise API key, like the rest of the Vault API.

> **Note:**
>
> * Authenticated with your CloudCruise API key (`cc-key` header), the same as the rest of the Vault API.
> * Use a connection `id` from this response as `secret_provider_id` when creating or updating a [vault entry](/vault-api/create-vault-entry). See the [1Password integration](/integrations/1password).
> * Connections are created and managed from the dashboard; this endpoint is read-only.


## OpenAPI

````yaml vault-api/vault-api.yaml get /secret-providers
openapi: 3.1.0
info:
  title: CloudCruise Vault API
  version: 0.1.0
  description: Endpoints for managing vault entries.
servers:
  - url: https://api.cloudcruise.com
    description: CloudCruise Platform Production API Server
security:
  - AuthScheme: []
paths:
  /secret-providers:
    get:
      summary: List secret provider connections
      description: >-
        Lists the workspace's external secret-provider connections (e.g.
        1Password). Use a connection `id` from this response as
        `secret_provider_id` when creating or updating a vault entry.
        Connections are created and managed from the dashboard; this endpoint is
        read-only. Authenticated with your CloudCruise API key, like the rest of
        the Vault API.
      operationId: list_secret_providers
      responses:
        '200':
          description: The workspace's secret-provider connections.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SecretProviderConnection'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    SecretProviderConnection:
      type: object
      description: >-
        A configured connection to an external secret provider. Never includes
        the connection's credential (e.g. the 1Password service-account token).
      properties:
        id:
          type: string
          format: uuid
          description: Connection id. Use as `secret_provider_id` on a vault entry.
        workspace_id:
          type: string
          format: uuid
          description: The workspace this connection belongs to.
        provider_type:
          type: string
          enum:
            - 1password
          description: The external secret provider.
        name:
          type: string
          description: Human-readable connection name.
        config_hint:
          type: object
          nullable: true
          description: >-
            Non-sensitive hints about the connection (e.g. the last four
            characters of the service-account token).
        cache_ttl_seconds:
          type: integer
          description: >-
            Default duration (seconds) that resolved secrets are cached for
            entries bound to this connection.
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
        - id
        - workspace_id
        - provider_type
        - name
        - config_hint
        - cache_ttl_seconds
        - created_at
        - updated_at
    ErrorResponse:
      type: object
      description: Error response returned when a request fails
      properties:
        statusCode:
          type: integer
          description: HTTP status code
        message:
          type: string
          description: Human-readable error message
        error:
          type: string
          description: HTTP status text (e.g., "Not Found", "Conflict")
      required:
        - statusCode
        - message
  securitySchemes:
    AuthScheme:
      type: apiKey
      name: cc-key
      in: header
      description: >-
        API key-based authentication. Provide your CloudCruise API key in the
        cc-key header.

````