---
title: "List Channel Spaces"
method: GET
path: "/channels/spaces/"
tags: ["Channels"]
---

# List Channel Spaces

`GET /channels/spaces/`

## Response `200`

Successful Response

- ChannelSpacesResponse
  - `count` integer
  - `spaces` ChannelSpace[]
    - `flags` ChannelSpaceFlags
      - `is_active` boolean
      - `is_backfilled` boolean
      - `is_opted_out` boolean
    - `tags` object, nullable
    - `meta` object, nullable
    - `name` string, nullable
    - `description` string, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `deleted_at` string, date-time, nullable
    - `created_by_id` string, uuid, nullable
    - `updated_by_id` string, uuid, nullable
    - `deleted_by_id` string, uuid, nullable
    - `id` string, uuid, nullable
    - `connection_id` string, uuid, required
    - `kind` 'private' | 'group' | 'topic', required
    - `external_key` string, uuid, required
    - `data` ChannelSpaceData, required
      - `external_locator` object, required
      - `policy` ChannelPolicy — What one level STATED. Every field optional; None means no opinion.
        - `triggers` ChannelTriggerKind[], nullable
        - `session_scope` 'thread' | 'message'
        - `backfill` boolean, nullable
        - `forwardfill` boolean, nullable

## Changes

- **2026-09-25** `ec21cdc5486c` — 1 info
  - added the optional property `spaces/items/flags/is_opted_out` to the response with the `200` status
- **2026-09-24** `a28f1d059149` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/channels/spaces/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)