Remove Role Assignment
DELETE
/user-accounts/{id}Remove a specific role from a user's account access.
This revokes the permissions associated with that role immediately. If it's
the user's only role for the account, they lose access to the account
entirely.
Use this to downgrade permissions or revoke access from someone leaving.
When to use this
- Revoking access when someone leaves a team
- Downgrading permissions after a project ends
- Removing temporary elevated access
Parameters
idpathrequiredRole assignment ID
Response
Role assignment removed
Notes
⚠️If this is the user's only role for the account, they lose all access immediately.
💡To completely remove someone from an account, remove all their role assignments.
Code Samples
Remove Role Assignment using the TypeScript SDK:
import { BackstageClient } from '@ticketlayer/backstage';
const client = new BackstageClient({
organisationSlug: 'your-org',
});
client.setAccessToken('YOUR_ACCESS_TOKEN');
// Remove Role Assignment
const result = await client.roleassignment.removeRoleAssignment('{{ID}}');
console.log('Operation completed:', result);