Create Secret

Create a new encrypted secret for the authenticated user’s space.

This endpoint:

• Requires API key authentication
• Encrypts the secret value using AWS KMS
• Stores the encrypted value in the database
• Returns metadata about the created secret (including id for future reference)

Args: service: Injected secrets service payload: Request containing secret_name and secret_value

Returns: Response with created secret metadata including id

Raises: 400 Bad Request: If user doesn’t have an associated space 500 Internal Server Error: If encryption or storage fails

POST /v1/secrets

Create Secret

cURL

curl --request POST \
  --url https://api.example.com/v1/secrets \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "secret_name": "<string>",
  "secret_value": "<string>",
  "secret_type": "OPENAI_API_KEY"
}
'

200

{
  "code": 100,
  "data": {
    "id": "<string>",
    "secret_name": "<string>"
  },
  "message": "<string>"
}

Authorizations

APIKeyHeaderHTTPBearer

X-API-KEY · string · header · required

Cookies

la_session · string

Body

application/json

Request schema for creating a new secret

secret_name · string · required

Name of the secret

Required string length: 1 - 255

secret_value · string · required

The secret value to encrypt and store

Minimum string length: 1

secret_type · enum<string> · required

The type of secret

Available options: OPENAI_API_KEY, ELEVENLABS_API_KEY

Response

200

application/json

Successful Response

code · integer · default: 100

data · CreateSecretResponseSchema · object

Response schema after creating a secret

Show child attributes

message · string