v6

latestOpenAPI 3.1.0raw.githubusercontent.com2025-04-245712812.6 KB
Records

Update a record (overwrite multiselect values)

Use this endpoint to update people, companies, and other records by record_id. If the update payload includes multiselect attributes, the values supplied will overwrite/remove the list of values that already exist (if any). Use the PATCH endpoint to append multiselect values without removing those that already exist.

Required scopes: record_permission:read-write, object_configuration:read.

put/v2/objects/{object}/records/{record_id}

Path parameters

objectstring required

A UUID or slug of the object the record belongs to.

Example:people
record_idstring required

A UUID of the record to update.

Example:891dcbfc-9141-415d-9b2a-2238a6cc012d

Request body

Example request

{
  "data": {
    "values": {
      "41252299-f8c7-4b5e-99c9-4ff8321d2f96": "Text value",
      "multiselect_attribute": [
        "Select option 1",
        "Select option 2"
      ]
    }
  }
}

Response

Success

Example response

{
  "data": {
    "id": {
      "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
      "object_id": "97052eb9-e65e-443f-a297-f2d9a4a7f795",
      "record_id": "bf071e1f-6035-429d-b874-d83ea64ea13b"
    },
    "created_at": "2022-11-21T13:22:49.061281000Z"
  }
}