---
title: Cloud Authentication
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > API Reference > Cloud Authentication
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Cloud Authentication

Configure AWS and GitHub cloud authentication mappings for persona and intake authentication through the Datadog API.

## [List AWS cloud authentication persona mappings →](https://docs.datadoghq.com/api/latest/cloud-authentication/list-aws-cloud-authentication-persona-mappings.md) preview{% #list-aws-cloud-authentication-persona-mappings %}

| Datadog site      | API endpoint                                                            |
| ----------------- | ----------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/cloud_auth/aws/persona_mapping      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/cloud_auth/aws/persona_mapping      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/cloud_auth/aws/persona_mapping  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping |

## [Get an AWS cloud authentication persona mapping →](https://docs.datadoghq.com/api/latest/cloud-authentication/get-an-aws-cloud-authentication-persona-mapping.md) preview{% #get-an-aws-cloud-authentication-persona-mapping %}

| Datadog site      | API endpoint                                                                                 |
| ----------------- | -------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping/{persona_mapping_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping/{persona_mapping_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/cloud_auth/aws/persona_mapping/{persona_mapping_id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/cloud_auth/aws/persona_mapping/{persona_mapping_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/cloud_auth/aws/persona_mapping/{persona_mapping_id}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping/{persona_mapping_id} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping/{persona_mapping_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping/{persona_mapping_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping/{persona_mapping_id} |

## [Create an AWS cloud authentication persona mapping →](https://docs.datadoghq.com/api/latest/cloud-authentication/create-an-aws-cloud-authentication-persona-mapping.md) preview{% #create-an-aws-cloud-authentication-persona-mapping %}

| Datadog site      | API endpoint                                                             |
| ----------------- | ------------------------------------------------------------------------ |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/cloud_auth/aws/persona_mapping      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/cloud_auth/aws/persona_mapping      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/cloud_auth/aws/persona_mapping  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping |

## [Delete an AWS cloud authentication persona mapping →](https://docs.datadoghq.com/api/latest/cloud-authentication/delete-an-aws-cloud-authentication-persona-mapping.md) preview{% #delete-an-aws-cloud-authentication-persona-mapping %}

| Datadog site      | API endpoint                                                                                    |
| ----------------- | ----------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping/{persona_mapping_id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping/{persona_mapping_id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/cloud_auth/aws/persona_mapping/{persona_mapping_id}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/cloud_auth/aws/persona_mapping/{persona_mapping_id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/cloud_auth/aws/persona_mapping/{persona_mapping_id}  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping/{persona_mapping_id} |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping/{persona_mapping_id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping/{persona_mapping_id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/cloud_auth/aws/persona_mapping/{persona_mapping_id} |

## [List GitHub cloud authentication persona mappings →](https://docs.datadoghq.com/api/latest/cloud-authentication/list-github-cloud-authentication-persona-mappings.md) preview{% #list-github-cloud-authentication-persona-mappings %}

| Datadog site      | API endpoint                                                               |
| ----------------- | -------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/cloud_auth/github/persona_mapping |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/cloud_auth/github/persona_mapping |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/cloud_auth/github/persona_mapping      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/cloud_auth/github/persona_mapping      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/cloud_auth/github/persona_mapping  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/cloud_auth/github/persona_mapping |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/cloud_auth/github/persona_mapping     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/cloud_auth/github/persona_mapping |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/cloud_auth/github/persona_mapping |

## [Get a GitHub cloud authentication persona mapping →](https://docs.datadoghq.com/api/latest/cloud-authentication/get-a-github-cloud-authentication-persona-mapping.md) preview{% #get-a-github-cloud-authentication-persona-mapping %}

| Datadog site      | API endpoint                                                                                    |
| ----------------- | ----------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id} |

## [Create a GitHub cloud auth persona mapping →](https://docs.datadoghq.com/api/latest/cloud-authentication/create-a-github-cloud-auth-persona-mapping.md) preview{% #create-a-github-cloud-auth-persona-mapping %}

| Datadog site      | API endpoint                                                                |
| ----------------- | --------------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/cloud_auth/github/persona_mapping |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/cloud_auth/github/persona_mapping |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/cloud_auth/github/persona_mapping      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/cloud_auth/github/persona_mapping      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/cloud_auth/github/persona_mapping  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/cloud_auth/github/persona_mapping |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/cloud_auth/github/persona_mapping     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/cloud_auth/github/persona_mapping |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/cloud_auth/github/persona_mapping |

## [Delete a GitHub cloud auth persona mapping →](https://docs.datadoghq.com/api/latest/cloud-authentication/delete-a-github-cloud-auth-persona-mapping.md) preview{% #delete-a-github-cloud-auth-persona-mapping %}

| Datadog site      | API endpoint                                                                                       |
| ----------------- | -------------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id}  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id} |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/cloud_auth/github/persona_mapping/{persona_mapping_id} |

## [List GitHub cloud authentication intake mappings →](https://docs.datadoghq.com/api/latest/cloud-authentication/list-github-cloud-authentication-intake-mappings.md) preview{% #list-github-cloud-authentication-intake-mappings %}

| Datadog site      | API endpoint                                                              |
| ----------------- | ------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/cloud_auth/github/intake_mapping |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/cloud_auth/github/intake_mapping |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/cloud_auth/github/intake_mapping      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/cloud_auth/github/intake_mapping      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/cloud_auth/github/intake_mapping  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/cloud_auth/github/intake_mapping |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/cloud_auth/github/intake_mapping     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/cloud_auth/github/intake_mapping |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/cloud_auth/github/intake_mapping |

## [Get a GitHub cloud authentication intake mapping →](https://docs.datadoghq.com/api/latest/cloud-authentication/get-a-github-cloud-authentication-intake-mapping.md) preview{% #get-a-github-cloud-authentication-intake-mapping %}

| Datadog site      | API endpoint                                                                                  |
| ----------------- | --------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id}  |
| uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id} |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id} |

## [Create a GitHub cloud auth intake mapping →](https://docs.datadoghq.com/api/latest/cloud-authentication/create-a-github-cloud-auth-intake-mapping.md) preview{% #create-a-github-cloud-auth-intake-mapping %}

| Datadog site      | API endpoint                                                               |
| ----------------- | -------------------------------------------------------------------------- |
| ap1.datadoghq.com | POST https://api.ap1.datadoghq.com/api/v2/cloud_auth/github/intake_mapping |
| ap2.datadoghq.com | POST https://api.ap2.datadoghq.com/api/v2/cloud_auth/github/intake_mapping |
| app.datadoghq.eu  | POST https://api.datadoghq.eu/api/v2/cloud_auth/github/intake_mapping      |
| app.ddog-gov.com  | POST https://api.ddog-gov.com/api/v2/cloud_auth/github/intake_mapping      |
| us2.ddog-gov.com  | POST https://api.us2.ddog-gov.com/api/v2/cloud_auth/github/intake_mapping  |
| uk1.datadoghq.com | POST https://api.uk1.datadoghq.com/api/v2/cloud_auth/github/intake_mapping |
| app.datadoghq.com | POST https://api.datadoghq.com/api/v2/cloud_auth/github/intake_mapping     |
| us3.datadoghq.com | POST https://api.us3.datadoghq.com/api/v2/cloud_auth/github/intake_mapping |
| us5.datadoghq.com | POST https://api.us5.datadoghq.com/api/v2/cloud_auth/github/intake_mapping |

## [Delete a GitHub cloud auth intake mapping →](https://docs.datadoghq.com/api/latest/cloud-authentication/delete-a-github-cloud-auth-intake-mapping.md) preview{% #delete-a-github-cloud-auth-intake-mapping %}

| Datadog site      | API endpoint                                                                                     |
| ----------------- | ------------------------------------------------------------------------------------------------ |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id}  |
| uk1.datadoghq.com | DELETE https://api.uk1.datadoghq.com/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id} |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/cloud_auth/github/intake_mapping/{intake_mapping_id} |
