Auth0

Auth0 Roles API

The roles API from Auth0 — 4 operation(s) for roles.

Documentation GitHub OpenAPI

Business capability

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /roles List roles in a tenant · Get Roles #

Ask an LLM

“Which roles have I created in my tenant?”

“Can I search roles by name?”

Tell an agent

List my roles.

Find roles named {name_filter}.

POST /roles Create a role · Create a Role #

Ask an LLM

“How do I create a new role for role-based access control?”

“Does a new role get any permissions by default?”

Tell an agent

Create a role {name}.

Create role {name} described as {description}.

GET /roles/{id} Get a role by ID · Get a Role #

Ask an LLM

“Can I see the name and description of one role?”

“What are the details of a specific role ID?”

Tell an agent

Show role {id}.

Get details of role {id}.

DELETE /roles/{id} Delete a role · Delete a Role #

Ask an LLM

“What happens to users who had a role when I delete it?”

“How do I delete a role?”

Tell an agent destructive · confirm first

Delete role {id}.

Remove role {id} from the tenant.

PATCH /roles/{id} Rename or describe a role · Update a Role #

Ask an LLM

“Can I rename an existing role?”

“How do I change a role's description?”

Tell an agent

Rename role {id} to {name}.

Set the description of role {id} to {description}.

GET /roles/{id}/permissions List permissions granted by a role · Get Permissions Granted by Role #

Ask an LLM

“Which permissions does a role grant?”

“Can I see the resource server behind each permission of a role?”

Tell an agent

List permissions of role {id}.

Show what role {id} is allowed to do.

DELETE /roles/{id}/permissions Remove permissions from a role · Remove Permissions from a Role #

Ask an LLM

“How do I take a permission away from a role?”

“Can I strip several scopes from a role at once?”

Tell an agent destructive · confirm first

Remove permissions {permissions} from role {id}.

Revoke scopes {permissions} on role {id}.

POST /roles/{id}/permissions Add permissions to a role · Associate Permissions with a Role #

Ask an LLM

“How do I add API permissions to a role?”

“Can I attach several permissions to a role in one go?”

Tell an agent

Add permissions {permissions} to role {id}.

Grant role {id} the scopes {permissions}.

GET /roles/{id}/users List users who have a role · Get a Role's Users #

Ask an LLM

“Which users are assigned a particular role?”

“Can I page through everyone holding a role with a checkpoint?”

Tell an agent

List users with role {id}.

Show {take} members of role {id}.

POST /roles/{id}/users Assign users to a role · Assign Users to a Role #

Ask an LLM

“How do I add several users to a role at once?”

“Can I bulk-assign a role to a list of users?”

Tell an agent

Assign users {users} to role {id}.

Add {users} as members of role {id}.

Auth0 Roles API

Operations 10

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification