Live mobile control info (geometry + supported actions).
Returns the android instance’s online status, screen geometry,
supported actions, and foreground app. Returns 404 if the
instance is a desktop device (use the computer endpoints).
This is the synchronous control plane: online + screen_*
reflect the live control-channel state at request time. For the
device’s registration / static metadata (BYOD device type,
model, OS, registered geometry, hardware capabilities) — readable
even when the device is offline — use
GET /api/v1/instances/{id}/device/info (DeviceInfoDTO) instead.
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
128