---
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`

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.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)