v1

latestOpenAPI 3.0.02026-08-04891301.4 MB

List activity feed entries

Returns a cursor-paginated list of activity feed entries visible to the authenticated user. Entries are ordered from newest to oldest by default. Use before_cursor to page backward and after_cursor to page forward.

Results are scoped to the caller's app. All filter params are optional and can be combined. Passing multiple values in an array filter returns entries matching any of the supplied values (OR semantics).

Invalid kind or level values return a 400 error listing the accepted values rather than being silently ignored.

get/api/v1/activity_feed

Query parameters

limitinteger

Maximum number of entries to return per page. Defaults to 50; maximum is 100.

kindstring[]

One or more entry kinds to include. Accepted values: routine_run, automation_run, thread_story, agent_quality_verdict, generic. Omit to return all kinds.

levelstring[]

One or more severity levels to include. Accepted values: debug, info, warn, error, audit. Omit to return all levels.

after_cursorstring

Opaque cursor from a previous response's after_cursor field. Returns entries newer than the cursor's position.

before_cursorstring

Opaque cursor from a previous response's before_cursor field. Returns entries older than the cursor's position.

agentstring[]

Restrict results to entries associated with these agent IDs (agt_...). Accepts multiple values.

orgstring[]

Restrict results to entries associated with these organization IDs (org_...). Accepts multiple values.

teamstring[]

Restrict results to entries associated with these team IDs (tem_...). Accepts multiple values.

threadstring[]

Restrict results to entries associated with these thread IDs (thr_...). Accepts multiple values.

correlation_idstring

Restrict results to entries that share this correlation group identifier. Useful for tracing a chain of related events.

Response

Successful response

after_cursorstring

Opaque cursor to pass as after_cursor to retrieve the next newer page. Absent when no newer entries exist.

before_cursorstring

Opaque cursor to pass as before_cursor to retrieve the next older page. Absent when no older entries exist.

has_moreboolean required

true when additional entries exist beyond this page in the requested direction.

Example response

{
  "after_cursor": "string",
  "before_cursor": "string",
  "data": [
    {
      "agent": "agi_0aBcDeFgHiJkLmNoPqRsTu",
      "app": "dap_0aBcDeFgHiJkLmNoPqRsTu",
      "attachments": [
        {}
      ],
      "automation_run": "atr_0aBcDeFgHiJkLmNoPqRsTu",
      "content": "The agent completed the task successfully.",
      "correlation_id": "01234567-89ab-cdef-0123-456789abcdef",
      "created_at": "2024-01-01T00:00:00Z",
      "id": "afe_0aBcDeFgHiJkLmNoPqRsTu",
      "kind": "agent_step",
      "level": "info",
      "metadata": {
        "key": "value"
      },
      "org": "org_0aBcDeFgHiJkLmNoPqRsTu",
      "routine_run": "arr_0aBcDeFgHiJkLmNoPqRsTu",
      "sandbox": "string",
      "session_record": "ase_0aBcDeFgHiJkLmNoPqRsTu",
      "team": "tem_0aBcDeFgHiJkLmNoPqRsTu",
      "thread": "thr_0aBcDeFgHiJkLmNoPqRsTu",
      "title": "Example Title",
      "updated_at": "2024-01-01T00:00:00Z",
      "user": "usr_0aBcDeFgHiJkLmNoPqRsTu"
    }
  ],
  "has_more": true
}