---
title: "Deletes a specific conversation from the system. This method removes the conversation and all its associated data permanently."
method: DELETE
path: "/aiagents/DeleteConversation"
tags: ["AIAgents"]
---

# Deletes a specific conversation from the system. This method removes the conversation and all its associated data permanently.

`DELETE /aiagents/DeleteConversation`

## Request

- Base URL: `https://sb2api.servicechannel.com/v3`
- URL: `https://sb2api.servicechannel.com/v3/aiagents/DeleteConversation`
- Auth: OAuth 2
  - Authorization code: `https://sb2login.servicechannel.com/oauth/authorize`
  - Token URL: `https://sb2login.servicechannel.com/oauth/token`
- TypeScript: <https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/docs/aiagents/DeleteConversation/delete.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `threadId` string, required

## Response `200`

Indicates that the conversation has been deleted.

## Other responses

- `400`: Bad Request - the request could not be understood or was missing required parameters. <br/>Error codes: <br/> 503 - Request is invalid
- `401`: Indicates that the requested resource requires authentication. <br>Error codes: 504 - API call rejected by security permissions;

---

[API](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3.md) - [All operations](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/llms.txt) - [OpenAPI document](https://skmtc.dev/servicechannel/apis/servicechannel-api-v-3/revisions/d490d6596809?raw)