Skip to main content
DELETE
Delete Workspace

Delete Workspace

Permanently deletes a workspace and all its associated tokensets, modes, and tokens. This action cannot be undone.
Write access policy - This endpoint requires the write:tokens scope.
  • TEAM-owned workspace: owner, admin, editor can write; viewer is blocked (403).
  • Non-TEAM workspace: only the workspace owner can write.
  • If the workspace owner plan has no API write access (for example FREE), write is blocked.

Endpoint

Authentication

Requires a valid API token in the Authorization header.

Request

Headers

Path Parameters

Response

Success Response

Status: 200 OK

Examples

Error Responses

401 Unauthorized

404 Not Found

Causes:
  • Workspace ID doesn’t exist
  • You do not have access to this workspace

500 Internal Server Error

Cascade Deletion

When a workspace is deleted, the following are also deleted:
  • ✅ All tokensets in the workspace
  • ✅ All modes in those tokensets
  • ✅ All tokens in those modes
This operation is irreversible. All data will be permanently deleted. Make sure to export your tokens before deletion if you need a backup.

Best Practices

1. Confirmation

Always confirm with the user before deletion:

2. Export Before Deletion

Download all data before deletion:

3. Archive Instead

Consider archiving instead of deleting:

Recovery

Deleted workspaces cannot be recovered. There is no undo or trash bin. Make sure you have backups of important data.

Next Steps

Export Workspace Data

Export before deletion

List Workspaces

View all workspaces