# Permissions

> Botyard REST API endpoints for permissions.

Canonical URL: https://docs.botyard.io/docs/api/permissions

8 endpoints in this group. Every request authenticates with an
[API key](/docs/api/authentication); see the [API reference](/docs/api) for the other groups.

* [List Effective Permissions](/docs/api/permissions/list_effective_permissions_v1_orgs__org_id__permissions_get): `GET /v1/orgs/{org_id}/permissions`
* [Get My Permissions](/docs/api/permissions/get_my_permissions_v1_orgs__org_id__permissions_mine_get): `GET /v1/orgs/{org_id}/permissions/mine`
* [Get Permission Catalogue](/docs/api/permissions/get_permission_catalogue_v1_orgs__org_id__permission_catalogue_get): `GET /v1/orgs/{org_id}/permission-catalogue`
* [List Permission Holders](/docs/api/permissions/list_permission_holders_v1_orgs__org_id__permission_holders_get): `GET /v1/orgs/{org_id}/permission-holders`
* [Get Grant Impact](/docs/api/permissions/get_grant_impact_v1_orgs__org_id__permission_grants__grant_id__impact_get): `GET /v1/orgs/{org_id}/permission-grants/{grant_id}/impact`
* [Get Role Permission Impact](/docs/api/permissions/get_role_permission_impact_v1_orgs__org_id__role_permissions__role_permission_id__impact_get): `GET /v1/orgs/{org_id}/role-permissions/{role_permission_id}/impact`
* [Create Permission Grant](/docs/api/permissions/create_permission_grant_v1_orgs__org_id__permission_grants_post): `POST /v1/orgs/{org_id}/permission-grants`
* [Revoke Permission Grant](/docs/api/permissions/revoke_permission_grant_v1_orgs__org_id__permission_grants__grant_id__delete): `DELETE /v1/orgs/{org_id}/permission-grants/{grant_id}`