PATCH /conversations/{id}
Updated Oct 1, 20261 minute read
Update a conversation
Send any subset; each field applies as its own change, in order. status narrates into the thread. snoozedUntil takes a unix ms timestamp, or null to wake it now. ai set to paused takes the thread off the AI; handling hands it back.
Part of Conversations.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | A conversation id. |
Request body
application/json, required.
| Field | Type | Required | Description |
|---|---|---|---|
status | "open" | "resolved" | "closed" | No | |
isArchived | boolean | No | |
isUnread | boolean | No | |
snoozedUntil | any | No | |
ai | "paused" | "handling" | No |
Responses
| Status | Description |
|---|---|
200 | Done. |
400 | The request is malformed, and the message names the field. |
401 | The bearer token is missing, revoked, or expired. |
404 | Not one of yours, or not there at all. |
429 | Too many requests. Wait the seconds in Retry-After. Limits depend on the plan. See rate limits. |
200 body
| Field | Type | Required | Description |
|---|---|---|---|
ok | boolean | No |
Example response
{
"ok": true
}Example request
curl -X PATCH https://api.median.sh/v1/conversations/id \
-H "Authorization: Bearer $BEARER_AUTH" \
-H "content-type: application/json" \
-d '{"status":"resolved"}'