Delete Role
DELETE
/roles/{id}Remove a role from your organisation.
Deleting a role removes it from all users who have it. They'll lose any
permissions that were only granted through this role.
Make sure to reassign users to other roles first, or they might lose access
to things they need.
When to use this
- Cleaning up roles you no longer need
- Consolidating multiple similar roles into one
- Removing a role that was created by mistake
Parameters
idpathrequiredRole ID
Response
Role deleted successfully
Notes
⚠️Users with this role will lose its permissions immediately. Reassign them first if needed.
ℹ️System roles (like "Owner" or "Admin") can't be deleted.
Code Samples
Delete Role using the TypeScript SDK:
import { BackstageClient } from '@ticketlayer/backstage';
const client = new BackstageClient({
organisationSlug: 'your-org',
});
client.setAccessToken('YOUR_ACCESS_TOKEN');
// Delete role
await client.role.delete('{{ROLE_ID}}');
console.log('Role deleted successfully');