Skip to main content
PATCH
/
v1
/
{target}
/
{identifier}
/
attributes
/
{attribute}
Update an attribute
curl --request PATCH \
  --url https://api.connect-crm.com/v1/{target}/{identifier}/attributes/{attribute} \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "description": "<string>",
  "type": "<string>",
  "is_required": true,
  "is_unique": true,
  "is_multi_select": true,
  "default_value": "<string>",
  "config": {
    "currency": null,
    "record_reference": {
      "allowed_object_ids": [
        "9293961c-df93-4d6d-a2cc-fc3e353b2d10"
      ]
    }
  }
}
'
{
  "data": {
    "id": {
      "workspace_id": "9293961c-df93-4d6d-a2cc-fc3e353b2d10",
      "object_id": "9293961c-df93-4d6d-a2cc-fc3e353b2d10",
      "attribute_id": "9293961c-df93-4d6d-a2cc-fc3e353b2d10"
    },
    "created_at": "2024-09-04T20:45:09Z",
    "archived_at": "2024-09-04T20:45:09Z",
    "slug": "<string>",
    "title": "<string>",
    "type": "<string>",
    "description": "<string>",
    "is_required": true,
    "is_unique": true,
    "is_multi_select": true,
    "is_system_attribute": true,
    "config": {
      "currency": null,
      "record_reference": {
        "allowed_object_ids": [
          "9293961c-df93-4d6d-a2cc-fc3e353b2d10"
        ]
      }
    },
    "relationship": {
      "id": {
        "attribute_id": "9293961c-df93-4d6d-a2cc-fc3e353b2d10",
        "object_id": "9293961c-df93-4d6d-a2cc-fc3e353b2d10"
      }
    },
    "sort_order": 1,
    "default_value": "Default Value"
  }
}

Path Parameters

​
target
enum<string>
required

Whether the attributes are on an object.

Available options:
objects
​
identifier
string
required

A UUID or slug to identify the object.

​
attribute
string<uuid>
required

A UUID or slug to identify the attribute.

Body

application/json
​
title
string
required

The name of the attribute.

​
description
string | null
required

A text description for the attribute.

​
type
string
required

The type of the attribute. This value affects the possible config values.

​
is_required
boolean
required

When is_required is true, new records/entries must have a value for this attribute. If false, values may be null. This value does not affect existing data and you do not need to back-fill null values if changing is_required from false to true.

​
is_unique
boolean
required

Whether or not new values for this attribute must be unique. Uniqueness restrictions are only applied to new data and do not apply retroactively to previously created data.

​
is_multi_select
boolean
required

Whether or not this attribute can have multiple values. Multiselect is only available on some value types.

​
default_value
string | null
required

The default value for the attribute.

​
config
object
required

Response

Success

​
data
object
required