List an Agent's runs
Each time one of its triggers fired or was run by hand, newest first: when it was due, whether it was late, and what came of it (started, queued, skipped or failed, with a reason), with the session and turn.
AuthorizationBearer <token>An application key of the Tenant (PUT /v1/tenant/keys/{keyId}), or Studio's key, derived from the admin key. With Nylorun-Subject and Nylorun-Scopes, it acts for that person, narrowed to those scopes. Never accepted from a browser (Origin).
agentId*stringThe Agent id, percent-encoded
limit?integerA page holds at most the Tenant's Runtime limit pageItems (default 200); a larger limit gets that many
1 <= valuecursor?stringtriggerId?stringOnly this trigger's runs
Nylorun-Protocol*stringThe protocol version, 18
Nylorun-Subject?stringThe person an application key acts for
Nylorun-Scopes?stringThe subject's space-separated scopes; required with a subject
A page of runs
application/json- response
runs*array<>nextCursor*string|nullimport { createClient } from "@nylorun/agents";const client = await createClient();const runs = await client.agents.runs("users/alice/assistant", { triggerId: "nightly", limit: 20,});{ "runs": [ { "id": "string", "triggerId": "string", "kind": "schedule", "dueAt": "string", "firedAt": "string", "late": true, "status": "started", "reason": "string", "sessionId": "string", "turnId": "string", "queuedMessageId": "string" } ], "nextCursor": "string"}Run a trigger now POST
Runs it once now, paused or not, as if it had fired: a turn on its session, or a queued message when a turn runs there. A retried request with the same `Idempotency-Key` answers the same run.
Make a webhook trigger's signing secret POST
A new Standard Webhooks secret (`whsec_…`) for a webhook trigger, shown this once; the one before stops working at once. Give it to the sender with the trigger's `webhookUrl`.