Skip to main content
DELETE
/
v1
/
collections
/
{readable_id}
Delete Collection
curl --request DELETE \
  --url https://api.example.com/v1/collections/{readable_id}
{
  "id": "<string>",
  "name": "<string>",
  "readable_id": "<string>",
  "status": "<string>"
}

​
Overview

Permanently delete a collection and all its data. This operation:
  • Removes all synced data from the vector database
  • Deletes all source connections within the collection
  • Cancels any scheduled sync jobs
  • Cleans up all related resources
This action cannot be undone. All data will be permanently deleted.

​
Path Parameters

​
readable_id
string
required
The unique readable identifier of the collection to delete

​
Response

Returns the deleted collection object.
​
id
string
required
UUID of the deleted collection
​
name
string
required
Name of the deleted collection
​
readable_id
string
required
Readable ID of the deleted collection
​
status
string
required
Final status of the collection

​
Example Request

curl -X DELETE https://api.airweave.ai/v1/collections/finance-data-ab123 \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Example Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Finance Data",
  "readable_id": "finance-data-ab123",
  "vector_size": 3072,
  "embedding_model_name": "text-embedding-3-large",
  "sync_config": null,
  "created_at": "2024-01-15T09:30:00Z",
  "modified_at": "2024-01-15T14:22:15Z",
  "organization_id": "org12345-6789-abcd-ef01-234567890abc",
  "created_by_email": "admin@company.com",
  "modified_by_email": "finance@company.com",
  "status": "ACTIVE"
}

​
Error Responses

​
404 Not Found
Collection with the specified readable_id does not exist