events

The account's events, oldest first by updatedAt, paged by a stable cursor.

A key acts for its own account; a session for the account in the account header. A personal account reads its own events (not its teams'); a team reads the team's. Keys made before scopes cannot read it (403 insufficient_scope). The page is oldest first by updatedAt, then sequence. nextCursor is always set: pass it back for the next page, or keep it and poll; an empty page still moves it on, so the next call reads only new events. Events are the webhook catalog's, with the same data; they are kept 90 days. Load by id to drop the rare repeat. Behind the warehouseExport flag: 404 not_found until it is on for your account.

get/v1/events

Request

  • Base URL: https://api.50heads.com
  • URL: https://api.50heads.com/v1/events
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://auth.50heads.com/authorize, token URL https://auth.50heads.com/token; client credentials, token URL https://auth.50heads.com/token, scopes: events:read)

Query parameters

cursorstring

nextCursor from the last page. Omit to start from the oldest event still kept (90 days), or from since.

sincestring

With no cursor: start at events updated at or after this time (ISO 8601, or a date).

typestring

Only this event type (question.completed), or every type of a group (question).

limitinteger

Events per page (default 100, at most 500).

Response

OK

nextCursorstring required
hasMoreboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.