Create a database row

Create a row (e.g. a task) in a live-database document and fan it out to everyone currently viewing the board. Read the database first for valid property ids and select options.

Authorization

bearerApiKey

AuthorizationBearer <token>

Create a scoped API key in the Adlass settings.

In: header

Path Parameters

document_id*string

Resource identifier: document_id.

Formatuuid

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.

expected_content_hash?string

Lengthlength <= 64

cells*

Maps property ids to string values, e.g. {"title": "Fix login bug", "status": "todo"}. Read the database first to see valid property ids and select options; person properties (e.g. assignee) take a member's user id or email from spaces.members; null clears a cell.

Response Body

`application/json`

`application/problem+json`

curl -X POST "https://example.com/documents/123e4567-e89b-42d3-a456-426614174000/rows" \  -H "Idempotency-Key: 123e4567-e89b-42d3-a456-426614174000" \  -H "Content-Type: application/json" \  -d '{    "cells": {}  }'

{  "document_id": "123e4567-e89b-42d3-a456-426614174000",  "content_hash": "3f786850e387550fdab836ed7e6dc881de23001b",  "changed": false,  "row_id": "example"}

Authorization

Path Parameters

Header Parameters

Request Body

Response Body

201application/json

400application/problem+json

401application/problem+json

402application/problem+json

403application/problem+json

404application/problem+json

405application/problem+json

409application/problem+json

410application/problem+json

413application/problem+json

415application/problem+json

422application/problem+json

429application/problem+json

500application/problem+json

502application/problem+json

503application/problem+json

504application/problem+json

`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`