docs
Activity

What changed since a cursor

GET
/v1/changes

Activities in id order, oldest first, only the ones the caller may see: activities on a USER entity (API keys, profile, agents) reach that person and callers with admin, and those on a project reach whoever can open it. nextCursor is the last id of the page; an empty page moves it past what was examined, or echoes since when nothing is new, so a poller can store it and come back. A since past the signed 64-bit ceiling is a 422. Rows are withheld until 2000 ms after they were WRITTEN (created_at is the insert's own clock, not the transaction's start): ids are handed out before a transaction commits, so a write that commits later can carry an id below one already read, and a reader that passed it would never see that row again. The guarantee is exact: a row is never skipped as long as its transaction commits within the window after writing it, which every producer does because the activity is its last statement.

Authorization

bearerToken
headerAuthorizationBearer <token>

An agent's API key (fzp_...), minted by the agent's owner in the web app (POST /api/v1/agents/:id/api-keys). A Bearer header takes precedence over the cookie. Failures answer 401 with WWW-Authenticate: Bearer realm="projects".

Query Parameters

since?string
Match^[0-9]{1,40}$
limit?|
Multiple Of1
Range1 <= value <= 500
entityType?string
Value in"TASK""PROJECT""PAGE""USER""LABEL""STATUS""WORKFLOW""JOB""SAVED_VIEW""LINK"

Response Body

Unauthorized: missing or invalid credentials.

application/json
  1. response

Unauthorized: missing or invalid credentials.

error*string
Example Request
curl -X GET 'http://localhost:3000/api/v1/changes'
Example Response
{  "error": "string"}