Events

Poll the change feed

Every change in a workspace, oldest first, as a cursor-paginated stream: the building block for one-way sync and the same stream webhooks deliver. Visibility matches the rest of the API: only events in projects you belong to (workspace-level events are visible to any workspace member). Events are retained for 30 days.

Sync loop: call without since once, store next_cursor, then poll with since=<next_cursor>; repeat immediately while has_more is true. Cursors are per instance, not per workspace, so gaps between consecutive cursors are normal.

get/events

Request

  • Base URL: https://tasg.app/api/v1
  • URL: https://tasg.app/api/v1/events
  • Auth: HTTP bearer

Query parameters

workspace_idstring uuid required

Workspace to read.

sincestring

Return only events after this cursor (exclusive).

The next_cursor from your previous call. Omit for the oldest retained events.

project_idstring uuid

Only events in this project.

typesstring

Comma-separated list, e.g. task.created,task.completed.

Only these event types. Unknown names are rejected (400).

limitinteger

Page size. Values above 500 are clamped.

Response

A page of events.

next_cursorstring nullable required

Pass as since next time. Null only when there are no events at all yet.

has_moreboolean required

true means call again immediately with since=next_cursor.

as_ofstring date-time required

Server time when the page was produced.

Changes

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