---
title: "Remove conversation channels"
method: DELETE
path: "/v1/conversations/{id}/channels"
tags: ["Conversations"]
---

# Remove conversation channels

`DELETE /v1/conversations/{id}/channels`

## Request

- Base URL: `https://api.samva.dev`
- URL: `https://api.samva.dev/v1/conversations/{id}/channels`
- Auth: API key in header `x-api-key`

Removes the given channels from the conversation and returns the conversation. The primary channel cannot be removed; a channel the conversation does not have is ignored.

## Path parameters

- `id` string, required

## Request body

- ConversationChannels
  - `channels` string[], required

## Response `200`

Conversation

- Conversation
  - `id` string, required
  - `title` string, nullable, required
  - `externalId` string, nullable, required
  - `status` 'active' | 'waiting' | 'resolved' | 'escalated' | 'archived', required
  - `primaryChannel` 'email', required
  - `channels` string[], required
  - `priority` integer, required
  - `urgency` 'low' | 'medium' | 'high' | 'critical', required
  - `tags` string[], required
  - `isTest` boolean, required
  - `messageCount` integer, required
  - `lastActivityAt` string, required
  - `createdAt` string, required
  - `description` string, nullable, required
  - `parentConversationId` string, required
  - `statusReason` string, nullable, required
  - `complexity` 'simple' | 'moderate' | 'complex', required
  - `categories` string[], required
  - `metadata` JsonObject, required
  - `context` ConversationContext, required
    - `customerData` UnknownRecord
    - `previousConversations` string[], nullable
    - `sessionVariables` UnknownRecord
    - `workflowState` object, nullable
      - `currentStep` string, nullable
      - `completedSteps` string[], nullable
      - `pendingSteps` string[], nullable
      - `workflowData` UnknownRecord
  - `isInternal` boolean, required
  - `isPrivate` boolean, required
  - `contacts` ConversationContact[], required
    - `id` string, required
    - `name` string, required
    - `displayName` string, nullable, required
    - `identities` object[], required
      - `type` 'email' | 'phone', required
      - `identifier` string, required
      - `verified` boolean, required
  - `startedAt` string, required
  - `lastHumanActivityAt` string, nullable, required
  - `resolvedAt` string, nullable, required
  - `archivedAt` string, nullable, required
  - `resolutionType` 'automated' | 'human_assisted' | 'escalated' | 'abandoned' | 'timeout', nullable, required
  - `resolutionNotes` string, nullable, required
  - `updatedAt` string, required

## Other responses

- `401`: UnauthorizedError
- `403`: ForbiddenError
- `404`: ResourceNotFoundError
- `422`: ValidationError
- `500`: InternalError
- `504`: GatewayTimeoutError

---

[API](https://skmtc.dev/samva/apis/samva-api.md) · [All operations](https://skmtc.dev/samva/apis/samva-api/llms.txt) · [OpenAPI document](https://skmtc.dev/samva/apis/samva-api/revisions/a99408542cc3?raw)