Documents

Create a live document

POST
/documents/live

Create a live-collaboration document or sheet. Its content lives in the CRDT and is edited with documents.live_edit or the collab WebSocket. Markdown documents accept optional initial content. Structured data belongs in record types (records.types.create), not in live databases.

Authorization

bearerApiKey
AuthorizationBearer <token>

Create a scoped API key in the Adlass settings.

In: header

Header Parameters

X-Request-Id?string

Optional correlation identifier.

Lengthlength <= 128
Idempotency-Key*string

A unique key for this intended write. Reuse it only for an identical retry.

Length1 <= length <= 200

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/documents/live" \  -H "Idempotency-Key: 123e4567-e89b-42d3-a456-426614174000" \  -H "Content-Type: application/json" \  -d '{    "space_id": "123e4567-e89b-42d3-a456-426614174000",    "file_name": "invoice-2026-09.pdf",    "content_type": "application/vnd.adlass.live-document"  }'
{  "id": "123e4567-e89b-42d3-a456-426614174000",  "tenant_id": "123e4567-e89b-42d3-a456-426614174000",  "workspace_id": "123e4567-e89b-42d3-a456-426614174000",  "space_id": "123e4567-e89b-42d3-a456-426614174000",  "folder_id": "123e4567-e89b-42d3-a456-426614174000",  "uploaded_by": {},  "file_name": "invoice-2026-09.pdf",  "content_type": "application/pdf",  "file_size": 0,  "storage_key": "tenants/acme/customer-documents/invoice-2026-09.pdf",  "status": "ACTIVE",  "created_at": "2026-09-04T12:00:00Z",  "doc_origin": "example",  "live_content_type": "example",  "has_active_collab_session": false}