Skip to main content

Delete Session (v1)

Method + Path

DELETE /v1/workspace/:workspaceId/sessions/:sessionId

Actual backend path: /v1/workspace/:workspaceId/sessions/:sessionId

Description

Delete a session from a workspace.

Authentication

Required - JWT token in Authorization header

Required Permissions:

  • sessions.delete

Headers

HeaderTypeRequiredDescription
AuthorizationstringYesBearer token: Bearer <token>

Path Parameters

ParameterTypeRequiredDescription
workspaceIdstringYesWorkspace identifier
sessionIdstringYesSession identifier

Response (204)

No content - successful deletion.

Common Errors

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