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

# Archive a Project To-do

> Retire an item with an audited reason, closing its open assignments while retaining history.

Archives one item: it leaves the active catalog, future-hire auto-assignment turns off, and every open assignment closes with your reason recorded in each person's history. Completed, waived, and already-closed history is retained. Requires `project_todos:write` and employer access to the job.

Preview first with [`preflight`](/docs/developers/api-reference/project-todos/preflight) (`operation: "archive_item"`) — it returns the exact number of open assignments that would close.

<ParamField body="action" type="string" required>`archive_item`</ParamField>

<ParamField body="idempotencyKey" type="string" required />

<ParamField body="jobId" type="string" required />

<ParamField body="itemId" type="string" required />

<ParamField body="reason" type="string" required>
  Audited and kept on every closed assignment (up to 2,000 characters).
</ParamField>

## Response

```json theme={null}
{
  "ok": true,
  "action": "archive_item",
  "itemId": "…",
  "archive": {
    "closedAssignments": 2,
    "closedAssignmentIds": ["…", "…"],
    "irreversible": true,
    "historyRetained": true
  }
}
```

Archiving cannot be undone through this surface. To require the work again, create a new item.