# Vault: List secrets (https://docs.envocal.ai/api-reference/vault/list-secrets/) > The secrets in the tenant's vault that tools can use, by name. A tool sends one in a header: the header has inputType: "secret" and the secret's id as its secretId. Secrets are created and changed in the Studio (Vault); the API returns their name only, never their value. ## GET `/v1/tenants/{tenantId}/vault/secrets` The secrets in the tenant's vault that tools can use, by name. A tool sends one in a header: the header has `inputType: "secret"` and the secret's `id` as its `secretId`. Secrets are created and changed in the Studio (**Vault**); the API returns their name only, never their value. **Required permission:** `vault:read` ### Parameters | Name | In | | Type | Description | | --- | --- | --- | --- | --- | | `tenantId` | path | required | string | Tenant id, or `current` for the key's own tenant. Must be the key's tenant or one of its sub-tenants. | ### Responses **200** — PublicVaultSecretDto[]: The secrets, sorted by name. | Field | Type | | Description | | --- | --- | --- | --- | | `id` | string (uuid) | | Secret id. Use it as the `secretId` of a header in a tool's config. | | `name` | string | required | Name given to the secret in the Studio. | **401**: Missing, invalid, revoked or expired API key. **403**: The key lacks the required permission, or the tenant/resource is outside its reach. **429**: Rate limit exceeded. Retry after the number of seconds in the Retry-After header. ### Example ```bash curl -X GET "https://api.envocal.ai/v1/tenants/current/vault/secrets" \ -H "Authorization: Bearer evk_eu_..." ```