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

Overview

This endpoint returns a page of the output files a batch session’s job produced, newest first. Each entry points at a stored file.

Request

string
required
Session ses_ 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. The cursor is opaque: it is not a result id, so 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 output file the session 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.
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.

Result entry object

object
required
The stored file and how to fetch it.
string
required
When the result was recorded (date-time).

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

  • Passing both after and before returns 400, as does a malformed cursor.
  • A 409 means the session is a serving session, which writes no output files. Its answers are returned by Query Session.
  • A 404 means the session does not exist, belongs to another organization, or is in a project you cannot see.