Org Content

List events

GET/org-content/event
org-content:readlist_org_eventsRead-only

Lists the organisation's events. The featured event comes first unless it has ended, then the organisation's sort setting for events, then the oldest id. Someone who cannot manage content sees only published items whose publish date has passed. Changes nothing.

Query parameters

  • limitinteger#

    Page size (1–100). Defaults to 25; values are clamped to the range.

    Default: 25
  • cursorstring#

    Opaque pagination cursor taken from a prior response's meta.next_cursor.

  • fieldsstring#

    Comma-separated top-level fields to return. id is always returned.

  • sortstring#

    Comma-separated fields to sort by: id, created_at, updated_at, title, publish_date, start_date, end_date. Prefix a field with - for descending. When given, it replaces the organisation's sort setting; the featured item still comes first. Defaults to the setting.

  • filter[q]string#

    Items whose title or summary contains this text, ignoring case.

  • filter[published]boolean#

    true for published items only, false for drafts only.

  • filter[featured]boolean#

    true for the featured item only, false for every other item.

Responses

200

The events.

OrgEvent[]
{
  "data": [
    {
      "id": "9a9d1c5e-4f2b-4c8e-9a7d-2f1e6b3c4d5a",
      "type": "event",
      "title": "string",
      "summary": "string",
      "body": "string",
      "author": "string",
      "external_link": "string",
      "image_file_key": "string",
      "published": true,
      "featured": true,
      "publish_date": "2026-06-12T10:00:00+00:00",
      "location": "string",
      "start_date": "2026-06-12T10:00:00+00:00",
      "end_date": "2026-06-12T10:00:00+00:00",
      "like_count": 1,
      "comment_count": 1,
      "created_at": "2026-06-12T10:00:00+00:00",
      "updated_at": "2026-06-12T10:00:00+00:00"
    }
  ],
  "meta": {
    "limit": 1,
    "next_cursor": "string",
    "prev_cursor": "string"
  }
}
401

Authentication failed. error.code is one of invalid_token, expired, revoked.

Error
403

Authorization failed. error.code is one of org_disabled, ip_blocked, missing_scope, scope_disabled, user_disabled.

Error
422

The request can't be processed (HTTP 422): validation_failed with one ErrorDetail per problem, or a code documented on the operation.

Error
429

Rate limit exceeded (error.code = rate_limited).

Error

Examples

curl https://your-org-domain/kong/core/api/v2/org-content/event\
  -H "Authorization: Bearer $HELM_API_KEY"\
  -H "Content-Type: application/json"