# Permit.io Roles API

**Canonical:** https://apis.io/apis/permit-io/permit-io-roles-api/  
**Provider:** Permit.io — https://apis.io/providers/permit-io/  
**Base URL:** https://api.permit.io  
**Documentation:** https://docs.permit.io/

Permit.io Roles API is one of 43 APIs that [Permit.io](https://apis.io/providers/permit-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Roles. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Roles allow you to associate permissions indirectly via a job function. The Roles API allows you to manipulate roles: assign or unassign permissions to a role, define hierarchy between roles or define relationships between resource roles. Roles manipulated by this API are **tenant roles**, meaning when they are assigned, they are assigned on a tenant.

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/permit-io/refs/heads/main/openapi/permit-io-roles-api-openapi.yml
- **Documentation** — https://docs.permit.io/
- **APIReference** — https://api.permit.io/v2/redoc

## Other Permit.io APIs (12)

- [Permit.io Access Requests (EAP) API](https://apis.io/apis/permit-io/permit-io-access-requests-eap-api/)
- [Permit.io Activity Log API](https://apis.io/apis/permit-io/permit-io-activity-log-api/)
- [Permit.io API History API](https://apis.io/apis/permit-io/permit-io-api-history-api/)
- [Permit.io API Keys API](https://apis.io/apis/permit-io/permit-io-api-keys-api/)
- [Permit.io Audit Elements Data API](https://apis.io/apis/permit-io/permit-io-audit-elements-data-api/)
- [Permit.io Audit Log Replay API](https://apis.io/apis/permit-io/permit-io-audit-log-replay-api/)
- [Permit.io Audit Logs API](https://apis.io/apis/permit-io/permit-io-audit-logs-api/)
- [Permit.io Bulk Operations API](https://apis.io/apis/permit-io/permit-io-bulk-operations-api/)
- [Permit.io Condition Set Rules API](https://apis.io/apis/permit-io/permit-io-condition-set-rules-api/)
- [Permit.io Condition Sets API](https://apis.io/apis/permit-io/permit-io-condition-sets-api/)
- [Permit.io Deprecated API](https://apis.io/apis/permit-io/permit-io-deprecated-api/)
- [Permit.io Elements Configs (EAP) API](https://apis.io/apis/permit-io/permit-io-elements-configs-eap-api/)

## Tags

Roles

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/permit-io/permit-io-roles-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/permit-io/.