# Ansible Roles

**Canonical:** https://apis.io/providers/ansible-roles/  
**APIs profiled:** 10

A curated collection of APIs and resources for discovering, managing, and consuming Ansible roles — the primary unit of reusable automation content in the Ansible ecosystem. Covers the Galaxy and Automation Hub APIs for role discovery, download, and publishing, as well as the Ansible Collections framework that has extended the role model into full-featured content packages.

## Kin Score — 37.5 / 100 (thin)

Scored 2026-08-20 under rubric 0.12.0. Trend: flat (+0.0 from 37.5).

| Facet | Score |
|---|---|
| Discoverability | 74.1 |
| Contract Quality | 55.8 |
| Governance | 25.0 |
| Contract Governance | 25.0 |
| Operational Transparency | 26.3 |
| Developer Ergonomics | 11.9 |
| Commercial Clarity | 36.8 |
| Access Clarity | 36.8 |

## Agent readiness — 29.1 (agent-aware)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | no |
| MCP Server | no |
| Auth Clarity | yes |
| Idempotency | no |
| Error Semantics | no |
| OpenAPI Examples | no |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |

## Access

Freemium · Self-serve signup — onboarding: self-serve, pricing: freemium, trial: no (confidence: high).

## APIs (10)

- **Ansible Galaxy Roles API** — The Ansible Galaxy v1 and v2 REST API enables searching, discovering, and downloading Ansible roles contributed by the community. Supports searching roles by keyword, author, or...
- **Ansible Galaxy Collections API** — The Ansible Galaxy v3 API provides enhanced support for Ansible collections — the modern packaging format that bundles roles, modules, plugins, and documentation together. Suppo...
- **Ansible Automation Hub Roles API** — The Red Hat Ansible Automation Hub provides certified and partner-validated Ansible collections and roles for enterprise use. The API enables access to Red Hat-certified content...
- **Ansible Roles Ansible Galaxy Roles & Collections API API** — The Ansible Galaxy Roles & Collections API API from Ansible Roles — 2 operation(s) for ansible galaxy roles & collections api.
- **Ansible Roles Collections API** — Modern v3 collections (Galaxy NG / Pulp).
- **Ansible Roles Imports API** — Track role import job status.
- **Ansible Roles Namespaces API** — Legacy v1 namespaces (mapped from GitHub orgs/users).
- **Ansible Roles Roles API** — Legacy v1 community roles API.
- **Ansible Roles Sync API** — Trigger legacy content sync.
- **Ansible Roles Users API** — Legacy v1 users API.

## Agentic access (1)

- **Ansible Roles Agentic Access** — 18 operations · 3 acting

## Security (2)

- **Ansible Roles Authentication** — apiKey · 1 scheme
- **Ansible Roles Domain Security** — TLSv1.3 · HSTS · DMARC

## Plans (1)

- **Ansible Roles Plans Pricing**

## Use cases (4)

- **Role Reuse Across Projects** — Discover and install community roles from Galaxy to avoid reinventing automation logic for common tasks like nginx, MySQL, or Kubernetes setup.
- **Certified Enterprise Automation** — Use Red Hat-certified collections from Automation Hub in production environments where quality assurance and support are required.
- **Private Content Distribution** — Publish internal roles and collections to a private Automation Hub instance for controlled distribution within an organization.
- **Dependency Management** — Pin role and collection versions in requirements.yml files and install them via the Galaxy API in CI/CD pipelines.

## Tags

Ansible, Automation, Collection, Configuration Management, DevOps, Infrastructure as Code, Roles

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/ansible-roles/). Scores are computed from the provider's own public artifacts under a published rubric.