Create a kubbi

Create a single-content kubbi with one piece of data and a content type. For multi-file packages, see Create a files kubbi.

POST/api/v1/kubbis

Create a kubbi with a single content payload. The request must contain content (not files).

Auth: API key (Bearer token)

Parameters

Field	Type	Required	Description
content	any JSON value	Yes	The data to encrypt (max size depends on your plan)
content_type	string	Yes	`text/plain`, `application/json`, `text/markdown`, or `text/csv`
ttl_seconds	integer	Yes	Time-to-live in seconds (60 – max depends on your plan)
max_retrievals	integer	No	≥ 1 if set; max depends on your plan. Omit or null for unlimited
metadata	object	No	Arbitrary JSON (≤ 1 KB serialized)

Response 201· json

{
  "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
  "claim_url": "https://api.kubbi.ai/r/abc123xyz",
  "claim_token": "abc123xyz",
  "status": "active",
  "content_type": "application/json",
  "max_retrievals": 1,
  "metadata": { "source": "my-app" },
  "created_at": "2026-03-28T12:00:00.000Z",
  "expires_at": "2026-03-28T13:00:00.000Z"
}