Skip to main content
PATCH
/
v1
/
items
/
{id}
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}'
{
  "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"
}

Path Parameters

id
string
required
The item ID. Example: itm_r9f3a.

Body Parameters

All fields are optional. Only include the fields you want to change.
status
string
Set to queue or archive. Inbox items can be moved to queue or archive, but items cannot be moved back to inbox.
is_favorite
boolean
Set to true to favorite, false to unfavorite.
reading_progress
number
Reading progress as a float from 0.0 to 1.0.

Response

Returns the updated item.
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}'
{
  "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"
}