SPspice
Secrets

Create or update an organization secret

Creates an organization secret, or replaces the value of the one with the same name. The value is encrypted at rest and never returned. A name reserved by a platform-managed secret is refused.

post/v1/orgs/{orgId}/secrets

Request

  • Base URL
    https://api.spice.ai
  • Auth
    HTTP bearer

Path parameters

orgIdinteger required

The org id from GET /v1/orgs

Headers

X-Org-Namestring

When present, X-Org-Name must name the same org as orgId. Otherwise the request returns org_path_mismatch (400).

Request body

namestring required
valuestring required

Response

The existing secret's value was replaced

idinteger

Unique identifier for the secret

namestring

Name of the secret

valuestring

Always masked with asterisks

created_atstring date-time

Timestamp when the secret was created

updated_atstring date-time

Timestamp when the secret was last updated

Changes

No recorded changes to this operation across all 1 revision of this API.