Skip to main content
POST
Commit at most 1,000 create/update/delete mutations atomically. With repair, accept only revision-bound updates as a durable operator repair job; require a personal admin with installation:manage and rows:write, current permission checks for the target, schema, revisions, values and reason. Ordinary batches return the synchronous result.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key
string
required

Bound to actor, operation, target, schema version and canonical payload; changed input returns 409.

Required string length: 8 - 255

Path Parameters

orgId
string
required
Pattern: ^[0-7][0-9A-HJKMNP-TV-Z]{25}$
databaseId
string
required
Pattern: ^[0-7][0-9A-HJKMNP-TV-Z]{25}$
tableId
string
required
Pattern: ^[0-7][0-9A-HJKMNP-TV-Z]{25}$

Body

application/json
expectedSchemaVersion
integer
required
Required range: 1 <= x <= 2147483647
mutations
object[]
required
Required array length: 1 - 1000 elements
repair
object

Response

Committed synchronous result or accepted durable job; polling is required for terminal verification.

mutationId
string
required
Pattern: ^[0-7][0-9A-HJKMNP-TV-Z]{25}$
results
object[]
required
Maximum array length: 1000