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

# List Secrets

> List the workspace's own secrets. Values are not included.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/secrets
openapi: 3.1.0
info:
  description: >-
    Modular and extensible framework for building AI agents. This API requires
    JWT Bearer token authentication for most endpoints. Include your JWT token
    in the Authorization header. Public endpoints include /, /health, /docs,
    /redoc, and /openapi.json.
  title: AgentArea API
  version: 0.1.0
servers: []
security:
  - bearer: []
paths:
  /v1/secrets:
    get:
      tags:
        - v1
        - protected
        - secrets
      summary: List Secrets
      description: List the workspace's own secrets. Values are not included.
      operationId: list_secrets_v1_secrets_get
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/SecretResponse'
                title: Response List Secrets V1 Secrets Get
                type: array
          description: Successful Response
      security:
        - HTTPBearer: []
components:
  schemas:
    SecretResponse:
      description: A secret's metadata. The value is never part of this.
      properties:
        created_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Created At
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        id:
          format: uuid
          title: Id
          type: string
        name:
          description: Unique within the workspace.
          title: Name
          type: string
        updated_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Updated At
        used_by:
          items:
            $ref: '#/components/schemas/SecretConsumer'
          title: Used By
          type: array
      required:
        - id
        - name
      title: SecretResponse
      type: object
    SecretConsumer:
      properties:
        consumer_id:
          description: Id of the using entity.
          title: Consumer Id
          type: string
        consumer_type:
          description: Kind of thing using the secret, e.g. provider_config.
          title: Consumer Type
          type: string
        field:
          description: Which slot on that entity — a header name, an env var.
          title: Field
          type: string
      required:
        - consumer_type
        - consumer_id
        - field
      title: SecretConsumer
      type: object
  securitySchemes:
    bearer:
      bearerFormat: JWT
      description: JWT Bearer token for authentication
      scheme: bearer
      type: http
    HTTPBearer:
      scheme: bearer
      type: http

````