---
title: "Update inbox thread attention"
method: PATCH
path: "/mailboxes/{id}/inbox/threads/{thread_id}"
tags: ["Mailboxes"]
---

# Update inbox thread attention

`PATCH /mailboxes/{id}/inbox/threads/{thread_id}`

## Request

- Base URL: `https://shipmail.to/api/v1`
- URL: `https://shipmail.to/api/v1/mailboxes/{id}/inbox/threads/{thread_id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://shipmail.to/api/auth/oauth2/authorize`, token URL `https://shipmail.to/api/auth/oauth2/token`)

Complete, reopen, or schedule follow-up for a thread using optimistic version concurrency.

## Headers

- `X-Shipmail-Organization` string

## Request body

- union
  - object
    - `done` boolean, required
    - `follow_up_at` string, date-time, nullable
    - `expected_version` integer, required
  - object
    - `done` boolean
    - `follow_up_at` string, date-time, nullable, required
    - `expected_version` integer, required

## Response `200`

Updated attention state.

- InboxThreadAttentionResult
  - `object` 'inbox_thread_attention', required
  - `id` string, required
  - `thread_id` string, required: Deprecated and not stable: a legacy thread ID that changes when the mail server re-threads its IDs or a relayed send's placeholder key is replaced. It remains supported in thread paths; store conversation_id instead.
  - `conversation_id` string, required: Stable Shipmail conversation identifier (thd_...). Store this: it survives thread merges and mail-server re-threading, which thread_id does not.
  - `attention_state` 'needs_reply' | 'waiting_on_them' | 'done' | 'follow_up_due' | 'delivery_failed' | 'no_action', required
  - `version` integer, required
  - `attention_since` string, date-time, nullable, required
  - `done_at` string, date-time, nullable, required
  - `follow_up_at` string, date-time, nullable, required

## Other responses

- `401`: Authentication failed.
- `403`: Insufficient permissions.
- `404`: Resource not found.
- `409`: Resource conflict.
- `422`: Validation failed.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/shipmail/apis/shipmail-api.md) · [All operations](https://skmtc.dev/shipmail/apis/shipmail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/shipmail/apis/shipmail-api/revisions/2c23e59d7e30?raw)