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.

Supported token levels: workspace, user.

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

cURL

Attribute values

curl --request PUT \ --url https://api.attio.com/v2/objects/{object}/records/{record_id} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "data": { "values": { "name": "Alice Adams", "email_addresses": [ "[e-mail]" ] } } } '

200

{
  "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",
    "web_url": "https://app.attio.com/salarya/person/bf071e1f-6035-429d-b874-d83ea64ea13b",
    "values": {}
  }
}

Authorizations

Authorization · string · header · required

This API uses OAuth 2.0 with the authorization code grant flow.

Path Parameters

object · string · required

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

Example:

"people"

record_id · string · required

A UUID of the record to update.

Example:

"891dcbfc-9141-415d-9b2a-2238a6cc012d"

Body

application/json

data · object · required

Show child attributes

Response

200

application/json

Success

Success

data · object · required

Show child attributes