---
title: "Create connection environments"
method: POST
path: "/v1/connection-environments"
tags: ["Connection environments"]
---

# Create connection environments

`POST /v1/connection-environments`

Creates connection environments by associating environment-specific connections with a base connection

## Request body

- object
  - `baseConnectionId` string, uuid, required — The UUID of the base connection to associate environment connections with
  - `environmentConnectionIds` string, required — A comma-separated list of connection UUIDs to use as environment connections. All connection IDs must be valid UUIDs that: - Exist in your organization - Have the same dialect as the base connection - Aren't already used as environment connections for the base connection - Aren't the same as the base connection

## Response `201`

Connection environment(s) created successfully

- object
  - `success` boolean
  - `data` object[]
    - `id` string, uuid
    - `environmentConnectionId` string, uuid

## Other responses

- `400` — Bad Request Possible error messages: - `Invalid method` - `Invalid JSON` - `baseConnectionId: Base connection ID must be a valid UUID` - `environmentConnectionIds: All environment connection IDs must be valid UUIDs` - `The following environment connection IDs are not valid for this connection: <ids>`
- `403` — Forbidden - Insufficient permissions
- `404` — Not Found Possible error messages: - `Connection with id <baseConnectionId> does not exist`
- `429` — Too Many Requests - Rate limit exceeded (60 requests/minute)

---

[API](https://skmtc.net/omni/apis/omni-api.md) · [All operations](https://skmtc.net/omni/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omni/omni-api/revisions/6b02f7349d0e/schema)