Skip to main content
POST
Publish live activity

Authorizations

Authorization
string
header
required

Runner token beginning with agt_r, returned once by POST /v1/runners

Path Parameters

lease_id
string
required

Lease identifier (version 7 universally unique identifier, or UUID).

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; delivery to subscribers is not yet confirmed

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. Rejected batches return an error response instead.