Skip to main content
PUT
/
secrets
/
{setName}
curl --request PUT \
  --url https://api.pipecat.daily.co/v1/secrets/{setName} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "secrets": [
    {
      "secretKey": "API_KEY",
      "secretValue": "your-api-key"
    },
    {
      "secretKey": "DATABASE_URL",
      "secretValue": "postgresql://user:pass@host:5432/db"
    }
  ],
  "region": "us-west"
}
'
{
  "status": "OK",
  "region": "us-west"
}

Authorizations

​
Authorization
string
header
required

Authentication requires a Pipecat Cloud Private API token.

Generate a Private API key from your Dashboard (Settings > API Keys > Private > Create key) and include it as a Bearer token in the Authorization header.

Path Parameters

​
setName
string
required

Name of the secret set to create or update

Required string length: 3 - 63

Body

application/json
​
secrets
object[]
required

Array of secret key-value pairs

Minimum array length: 1
​
region
string

The region where the secret set will be created. If not specified, defaults to the organization's default region. Secrets must be in the same region as the agents that use them. Cannot be changed after creation.

Example:

"us-west"

Response

Secret set successfully created or updated

​
status
enum<string>
required
Available options:
OK
​
region
string
required

The region where the secret set was created or exists