> ## 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.

# Identity and access API

> HTTP API operations for the calling credential, Personal keys, External Apps and job roles: who you are, what you may do, and the credentials that act.

These operations answer who the calling credential is and manage the credentials that act on Forge: Personal keys, host sign-ins and External Apps. Job roles, the bundles of tools and skills that positions grant, live here too. Every path here is under `/api/v3`; see [authentication and permissions](https://docs.gloo.com/forge/reference/permissions) for the credential each operation takes.

## Domains

> [card] [Current actor](https://docs.gloo.com/forge/reference/http-api/actor.md)
>
> Who the calling credential is, its narrowed permissions, rate limits, usage and refusals.

> [card] [API keys](https://docs.gloo.com/forge/reference/http-api/api-keys)
>
> List and revoke Personal keys and host sign-ins, deployment-wide or your own.

> [card] [External apps](https://docs.gloo.com/forge/reference/http-api/externalApps)
>
> Register an integrating system, rotate its secrets, and manage what it owns.

> [card] [Roles and grants](https://docs.gloo.com/forge/reference/http-api/grants-roles)
>
> Create job roles and choose the tools and skills each grants.

## Common tasks

| Task | Operation |
| - | - |
| See who you are and what you may call | [`GET /api/v3/me/actor`](https://docs.gloo.com/forge/reference/http-api/actor) |
| List your effective permissions | [`GET /api/v3/me/permissions`](https://docs.gloo.com/forge/reference/http-api/actor/my-permissions) |
| Explain one of your refusals | [`GET /api/v3/me/denials/{decisionId}`](https://docs.gloo.com/forge/reference/http-api/actor/my-denials) |
| Register an External App | [`POST /api/v3/external-apps`](https://docs.gloo.com/forge/reference/http-api/externalApps/create) |
| Revoke a Personal key | [`POST /api/v3/personal-keys/{keyId}/revoke`](https://docs.gloo.com/forge/reference/http-api/api-keys/admin/personal-keys-revoke) |

## Related

* [Credentials and access](https://docs.gloo.com/forge/get-started/credentials-and-access.md)
* [Set up an External App](https://docs.gloo.com/forge/build/set-up-external-app.md)
* [Permissions reference](https://docs.gloo.com/forge/reference/permissions)


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