---
title: "Remove chat collaborators"
method: POST
path: "/collaborators/remove"
tags: ["Collaborators"]
---

# Remove chat collaborators

`POST /collaborators/remove`

Removes collaborators from a chat using the same `from`, `to`, and `agentNumbers` rules as add. The success and failure lists show which numbers matched a team member; they do not indicate whether that user was already a collaborator.

## Request body

- PublicChatCollaboratorsAddRemoveBodyDto
  - `from` string, required — WABA / WhatsApp Business number for the integration (matched against Integration.wabaNumber or credentials phone; digits only compared).
  - `to` string, required — Customer phone number (matched against Customer.phoneNumber; digits only compared).
  - `agentNumbers` string[], required — Phone numbers of agents to add or remove. Each must resolve to an org team member via User.phone.

## Response `200`

Collaborators updated (partial success allowed).

- PublicChatCollaboratorsAddRemoveResponseDto
  - `success` object[] — Inputs that resolved to a team member (phone + display name).
    - `number` string
    - `name` string, nullable
  - `failed` object[] — Inputs that did not resolve to an org team member (empty number, or no matching User.phone).
    - `number` string

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/doubletick/apis/doubletick-public-apis.md) · [All operations](https://skmtc.net/doubletick/apis/doubletick-public-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/doubletick/doubletick-public-apis/versions/bba484527d34/schema)