---
title: "Update Text Thread"
method: PATCH
path: "/texts/threads/{thread_id}"
tags: ["Texts"]
---

# Update Text Thread

`PATCH /texts/threads/{thread_id}`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/texts/threads/{thread_id}`
- Auth: none declared

Archive or unarchive a thread. A new inbound message reopens an archived one.

## Path parameters

- `thread_id` string, uuid, required

## Request body

- UpdateTextThreadRequest
  - `status` 'open' | 'archived', required

## Response `200`

Successful Response

- TextThreadListItem: One conversation in the Texts list.
  - `text_thread_id` string, uuid, required
  - `contact_phone` string, required
  - `business_phone` string, required
  - `contact_name` string, nullable: The linked outbound lead's name, else the thread's display name
  - `outbound_lead_id` string, uuid, nullable
  - `lead_id` string, uuid, nullable
  - `status` string, required
  - `last_message_at` string, date-time, nullable
  - `last_message_preview` string, nullable
  - `last_message_direction` string, nullable
  - `last_inbound_at` string, date-time, nullable
  - `is_unread` boolean, required
  - `needs_staff` boolean: The SMS agent handed this person to staff and no one at the firm has texted them or marked it handled since
  - `needs_staff_since` string, date-time, nullable: When the SMS agent handed the thread to staff, while it still needs them
  - `needs_staff_reason` string, nullable: Why the SMS agent handed the thread to staff, in the firm's words
  - `message_count` integer, required
  - `is_test` boolean, required
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-27** `4d3da2f87786`: 3 info
  - added the optional property `needs_staff` to the response with the `200` status
  - added the optional property `needs_staff_reason` to the response with the `200` status
  - added the optional property `needs_staff_since` to the response with the `200` status
- **2026-09-25** `2874401d2b40`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openintake/apis/openintake-api/changes/texts/threads/:thread_id/patch.md)

---

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