---
title: "List Secrets"
method: GET
path: "/vault/v1/secrets/"
tags: ["Secrets"]
---

# List Secrets

`GET /vault/v1/secrets/`

## Response `200`

Successful Response

- SecretResponseDTO[]
  - `kind` 'provider_key' | 'custom_provider' | 'sso_provider', required
  - `data` union, required
    - StandardProviderDTO
      - `kind` 'openai' | 'cohere' | 'anyscale' | 'deepinfra' | 'alephalpha' | 'groq' | 'mistral' | 'mistralai' | 'anthropic' | 'perplexityai' | 'together_ai' | 'openrouter' | 'gemini', required
      - `provider` StandardProviderSettingsDTO, required
        - `key` string, required
    - CustomProviderDTO
      - `kind` 'custom' | 'azure' | 'bedrock' | 'sagemaker' | 'vertex_ai' | 'openai' | 'cohere' | 'anyscale' | 'deepinfra' | 'alephalpha' | 'groq' | 'mistral' | 'mistralai' | 'anthropic' | 'perplexityai' | 'together_ai' | 'openrouter' | 'gemini', required
      - `provider` CustomProviderSettingsDTO, required
        - `url` string, nullable
        - `version` string, nullable
        - `key` string, nullable
        - `extras` object, nullable
      - `models` CustomModelSettingsDTO[], required
        - `slug` string, required
        - `extras` object, nullable
      - `provider_slug` string, nullable
      - `model_keys` string[], nullable
    - SSOProviderDTO
      - `provider` SSOProviderSettingsDTO, required
        - `client_id` string, required
        - `client_secret` string, required
        - `issuer_url` string, required
        - `scopes` string[], required
        - `extra` object
  - `id` string, uuid, nullable
  - `header` Header, required
    - `name` string, nullable
    - `description` string, nullable
  - `lifecycle` LegacyLifecycleDTO
    - `created_at` string, nullable
    - `updated_at` string, nullable
    - `updated_by_id` string, nullable
    - `updated_by` string, nullable

## Changes

- **2026-02-13** `72fe88316d15` — 1 warning, 1 info
  - added the new `sso_provider` enum value to the `items/kind` response property for the response status `200`
  - added `#/components/schemas/SSOProviderDTO` to the `items/data` response property `anyOf` list for the response status `200`
- **2026-01-14** `53da4c9de2b7` — 2 warning
  - added the new `mistral` enum value to the `items/data/anyOf[subschema #1: StandardProviderDTO]/kind` response property for the response status `200`
  - added the new `mistral` enum value to the `items/data/anyOf[subschema #2: CustomProviderDTO]/kind` response property for the response status `200`
- **2025-11-05** `e62506c24377` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added
- **2025-10-27** `66fd6182088f` — 1 warning, 1 info
  - added the new `vertex_ai` enum value to the `items/data/anyOf[subschema #2: CustomProviderDTO]/kind` response property for the response status `200`
  - removed the `vertex` enum value from the `items/data/anyOf[subschema #2: CustomProviderDTO]/kind` response property for the response status `200`
- **2025-06-27** `e3e84db47198` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/vault/v1/secrets/get.md)

---

[API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) · [All operations](https://skmtc.dev/agenta-ai/apis/agenta-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agenta-ai/agenta-api/revisions/8fcd55a5a656/schema)