---
title: "Get a specific secret set"
method: GET
path: "/secrets/{setName}"
---

# Get a specific secret set

`GET /secrets/{setName}`

Retrieve the keys (not values) of a specific secret set. Image pull secrets cannot be retrieved.

## Path parameters

- `setName` string, required

## Response `200`

Secret set details, including readiness status

- object
  - `region` string — The region where the secret set is stored
  - `status` 'pending' | 'ready' | 'failed' — Readiness state. `pending` while provisioning is in flight, `ready` once the set can be bound to a deploy, `failed` if provisioning could not complete.
  - `errorMessage` string — Customer-facing message returned only when `status` is `failed`. Generic by design — internal diagnostic details are kept in platform logs.
  - `secrets` SecretKey[]
    - `fieldName` string — Name of the secret key (values are not returned for security)

## Other responses

- `400` — Bad request - Cannot retrieve image pull secrets
- `401` — Unauthorized - Invalid or missing API key
- `404` — Secret set not found
- `500` — Internal server error

---

[API](https://skmtc.dev/pipecat/apis/pipecat-cloud.md) · [All operations](https://skmtc.dev/pipecat/apis/pipecat-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pipecat/pipecat-cloud/revisions/acd0f7dfe734/schema)