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

Overview

This endpoint returns one agent (bundle run) by its agt_ id, including its lifecycle status, I/O binding, and the executor job id once the run has been dispatched.

Request

string
required
Agent agt_ id.

Response

string
required
TypeID-encoded agent identifier (agt_ prefix).
string
required
Name of the agent (a run’s name is its bundle’s name).
string
required
Organization identifier the agent belongs to.
string
required
The bundle this agent was run from (provenance).
string
required
Human-readable pinned blueprint reference (its key), e.g. osm.
string
required
Immutable blueprint id the bundle pinned.
string
required
Agent lifecycle status: running, paused, completed, failed, or canceled.
string
required
Creation timestamp (date-time).
object
Source/sink connectors binding this run’s I/O; null when none is recorded.
array
One or more input refs; multiple files are staged on the same JOS input port.
object
The single output ref, when the run was started with one. Omitted (the default): the runner writes one output per input, named after the input.
string
External executor’s job id for the current run (a JOS job_ id). Present once the run has been dispatched; lets clients query JOS for run progress.
string
When the run started; null before then.
string
When the run finished; null while unfinished.
string
Failure detail; null unless the run failed.

Important Notes

  • Lifecycle: a run starts running, can move to paused and back via /pause and /resume, and terminates in completed, failed, or canceled.
  • job_id appears once the run has been dispatched to the executor; use it to query JOS for run progress.
  • To re-run, run the bundle again — each run is a new agent.