Update record

PATCH/v1/bases/{baseId}/records/{recordId}

Authorization

bearerAuth

AuthorizationBearer <token>

API token issued from the dashboard (Settings → API Tokens). Sent as Authorization: Bearer <token>.

In: header

Path Parameters

baseId*string

Match

^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Formatuuid

recordId*string

Match

^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

tableId*string

Which table to write into.

Match

^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Formatuuid

data*

Column-keyed payload for the new row.

version?integer

Optimistic-concurrency guard: pass the version you last read — 409 when the row moved since then.

Range0 < value <= 9007199254740991

Response Body

`application/json`

cURL

curl -X PATCH "https://example.com/bases/497f6eca-6276-4993-bfeb-53cbbbba6f08/records/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "tableId": "073fbfcb-cd05-4203-be18-a1ce6f8e4d2d",    "data": {      "property1": null,      "property2": null    }  }'

{
  "record": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "tableId": "073fbfcb-cd05-4203-be18-a1ce6f8e4d2d",
    "orgId": "25b2c2d5-a7fc-47d0-89e4-8709a1560bfa",
    "data": {
      "property1": null,
      "property2": null
    },
    "computedData": {
      "property1": null,
      "property2": null
    },
    "version": -9007199254740991,
    "createdBy": "25a02396-1048-48f9-bf93-102d2fb7895e",
    "updatedBy": "b0efe45f-0520-4e21-90f0-7e35f137732e",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
  }
}

{
  "error": "validation_failed",
  "message": "string",
  "issues": null
}

{
  "error": "unauthorized"
}

{
  "success": false,
  "error": "API key lacks write permission"
}

{
  "error": "validation_failed",
  "message": "string",
  "issues": null
}

{
  "error": "validation_failed",
  "message": "string",
  "issues": null
}

Authorization

Path Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

409application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`