BYOD device registration / static metadata.
Returns the registration / static device metadata for an
instance backed by a user-provided device (BYOD), e.g. a phone:
device type, model, OS + version, the registered screen geometry
(width / height / density), and the device hardware /
Agent-reported capabilities.
This is distinct from GET /api/v1/instances/{id}/mobile
(ControlInfo): /mobile is the synchronous control plane and
reports live geometry + reachability via the control channel,
whereas /device/info is the registered/static device snapshot
and can be read even when the device is offline (cached static
info is returned). Returns 404 if the instance does not exist or is
not owned by the caller.
Authorizations
Pass a user JWT or a oag_ User API Key on the
Authorization: Bearer <token> header. Both are validated by
openapi-gateway against the Auth service.
Both credential types are user-scoped: every key (and every JWT) is bound to exactly one owner, and every route grants the caller full access to that owner's own resources. Cross-tenant access is denied by owner-ACL inside the handlers — there is no per-route scope vocabulary on this API.
Removed in v1.1.0: the legacy
agents:*/tasks:*/files:*/instances:*scope set has been dropped together with the403 insufficient_scopeerror. Existingoag_keys automatically gain full owner-level access and do not need to be re-issued. SDK calls that previously passedscopestocreateAPIKeyshould drop the argument. See the changelog at the bottom of this spec for the full migration note.
Path Parameters
128Response
Standard envelope; data is a DeviceInfoDTO.
BYOD (bring-your-own-device) registration / static metadata for an instance's backing device, e.g. a user-provided phone.
Distinct from ControlInfo (the /computer + /mobile live
control surface): this is the registered hardware snapshot and is
readable even when the device is offline. capabilities here are
device hardware / Agent-reported capability strings — semantically
different from InstanceDataDTO.capabilities (the instance-level
capability JSON declaration).