Skip to main content

Delete Workspace

Delete a workspace and optionally all its documents.

DELETE /v1/workspaces/:id

Path Parameters

ParameterTypeDescription
idstringWorkspace ID

Query Parameters

ParameterTypeDefaultDescription
delete_documentsbooleanfalseAlso delete all documents

Example Request

# Delete workspace only (fails if documents exist)
curl -X DELETE https://api.inherent.systems/v1/workspaces/ws_abc123 \
-H "Authorization: Bearer $INHERENT_API_KEY"

# Delete workspace and all documents
curl -X DELETE "https://api.inherent.systems/v1/workspaces/ws_abc123?delete_documents=true" \
-H "Authorization: Bearer $INHERENT_API_KEY"

Response

{
"id": "ws_abc123",
"deleted": true,
"documents_deleted": 156
}

Errors

CodeDescription
404Workspace not found
409Workspace has documents (use delete_documents=true)