Skip to main content
POST
Create Secret
Stores a named secret for the organization that owns your API key and returns its ID. Use the ID to read, update, or delete the secret.
Response:
Secret values are write-only. They are stored in Google Cloud Secret Manager, and no endpoint returns them, so keep your own copy if you need it.
Names are unique within your organization and can’t be changed later. Creating a secret with a name that’s already in use returns 409. Your API key must belong to an organization, otherwise the request returns 404.

Authorizations

X-API-KEY
string
header
required

Body

application/json
name
string
required

Secret name. Unique within your organization and cannot be changed later.

Minimum string length: 1
value
string
required

Secret value. Write-only: no endpoint returns it.

Minimum string length: 1

Response

Successful Response

id
string
required

ID of the new secret.