---
title: "Update a thread"
method: PATCH
path: "/inbox/threads/{id}"
tags: ["Inbox"]
---

# Update a thread

`PATCH /inbox/threads/{id}`

## Request

- Base URL: `https://api.rizamo.com/v1`
- URL: `https://api.rizamo.com/v1/inbox/threads/{id}`
- Auth: HTTP bearer

Marks it done or open, read or unread, or hands it to a teammate who reaches its profile (`assigneeId`). Nothing is sent to the network.

## Path parameters

- `id` string, required: The thread's id (`thr_`).

## Request body

- object
  - `status` 'open' | 'done': done closes it; a new message opens it again.
  - `unread` boolean: True marks it unread, false read.
  - `assigneeId` string, nullable: Hand it to a teammate who reaches its profile, by user id (`user_`, from List members): an agent passing it to a person. Null unassigns.

## Response `200`

OK

- Thread
  - `id` string, required
  - `profileId` string, required
  - `accountId` string, required
  - `network` 'instagram' | 'facebook' | 'threads' | 'linkedin' | 'tiktok' | 'youtube' | 'x' | 'pinterest' | 'google', required
  - `kind` 'comment' | 'dm' | 'mention' | 'review', required: comment: a first comment on a post, with the replies under it. dm: private messages with one person. mention and review: not collected yet.
  - `contact` Contact, nullable, required
    - `name` string, required
    - `handle` string, required
    - `initials` string, required
    - `color` string, required
    - `avatarUrl` string, nullable, required: Their picture. On Facebook, Instagram, Threads, TikTok and LinkedIn, whose own links expire, a small copy Rizamo keeps, on Rizamo's media host: the link works for a few hours, so get the thread again for a fresh one. The network's own link elsewhere, and until the copy is made. Null when the network gives none, or its link expired with no copy.
  - `postId` string, nullable, required: Comments: the Rizamo post (`post_`) the comment is on, when it went out through Rizamo. Null on posts made elsewhere, and for messages.
  - `networkPostId` string, nullable, required: Comments: the post they are on (`npost_`), as `Get a post on a network` returns it, once Rizamo has listed it.
  - `preview` string, required: The newest message's text, empty when that message has none.
  - `lastMessageAt` string, date-time, required
  - `unread` boolean, required
  - `status` 'open' | 'done', required
  - `assignee` union, required
    - object
      - `type` 'agent', required
      - `agent` 'claude' | 'chatgpt' | 'claudecode' | 'cursor' | 'codex' | 'gemini' | 'perplexity' | 'openclaw' | 'n8n' | 'make' | 'zapier', nullable, required
      - `name` string, required
      - `agentId` string
      - `onBehalfOf` object: The person whose agent it is, who connected it and whom it acts as, with their role: "Ana via Claude Code". Events from before 2026-11-02 have it too, with the person's name now. Left out of an agent with no person, and of other records from before. After the person's erasure, `name` is "A former member" and `userId` empty.
        - `userId` string, required
        - `name` string, required
    - object
      - `type` 'user', required
      - `userId` string, required
      - `name` string, required
      - `initials` string, required
    - object
      - `type` 'api_key', required
      - `keyId` string, required
      - `name` string, required
    - object
      - `type` 'automation', required
      - `automationId` string, required
      - `name` string, required
  - `sentiment` 'positive' | 'neutral' | 'negative', required: Not computed yet: always `neutral` until Rizamo reads sentiment, so do not rely on it.
  - `replyWindowEndsAt` string, date-time, nullable, required: Messages: replies are possible until then, 24 hours after the person's last message (Meta's messaging window). Null for comments, which have none.

## Other responses

- `400`: `invalid_request`: A field is missing or wrong, or the request cannot be done as asked: the message names the field or says what to change.
- `401`: `unauthorized`: No API key or sign-in, or the key does not work: it was deleted, or it expired.
- `403`: `forbidden`: The caller may not do this: the key or agent lacks the scope (the message names it), or the action needs another role or a fresh sign-in.
- `404`: `not_found`: No such object, or it is outside your team or the profiles your key reaches.
- `409`: `conflict`: The object's state does not allow it now, such as an account that needs a new login. `queue_empty`: A post with `queue: true` whose profile has no posting times: set them, or give a `scheduledAt`. `queue_full`: No posting time free for the post's accounts in the next 90 days: add times, or give a `scheduledAt`. `idempotency_key_in_use`: A request with this `Idempotency-Key` is still running: try again in a moment.
- `413`: `payload_too_large`: The body is over 1 MB: files go up through the upload links of `POST /v1/media`.
- `415`: `unsupported_media_type`: The body is not JSON: send it with `Content-Type: application/json`.
- `429`: `rate_limited`: Over one of Rizamo's limits, or a network asked Rizamo to slow down: wait for `Retry-After` seconds, or as long as the message says.
- `500`: `internal`: Our side failed: retry, and send the `requestId` if it keeps failing.
- `503`: `timeout`: The request took too long to work out, most often a report: try again in a moment, or ask a report for a shorter period or one profile.

---

[API](https://skmtc.dev/rizamo/apis/rizamo-api.md) - [All operations](https://skmtc.dev/rizamo/apis/rizamo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rizamo/apis/rizamo-api/revisions/31b0c1b1ffb5?raw)
