tables

Update a row

Move a row on (Ready to collect, Delivered…) or correct it.

Send any of status (one of the table's status keys), data (the full set of values, replacing the old, checked against the columns) and notes (up to 2,000 characters, or null to clear).

A status change fires table_row.status_changed and the automations listening for it, so a "ready to collect" message can go out the moment your system marks the row ready.

patch/api/v1/tables/{id}/rows/{rowId}

Request

  • Base URL: https://app.blueticked.com
  • URL: https://app.blueticked.com/api/v1/tables/{id}/rows/{rowId}
  • Auth: HTTP bearer

Path parameters

idstring required

The resource's unique identifier.

Request body

statusstring

Example request

{
  "status": "ready"
}

Response

Success

request_idstring required

Example response

{
  "row": {
    "id": "8e2f4a6c-1b3d-4e5f-9a7b-2c4d6e8f0a12",
    "table_id": "3c5e7a9b-2d4f-4a6c-8e0b-1d3f5a7c9e24",
    "source": "api",
    "created_at": "2026-10-01T10:00:00.000Z",
    "updated_at": "2026-10-01T10:00:00.000Z"
  },
  "request_id": "req_b2e3d610e10f1b07468721ee98f0e1d2"
}

Changes

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