> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gloo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Roles and grants administration

> Create, change and delete job roles, and manage the tools and skills each role grants, with a platform API key.

These admin routes run the Console's own job-role operations for a platform API key. An External App is refused with `403`, even when it holds the permission.

* Job roles: create, update and delete a role with `roles:manage`. A role a position still holds cannot be deleted (`409 conflict`).
* Role capabilities: list the tools, skills, tool sets and skill sets a role grants or denies with `roles:read`, and grant, deny or revoke them with `roles:manage`. A save applies every change or none.

A platform API key's change is recorded in the audit log under the key, as `system`, not as a person; a Personal key acts as its owner and is recorded as that person. Drafting a role's content with AI and the Role Architect conversation stay in the Console for now. To list who holds which Trust Fabric role, use [List grants](https://docs.gloo.com/forge/reference/http-api/governance/listGrants.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.