HTTP API reference › Gala Launchpad › recordings

Gala Launchpad — recordings

3 operations in this group.

• GET /v1/tokens/{tokenName}/recordings — List token recordings
• DELETE /v1/tokens/{tokenName}/recordings/{assetId} — Delete recording
• GET /v1/tokens/{tokenName}/recordings/{assetId}/download — Get recording download

GET /v1/tokens/{tokenName}/recordings

RecordingController_listRecordings

List token recordings

List all video recordings for a token with pagination

Parameters

Name	In	Required	Type	Description
tokenName	path	required	string

Responses

200 — Recordings retrieved successfully - returns paginated array of recording metadata

Content type: application/json

Schema: RecordingListSuccessEnvelopeDto

Field	Type	Required	Description
data	array<RecordingInfoResponseDto>	yes
error	boolean enum: false	yes
message	string	yes
status	number	yes

400 — Bad request - skip/limit parameters invalid

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
error	boolean enum: true	yes
message	oneOf: string | array<string>	yes
status	integer	yes	HTTP status code.
message	string	yes
statusCode	integer	yes	HTTP status code.

404 — Token not found - tokenName does not match any existing pool

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
error	boolean enum: true	yes
message	oneOf: string | array<string>	yes
status	integer	yes	HTTP status code.
message	string	yes
statusCode	integer	yes	HTTP status code.

500 — Internal server error - failed to retrieve recordings from Mux

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
error	boolean enum: true	yes
message	oneOf: string | array<string>	yes
status	integer	yes	HTTP status code.
message	string	yes
statusCode	integer	yes	HTTP status code.

default — Shared error envelope for token lookup and recording service failures.

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
error	boolean enum: true	yes
message	oneOf: string | array<string>	yes
status	integer	yes	HTTP status code.
message	string	yes
statusCode	integer	yes	HTTP status code.

Example response

[]

DELETE /v1/tokens/{tokenName}/recordings/{assetId}

RecordingController_deleteRecording

Delete recording

Delete a recording (token owner only)

Authentication: apiKeyAuth, bearer

Parameters

Name	In	Required	Type	Description
tokenName	path	required	string
assetId	path	required	string

Responses

200 — Recording deleted successfully - removed from Mux

Content type: application/json

Schema: RecordingDeleteSuccessEnvelopeDto

Field	Type	Required	Description
error	boolean enum: false	yes
message	string	yes
status	number	yes

403 — Forbidden - only token owner can delete recordings

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
error	boolean enum: true	yes
message	oneOf: string | array<string>	yes
status	integer	yes	HTTP status code.
message	string	yes
statusCode	integer	yes	HTTP status code.

404 — Recording not found - assetId does not match any recording for this token

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
error	boolean enum: true	yes
message	oneOf: string | array<string>	yes
status	integer	yes	HTTP status code.
message	string	yes
statusCode	integer	yes	HTTP status code.

500 — Internal server error - failed to delete recording from Mux

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
error	boolean enum: true	yes
message	oneOf: string | array<string>	yes
status	integer	yes	HTTP status code.
message	string	yes
statusCode	integer	yes	HTTP status code.

default — Shared error envelope for authentication and recording deletion failures.

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
error	boolean enum: true	yes
message	oneOf: string | array<string>	yes
status	integer	yes	HTTP status code.
message	string	yes
statusCode	integer	yes	HTTP status code.

Example response

[]

GET /v1/tokens/{tokenName}/recordings/{assetId}/download

RecordingController_getRecordingDownload

Get recording download

Get download URL for a recording (token owner only)

Authentication: apiKeyAuth, bearer

Parameters

Name	In	Required	Type	Description
tokenName	path	required	string
assetId	path	required	string

Responses

200 — Download info retrieved successfully - URL only provided to token owner

Content type: application/json

Schema: RecordingDownloadSuccessEnvelopeDto

Field	Type	Required	Description
data	RecordingDownloadResponseDto	yes
error	boolean enum: false	yes
message	string	yes
status	number	yes

403 — Forbidden - only token owner can download recordings

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
error	boolean enum: true	yes
message	oneOf: string | array<string>	yes
status	integer	yes	HTTP status code.
message	string	yes
statusCode	integer	yes	HTTP status code.

404 — Recording not found - assetId does not match any recording for this token

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
error	boolean enum: true	yes
message	oneOf: string | array<string>	yes
status	integer	yes	HTTP status code.
message	string	yes
statusCode	integer	yes	HTTP status code.

500 — Internal server error - failed to prepare download

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
error	boolean enum: true	yes
message	oneOf: string | array<string>	yes
status	integer	yes	HTTP status code.
message	string	yes
statusCode	integer	yes	HTTP status code.

default — Shared error envelope for authentication and download preparation failures.

Content type: application/json

Schema: ApiErrorEnvelope

Field	Type	Required	Description
error	boolean enum: true	yes
message	oneOf: string | array<string>	yes
status	integer	yes	HTTP status code.
message	string	yes
statusCode	integer	yes	HTTP status code.

Example response

[]

---

Previous group: stream-actions · Next group: recording-assets