# Airia Custom Roles API

**Canonical:** https://apis.io/apis/airia/airia-custom-roles-api/  
**Provider:** Airia — https://apis.io/providers/airia/  
**Base URL:** https://mcp-gateway.airia.ai  
**Documentation:** https://airia.ai/docs/mcp-servers/end-user-usage/how-to-set-up-a-gateway

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

The Custom Roles API from Airia — 7 operation(s) for custom roles.

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/custom-roles` | Custom roles get roles |
| POST | `/v1/custom-roles` | Custom roles create role |
| POST | `/v1/custom-roles/by-ids` | Custom roles get roles by ids |
| POST | `/v1/custom-roles/assignable-by-caller` | Custom roles get assignable role ids |
| POST | `/v1/custom-roles/{roleId}/duplicate` | Custom roles duplicate role |
| GET | `/v1/custom-roles/{roleId}` | Custom roles get role |
| PUT | `/v1/custom-roles/{roleId}` | Custom roles update role |
| DELETE | `/v1/custom-roles/{roleId}` | Custom roles delete role |
| GET | `/v1/custom-roles/permissions` | Custom roles get available permissions |
| POST | `/v1/custom-roles/validate-permissions` | Custom roles validate permissions |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/airia/refs/heads/main/openapi/airia-custom-roles-api-openapi.yml
- **APIReference** — https://api.airia.ai/docs/
- **Documentation** — https://airia.ai/docs/build/interface-options/api-deployment
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/airia/refs/heads/main/authentication/airia-authentication.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/airia/refs/heads/main/errors/airia-problem-types.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/airia/refs/heads/main/conventions/airia-conventions.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/airia/refs/heads/main/data-model/airia-data-model.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/airia/refs/heads/main/asyncapi/airia-webhooks.yml

## Other Airia APIs (12)

- [Airia MCP Gateway](https://apis.io/apis/airia/airia-mcp-gateway/)
- [Airia Agent API](https://apis.io/apis/airia/airia-agent-api/)
- [Airia Agent Attribute Auto Fill API](https://apis.io/apis/airia/airia-agentattributeautofill-api/)
- [Airia Agent Card API](https://apis.io/apis/airia/airia-agentcard-api/)
- [Airia Agent Discovery API](https://apis.io/apis/airia/airia-agentdiscovery-api/)
- [Airia Agent Evaluation API](https://apis.io/apis/airia/airia-agentevaluation-api/)
- [Airia Agent Evaluation Dataset API](https://apis.io/apis/airia/airia-agentevaluationdataset-api/)
- [Airia Agent Event Trigger API](https://apis.io/apis/airia/airia-agenteventtrigger-api/)
- [Airia Agent Feedback API](https://apis.io/apis/airia/airia-agentfeedback-api/)
- [Airia Agents Config API](https://apis.io/apis/airia/airia-agentsconfig-api/)
- [Airia Agent Shareable Link API](https://apis.io/apis/airia/airia-agentshareablelink-api/)
- [Airia Agent Steps API](https://apis.io/apis/airia/airia-agentsteps-api/)

## Tags

Custom Roles

---

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