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

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

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

{
  "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.