GETresults:read
Get sensing config
The single active capture configuration of a device.
Request
GEThttps://api.cymatics.tech/v1/devices/{device}/sensing-config
Send your key as Authorization: Bearer cym_test_…. Requires the results:read scope. Test keys read the simulator; live keys read your paired Cymos.
devicerequiredstring | pathDevice idSDK and CLI: device_id |
Response
200 · application/json
{
"data": {
"object": "sensing_config",
"device_id": "dev_bedroom",
"profile_id": "profile_sleep_default",
"revision": 1
},
"meta": {
"request_id": "req_01",
"project_id": "proj_demo",
"livemode": false,
"generated_at": "2026-10-24T23:55:30.000Z"
}
}Errors
429rate_limit_exceeded: Too many requests this minute for the key (or twice that across the project), or too many open streams for the project. Retry after the seconds in Retry-After.quota_exceeded: A live key's project has used its monthly live-hour cap. There is no Retry-After. Don't retry; raise the live-hour cap in the dashboard. Headers: Retry-After, RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset.503live_unavailable: This operation has no live data for this project yet (for example, no paired Cymo covers it). Don't retry the same request; pair a Cymo that covers it, or build against a test key.service_unavailable: A dependency, such as API key verification, is unreachable, or the project is busy with another write. Retry after the seconds in Retry-After, with backoff.4XXInvalid request, credential, permission or revision.defaultError with a stable code and request ID.
Every error is a { error, meta } envelope with a stable code. See Errors for each code and whether to retry.
Call it
TypeScript · @cymos/sdk
import { Cymo } from "@cymos/sdk";
const cymo = new Cymo({ apiKey: process.env.CYMO_API_KEY! });
const { data, meta } = await cymo.devices.sensingConfig.get({
device_id: "dev_bedroom"
});terminal · cymatics CLI
$ cymatics devices sensing-config get --device-id dev_bedroom --jsoncurl
curl "https://api.cymatics.tech/v1/devices/dev_bedroom/sensing-config" \
-H "Authorization: Bearer $CYMO_API_KEY"MCP tool
get_sensing_config({ device_id: "dev_bedroom" })The MCP tool get_sensing_config calls this operation with your key.
Try it
GEThttps://api.cymatics.tech/v1/devices/dev_bedroom/sensing-configPaste a test key and preview the response. Test keys read the simulator, so no device is needed.