Skip to content

Command Request

APIs to view and manage command requests. Learn more about commands or how to schedule a command.

Scheduled commands are currently compatible with Android devices.

Operations

List command requests
Stable

Request

Returns a paginated list of command requests within the enterprise. Each record includes the command type, targeted devices or groups, schedule details, arguments, and current status. This endpoint provides visibility into commands that have been issued, whether they are queued, in progress, successful, or failed. Common use cases: Auditing commands sent across the enterprise Tracking scheduled vs immediate commands Reviewing historical command activity Troubleshooting command execution at scale Best Practices: Use pagination parameters to manage large datasets. Filter or search (if supported) to narrow results when investigating specific command IDs or timeframes. For device-level execution results, pair this endpoint with command status or event feed views.

Security
commands_apiKey
Query
devicesstring

Filter by device IDs. Accepts comma separated values.

groupsstring

Filter by group IDs. Accepts comma separated values.

commandstring

Filter by command name

schedulestring

Filter by schedule type

Enum:"IMMEDIATE""WINDOW""RECURRING"
exclude_internal_commandsboolean

Filter to exclude internal commands

Default:false
limitnumber
offsetnumber
cURL
curl -i -X GET \
  'https://api.esper.io/_mock/openapi/commands/v0/commands/?devices=string&groups=string&command=string&schedule=IMMEDIATE&exclude_internal_commands=false&limit=0&offset=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Command request list for the Tenant

Bodyapplication/json
codeinteger
messagestring
contentobject
Response
{
  "code": 0,
  "message": "string",
  "content": {
    "count": 0,
    "previous": "string",
    "next": "string",
    "results": [ … ]
  }
}