custom_data

Claim Custom Row

Atomically take one matching row and mark it.

The operation a query plus an upsert cannot express: two callers doing that both read the same row before either writes, and upsert has no precondition to refuse the second. Here the select and the mark are one statement.

An empty result is a 200 with found: false — running out of rows is an answer the caller acts on, not an error.

post/core/custom-data/tables/{name}/claim

Request

  • Base URL
    https://api.anyreach.ai (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

namestring required

Headers

x-anyreach-orgstring nullable

Organization ID for user PATs (pat_ prefix tokens)

Request body

patchobject required

Declared properties to set on the claimed row, merged over what is already there. Cannot include the row key.

Response

Successful Response

foundboolean required
recordobject nullable

Changes

No recorded changes to this operation across all 1 revision of this API.