API referenceEndpoints

List runs

Requires an authenticated tenant principal. Generated from the production route registered in `internal/features/agentrun/inbound/http.go`.

GET/v1/runs

Requires an authenticated tenant principal. Generated from the production route registered in internal/features/agentrun/inbound/http.go.

Authorization

bearerAuth
AuthorizationBearer <token>

Engine-issued API key or tenant-signed JWT.

In: header

Query Parameters

schedule_id?string

Restrict the caller's own runs to those created by this schedule's fires (an agent_run scheduled task). Runs remain owner-only for every role; a malformed id is 404.

Formatuuid
conversation_id?string

Restrict the caller's own runs to those on this conversation — a thread of runs, newest first (a follow-up run joins the thread by sending the same conversation_id when it is created). Runs remain owner-only for every role, so another person's thread lists as an empty page; a malformed id is 404.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/runs"
{}

Create claim

Requires an authenticated tenant principal. Generated from the production route registered in `internal/features/runners/inbound/http.go`.

Create run from a request

Requires an authenticated tenant principal. Generated from the production route registered in `internal/features/agentrun/inbound/http.go`.