Beta. This endpoint is live for design partners, with keys that Dopl issues while the developer portal is being built.
{
"error": {
"type": "device_error",
"code": "device_offline",
"message": "No target device is online.",
"retryable": true,
"doc_url": "https://www.usedopl.com/docs/errors/device-offline"
}
}device_kind appears when one device is involved. Retry only when retryable is true, with the same idempotency key. The Request-Id header identifies the call.
Codes
| Code | HTTP | Type | Retryable | Meaning |
|---|---|---|---|---|
device_offline | 409 | device_error | Yes | No target device is online |
capability_unsupported | 422 | invalid_request_error | No | The device does not publish this capability, or its profile does not allow it |
grant_missing | 403 | permission_error | No | The user has not granted this capability at this tier |
grant_expired | 403 | permission_error | No | The grant has expired |
confirmation_denied | 403 | permission_error | No | The profile denies this tier, which is the default for T4 |
rate_limited | 429 | rate_limit_error | Yes | Too many requests for this project and environment |
vendor_error | 502 | device_error | Yes | The vendor's service failed, or delivery to this kind of device is not available yet |
needs_reauth | 409 | permission_error | No | The user must reconnect the device |
invalid_request | 400 | invalid_request_error | No | The request does not match the contract, or a token is invalid or used |
unauthenticated | 401 | authentication_error | No | The key is missing, unknown, revoked or expired |
insufficient_scope | 403 | permission_error | No | The key's scopes do not cover this route, or a publishable key called a secret key route |
not_found | 404 | invalid_request_error | No | No such user, device, connection or action |
idempotency_conflict | 409 | invalid_request_error | No | The idempotency key was already used with a different body |