> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update an attribute

> Update workspace attributes.

Requires Objects enabled and a verified administrator. Reads require `object_types:read`; writes require `object_types:write`.

Accepts `name`, `slug`, `description`, and `options`. Omitted fields stay unchanged;
`description: null` clears the description. Each option may name an existing `id`
to update, or supply `slug` and `name` to add one. Options also accept `position`
and `archived`. Field type and reference target are immutable. Existing saved
values remain associated with the attribute when its slug changes.

Use the `Idempotency-Key` header for an identical write retry. Through MCP, use `idempotency_key` in the tool arguments.

### Agent proposals

Attribute request tools create unapplied Changesets using `object_types:read` and `object_types:request`. A permitted person reviews and applies them. Create the object type before proposing its attributes, then create records after their fields exist.

### Returns

Returns the affected attribute `id`.