# Red Hat Ansible Automation Platform Roles API

**Canonical:** https://apis.io/apis/red-hat-ansible-automation-platform/red-hat-ansible-automation-platform-roles-api/  
**Provider:** Red Hat Ansible Automation Platform — https://apis.io/providers/red-hat-ansible-automation-platform/  
**Base URL:** https://controller-host/api/v2/  
**Documentation:** https://access.redhat.com/documentation/en-us/red_hat_ansible_automation_platform/

Red Hat Ansible Automation Platform Roles API is one of 333 APIs that [Red Hat Ansible Automation Platform](https://apis.io/providers/red-hat-ansible-automation-platform/) 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, an API reference, and authentication docs.

The roles API from Red Hat Ansible Automation Platform — 6 operation(s) for roles.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v2/roles/` | Roles list |
| GET | `/api/v2/roles/{id}/` | Roles retrieve |
| GET | `/api/v2/roles/{id}/teams/` | Roles teams list |
| POST | `/api/v2/roles/{id}/teams/` | Roles teams create |
| GET | `/api/v2/roles/{id}/users/` | Roles users list |
| POST | `/api/v2/roles/{id}/users/` | Roles users create |
| GET | `/api/automation-hub/pulp/api/v3/roles/` | List roles |
| POST | `/api/automation-hub/pulp/api/v3/roles/` | Create a role |
| GET | `/api/automation-hub/pulp/api/v3/roles/{pulp_id}/` | Inspect a role |
| PUT | `/api/automation-hub/pulp/api/v3/roles/{pulp_id}/` | Update a role |
| PATCH | `/api/automation-hub/pulp/api/v3/roles/{pulp_id}/` | Update a role |
| DELETE | `/api/automation-hub/pulp/api/v3/roles/{pulp_id}/` | Delete a role |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/red-hat-ansible-automation-platform/refs/heads/main/openapi/red-hat-ansible-automation-platform-roles-api-openapi.yml
- **Documentation** — https://access.redhat.com/documentation/en-us/red_hat_ansible_automation_platform/
- **APIReference** — https://docs.ansible.com/automation-controller/latest/html/controllerapi/api_ref.html
- **Authentication** — https://docs.ansible.com/automation-controller/latest/html/controllerapi/authentication.html
- **Documentation** — https://access.redhat.com/documentation/en-us/red_hat_ansible_automation_platform/2.4/html/managing_red_hat_certified_and_ansible_galaxy_collections_in_automation_hub/
- **Documentation** — https://access.redhat.com/documentation/en-us/red_hat_ansible_automation_platform/2.4/html/event-driven_ansible_controller_user_guide/
- **Console** — https://console.redhat.com/ansible/ansible-dashboard

## Other Red Hat Ansible Automation Platform APIs (12)

- [Red Hat Automation Services Catalog API](https://apis.io/apis/red-hat-ansible-automation-platform/services-catalog-api/)
- [Red Hat Ansible Automation Platform Access Policies API](https://apis.io/apis/red-hat-ansible-automation-platform/red-hat-ansible-automation-platform-access-policies-api/)
- [Red Hat Ansible Automation Platform Acs: File API](https://apis.io/apis/red-hat-ansible-automation-platform/red-hat-ansible-automation-platform-acs-file-api/)
- [Red Hat Ansible Automation Platform Activation Instances API](https://apis.io/apis/red-hat-ansible-automation-platform/red-hat-ansible-automation-platform-activation-instances-api/)
- [Red Hat Ansible Automation Platform Activations API](https://apis.io/apis/red-hat-ansible-automation-platform/red-hat-ansible-automation-platform-activations-api/)
- [Red Hat Ansible Automation Platform Activity Stream API](https://apis.io/apis/red-hat-ansible-automation-platform/red-hat-ansible-automation-platform-activity-stream-api/)
- [Red Hat Ansible Automation Platform Ad Hoc Command Events API](https://apis.io/apis/red-hat-ansible-automation-platform/red-hat-ansible-automation-platform-ad-hoc-command-events-api/)
- [Red Hat Ansible Automation Platform Ad Hoc Commands API](https://apis.io/apis/red-hat-ansible-automation-platform/red-hat-ansible-automation-platform-ad-hoc-commands-api/)
- [Red Hat Ansible Automation Platform AI API](https://apis.io/apis/red-hat-ansible-automation-platform/red-hat-ansible-automation-platform-ai-api/)
- [Red Hat Ansible Automation Platform Analytics API](https://apis.io/apis/red-hat-ansible-automation-platform/red-hat-ansible-automation-platform-analytics-api/)
- [Red Hat Ansible Automation Platform Ansible: Collections API](https://apis.io/apis/red-hat-ansible-automation-platform/red-hat-ansible-automation-platform-ansible-collections-api/)
- [Red Hat Ansible Automation Platform Api: API](https://apis.io/apis/red-hat-ansible-automation-platform/red-hat-ansible-automation-platform-api-api-api/)

## Tags

Roles

---

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