> ## 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`, `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`. An attribute's `slug`, field type and reference target can't
change after creation; rename the attribute with `name`.

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`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.