Platform API reference

Platform API · Workspace-Roles

delete/v1/workspaces/{workspace_slug}/roles/{role_id}Auth

Delete a custom role (fails if it has members). Cookie/JWT only — role authoring is a human-admin surface.

Path parameters

workspace_slug*string

Slug of the workspace. Platform routes name the workspace by slug, positionally in the SDK (`platform.workspaces.retrieve("acme")`); the product APIs bind `workspace_id` instead.

role_id*string · uuid

Id of the role.

Response · 204

Custom role deleted.

Example

Request

DELETE https://api.platform-auth.productcraft.co/v1/workspaces/{workspace_slug}/roles/{role_id}
Authorization: Bearer YOUR_TOKEN