Update a record.

Update a record.

Send only what changes. data is keyed by field slug, never by field name or label; a key you omit keeps its value, and an empty value clears the field (a required field cannot be cleared). relations is keyed by relation slug and replaces the links of each relation you send. admin_slug changes the owner and is ignored when the credential may not assign records; null removes the owner.

The same values are dropped as on create and listed in dropped_fields. To upload files, send multipart/form-data as on create; in data, a file or photo field then lists the stored files to keep.

The response is the whole record after the write, computed fields included, in the same shape as a record read. _meta.pending_fields names fields whose value a background recalculation will still replace.

Scope: update.<object slug>, for example update.contacts.

Errors:

• 400 — no record has that slug, a value is invalid (the message starts Validation failed:), a status change is not an allowed transition, a linked record in relations cannot be found or seen, a file is rejected, or no active object has that slug.
• 403 — the credential may not edit this record.
• 409 — another record already has the same value in a unique field.
• 422 — the body is invalid, for example data is not an object.

Request:

{
  "data": { "stage-k2j9h4g7": "b2c4d6e8-1a3b-4c5d-8e7f-9a0b1c2d3e4f" }
}

Response 200:

{
  "status": 200,
  "message": "Data updated successfully",
  "data": {
    "title-mpoc3dn1": "Sara Ali",
    "assignees": [
      {
        "type": "user",
        "slug": "a3f1b2c8e9d7",
        "name": "Omar Hassan",
        "email": "omar@example.com",
        "profile_image": null
      }
    ],
    "email-p0zx7c1v": "sara@example.com",
    "stage-k2j9h4g7": [
      {
        "id": "b2c4d6e8-1a3b-4c5d-8e7f-9a0b1c2d3e4f",
        "value": "customer",
        "label": "Customer",
        "color": "#10B981",
        "icon": null
      }
    ],
    "name": "Sara Ali",
    "relations": {
      "company-mf3k2p9a": {
        "items": [
          {
            "type": "relation",
            "name": "Acme Inc",
            "label": "Acme Inc",
            "slug": "2e8b5d1f7c4a",
            "random_id": "7d3e9a1c",
            "object_slug": "companies",
            "object_name": "Companies",
            "object_icon": "tabler-building"
          }
        ],
        "pagination": {
          "total": 1,
          "page": 1,
          "limit": 10,
          "totalPages": 1,
          "nextPage": null,
          "prevPage": null
        }
      }
    },
    "slug": "9f2c4b7a1e03",
    "random_id": "5c0e7a9b",
    "createdAt": "2026-09-14T10:00:00.000Z",
    "updatedAt": "2026-09-14T11:30:00.000Z",
    "position": "1000",
    "creator": {
      "type": "user",
      "slug": "a3f1b2c8e9d7",
      "name": "Omar Hassan",
      "email": "omar@example.com",
      "profile_image": null
    },
    "updater": {
      "type": "user",
      "slug": "a3f1b2c8e9d7",
      "name": "Omar Hassan",
      "email": "omar@example.com",
      "profile_image": null
    },
    "linked_record": null,
    "capabilities": {
      "can_edit": true,
      "can_delete": true,
      "can_assign": true
    }
  },
  "_meta": { "enriched": true }
}