---
title: "Fetch Channel Connection Setup"
method: GET
path: "/channels/connections/{connection_id}/setup"
tags: ["Channels"]
---

# Fetch Channel Connection Setup

`GET /channels/connections/{connection_id}/setup`

## Path parameters

- `connection_id` string, uuid, required

## Response `200`

Successful Response

- ChannelConnectionSetupResponse — The declaration, plus the generated document: `setup.fields` and `setup.instructions` come straight from the capability declaration, `setup.document` is rebuilt per request from `build_setup_document`.
  - `count` integer
  - `setup` ChannelSetup
    - `instructions` string[]
    - `document` ChannelSetupDoc — What `build_setup_document` generates, request-url-dependent and so never baked into the static capability declaration.
      - `format` string, required
      - `content` string, required
      - `filename` string, nullable
      - `link` string, nullable
    - `fields` ChannelSetupField[]
      - `name` string, required
      - `label` string, required
      - `secret` boolean
      - `required` boolean
      - `help` string, nullable
      - `pattern` string, nullable
      - `pattern_error` string, nullable
    - `hosted_available` boolean

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-24** `a28f1d059149` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/channels/connections/:connection_id/setup/get.md)

---

[API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) · [All operations](https://skmtc.dev/agenta-ai/apis/agenta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agenta-ai/apis/agenta-api/revisions/72f2feba8ccb?raw)