Skip to main content

​
Unassign Thread

Remove the user assignment from an SMS conversation thread. The thread remains completed — AI responses are not reactivated.

​
Endpoint

POST /v1/threads/unassign

​
Authentication

​
X-API-Key
string
required
Your API key

​
Request Body

​
campaign_id
string
required
The campaign ID containing the thread
​
phone_number
string
required
The contact’s phone number (E.164 format recommended, e.g. +15551234567)

​
Response

​
success
boolean
Whether the unassignment was successful
​
message
string
Human-readable result message
​
thread_id
string
The thread identifier (format: {phone_number}_{campaign_id})

​
Example Request

curl -X POST "https://partner.teli.ai/api/proxy/v1/threads/unassign" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "campaign_id": "camp_abc123",
    "phone_number": "+15551234567"
  }'

​
Example Response

{
  "success": true,
  "message": "Thread unassigned",
  "thread_id": "+15551234567_camp_abc123",
  "powered_by": "Teli"
}

​
Error Responses

400
{
  "error": "campaign_id and phone_number are required",
  "success": false,
  "powered_by": "Teli"
}
404
{
  "error": "Thread not found",
  "success": false,
  "powered_by": "Teli"
}

​
Important Notes

  • AI does not restart — unassigning a thread does not reactivate the AI agent or drip messages. The thread remains in a completed state.
  • Admin visibility — once unassigned, the thread is no longer visible to non-admin users (since they only see threads assigned to them).
  • Re-assignment — you can assign the thread to a different user by calling the Assign Thread endpoint again.