Skip to content
Olivares AI docs

Lists the active Channels of the selected workspace that the current caller may read, with the caller's own current local grant bits, without changing any state.

GET
/v1/m/sessions/channels
 
curl --request GET \
  --url 'https://example.com/v1/m/sessions/channels?workspace_id=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0&limit=50' \
  --header 'Authorization: Bearer <token>'

Lists the active Channels of the selected workspace that the current caller may read, with the caller’s own current local grant bits, without changing any state.

Authorizations

Section titled “ Authorizations ”

Parameters

Section titled “ Parameters ”

Header Parameters

Section titled “ Header Parameters ”
X-Olivares-Tenant
string format: uuid

Target tenant id; required when the principal can act in more than one tenant.

Query Parameters

Section titled “ Query Parameters ”
workspace_id
required
string format: uuid
/^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/

Canonical stored workspace UUID selected for this personal collection; it is revalidated and never grants authority.

continuation
string
>= 1 characters <= 2048 characters

Authenticated c3n1 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. Raw Channel positions are not accepted.

limit
integer
default: 50 >= 1 <= 200

Visible page size from 1 through 200; default 50.

Responses

Section titled “ Responses ”

200

Section titled “ 200 ”

Visible Channels of the selected workspace with the caller’s current local grant bits

Media type application/json
object
continuation

Authenticated c3n1 token anchored to the last returned Channel; present only when has_more is true.

string
has_more
required

True exactly when a visible limit+1th Channel was authorized in the same bound transaction; never a hidden-row fact.

boolean
items
required
Array<object>
object
acl_revision
required
integer format: int64
content_protection
required
string
created_at
required
string format: date-time
default_ack_policy
required
string
default_ack_timeout_ms
required
integer format: int64
default_wake
required
string
description
string
id
required
string format: uuid
kind
required
string
max_automation_depth
required
integer format: int64
max_fanout
required
integer format: int64
my_access
required
object
admin
required
boolean
read
required
boolean
write
required
boolean
name
required
string
protection_generation
required
integer format: int64
retention_policy_ref
string
route_revision
required
integer format: int64
sensitivity
required
string
slug
required
string
state
required
string
subscription_revision
required
integer format: int64
tenant_id
required
string format: uuid
updated_at
required
string format: date-time
version
required
integer format: int64
workspace_id
required
string format: uuid
Example generated 
{
  "continuation": "example",
  "has_more": true,
  "items": [
    {
      "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,
      "my_access": {
        "admin": true,
        "read": true,
        "write": true
      },
      "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"
    }
  ]
}

400

Section titled “ 400 ”

Bad request

Media type application/json
object
Example generated 
{}

401

Section titled “ 401 ”

Unauthenticated

Media type application/json
object
Example generated 
{}

403

Section titled “ 403 ”

Forbidden

Media type application/json
object
Example generated 
{}

404

Section titled “ 404 ”

Not found

Media type application/json
object
Example generated 
{}

429

Section titled “ 429 ”

Rate limited

Media type application/json
object
Example generated 
{}

503

Section titled “ 503 ”

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

Media type application/json
object
Example generated 
{}