# Avetta Roles API

**Canonical:** https://apis.io/apis/avetta/avetta-roles-api/  
**Provider:** Avetta — https://apis.io/providers/avetta/  
**Base URL:** https://api.avetta.com  
**Documentation:** https://docs.api.avetta.com

Avetta Roles API is one of 96 APIs that [Avetta](https://apis.io/providers/avetta/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 17 JSON Schema definitions. Tagged areas include Roles. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 17 JSON Schemas.

The Roles API allows you to retrieve role information.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/roles` | List of roles |
| GET | `/roles/{rolID}` | Get role by id |
| POST | `/roles/{rolID}/users/{usrID}` | Insert new role to user |
| DELETE | `/roles/{rolID}/users/{usrID}` | Delete the asignation of the role to the user |
| POST | `/roles/users` | Bulk role assignment or unassignment to users |

## Machine-readable artifacts (21)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/avetta/refs/heads/main/openapi/avetta-roles-api-openapi.yml
- **Documentation** — https://docs.connect.avetta.com/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/avetta/refs/heads/main/json-schema/avetta-1-0-0-supplier-profile-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/avetta/refs/heads/main/json-schema/avetta-1-0-0-get-workflow-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/avetta/refs/heads/main/json-schema/avetta-1-0-0-supplier-profiles-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/avetta/refs/heads/main/json-schema/avetta-1-0-0-create-work-request-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/avetta/refs/heads/main/json-schema/avetta-1-0-0-worker-open-work-requests-summary-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/avetta/refs/heads/main/json-schema/avetta-1-0-0-get-work-request-questions-response-schema.json
- **Documentation** — https://docs.pegasus.avetta.com/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/avetta/refs/heads/main/json-schema/avetta-3-29-14-integrate-employee-resource-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/avetta/refs/heads/main/json-schema/avetta-3-29-14-employee-resource-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/avetta/refs/heads/main/json-schema/avetta-3-29-14-worker-resource-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/avetta/refs/heads/main/json-schema/avetta-3-29-14-competency-resource-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/avetta/refs/heads/main/json-schema/avetta-3-29-14-scope-permission-resource-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/avetta/refs/heads/main/json-schema/avetta-3-29-14-client-company-registration-resource-schema.json
- **Documentation** — https://docs.worker.avetta.com/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/avetta/refs/heads/main/json-schema/avetta-stats-schema-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/avetta/refs/heads/main/json-schema/avetta-request-structure-refresh-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/avetta/refs/heads/main/json-schema/avetta-request-structure-password-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/avetta/refs/heads/main/json-schema/avetta-request-wmconnect-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/avetta/refs/heads/main/json-schema/avetta-sites-message-response-schema.json

## Other Avetta APIs (12)

- [Avetta Developer API](https://apis.io/apis/avetta/avetta-developer-api/)
- [Avetta Account API](https://apis.io/apis/avetta/avetta-account-api/)
- [Avetta Accounts API](https://apis.io/apis/avetta/avetta-accounts-api/)
- [Avetta Admin API](https://apis.io/apis/avetta/avetta-admin-api/)
- [Avetta Auth API](https://apis.io/apis/avetta/avetta-auth-api/)
- [Avetta Authentication API](https://apis.io/apis/avetta/avetta-authentication-api/)
- [Avetta Compliance API](https://apis.io/apis/avetta/avetta-compliance-api/)
- [Avetta Countries API](https://apis.io/apis/avetta/avetta-countries-api/)
- [Avetta Credit API](https://apis.io/apis/avetta/avetta-credit-api/)
- [Avetta Deprecated Endpoints API](https://apis.io/apis/avetta/avetta-deprecated-endpoints-api/)
- [Avetta Event API](https://apis.io/apis/avetta/avetta-event-api/)
- [Avetta Events API](https://apis.io/apis/avetta/avetta-events-api/)

## Tags

Roles

---

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