Lists the Channels of the selected workspace that the current caller may administer, each with the strong Channel ETag the existing mutations take as their precondition, without changing any state.
const url = 'https://example.com/v1/m/sessions/channels/administration?workspace_id=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0&state=all&limit=50';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://example.com/v1/m/sessions/channels/administration?workspace_id=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0&state=all&limit=50' \ --header 'Authorization: Bearer <token>'Lists the Channels of the selected workspace that the current caller may administer, each with the strong Channel ETag the existing mutations take as their precondition, without changing any state.
Authorizations
Section titled “ Authorizations ”Parameters
Section titled “ Parameters ”Header Parameters
Section titled “ Header Parameters ”Target tenant id; required when the principal can act in more than one tenant.
Query Parameters
Section titled “ Query Parameters ”Canonical stored workspace UUID selected for this personal collection; it is revalidated and never grants authority.
Persisted Channel state selection: all (default), active or archived. Archived Channels are inspectable because administration must not depend on the operational read catalog; nothing here un-archives one.
Authenticated c3a1 continuation returned by the preceding page, anchored to the last Channel it returned; its claims are base64-readable and MAC-authenticated, not encrypted, and it conveys no authority. It is a distinct family from the read catalog’s c3n1 and from c3g1.
Administrable page size from 1 through 200; default 50.
Responses
Section titled “ Responses ”Administrable Channels of the selected workspace with each Channel’s current precondition ETag
object
Authenticated c3a1 token anchored to the last returned Channel; present only when has_more is true.
True exactly when an administrable limit+1th Channel was authorized in the same bound transaction; never a hidden-row fact.
object
object
Strong Channel validator (“v
Example generated
{ "continuation": "example", "has_more": true, "items": [ { "channel": { "acl_revision": 1, "content_protection": "example", "created_at": "2026-04-15T12:00:00Z", "default_ack_policy": "example", "default_ack_timeout_ms": 1, "default_wake": "example", "description": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "kind": "example", "max_automation_depth": 1, "max_fanout": 1, "name": "example", "protection_generation": 1, "retention_policy_ref": "example", "route_revision": 1, "sensitivity": "example", "slug": "example", "state": "example", "subscription_revision": 1, "tenant_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "updated_at": "2026-04-15T12:00:00Z", "version": 1, "workspace_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }, "etag": "example" } ]}Headers
Section titled “ Headers ”Always no-store. These pages are authorization-dependent and observation-dependent: the same request from the same client can legitimately produce a different answer a moment later, and a refusal must never be replayed from a cache after the authority behind it changed. There is no HTTP ETag and no 304 on these routes; the etag in the body is the Channel precondition for the existing mutations, not a representation validator.
Bad request
object
Example generated
{}Headers
Section titled “ Headers ”Always no-store. These pages are authorization-dependent and observation-dependent: the same request from the same client can legitimately produce a different answer a moment later, and a refusal must never be replayed from a cache after the authority behind it changed. There is no HTTP ETag and no 304 on these routes; the etag in the body is the Channel precondition for the existing mutations, not a representation validator.
Unauthenticated
object
Example generated
{}Headers
Section titled “ Headers ”Always no-store. These pages are authorization-dependent and observation-dependent: the same request from the same client can legitimately produce a different answer a moment later, and a refusal must never be replayed from a cache after the authority behind it changed. There is no HTTP ETag and no 304 on these routes; the etag in the body is the Channel precondition for the existing mutations, not a representation validator.
Forbidden
object
Example generated
{}Headers
Section titled “ Headers ”Always no-store. These pages are authorization-dependent and observation-dependent: the same request from the same client can legitimately produce a different answer a moment later, and a refusal must never be replayed from a cache after the authority behind it changed. There is no HTTP ETag and no 304 on these routes; the etag in the body is the Channel precondition for the existing mutations, not a representation validator.
Not found
object
Example generated
{}Headers
Section titled “ Headers ”Always no-store. These pages are authorization-dependent and observation-dependent: the same request from the same client can legitimately produce a different answer a moment later, and a refusal must never be replayed from a cache after the authority behind it changed. There is no HTTP ETag and no 304 on these routes; the etag in the body is the Channel precondition for the existing mutations, not a representation validator.
Rate limited
object
Example generated
{}Headers
Section titled “ Headers ”Always no-store. These pages are authorization-dependent and observation-dependent: the same request from the same client can legitimately produce a different answer a moment later, and a refusal must never be replayed from a cache after the authority behind it changed. There is no HTTP ETag and no 304 on these routes; the etag in the body is the Channel precondition for the existing mutations, not a representation validator.
Current authority, custody or store evidence is unavailable; or, with code commit_outcome_unknown, the write was issued and its outcome was never learned, so it may be durable and must not be retried automatically
object
Example generated
{}Headers
Section titled “ Headers ”Always no-store. These pages are authorization-dependent and observation-dependent: the same request from the same client can legitimately produce a different answer a moment later, and a refusal must never be replayed from a cache after the authority behind it changed. There is no HTTP ETag and no 304 on these routes; the etag in the body is the Channel precondition for the existing mutations, not a representation validator.