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

# Org Groups

Manage organization groups, memberships, policies, policy overrides, and policy configurations.

## List org groups → preview{% #list-org-groups %}

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

## Get an org group → preview{% #get-an-org-group %}

| Datadog site      | API endpoint                                                       |
| ----------------- | ------------------------------------------------------------------ |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/org_groups/{org_group_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/org_groups/{org_group_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/org_groups/{org_group_id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/org_groups/{org_group_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/org_groups/{org_group_id}  |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/org_groups/{org_group_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/org_groups/{org_group_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/org_groups/{org_group_id} |

## Create an org group → preview{% #create-an-org-group %}

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

## Update an org group → preview{% #update-an-org-group %}

| Datadog site      | API endpoint                                                         |
| ----------------- | -------------------------------------------------------------------- |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/org_groups/{org_group_id} |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/org_groups/{org_group_id} |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/org_groups/{org_group_id}      |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/org_groups/{org_group_id}      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/org_groups/{org_group_id}  |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/org_groups/{org_group_id}     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/org_groups/{org_group_id} |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/org_groups/{org_group_id} |

## Delete an org group → preview{% #delete-an-org-group %}

| Datadog site      | API endpoint                                                          |
| ----------------- | --------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/org_groups/{org_group_id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/org_groups/{org_group_id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/org_groups/{org_group_id}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/org_groups/{org_group_id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/org_groups/{org_group_id}  |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/org_groups/{org_group_id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/org_groups/{org_group_id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/org_groups/{org_group_id} |

## List org group memberships → preview{% #list-org-group-memberships %}

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

## Get an org group membership → preview{% #get-an-org-group-membership %}

| Datadog site      | API endpoint                                                                             |
| ----------------- | ---------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/org_group_memberships/{org_group_membership_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/org_group_memberships/{org_group_membership_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/org_group_memberships/{org_group_membership_id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/org_group_memberships/{org_group_membership_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/org_group_memberships/{org_group_membership_id}  |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/org_group_memberships/{org_group_membership_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/org_group_memberships/{org_group_membership_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/org_group_memberships/{org_group_membership_id} |

## Update an org group membership → preview{% #update-an-org-group-membership %}

| Datadog site      | API endpoint                                                                               |
| ----------------- | ------------------------------------------------------------------------------------------ |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/org_group_memberships/{org_group_membership_id} |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/org_group_memberships/{org_group_membership_id} |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/org_group_memberships/{org_group_membership_id}      |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/org_group_memberships/{org_group_membership_id}      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/org_group_memberships/{org_group_membership_id}  |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/org_group_memberships/{org_group_membership_id}     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/org_group_memberships/{org_group_membership_id} |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/org_group_memberships/{org_group_membership_id} |

## Bulk update org group memberships → preview{% #bulk-update-org-group-memberships %}

| Datadog site      | API endpoint                                                          |
| ----------------- | --------------------------------------------------------------------- |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/org_group_memberships/bulk |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/org_group_memberships/bulk |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/org_group_memberships/bulk      |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/org_group_memberships/bulk      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/org_group_memberships/bulk  |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/org_group_memberships/bulk     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/org_group_memberships/bulk |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/org_group_memberships/bulk |

## List org group policies → preview{% #list-org-group-policies %}

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

## Get an org group policy → preview{% #get-an-org-group-policy %}

| Datadog site      | API endpoint                                                                      |
| ----------------- | --------------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/org_group_policies/{org_group_policy_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/org_group_policies/{org_group_policy_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/org_group_policies/{org_group_policy_id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/org_group_policies/{org_group_policy_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/org_group_policies/{org_group_policy_id}  |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/org_group_policies/{org_group_policy_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/org_group_policies/{org_group_policy_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/org_group_policies/{org_group_policy_id} |

## Create an org group policy → preview{% #create-an-org-group-policy %}

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

## Update an org group policy → preview{% #update-an-org-group-policy %}

| Datadog site      | API endpoint                                                                        |
| ----------------- | ----------------------------------------------------------------------------------- |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/org_group_policies/{org_group_policy_id} |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/org_group_policies/{org_group_policy_id} |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/org_group_policies/{org_group_policy_id}      |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/org_group_policies/{org_group_policy_id}      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/org_group_policies/{org_group_policy_id}  |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/org_group_policies/{org_group_policy_id}     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/org_group_policies/{org_group_policy_id} |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/org_group_policies/{org_group_policy_id} |

## Delete an org group policy → preview{% #delete-an-org-group-policy %}

| Datadog site      | API endpoint                                                                         |
| ----------------- | ------------------------------------------------------------------------------------ |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/org_group_policies/{org_group_policy_id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/org_group_policies/{org_group_policy_id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/org_group_policies/{org_group_policy_id}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/org_group_policies/{org_group_policy_id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/org_group_policies/{org_group_policy_id}  |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/org_group_policies/{org_group_policy_id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/org_group_policies/{org_group_policy_id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/org_group_policies/{org_group_policy_id} |

## List org group policy overrides → preview{% #list-org-group-policy-overrides %}

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

## Get an org group policy override → preview{% #get-an-org-group-policy-override %}

| Datadog site      | API endpoint                                                                                       |
| ----------------- | -------------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id} |
| ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id} |
| app.datadoghq.eu  | GET https://api.datadoghq.eu/api/v2/org_group_policy_overrides/{org_group_policy_override_id}      |
| app.ddog-gov.com  | GET https://api.ddog-gov.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id}      |
| us2.ddog-gov.com  | GET https://api.us2.ddog-gov.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id}  |
| app.datadoghq.com | GET https://api.datadoghq.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id}     |
| us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id} |
| us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id} |

## Create an org group policy override → preview{% #create-an-org-group-policy-override %}

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

## Update an org group policy override → preview{% #update-an-org-group-policy-override %}

| Datadog site      | API endpoint                                                                                         |
| ----------------- | ---------------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | PATCH https://api.ap1.datadoghq.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id} |
| ap2.datadoghq.com | PATCH https://api.ap2.datadoghq.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id} |
| app.datadoghq.eu  | PATCH https://api.datadoghq.eu/api/v2/org_group_policy_overrides/{org_group_policy_override_id}      |
| app.ddog-gov.com  | PATCH https://api.ddog-gov.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id}      |
| us2.ddog-gov.com  | PATCH https://api.us2.ddog-gov.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id}  |
| app.datadoghq.com | PATCH https://api.datadoghq.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id}     |
| us3.datadoghq.com | PATCH https://api.us3.datadoghq.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id} |
| us5.datadoghq.com | PATCH https://api.us5.datadoghq.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id} |

## Delete an org group policy override → preview{% #delete-an-org-group-policy-override %}

| Datadog site      | API endpoint                                                                                          |
| ----------------- | ----------------------------------------------------------------------------------------------------- |
| ap1.datadoghq.com | DELETE https://api.ap1.datadoghq.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id} |
| ap2.datadoghq.com | DELETE https://api.ap2.datadoghq.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id} |
| app.datadoghq.eu  | DELETE https://api.datadoghq.eu/api/v2/org_group_policy_overrides/{org_group_policy_override_id}      |
| app.ddog-gov.com  | DELETE https://api.ddog-gov.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id}      |
| us2.ddog-gov.com  | DELETE https://api.us2.ddog-gov.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id}  |
| app.datadoghq.com | DELETE https://api.datadoghq.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id}     |
| us3.datadoghq.com | DELETE https://api.us3.datadoghq.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id} |
| us5.datadoghq.com | DELETE https://api.us5.datadoghq.com/api/v2/org_group_policy_overrides/{org_group_policy_override_id} |

## List org group policy configs → preview{% #list-org-group-policy-configs %}

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