# Datadog Roles API

**Canonical:** https://apis.io/apis/datadog/datadog-roles-api/  
**Provider:** Datadog — https://apis.io/providers/datadog/  
**Base URL:** https://api.datadoghq.com  
**Documentation:** https://docs.datadoghq.com/api/latest/

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

The Roles API is used to create and manage Datadog roles, what [global permissions](https://docs.datadoghq.com/account_management/rbac/) they grant, and which users belong to them. Permissions related to specific account assets can be granted to roles in the Datadog application without using this API. For example, granting read access on a specific log index to a role can be done in Datadog from the [Pipelines page](https://app.datadoghq.com/logs/pipelines).

## Machine-readable artifacts (18)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/openapi/datadog-roles-api-openapi.yml
- **Documentation** — https://docs.datadoghq.com/api/latest/
- **Authentication** — https://docs.datadoghq.com/api/latest/authentication/
- **GraphQL** — https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/graphql/datadog-graphql.md
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-schema/datadog-metric-schema.json
- **Documentation** — https://docs.datadoghq.com/api/latest/metrics/
- **Reference** — https://docs.datadoghq.com/metrics/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-schema/datadog-log-event-schema.json
- **Documentation** — https://docs.datadoghq.com/api/latest/logs/
- **Reference** — https://docs.datadoghq.com/logs/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-schema/datadog-event-schema.json
- **Documentation** — https://docs.datadoghq.com/api/latest/events/
- **Reference** — https://docs.datadoghq.com/service_management/events/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/datadog/refs/heads/main/json-schema/datadog-monitor-schema.json
- **Documentation** — https://docs.datadoghq.com/api/latest/monitors/
- **Reference** — https://docs.datadoghq.com/monitors/
- **Documentation** — https://docs.datadoghq.com/api/latest/incidents/
- **Reference** — https://docs.datadoghq.com/service_management/incident_management/

## Other Datadog APIs (12)

- [Datadog Dashboards API](https://apis.io/apis/datadog/datadog-dashboards-api/)
- [Datadog Synthetics API](https://apis.io/apis/datadog/datadog-synthetics-api/)
- [Datadog Service Level Objectives API](https://apis.io/apis/datadog/datadog-service-level-objectives-api/)
- [Datadog Security Monitoring API](https://apis.io/apis/datadog/datadog-security-monitoring-api/)
- [Datadog Service Definition API](https://apis.io/apis/datadog/datadog-service-definition-api/)
- [Datadog Software Catalog API](https://apis.io/apis/datadog/datadog-software-catalog-api/)
- [Datadog Users API](https://apis.io/apis/datadog/datadog-users-api/)
- [Datadog Key Management API](https://apis.io/apis/datadog/datadog-key-management-api/)
- [Datadog Organizations API](https://apis.io/apis/datadog/datadog-organizations-api/)
- [Datadog Downtimes API](https://apis.io/apis/datadog/datadog-downtimes-api/)
- [Datadog RUM API](https://apis.io/apis/datadog/datadog-rum-api/)
- [Datadog APM Retention Filters API](https://apis.io/apis/datadog/datadog-apm-retention-filters-api/)

## Tags

Roles

---

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