Update Record

PUT 
/objects/:schemaKey/records/:id

Update a Custom Object Record by Id. Supported Objects are business and custom objects. Documentation Link - https://doc.clickup.com/8631005/d/h/87cpx-277156/93bf0c2e23177b0/87cpx-376296

Request

Version stringrequired

API Version

Available options2021-04-15

schemaKey stringrequired

The key of the Custom Object / Standard Object Schema. For custom objects, the key must include the “custom_objects.” prefix, while standard objects use their respective object keys. This information is available on the Custom Objects Details page under Settings.

id stringrequired

id of the record to be updated. Available on the Record details page under the 3 dots or in the url

locationId stringrequired

Your Sub Accounts ID

application/json

application/json

Body

Bodyrequired

configobject

Generic configuration for different object types

Example (auto)

{
  "config": {
    "recurringTask": {
      "frequency": "weekly",
      "interval": 1
    }
  }
}

application/json

Successful response

application/json

Schema

Schema

recordobject

The record matching the requested id

Example (auto)

{
  "record": {
    "id": "661c06b4ffde146bdb469442",
    "owner": [
      "sx6wyHhbFdRXh302Lunr"
    ],
    "followers": [
      "v5cEPM428h8vShlRW1KT"
    ],
    "properties": {
      "pet_name": "Cat",
      "pet_age": 10
    },
    "dateAdded": "2025-01-02T09:35:39.032Z",
    "dateUpdated": "2025-01-02T09:35:39.032Z"
  }
}