---
title: "Delete a conversation."
method: DELETE
path: "/api/v1/projects/{projectId}/conversations/{sessionId}"
tags: ["Conversations"]
---

# Delete a conversation.

`DELETE /api/v1/projects/{projectId}/conversations/{sessionId}`

Delete a conversation within an agent (formerly known as project) identified by its unique projectId and sessionId. This endpoint allows you to remove a specific conversation from the agent, permanently deleting all associated messages. By providing the projectId and sessionId, you can target the conversation to be deleted, ensuring the removal of all conversation-related data.
Here is an example to delete a conversation: [API](https://github.com/Poll-The-People/customgpt-cookbook/blob/main/examples/Update_Delete_a_conversation.ipynb) [SDK](https://github.com/Poll-The-People/customgpt-cookbook/blob/main/examples/SDK_Update_Delete_a_conversation.ipynb).

## Path parameters

- `projectId` integer, required
- `sessionId` string, required

## Response `200`

Agent deleted successfully

- object
  - `status` 'error' | 'success' — The status of the response
  - `data` object
    - `deleted` boolean — Whether the agent was deleted successfully or not

## Other responses

- `400` — Bad Argument
- `401` — API Token is either missing or invalid
- `404` — Agent not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/poll-the-people/apis/customgpt-ai.md) · [All operations](https://skmtc.net/poll-the-people/apis/customgpt-ai/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poll-the-people/customgpt-ai/revisions/b80e6dfcf78d/schema)