Complete a stream | FastPix Developer Documentation

This endpoint marks a livestream as completed by stopping the active stream and transitioning its status to `idle`. It is typically used after a livestream session has ended. This operation only works when the stream is in the `active` state. Completing a stream can help finalize the session and trigger post-processing events like VOD generation. #### Example A virtual event ends, and the system or host needs to close the livestream to prevent further streaming. This endpoint ensures the livestream status is changed from `active` to `idle`, indicating it's officially completed. Related guide <a href="https://docs.fastpix.io/docs/manage-streams">Manage streams</a>

This endpoint marks a livestream as completed by stopping the active stream and transitioning its status to idle. It is typically used after a livestream session has ended.

This operation only works when the stream is in the active state.

Completing a stream can help finalize the session and trigger post-processing events like VOD generation.

Example

A virtual event ends, and the system or host needs to close the livestream to prevent further streaming. This endpoint ensures the livestream status is changed from active to idle, indicating it’s officially completed.

Related guide Manage streams

Authentication

AuthorizationBasic

FastPix APIs are secured with Basic Authentication. Use your Access Token ID as the username and Secret Key as the password in the Authorization header of each API request.

Username: Access Token ID
Password: Secret Key

Activate your FastPix account to generate your API credentials. See the guide here

Path parameters

streamIdstringRequired

Upon creating a new live stream, FastPix assigns a unique identifier to the stream.

Response

Stream details updated successfully

successboolean

Shows the request status. Returns true for success and false for failure.

This endpoint marks a livestream as completed by stopping the active stream and transitioning its status to idle. It is typically used after a livestream session has ended.

This operation only works when the stream is in the active state.

Completing a stream can help finalize the session and trigger post-processing events like VOD generation.

Example

Related guide Manage streams

FastPix APIs are secured with Basic Authentication. Use your Access Token ID as the username and Secret Key as the password in the Authorization header of each API request.

Username: Access Token ID
Password: Secret Key

Activate your FastPix account to generate your API credentials. See the guide here

Upon creating a new live stream, FastPix assigns a unique identifier to the stream.

Stream details updated successfully

Shows the request status. Returns true for success and false for failure.

$	curl -X PUT https://api.fastpix.com/v1/live/streams/91a264dcc447b63da6fb79ef925cd76d/finish \
>	-u "<username>:<password>"