Skip to main content
POST
Create Secret

Authorizations

x-api-key
string
header
required

Headers

x-selected-account-id
string | null

Body

application/json

Request body for creating a secret.

key
string
required

Secret name (e.g. openai-api-key). Must be lowercase alphanumeric with hyphens (no dots or underscores), so it maps 1:1 to a valid secret name on every cloud backend (AWS / Azure Key Vault / GCP Secret Manager).

Required string length: 1 - 90
Pattern: ^[a-z0-9]([a-z0-9-]*[a-z0-9])?$
value
string
required

The secret value to store

Minimum string length: 1
description
string

Optional human-readable description

Response

Successful Response

API response model for a secret. Never includes the secret value.

id
string
required
key
string
required
cloud_secret_path
string
required
account_id
string
required
created_at
string<date-time>
required
created_by
Identity · object
required

The identity that created the entity.

object
string
default:sgp_cloud_secret
Allowed value: "sgp_cloud_secret"
description
string
updated_by
string

User who last updated the secret.

updated_at
string<date-time>

Timestamp of last update.