Skip to content

Update stream device parameters

POST
/v3/streams/{stream_id}/params
curl --request POST \
--url https://api.cardio.ai/v3/streams/1/params \
--header 'Content-Type: application/json' \
--header 'X-Api-Token: <X-Api-Token>' \
--data '{ "device_state": "WAITING_FOR_START" }'

Updates the device state and heartbeat timestamp for a stream.

stream_id
required
integer format: uint64

Stream identifier.

Stream parameter update request.

Media type application/json

Request payload for updating stream device parameters.

object
device_state
required

Current device state.

string
Allowed values: WAITING_FOR_START RECORDING RECORDING_COMPLETED UPLOADING UPLOADING_FAILED

Operation completed successfully.

Bad Request - missing or invalid parameters.

Media type application/json
string
Example generated
example

Unauthorized - missing, expired, or invalid token.

Media type application/json
string
Example generated
example

Forbidden - the provided token is not authorized to call this endpoint.

Media type application/json
string
Example generated
example

Not Found - requested resource does not exist or is unavailable.

Media type application/json
string
Example generated
example

Unsupported Media Type - Content-Type must be application/json.

Media type application/json
string
Example generated
example

Too Many Requests - rate limit exceeded.

Media type application/json
string
Example generated
example