Agents API
Get Agent Results
Page through the output artifacts an agent run produced
GET
Requires version 1.1.9 or later of the Archetype platform.
Overview
This endpoint returns a page of a run’s output refs, newest first. Results come from the executor (JOS job outputs), so each entry names the output port it was written to and points at the stored file. The list is empty for a noop run.Request
string
required
Agent
agt_ id.integer
default:"100"
Page size. Minimum
1, maximum 1000.string
Forward cursor: return results older than this page. Pass the previous page’s
next_cursor. Opaque — not a result id; never compute on it. Mutually exclusive with before.string
Backward cursor: return results newer than this page. Opaque, as
after is. Mutually exclusive with after.Response
array
required
The page, newest first. Each entry is one artifact the run produced.
boolean
required
True when more results 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.Result entry object
string
required
Executor-assigned output id. Stable, but not this list’s cursor.
string
required
Executor output port the result was written to.
object
required
The stored file this result points at.
string
required
When the result was recorded (date-time).
string
When the result expires;
null when it does not.File ref object (data)
string
required
Fetchable reference to the bytes — a presigned URL, or a data-service ref that has to be downloaded through the authenticated proxy.
string
required
Name of the stored file.
string
File extension;
null when unknown.string
File type;
null when unknown.integer
Size of the file in bytes;
null when unknown.object
Executor-recorded attributes. Carries
job_output.status, which marks a result written by a run that only partially succeeded.Important Notes
- The cursor here is opaque and is not a result id. Pass
next_cursorback verbatim; never derive it fromdata[last].id. refmay be a presigned URL or a data-service ref — the latter must be downloaded through the authenticated proxy.- Check
file_attributes["job_output.status"]: it marks a result written by a run that only partially succeeded. - A noop run produces no outputs, so
datacomes back empty.