---
title: "List the environments a coding agent connection may launch in"
method: GET
path: "/integrations/connections/{connectionId}/coding-agent-environments"
tags: ["Integrations"]
---

# List the environments a coding agent connection may launch in

`GET /integrations/connections/{connectionId}/coding-agent-environments`

## Request

- Base URL: `https://api.sazabi.com/v1`
- URL: `https://api.sazabi.com/v1/integrations/connections/{connectionId}/coding-agent-environments`
- Auth: none declared
- TypeScript: <https://skmtc.dev/sazabi/apis/sazabi-public-api/docs/integrations/connections/:connectionId/coding-agent-environments/get.ts> (a function with typed inputs; its response is checked against the schema)

List the vendor environments a coding agent connection's key may launch a fix in (Replicas organization environments), each with the GitHub repositories it holds. Read live from the vendor; never launches work; personal environments are left out. Pass one's `id` as `environmentId` to `issues.fixes.create` or `agentDispatches.projectDefault.update`. An agent without environments answers `supported: false`.

## Path parameters

- `connectionId` string, uuid, required: A coding agent connection ID.

## Query parameters

- `organizationId` string: Organization the connection belongs to. Auto-filled from CLI and SDK context when omitted. User tokens must supply it unless the credential's fixed scope resolves it; secret keys may omit it (the key's organization applies).

## Response `200`

OK

- object
  - `supported` boolean, required: Whether the agent has environments at all; `environments` is empty when not.
  - `environments` object[], required
    - `id` string, required: The vendor's id for the environment.
    - `name` string, nullable, required: The environment's name at the vendor.
    - `scope` 'team' | 'personal', required: Whose it is: `team` is shared by the organization behind the key and is what a launch prefers; `personal` belongs to one person at the vendor.
    - `defaultBranch` string, nullable, required: The branch its runs start from, when the vendor's environment names one.
    - `repositories` object[], required: The GitHub repositories the environment holds.
      - `url` string, required: Canonical `https://github.com/<owner>/<name>`.
      - `fullName` string, required: `<owner>/<name>`.
    - `readiness` object, required: Whether a fix launched there would run with a working setup, from the vendor's own status. A fix is never handed to, or launched in, an environment that is not ready.
      - `ready` boolean, required
      - `reason` string, nullable, required: The vendor's reason while not ready; null when ready.

## Changes

- **2026-10-31** `e44124da5016`: 1 breaking, 2 info
  - removed the required property `environments/items/inherited` from the response with the `200` status
  - added the required property `environments/items/defaultBranch` to the response with the `200` status
  - added the required property `environments/items/scope` to the response with the `200` status
- **2026-10-30** `83f1a0e4894e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sazabi/apis/sazabi-public-api/changes/integrations/connections/:connectionId/coding-agent-environments/get.md)

---

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