Skip to main content

Delete Client (v1)

Method + Path

DELETE /v1/workspace/:workspaceId/clients/:clientId

Actual backend path: /v1/workspace/:workspaceId/clients/:clientId

Description

Delete a client (customer) from a workspace.

Authentication

Required - JWT token in Authorization header

Required Permissions:

  • clients.delete

Headers

HeaderTypeRequiredDescription
AuthorizationstringYesBearer token: Bearer <token>

Path Parameters

ParameterTypeRequiredDescription
workspaceIdstringYesWorkspace identifier
clientIdstringYesClient identifier

Response (204)

No content - successful deletion.

Common Errors

  • 401 Unauthorized: Missing or invalid authentication token
  • 403 Forbidden: Insufficient permissions (requires clients.delete)
  • 404 Not Found: Client or workspace not found
  • 500 Internal Server Error: Server error