Find stream by device

POST

/v3/streams/find

curl --request POST \
  --url https://api.cardio.ai/v3/streams/find \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Token: <X-Api-Token>' \
  --data '{ "device_id": "example" }'

• Production REST API endpoint.

Resolves a device identifier to its stream ID. Use this when the device knows its own identifier but not the task created for it.

Authorizations

• ApiToken

Request Body ^required

Stream lookup request.

Media type application/json

Request payload for finding an existing stream by device identifier.

object

device_id

required

Device identifier used to find a task waiting for ECG data.

string

Example ^generated

{
  "device_id": "example"
}

Responses

200

Successful response containing the stream ID.

Media type application/json

Response payload for stream lookup.

object

stream_id

required

Stream identifier. This is the task ID backing the stream.

integer format: uint64

Example ^generated

{
  "stream_id": 1
}

400

Bad Request - missing or invalid parameters.

Media type application/json

string

Example ^generated

example

401

Unauthorized - missing, expired, or invalid token.

Media type application/json

string

Example ^generated

example

403

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

Media type application/json

string

Example ^generated

example

404

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

Media type application/json

string

Example ^generated

example

415

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

Media type application/json

string

Example ^generated

example

429

Too Many Requests - rate limit exceeded.

Media type application/json

string

Example ^generated

example