---
title: "Create or update HAMR organization connection"
method: POST
path: "/api/v2/hamr"
tags: ["High Availability MultiRegion"]
---

# Create or update HAMR organization connection

`POST /api/v2/hamr`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/hamr`
- Auth: API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`

Create or update the High Availability Multi-Region (HAMR) organization connection.
This endpoint allows you to configure the HAMR connection between the authenticated organization
and a target organization, including setting the connection status (ONBOARDING, PASSIVE, FAILOVER, ACTIVE, RECOVERY)

## Request body

- HamrOrgConnectionRequest: Request payload for creating or updating a HAMR organization connection.
  - `data` HamrOrgConnectionDataRequest, required: Data object for a HAMR organization connection request.
    - `attributes` HamrOrgConnectionAttributesRequest, required: Attributes for a HAMR organization connection request.
      - `hamr_status` 0 | 1 | 2 | 3 | 4 | 5, required: Status of the HAMR connection: - 0: UNSPECIFIED - Connection status not specified - 1: ONBOARDING - Initial setup of HAMR connection - 2: PASSIVE - Secondary organization in passive standby mode - 3: FAILOVER - Liminal status between PASSIVE and ACTIVE - 4: ACTIVE - Organization is an active failover - 5: RECOVERY - Recovery operation in progress
      - `is_primary` boolean, required: Indicates whether this organization is the primary organization in the HAMR relationship. If true, this is the primary organization. If false, this is the secondary/backup organization.
      - `modified_by` string, required: Username or identifier of the user who last modified this HAMR connection.
      - `target_org_datacenter` string, required: Datacenter location of the target organization (e.g., us1, eu1, us5).
      - `target_org_name` string, required: Name of the target organization in the HAMR relationship.
      - `target_org_uuid` string, required: UUID of the target organization in the HAMR relationship.
    - `id` string, required: The organization UUID for this HAMR connection. Must match the authenticated organization's UUID.
    - `type` 'hamr_org_connections', required: Type of the HAMR organization connection resource.

## Response `200`

OK

- HamrOrgConnectionResponse: Response payload for a HAMR organization connection.
  - `data` HamrOrgConnectionDataResponse, required: Data object for a HAMR organization connection response.
    - `attributes` HamrOrgConnectionAttributesResponse, required: Attributes of a HAMR organization connection response.
      - `hamr_status` 0 | 1 | 2 | 3 | 4 | 5, required: Status of the HAMR connection: - 0: UNSPECIFIED - Connection status not specified - 1: ONBOARDING - Initial setup of HAMR connection - 2: PASSIVE - Secondary organization in passive standby mode - 3: FAILOVER - Liminal status between PASSIVE and ACTIVE - 4: ACTIVE - Organization is an active failover - 5: RECOVERY - Recovery operation in progress
      - `is_primary` boolean, required: Indicates whether this organization is the primary organization in the HAMR relationship. If true, this is the primary organization. If false, this is the secondary/backup organization.
      - `modified_at` string, required: Timestamp of when this HAMR connection was last modified (RFC3339 format).
      - `modified_by` string, required: Username or identifier of the user who last modified this HAMR connection.
      - `target_org_datacenter` string, required: Datacenter location of the target organization (e.g., us1, eu1, us5).
      - `target_org_name` string, required: Name of the target organization in the HAMR relationship.
      - `target_org_uuid` string, required: UUID of the target organization in the HAMR relationship.
    - `id` string, required: The organization UUID for this HAMR connection.
    - `type` 'hamr_org_connections', required: Type of the HAMR organization connection resource.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `429`: Too many requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)