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

# Create an attribute

> Create workspace attributes.

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

Supply `object` (such as `objects.equipment`), `slug`, `name`, and `type`.
Types are `string`, `date`, `select`, `reference`, `number`, `boolean`, and `money`.
Optional `description` explains the field. Select fields accept `options`, an
array of `{ "slug": "laptop", "name": "Laptop" }`. Reference fields require
`reference_object`, the target object type key. The referenced type must already exist.

```json theme={null}
{ "object": "objects.equipment", "slug": "serial", "name": "Serial number", "type": "string" }
```

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