---
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/). |