phone_device_status - Documentation

Returns a device’s connectivity and readiness: online/offline, paused state, app version, device name and model, and last_seen. Use it before starting work - it is the fastest way to explain a task that will not start. Read-only: it never changes device state.

Parameters

string

The device to check. Omit to use your default device.

Response

The status payload reports:

Field	Meaning
Online/offline	Whether the phone is currently reachable
Paused	Whether new tasks are being rejected with `device_paused`
App version	The AGI Android app build on the device
Device name and model	What hardware you are targeting
`last_seen`	When the device last contacted the server

When to use it

Before a session or long workflow - confirm the target is online and not paused.
When a task sits in pending - an offline or busy device is the usual cause.
After device_offline or queue_wait_exceeded - verify which device was selected and when it was last seen before retrying.

list_devices - all devices at a glance
phone_device_pause / phone_device_resume - control the paused state
phone_get_state - full hardware/software snapshot