---
title: "List Chat Connections"
method: GET
path: "/api/chat/connections"
tags: ["v2", "chat", "chat"]
---

# List Chat Connections

`GET /api/chat/connections`

Every AI connection the user can chat over, described by the server.

Additive alongside ``GET /transports``, which keeps its shape. This
carries what a client would otherwise have to infer — provider family,
what backs a run, the quality tiers, and the limitations that apply —
so product and billing statements come from the side that enforces them.

## Response `200`

Successful Response

- AIConnectionOffersResponse
  - `offers` AIConnectionOffer[], required
    - `offer_id` string, required
    - `provider_family` string, required
    - `display_name` string, required
    - `auth_method` string, required
    - `credential_id` string, nullable, required
    - `backed_by_label` string, required
    - `description` string, required
    - `state` string, required
    - `selectable` boolean, required
    - `is_default` boolean, required
    - `tiers` ConnectionTier[], required
      - `tier` 'standard' | 'advanced', required
      - `label` string, required
      - `selectable` boolean, required
      - `display_model` string, nullable
      - `lock_reason` string, nullable
    - `limitations` string[], required
    - `lock_reason` string, nullable
    - `unlock_href` string, nullable

## Other responses

- `401` — Authentication required

## Changes

- **2026-09-02** `f6b768414df0` — 1 info
  - added the optional property `offers/items/tiers/items/lock_reason` to the response with the `200` status
- **2026-09-02** `8710d0e78d92` — 3 info
  - added the optional property `offers/items/lock_reason` to the response with the `200` status
  - added the optional property `offers/items/tiers/items/display_model` to the response with the `200` status
  - added the optional property `offers/items/unlock_href` to the response with the `200` status
- **2026-09-02** `4010c759bbe8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/chat/connections/get.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/significant-gravitas/autogpt-agent-server/revisions/dc8f009814db/schema)