Activity

List activity feed entries

Returns activity entries for a project, newest first, filterable by kind, severity, agent, generation and orchestration run — every filter composable with the rest. Paginated with an opaque cursor rather than offset/limit — pass the previous page's next_cursor to fetch the next one; a null next_cursor means there is no more data.

get/v1/projects/{project_id}/activity

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/activity
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Query parameters

kind'action_executed' | 'approval_created' | 'approval_resolved' | 'exception_created' | 'schedule_fired' | 'share_cap_exceeded' | 'share_resumed' | 'share_revoked' | 'share_suspended' | 'tool_resolution_failed' | 'usage_quantity_invalid'

Filter by activity kind

severity'info' | 'warning' | 'critical'

Filter by severity

agent_idstring
Example:agent_V1StGXR8Z5jdHi6B

Filter to entries produced by one agent. Composable with every other filter — entries carry one agent, one generation and one run, so naming two narrows to the rows where both hold.

generation_idstring
Example:gen_V1StGXR8Z5jdHi6B

Filter to entries produced during one agent generation. This is what turns tool_resolution_failed from alertable into usable: the warning for a suspect turn is one query rather than a scan of the project's feed.

orchestration_run_idstring
Example:orch_run_V1StGXR8Z5jdHi

Filter to entries produced during one orchestration run.

cursorstring

Opaque cursor from a previous page's next_cursor

limitinteger

Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is 400.

Response

Page of activity entries

next_cursorstring nullable required

Pass as cursor to fetch the next page; null when this is the last page

Example response

{
  "data": [
    {
      "id": "acte_V1StGXR8Z5jdHi6B"
    }
  ]
}

Changes

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