Update Object Schema By Key / Id

PUT 
/objects/:key

Update Custom Object Schema or standard object's like contact, opportunity, business searchable fields. To understand objects and records, please have a look at the documentation here : https://doc.clickup.com/8631005/d/h/87cpx-277156/93bf0c2e23177b0

Request

Version stringrequired

API Version

Available optionsv3

key stringrequired

key of the custom or standard object. For custom objects, the key must include the prefix “custom_objects.”. This key can be found on the Object Details page under Settings in the UI.

application/json

application/json

Body

Bodyrequired

labelsobject

This is how your custom object will be displayed

descriptionstringnullable

Pet Object`s description

locationIdstringrequired

location id

searchablePropertiesstring[]required

Searchable Fields: Provide the field key of your object that you want to search on, using the format (custom_object.<object_name>.<field_key>).

uniquePropertiesobject

Update unique properties. Only removing unique properties is allowed through the API.

Example (auto)

{
  "labels": {
    "singular": "Pet",
    "plural": "Pets"
  },
  "description": "These are non vaccinated pets",
  "locationId": "632c34b4c9b7da3358ac9891",
  "searchableProperties": [
    "custom_objects.mad.mad",
    "custom_objects.mad.record_1",
    "custom_objects.mad.nn"
  ],
  "uniqueProperties": {
    "remove": [
      "custom_objects.pet.tag_number"
    ]
  }
}

application/json

Successful response

application/json

Schema

Schema

objectobject

The custom or standard object schema

Example (auto)

{
  "object": {
    "id": "661c06b4ffde146bdb469442",
    "standard": false,
    "key": "custom_objects.pet",
    "labels": {
      "singular": "Pet",
      "plural": "Pets"
    },
    "description": "These are non vaccinated pets",
    "locationId": "ve9EPM428h8vShlRW1KT",
    "primaryDisplayProperty": "custom_objects.pet.name",
    "type": "USER_DEFINED",
    "dateAdded": "2025-01-02T09:35:39.032Z",
    "dateUpdated": "2025-01-02T09:35:39.032Z"
  }
}