MARK ▸ 30 s

POST

/api/live/{handle}/clip

• Protocol hub (Next.js) — federation, writes, receipts, market context

Clips the last window of the caller’s live Mux broadcast into a take (cooldown 120 s, 10/day). Session-authenticated; the clip lands on the operator’s tape as processing.

Authorizations

• sessionCookie
• operatorKey

Parameters

Path Parameters

handle

required

string

Operator handle (case-insensitive).

Responses

200

Clip requested

object

clipId

string

assetId

string

marketId

string | null

status

string

Allowed value: processing

400

invalid_window

object

error

required

Stable machine-readable code (snake_case) or a short reason.

string

message

string

key

additional properties

any

401

auth_required

object

error

required

Stable machine-readable code (snake_case) or a short reason.

string

message

string

key

additional properties

any

409

not_live · too_early

object

error

required

Stable machine-readable code (snake_case) or a short reason.

string

message

string

key

additional properties

any

429

Cooldown or daily cap.

object

error

required

Stable machine-readable code (snake_case) or a short reason.

string

message

string

key

additional properties

any

502

upstream_unreachable · clip_failed

object

error

required

Stable machine-readable code (snake_case) or a short reason.

string

message

string

key

additional properties

any