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

# Secrets List

> Get a list of all the secrets registered for your account.

This endpoint allows you to retrieve every secret registered for your account, including each secret's associated tool, argument, and configuration details. The actual secret values are never returned in the response for security reasons.

> [!NOTE]
>
> The API supports multiple authentication mechanisms, but only **one** needs to be provided per request. You may authenticate using **any** of the following headers, an `Authorization` header, or an `x-api-key` header (io.net API key).

> [!NOTE]
>
> The `display` field returned for each secret provides a partially masked representation of the secret value. It shows only the first and last few characters, ensuring that at least part of the value remains hidden. Complete visibility is only possible for very short secrets (typically 4 characters or fewer).


## OpenAPI

````yaml openapi/ai-agents/secret-management-list.json GET /v1/secrets/
openapi: 3.1.0
info:
  title: IO Intelligence
  version: '1.0'
servers:
  - url: https://api.intelligence.io.solutions
security:
  - BearerAuth: []
  - ApiKeyAuth: []
paths:
  /v1/secrets/:
    get:
      tags:
        - agents
      summary: Get Secrets List
      operationId: get_secrets_list_v1_secrets__get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SecretInfoList'
        '404':
          description: Not found
components:
  schemas:
    SecretInfoList:
      properties:
        data:
          items:
            $ref: '#/components/schemas/SecretInfo'
          type: array
          title: Data
      type: object
      required:
        - data
      title: SecretInfoList
    SecretInfo:
      properties:
        secret_id:
          type: string
          format: uuid
          title: Secret Id
        user_id:
          type: string
          format: uuid
          title: User Id
        secret_name:
          type: string
          title: Secret Name
        display:
          anyOf:
            - type: string
            - type: 'null'
          title: Display
        tool_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Tool Name
        tool_arg:
          anyOf:
            - type: string
            - type: 'null'
          title: Tool Arg
        is_default_for_tool:
          type: boolean
          title: Is Default For Tool
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          type: string
          format: date-time
          title: Updated At
        matched_tools_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Matched Tools Count
        total_tools_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total Tools Count
      type: object
      required:
        - secret_id
        - user_id
        - secret_name
        - display
        - tool_name
        - tool_arg
        - is_default_for_tool
        - created_at
        - updated_at
      title: SecretInfo
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 'io.net provided API Key, sent as `Authorization: Bearer <API_KEY>`.'
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        io.net provided API Key. Use either this header or `Authorization:
        Bearer <API_KEY>`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.