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" }'

• Production REST API endpoint.

Updates the device state and heartbeat timestamp for a stream.

Authorizations

• ApiToken

Parameters

Path Parameters

stream_id

required

integer format: int64

>= 1

Stream identifier.

Request Body^required

Stream parameter update request.

Media typeapplication/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

Responses

200

Operation completed successfully.

400

Bad Request - missing or invalid parameters.

Media typeapplication/json

Error payload carried by every non-2xx response.

object

message

required

Human-readable description of the failure. The wording is not part of the API contract; do not match on it programmatically.

string

reason

Stable machine-readable failure code in snake_case, e.g. “api_token_missing” or “invalid_task_id”. Omitted for 500 responses.

string

Example^generated

{
  "message": "example",
  "reason": "example"
}

401

Unauthorized - missing, expired, or invalid token.

Media typeapplication/json

Error payload carried by every non-2xx response.

object

message

required

Human-readable description of the failure. The wording is not part of the API contract; do not match on it programmatically.

string

reason

Stable machine-readable failure code in snake_case, e.g. “api_token_missing” or “invalid_task_id”. Omitted for 500 responses.

string

Example^generated

{
  "message": "example",
  "reason": "example"
}

403

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

Media typeapplication/json

Error payload carried by every non-2xx response.

object

message

required

Human-readable description of the failure. The wording is not part of the API contract; do not match on it programmatically.

string

reason

Stable machine-readable failure code in snake_case, e.g. “api_token_missing” or “invalid_task_id”. Omitted for 500 responses.

string

Example^generated

{
  "message": "example",
  "reason": "example"
}

404

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

Media typeapplication/json

Error payload carried by every non-2xx response.

object

message

required

Human-readable description of the failure. The wording is not part of the API contract; do not match on it programmatically.

string

reason

Stable machine-readable failure code in snake_case, e.g. “api_token_missing” or “invalid_task_id”. Omitted for 500 responses.

string

Example^generated

{
  "message": "example",
  "reason": "example"
}

415

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

Media typeapplication/json

Error payload carried by every non-2xx response.

object

message

required

Human-readable description of the failure. The wording is not part of the API contract; do not match on it programmatically.

string

reason

Stable machine-readable failure code in snake_case, e.g. “api_token_missing” or “invalid_task_id”. Omitted for 500 responses.

string

Example^generated

{
  "message": "example",
  "reason": "example"
}

429

Too Many Requests - rate limit exceeded.

Media typeapplication/json

Error payload carried by every non-2xx response.

object

message

required

Human-readable description of the failure. The wording is not part of the API contract; do not match on it programmatically.

string

reason

Stable machine-readable failure code in snake_case, e.g. “api_token_missing” or “invalid_task_id”. Omitted for 500 responses.

string

Example^generated

{
  "message": "example",
  "reason": "example"
}