# Attribute lists

> An Attribute list is an attribute with a predefined set of options that categories can carry.

An **Attribute list** is an attribute whose values come from a **predefined set of options** - think "Color" with values Red, Green, Blue, or "Size" with S, M, L. It has a translatable `name` and the `categories` it applies to.

The attribute is the definition; each option is an [Attribute list value](/api/product-management/attribute-list-values/), and a product references the option(s) that apply to it.

## The Attribute list object

## Conventions

All requests require an OAuth 2.0 bearer token and the organization scope header:

```
Authorization: Bearer <token>
X-Flowkiwi-Organization-Id: <organization-id>
```

For the translatable `name`, set `X-Flowkiwi-Locale` (and optionally `X-Flowkiwi-Locale-Fallback`). `PATCH` uses [JSON Merge Patch](https://datatracker.ietf.org/doc/html/rfc7396).