Create a secret

POST

https://api.smallest.ai/atoms/v1/secret

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.

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Request

This endpoint expects an object.

namestringRequired

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

valuestringRequired

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

Response

Secret created (name only).

statusbooleanOptional

dataobjectOptional

A secret in the org Secrets vault. Write-only: the plaintext value is never returned by the API. Referenced by name from a tool’s auth block; decrypted and injected into the outbound request server-side at call time.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

1	import requests
2
3	url = "https://api.smallest.ai/atoms/v1/secret"
4
5	payload = {
6	"name": "ORDER_API_TOKEN",
7	"value": "sk_live_xxxxxxxxxxxx"
8	}
9	headers = {
10	"Authorization": "Bearer <token>",
11	"Content-Type": "application/json"
12	}
13
14	response = requests.post(url, json=payload, headers=headers)
15
16	print(response.json())

1	{
2	"status": true,
3	"data": {
4	"_id": "6a85323f98ca88de9272bb70",
5	"name": "ORDER_API_TOKEN",
6	"createdAt": "2024-01-15T09:30:00Z",
7	"updatedAt": "2024-01-15T09:30:00Z"
8	}
9	}