Skip to main content
GET
Requires version 1.1.9 or later of the Archetype platform.

Overview

This endpoint returns a page of an agent’s event log, newest first. Events are the agent-side log: an id, a three-level severity, a message, and a timestamp. For the executor’s own log lines, use GET /agents/instances/{agent_id}/logs.

Request

string
required
Agent agt_ id.
integer
default:"100"
Page size. Minimum 1, maximum 1000.
string
Forward cursor: return events older than the one with this id. Pass the next_cursor of the previous page (or the id of its last event) to fetch the next page. Mutually exclusive with before.
string
Backward cursor: return events newer than the one with this id. Pass the id of the first event of the current page to walk back. Mutually exclusive with after.

Response

array
required
The page, newest first. Each entry is an event.
boolean
required
True when more events exist beyond this page in the direction of travel.
string
Cursor for the next page in the same direction — pass it as after when paging forward, or as before when you supplied before. null when has_more is false.

Event object

string
required
Event id — the keyset cursor value for after/before.
string
required
Event severity for the agent event log: info, warning, or error.
string
required
The event message.
string
required
When the event was recorded (date-time).

Important Notes

  • The event id is this list’s cursor value — pass it directly as after or before.
  • after and before are mutually exclusive — send at most one of them.
  • Events use the agent-side severity vocabulary (info, warning, error), which is narrower than the executor log levels returned by /logs.