v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB
Namespaces

Delete Namespace

This endpoint deletes a namespace and ALL its resources including: - All buckets (with S3 objects, batches, uploads) - All collections (with Qdrant points, cache, webhooks) - All clusters (with Ray jobs, executions, triggers, S3 artifacts) - All retrievers (with executions, evaluations, interactions, cache) - Remaining MongoDB collections (tasks, uploads, taxonomies, API keys, etc.) - All S3 objects with namespace prefix - Qdrant collection (namespace's vector database) - All namespace cache (across all scopes) - Analytics data (ClickHouse tables) - Namespace metadata

The deletion is performed asynchronously. Returns a task_id that can be used
to poll for deletion progress via GET /v1/tasks/{task_id}.

⚠️  WARNING: This operation is irreversible and will delete ALL data in the namespace!
delete/v1/namespaces/{namespace_identifier}

Path parameters

namespace_identifierstring required

Either the namespace name or namespace ID

Example:my_namespace

Either the namespace name or namespace ID

Query parameters

forceboolean

Force deletion even if batches are still processing. Without this flag, the endpoint returns 409 when active batches exist.

Force deletion even if batches are still processing. Without this flag, the endpoint returns 409 when active batches exist.

Response

Successful Response

{"stackTrail":"paths:/v1/namespaces/{namespace_identifier}:delete:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}