Announcements

List announcements

Announcements published in your workspace, with their engagement counters.

Required scope announces:read

get/announcements

Authorizations

Authorizationstringrequired

Authorization header carrying a workspace API key, as “Bearer kbn_live_…”. The X-Api-Key header is accepted equivalently.

Query parameters

limitintegerdefault 50

Page size. Clamped to [1, 200] — out-of-range values are silently brought back into range, never rejected.

min: 1 · max: 200

offsetintegerdefault 0

Number of items to skip. Floored at 0.

min: 0

Response200 · application/json

A page of announcements.

dataany[]required

The page of items.

paginationobjectrequired

Offset pagination envelope shared by every paginated list endpoint.

{ "data": [ { "id": "3f9c9f2e-8a71-4e2a-9b0d-2c5f6a1d7e44", "title": "<string>", "content": "<string>", "type": "<string>", "teams": [ "3f9c9f2e-8a71-4e2a-9b0d-2c5f6a1d7e44" ], "app": "3f9c9f2e-8a71-4e2a-9b0d-2c5f6a1d7e44", "startDate": "2026-09-01T09:12:03Z", "endDate": "2026-09-01T09:12:03Z", "createdAt": "2026-09-01T09:12:03Z", "updatedAt": "2026-09-01T09:12:03Z", "seenCount": 123, "likeCount": 123, "dislikeCount": 123, "likeRatio": 123 } ], "pagination": { "limit": 123, "offset": 123, "total": 123 } }