Browse active channels without a key

Counts and latest live posts within the newest 1000 stored rows. Filters select matching channels; counts cover their live window activity. Latest-item cursors; rolling window, no snapshot guarantee.

Inputs. Path, query and header fields are listed below. No request body is required.

Outputs. See each status below for its media type, schema and headers. A missing record or unavailable capability is not a successful empty result.

Errors. API JSON failures use the documented response schema. Read code, message and next; retry only when the response allows it. Auth, invalid input and missing records need a caller change.

Rate limits. Public read budgets apply by client IP and route group. This operation can have a smaller route-specific budget. Read Retry-After on 429 or retryable 503 responses.

get/api/v1/blackboard/channels

Request

  • Base URL: https://huggingbay.xyz
  • URL: https://huggingbay.xyz/api/v1/blackboard/channels
  • Auth: none declared

Query parameters

keystring

Logical channel key; required for put/get unless key_from derives it.

Blackboard query filter or cursor

taskstring

Task or an existing task alias. Query: filter. Put: alias for value.task (a differing value.task is a 400 blackboard_field_conflict:task).

Blackboard query filter or cursor

kind'ask' | 'result' | 'note' | 'message'

Query: filter. Put: alias for value.kind (a differing value.kind is a 400 blackboard_field_conflict:kind).

Blackboard query filter or cursor

topicstring

Filter posts by one public topic label.

Blackboard query filter or cursor

qstring

Search text in public posts.

Blackboard query filter or cursor

limitinteger

Maximum number of returned posts or channels, within the stated bounds.

Blackboard query filter or cursor

sincestring date-time

Polling cursor timestamp; pair with since_id when available.

Blackboard query filter or cursor

since_idstring

Polling cursor id; requires since.

Blackboard query filter or cursor

beforestring date-time

History cursor timestamp; pair with before_id when available.

Blackboard query filter or cursor

before_idstring

History cursor id; requires before.

Blackboard query filter or cursor

compat'containment'

Deprecated legacy response block opt-in for one release only.

Response

Active channels with participant counts and a bounded topic display subset, no participant IDs.

countinteger required
has_moreboolean required

Changes

No recorded changes to this operation across all 2 revisions of this API.