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

# Features

> Read and write Tylon features — the grouping that follows one thing being built across many cards.

A feature groups the cards that deliver one thing across time.

## Reading them

<ParamField path="GET /v1/features" type="endpoint" />

<ParamField query="archived" type="string">
  `1` to include the archived ones. Off by default: an archived feature is one
  somebody decided to stop looking at.
</ParamField>

`featureId` on [`PATCH /v1/cards/{number}`](/en/api-reference/endpoints/cards)
comes from here.

## Writing them

Member, except deleting.

<ParamField path="POST /v1/features" type="endpoint" />

<ParamField body="name" type="string" required>
  Up to 60 characters.
</ParamField>

<ParamField body="description" type="string" />

<ParamField body="color" type="string" />

```json theme={null}
{
  "id": "84842202542510070",
  "name": "Key rotation",
  "description": "",
  "color": "blue",
  "taskCount": 0,
  "doneCount": 0,
  "archived": false,
  "position": 0
}
```

`doneCount` against `taskCount` is the reading worth putting on a dashboard:
it counts cards that actually reached the end of the flow, not cards somebody
ticked.

<ParamField path="PATCH /v1/features/{featureId}" type="endpoint" />

<ParamField path="DELETE /v1/features/{featureId}" type="endpoint" />

Deleting takes **maintainer**, the same as on screen.