---
title: "Create environment's federated environments relationships"
method: POST
path: "/environments/{environment}/relationships/federated-environments"
tags: ["federated-environments"]
---

# Create environment's federated environments relationships

`POST /environments/{environment}/relationships/federated-environments`

## Request

- Base URL: `https://example.scalr.io/api/iacp/v3`
- URL: `https://example.scalr.io/api/iacp/v3/environments/{environment}/relationships/federated-environments`
- Auth: HTTP bearer

## Path parameters

- `environment` string, required

## Request body

- FederatedEnvironmentRelationshipFieldsetsListingDocument: Document Listing.
  - `data` FederatedEnvironmentRelationship[]
    - `id` string, required
    - `type` 'environments', required
  - `included` object[]
  - `links` object
  - `meta` object

## Response `204`

Successfully created the federated environments relationships.

## Other responses

- `404`: Environments not found, or user unauthorized to perform action.
- `4XX`: Client error.
- `5XX`: Server error.

---

[API](https://skmtc.dev/scalr/apis/scalr-iacp-api.md) - [All operations](https://skmtc.dev/scalr/apis/scalr-iacp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scalr/apis/scalr-iacp-api/revisions/d3e1dc85657a?raw)