Create or update a secret

PUT

/api/v1/secrets/{name}

Store an encrypted secret. Encrypted with AES-256-GCM (per-secret IV + auth tag). Secrets are injected as environment variables during execution.

Naming: UPPER_SNAKE_CASE (e.g., OPENAI_API_KEY)

Values are never logged or returned in API responses.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Secret stored successfully

Body

🟠400BadRequest

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

cURL

Store an API keyStore a database password

curl --location --request PUT '/api/v1/secrets/' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "value": "sk-proj-abc123...",
    "description": "OpenAI production API key"
}'

Response Example

200 - Example 1

{
    "id": 0,
    "name": "string",
    "description": "string",
    "created_at": "2019-08-24T14:15:22.123Z",
    "updated_at": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-04-04 08:23:21

Execute code

Delete a secret