admin

List runs across principals

get/v1/admin/runs

Request

  • Base URL: https://api.runx.ai
  • URL: https://api.runx.ai/v1/admin/runs
  • Auth: HTTP bearer

Query parameters

principal_idstring

Filter by principal id.

qstring

Case-insensitive search over run id, skill, actors, and artifact types.

skillstring

Exact skill filter.

statusstring

Exact hosted lifecycle status filter.

actorstring

Exact actor filter derived from submitted resolutions.

artifact_typestring

Exact artifact type filter derived from hosted ledger entries.

sincestring

Inclusive ISO-8601 lower bound for run creation time.

untilstring

Inclusive ISO-8601 upper bound for run creation time.

limitstring

Maximum number of runs to return: integer 1–100, default 50.

cursorstring

Optional opaque cursor returned by the previous run-list page.

Response

Run list.

status'success' required
runsHostedRunSummary[] required(unresolved $ref)
next_cursorstring

Changes

No recorded changes to this operation across all 1 revision of this API.