Skip to main content
DELETE
/
workspaces
/
{id}
Delete Workspace
curl --request DELETE \
  --url https://api.kakiyo.com/v1/workspaces/{id} \
  --header 'Authorization: Bearer <token>'
{
  "message": "Workspace deleted successfully",
  "stats": {
    "agentsUnassigned": 3,
    "campaignsUpdated": 5,
    "chatsUpdated": 150
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.kakiyo.com/llms.txt

Use this file to discover all available pages before exploring further.

Agency Plan Required - This endpoint is only available for teams on the Agency plan.

​
Endpoint

DELETE https://api.kakiyo.com/v1/workspaces/:workspaceId

​
Path Parameters

ParameterTypeRequiredDescription
workspaceIdstringYesThe workspace ID to delete

​
Response

{
  "message": "Workspace deleted successfully",
  "stats": {
    "agentsUnassigned": 3,
    "campaignsUpdated": 5,
    "chatsUpdated": 150
  }
}

​
Example Request

curl -X DELETE "https://api.kakiyo.com/v1/workspaces/69724d900007cfde1d88" \
  -H "Authorization: Bearer YOUR_API_KEY"
This is a destructive operation. Deleting a workspace permanently removes client access and unassigns all agents.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Workspace ID

Response

Workspace deleted successfully

​
message
string
Example:

"Workspace deleted successfully"

​
stats
object
Last modified on January 28, 2026