---
title: "Fetch Channel Space"
method: GET
path: "/channels/spaces/{space_id}"
tags: ["Channels"]
---

# Fetch Channel Space

`GET /channels/spaces/{space_id}`

## Path parameters

- `space_id` string, uuid, required

## Response `200`

Successful Response

- ChannelSpaceResponse
  - `count` integer
  - `space` 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

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-25** `ec21cdc5486c` — 1 info
  - added the optional property `space/anyOf[subschema #1: ChannelSpace]/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/:space_id/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)
