delete_collection

Move a collection to the organisation's trash (soft-delete).

Move a collection to the organisation's trash (soft-delete).

Destructive · Writes data · Idempotent · Calls external systems. This tool can modify or delete data. Review the arguments before letting an agent call it.

Parameters

FieldTypeRequiredDescription
acknowledgebooleanYesMust be true — confirms the caller accepts moving this collection to trash (soft-delete, recoverable until admin empties trash)
operatorstringYesOperator slug
uidstringYesCollection UID to delete

Example arguments

Illustrative arguments an agent supplies when calling this tool:

{
  "operator": "string",
  "uid": "string",
  "acknowledge": false
}

Description

The collection is recoverable until an admin empties the trash; there is no direct hard-delete. Refuses unless acknowledge=true. Recommended flow: list_collection_items (review the contents) → delete_collection with acknowledge=true.

What's next?

All MCP tools

Browse the full tool reference by category.

Connect a client

Point Claude, Cursor, or Claude Code at the server.

Last updated on