Update a record (append multiselect values)

v1.0.0

Use this endpoint to update people, companies, and other records by record_id. If the update payload includes multiselect attributes, the values supplied will be created and prepended to the list of values that already exist (if any). Use the PUT endpoint to overwrite or remove multiselect attribute values.

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

Input

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "values"
      ],
      "properties": {
        "values": {
          "type": "object",
          "description": "An object with an attribute `api_slug` or `attribute_id` as the key, and a single value (for single-select attributes), or an array of values (for single or multi-select attributes) as the values. For complete documentation on values for all attribute types, please see our [attribute type docs](/docs/attribute-types)."
        }
      },
      "additionalProperties": false
    },
    "object": {
      "type": "string",
      "description": "A UUID or slug of the object the record belongs to."
    },
    "record_id": {
      "type": "string",
      "description": "A UUID of the record to update."
    }
  },
  "required": [
    "data",
    "object",
    "record_id"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "description": "Success",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "object",
      "required": [
        "created_at",
        "id",
        "values",
        "web_url"
      ],
      "properties": {
        "created_at": {
          "type": "string",
          "description": "When this record was created."
        },
        "id": {
          "type": "object",
          "required": [
            "object_id",
            "record_id",
            "workspace_id"
          ],
          "properties": {
            "object_id": {
              "type": "string",
              "format": "uuid",
              "description": "A UUID identifying the object this record belongs to."
            },
            "record_id": {
              "type": "string",
              "format": "uuid",
              "description": "A UUID identifying this record."
            },
            "workspace_id": {
              "type": "string",
              "format": "uuid",
              "description": "A UUID identifying the workspace this record belongs to."
            }
          }
        },
        "values": {
          "type": "object",
          "description": "A record type with an attribute `api_slug` as the key, and an array of value objects as the values."
        },
        "web_url": {
          "type": "string",
          "format": "uri",
          "description": "A URL that links directly to the record page in the Attio web application."
        }
      }
    }
  }
}