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

Overview

This endpoint returns a cursor-paginated list of progress entries reported during job execution, newest first. Progress entries provide real-time metrics and status updates as the job processes inputs.

Request

string
required
The unique job identifier
string
Filter progress entries by kind
string
Filter progress entries associated with a specific input
integer
default:"100"
Page size, between 1 and 1000. Clamped server-side.
string
Forward cursor: return entries recorded before the entry with this ID. Pass the previous page’s next_cursor. Mutually exclusive with before — sending both returns 400. v1.1.11+
string
Backward cursor: return entries recorded after the entry with this ID. Pass the current page’s prev_cursor. Mutually exclusive with after. v1.1.11+

Response

string
The job identifier
array
Array of progress entry objects, newest first (created_at descending) in both cursor directions, each containing:
  • id — Unique progress entry identifier
  • kind — Type of progress entry
  • step — Step number within the processing sequence. Numbered over the whole filtered set, so it stays consistent across pages
  • message — Optional human-readable progress message
  • metrics — Metrics data (e.g., percentage complete, items processed)
  • payload — Additional progress-specific data
  • input_id — Associated input ID (if applicable)
  • index — Index within the input (if applicable)
  • created_at — Progress entry timestamp
boolean
true when more entries exist beyond this page in the direction of travel. v1.1.11+
string
Cursor for the next page in the same direction — pass it as after when paging forward, or as before when the request used before. null when has_more is false. v1.1.11+
string
Cursor to step back the way this page was reached — pass it as before after a forward page, or as after after a backward one. null when the request carried no cursor. v1.1.11+