--- title: phone.takeThread | Doing Work API description: Take a text thread yourself: it is assigned to you, and sends paused by a customer's stop-like message start again once a person has read it. url: https://doingwork.work/docs/reference/phone-takethread/ --- # phone.takeThread Take a text thread yourself: it is assigned to you, and sends paused by a customer's stop-like message start again once a person has read it. | | | |---|---| | Who | Hosted page only (a person does it in the browser) | | REST | `POST /v1/phone/take-thread` | | MCP tool | Not an MCP tool | | Writes | yes, send an Idempotency-Key | | Area | [Shop](https://doingwork.work/docs/reference/#shop) | ## When to use it Take a text thread yourself: it is assigned to you, and sends paused by a customer's stop-like message start again once a person has read it. ## What to tell the owner Send the person the link. They finish this step themselves on the page; you never do it for them. ## Input | Field | Type | Required | |---|---|---| | `conversation_id` | string (uuid) | yes | | `resume_sends` | boolean | no | ## Example ```http POST https://doingwork.work/v1/phone/take-thread content-type: application/json Idempotency-Key: 3f1c... { "conversation_id": "00000000-0000-4000-8000-000000000000" } ``` ## Output | Field | Type | Always there | |---|---|---| | `id` | string (uuid) | yes | | `contact` | string | yes | | `customer_id` | ['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')'] | yes | | `job_id` | ['string', 'null', ' ', '(', 'u', 'u', 'i', 'd', ')'] | yes | | `assigned_to` | string | yes | | `assigned_to_me` | boolean | yes | | `sends_paused` | boolean | yes | | `paused_reason` | ['string', 'null'] | yes | | `last_message_at` | string (date-time) | yes | ```json { "id": "00000000-0000-4000-8000-000000000000", "contact": "...", "customer_id": "00000000-0000-4000-8000-000000000000", "job_id": "00000000-0000-4000-8000-000000000000", "assigned_to": "...", "assigned_to_me": true, "sends_paused": true, "paused_reason": "...", "last_message_at": "..." } ``` ## Errors | Code | Status | What to do | |---|---|---| | `invalid_input`, `invalid_token`, `rate_limited` | | Can happen on any call. See [errors](https://doingwork.work/docs/errors/). |