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

# Update Item

> Update an item's properties.

## Path Parameters

<ParamField path="id" type="string" required>
  The item ID. Example: `itm_r9f3a`.
</ParamField>

## Body Parameters

All fields are optional. Only include the fields you want to change.

<ParamField body="status" type="string">
  Set to `queue` or `archive`. Inbox items can be moved to `queue` or `archive`, but items cannot be moved back to `inbox`.
</ParamField>

<ParamField body="is_favorite" type="boolean">
  Set to `true` to favorite, `false` to unfavorite.
</ParamField>

<ParamField body="reading_progress" type="number">
  Reading progress as a float from `0.0` to `1.0`.
</ParamField>

## Response

Returns the updated item.

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH https://api.getmatter.com/public/v1/items/itm_r9f3a \
    -H "Authorization: Bearer mat_your_token_here" \
    -H "Content-Type: application/json" \
    -d '{"status": "archive", "is_favorite": true}'
  ```

  ```python Python theme={null}
  response = requests.patch(
      "https://api.getmatter.com/public/v1/items/itm_r9f3a",
      headers={
          "Authorization": f"Bearer {token}",
          "Content-Type": "application/json"
      },
      json={"status": "archive", "is_favorite": True}
  )
  item = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "object": "item",
    "id": "itm_r9f3a",
    "title": "How to Do Great Work",
    "url": "https://paulgraham.com/greatwork.html",
    "status": "archive",
    "is_favorite": true,
    "reading_progress": 0.75,
    "updated_at": "2026-03-30T20:00:00Z"
  }
  ```
</ResponseExample>