Overview

contox_delete_context permanently removes a context from the project. This operation is irreversible — the context and all its content will be lost.

For a non-destructive alternative, consider using contox_approve with the deprecate action to hide a context without deleting it.

Parameters

Return value

Returns a confirmation message:

Context deleted: ctx_abc123

Usage examples

Deleting an obsolete context

User: Delete the old API notes context, we don't need it anymore

Claude calls: contox_list_contexts()
// Finds the context: "Old API Notes" with id "ctx_old123"
Claude calls: contox_delete_context({ id: "ctx_old123" })

Response: Context deleted: ctx_old123

Notes

• This operation is irreversible. There is no undo or recycle bin.
• Deleting a parent context does not automatically delete its children. Child contexts will become orphaned (their parentContextId will reference a non-existent context).
• If you want to hide a context without deleting it, use contox_approve with action: "deprecate" instead.
• If the context ID does not exist, the tool returns an error.