---
title: "PATCH /data/v1/objects/{object_name}/attributes/{attribute_name}"
method: PATCH
path: "/data/v1/objects/{object_name}/attributes/{attribute_name}"
tags: ["Data", "Object Attributes"]
---

# PATCH /data/v1/objects/{object_name}/attributes/{attribute_name}

`PATCH /data/v1/objects/{object_name}/attributes/{attribute_name}`

## Path parameters

- `object_name` string, required
- `attribute_name` string, required

## Request body

- union — Definition of an attribute on a Unify object.
  - object — Base properties that define an attribute on a Unify object.
    - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
    - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
  - object — Base properties that define an attribute on a Unify object.
    - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
    - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
  - object — Base properties that define an attribute on a Unify object.
    - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
    - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
  - object — Base properties that define an attribute on a Unify object.
    - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
    - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
  - object — Base properties that define an attribute on a Unify object.
    - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
    - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
  - object — Base properties that define an attribute on a Unify object.
    - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
    - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
  - object — Base properties that define an attribute on a Unify object.
    - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
    - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
  - object — Base properties that define an attribute on a Unify object.
    - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
    - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
  - object — Base properties that define an attribute on a Unify object.
    - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
    - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
  - UObjectsUMultiSelectAttributeUpdate — Base properties that define an attribute on a Unify object.
    - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
    - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
  - object — Base properties that define an attribute on a Unify object.
    - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
    - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
  - UObjectsUReferenceAttributeUpdate — Base properties that define an attribute on a Unify object.
    - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
    - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
  - UObjectsUSelectAttributeUpdate — Base properties that define an attribute on a Unify object.
    - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
    - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
  - object — Base properties that define an attribute on a Unify object.
    - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
    - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
  - object — Base properties that define an attribute on a Unify object.
    - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
    - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
  - object — Base properties that define an attribute on a Unify object.
    - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
    - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.

## Response `200`

Response for a successful update operation.

- object — Response for a successful update operation.
  - `status` 'success', required
  - `data` union, required — Definition of an attribute on a Unify object.
    - object — Base properties that define an attribute on a Unify object.
      - `type` 'ADDRESS', required — The type of value this attribute can hold.
      - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
      - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
      - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
      - `is_required` boolean, required — Whether the attribute is required.
      - `is_unique` boolean, required — Whether the attribute is unique.
    - object — Base properties that define an attribute on a Unify object.
      - `type` 'BOOLEAN', required — The type of value this attribute can hold.
      - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
      - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
      - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
      - `is_required` boolean, required — Whether the attribute is required.
      - `is_unique` boolean, required — Whether the attribute is unique.
    - object — Base properties that define an attribute on a Unify object.
      - `type` 'COUNTRY', required — The type of value this attribute can hold.
      - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
      - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
      - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
      - `is_required` boolean, required — Whether the attribute is required.
      - `is_unique` boolean, required — Whether the attribute is unique.
    - object — Base properties that define an attribute on a Unify object.
      - `type` 'CURRENCY', required — The type of value this attribute can hold.
      - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
      - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
      - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
      - `is_required` boolean, required — Whether the attribute is required.
      - `is_unique` boolean, required — Whether the attribute is unique.
    - object — Base properties that define an attribute on a Unify object.
      - `type` 'DATE', required — The type of value this attribute can hold.
      - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
      - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
      - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
      - `is_required` boolean, required — Whether the attribute is required.
      - `is_unique` boolean, required — Whether the attribute is unique.
    - object — Base properties that define an attribute on a Unify object.
      - `type` 'DATETIME', required — The type of value this attribute can hold.
      - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
      - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
      - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
      - `is_required` boolean, required — Whether the attribute is required.
      - `is_unique` boolean, required — Whether the attribute is unique.
    - object — Base properties that define an attribute on a Unify object.
      - `type` 'DECIMAL', required — The type of value this attribute can hold.
      - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
      - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
      - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
      - `is_required` boolean, required — Whether the attribute is required.
      - `is_unique` boolean, required — Whether the attribute is unique.
    - object — Base properties that define an attribute on a Unify object.
      - `type` 'EMAIL_ADDRESS', required — The type of value this attribute can hold.
      - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
      - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
      - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
      - `is_required` boolean, required — Whether the attribute is required.
      - `is_unique` boolean, required — Whether the attribute is unique.
    - object — Base properties that define an attribute on a Unify object.
      - `type` 'INTEGER', required — The type of value this attribute can hold.
      - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
      - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
      - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
      - `is_required` boolean, required — Whether the attribute is required.
      - `is_unique` boolean, required — Whether the attribute is unique.
    - UObjectsUMultiSelectAttribute — Base properties that define an attribute on a Unify object.
      - `type` 'MULTI_SELECT', required — The type of value this attribute can hold.
      - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
      - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
      - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
      - `is_required` boolean, required — Whether the attribute is required.
      - `is_unique` boolean, required — Whether the attribute is unique.
    - object — Base properties that define an attribute on a Unify object.
      - `type` 'PHONE_NUMBER', required — The type of value this attribute can hold.
      - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
      - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
      - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
      - `is_required` boolean, required — Whether the attribute is required.
      - `is_unique` boolean, required — Whether the attribute is unique.
    - UObjectsUReferenceAttribute — Base properties that define an attribute on a Unify object.
      - `type` 'REFERENCE', required — The type of value this attribute can hold.
      - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
      - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
      - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
      - `is_required` boolean, required — Whether the attribute is required.
      - `is_unique` boolean, required — Whether the attribute is unique.
    - UObjectsUSelectAttribute — Base properties that define an attribute on a Unify object.
      - `type` 'SELECT', required — The type of value this attribute can hold.
      - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
      - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
      - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
      - `is_required` boolean, required — Whether the attribute is required.
      - `is_unique` boolean, required — Whether the attribute is unique.
    - object — Base properties that define an attribute on a Unify object.
      - `type` 'TEXT', required — The type of value this attribute can hold.
      - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
      - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
      - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
      - `is_required` boolean, required — Whether the attribute is required.
      - `is_unique` boolean, required — Whether the attribute is unique.
    - object — Base properties that define an attribute on a Unify object.
      - `type` 'URL', required — The type of value this attribute can hold.
      - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
      - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
      - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
      - `is_required` boolean, required — Whether the attribute is required.
      - `is_unique` boolean, required — Whether the attribute is unique.
    - object — Base properties that define an attribute on a Unify object.
      - `type` 'UUID', required — The type of value this attribute can hold.
      - `api_name` string, required — This is the unique identifier for the attribute at the API level. It is unique within the object and cannot be changed.
      - `display_name` string, required — This is the user-facing attribute name that will be shown within Unify. It is unique within the object and can be changed at any time.
      - `description` string, nullable, required — This is a description of the attribute. It is not required but will be shown in the UI to help understand the purpose of the object. Typically, this should be a short sentence or two explaining the attribute.
      - `is_required` boolean, required — Whether the attribute is required.
      - `is_unique` boolean, required — Whether the attribute is unique.

## Other responses

- `400` — Response for any operation that results in a bad request error.
- `401` — Response for any operation that results in an unauthorized error.
- `404` — Response for any operation that results in a not found error.
- `409` — Response for any operation that results in a conflict error.
- `500` — Response for any operation that results in an internal server error.

## Changes

- **2026-04-14** `8f2318f5f13a` — 13 breaking, 12 info
  - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7, subschema #8, subschema #9, subschema #11, subschema #14, subschema #15, subschema #16` from the request body `anyOf` list
  - added `#/components/schemas/UObjects.URelatedReferenceAttribute` to the `anyOf[#/components/schemas/UObjects.UReferenceAttributeUpdate]/related_attribute` request property `allOf` list
  - removed `#/components/schemas/UObjects.URelatedReferenceAttribute, subschema #2` from the `anyOf[#/components/schemas/UObjects.UReferenceAttributeUpdate]/related_attribute` request property `anyOf` list
  - request property `anyOf[#/components/schemas/UObjects.UMultiSelectAttributeUpdate]/allOf[subschema #1]/description` list-of-types was narrowed by removing types `null` from media type `application/json`
  - …21 more
- **2026-04-13** `6c8df028bd7e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/unifygtm/apis/unify-api/changes/data/v1/objects/:object_name/attributes/:attribute_name/patch.md)

---

[API](https://skmtc.dev/unifygtm/apis/unify-api.md) · [All operations](https://skmtc.dev/unifygtm/apis/unify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unifygtm/unify-api/revisions/832b8061b7a4/schema)
