Skip to main content
POST
Publish live-tail activity frames

Authorizations

Authorization
string
header
required

The opaque agt_r token minted when the runner enrols (POST /v1/runners)

Path Parameters

lease_id
string
required

UUIDv7 of the lease.

Body

application/json

POST /v1/runners/me/leases/{lease_id}/activity request, a batch of frames.

One frame per request today; the array shape lets a later change coalesce without a wire change. The reply is 202 carrying [ActivityAccepted].

frames
object[]
required

The frames being forwarded.

One progress frame.

Response

Accepted for publication; a subscriber reading it is a separate event

The acknowledgement a batch of frames is answered with.

202, because the frames were received and not yet read by anybody. The publish is best-effort and a subscriber seeing a frame is a separate event from this call returning.

ok
boolean
required

Always true: a batch this daemon could not accept is refused with a problem document, never acknowledged with false.