Skip to main content
GET
List channel mappings

Authorizations

Authorization
string
header
required

An organization-scoped API key, minted in control under Settings → API keys. Every failure to authenticate answers one identical 401: "Provide a valid organization-scoped API key or an active session." Each operation names the one scope it is filed under, <resource>:<read|write>, where the resource is the first path segment after /api/v1/; a key minted today carries all 22 of them. Scopes are RECORDED — on the key and on every audit row — and are not yet enforced: no request is refused for want of one.

Path Parameters

id
string
required

The Worker id. A malformed id answers 404, exactly as another organization's well-formed id does.

Query Parameters

clientId
string

Narrow to one Client. Rows that belong to no Client — a core-tier ework, a room marked internal, a core-tier task — are excluded, because they are not that Client's. A malformed id is a 400; a well-formed id naming another organization's Client answers an empty list.

limit
integer

Page size. Defaults to 50, clamped at 200. A value that is not a positive integer is a 400.

cursor
string

Opaque keyset cursor from the previous page's page.nextCursor. A cursor this API did not issue is a 400, never a silent page one.

Response

Success.

data
object[]
required

The page.

page
object
required

Present on every list, even when there is nothing more to fetch.