What happens if I try to delete a custom role that is still assigned?

Context:

Currently you can delete a custom role via the API (DELETE /api/v1/orgs/current/roles/{role_id}). Note that deleting custom roles is only available via the API — there is currently no delete option in the UI.

Answer:

The deletion will be blocked. LangSmith will not delete a custom role that is still in use, and users will not be automatically reassigned to a default role.

To delete the role, the customer must first reassign all users to another role, delete or reassign any service accounts using it, and update SSO settings if the role is configured as a default workspace role. Once all assignments are cleared, the API call will succeed.