Secrets

Create a secret

Changed on

Create a secret. The value is encrypted at rest and never returned — the response contains only the name. Reference it by name from a tool's auth.

post/secret

Request

  • Base URL
    https://api.smallest.ai/atoms/v1
  • URL
    https://api.smallest.ai/atoms/v1/secret
  • Auth
    HTTP bearer

Request body

namestring required

Secret name (letters, numbers, and underscores). Referenced from a tool's auth.

valuestring required

The secret value. Write-only — encrypted at rest and never returned.

Example request

{
  "name": "ORDER_API_TOKEN",
  "value": "sk_live_xxxxxxxxxxxx"
}

Response

Secret created (name only).

statusboolean

Example response

{
  "status": true,
  "data": {
    "_id": "6a85323f98ca88de9272bb70",
    "name": "ORDER_API_TOKEN"
  }
}

Changes