workspace/delete_by_id

Tool: delete

Delete a workspace owned by the authenticated agency.

Two-phase delete. A 204 removes the workspace from the account immediately: it no longer appears in workspace/get, workspace/get_by_id returns 404, and calls delegated with its workspaceId are rejected. Its contents (campaigns, senders, prospects, sent mail) are purged in the background — typically minutes, up to ~1 hour for a large workspace. The purge is not observable through the API, and the immediate 404 confirms acceptance, not completed cleanup. Treat the 204 as success; do not re-call this operation or poll for the purge.

Arguments

Response

200/204 — No body returned on success.

Errors: 400, 401, 404, 406, 422, 429, 500 — shared schema: schemas/errors.

Invoke

Call delete with name: "workspace/delete_by_id".