---
title: "Delete a collection"
method: DELETE
path: "/ai/collections/{uuid}"
tags: ["AI Collections"]
---

# Delete a collection

`DELETE /ai/collections/{uuid}`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/ai/collections/{uuid}`
- Auth: HTTP bearer

Soft-deletes a collection. Its `slug` is freed and may be reused by a new collection.

## Path parameters

- `uuid` string, uuid, required

## Response `204`

Collection deleted.

## Other responses

- `401`: Missing or invalid authentication.
- `404`: The requested resource does not exist.

## Changes

- **2026-10-21** `67df31283a8a`: 2 breaking, 2 info
  - the `errors/items/code` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `401`
  - the `errors/items/code` response's property type changed from `integer` to `string`, and format from `int32` to no format for status `404`
  - added the optional property `errors/items/description` to the response with the `401` status
  - added the optional property `errors/items/description` to the response with the `404` status
- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/ai/collections/:uuid/delete.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)