v1

latestOpenAPI 3.1.02026-07-26157321426.3 KB

Upserts a secret

Creates or updates a secret by name. Scoped to the caller's primary team; use the team-scoped variant to target a specific team.

post/v1/secrets

namestring required

Name of the new or existing secret

valuestring required

Value of the secret

{
  "name": "my_secret",
  "value": "my_secret_value"
}

idstring required

Stable identifier for the secret. Unchanged across rotation.

created_atstring date-time required

Time the secret was created in ISO 8601 format

namestring required

Name of the secret

team_namestring required

Name of the team the secret belongs to

{
  "id": "3kZ9xqd"
}