list_shell_actions
List recent shell actions (commands already sent) for a product.
List recent shell actions (commands already sent) for a product.
Read-only · Calls external systems. Safe to call: this tool does not modify data.
Parameters
| Field | Type | Required | Description |
|---|---|---|---|
detail | boolean | No | Return full JSON instead of compact summaries (default: false) |
from_date | string | No | Only show shells created after this ISO 8601 timestamp (e.g. 2026-03-15T19:29:17Z). Defaults to the last 24 hours when omitted. Use to poll for new async events. |
ordering | string (-created | created) | No | Sort order: '-created' (newest first, default), 'created' (oldest first) |
owner | string | No | Filter by device identifier (MSISDN or hostname) |
product_id | number | No | Filter by product ID |
status | string (P | D | O | B | C | T | M) | No | Filter by status: P (Pending), D (Done), O (Ongoing), B (Blocked), C (Canceled), T (Timeout), M (Maintenance) |
to_date | string | No | Only show shells created before this ISO 8601 timestamp. Combine with from_date for a closed window. |
Example arguments
Illustrative arguments an agent supplies when calling this tool:
{
"detail": false,
"from_date": "string"
}Description
Returns compact summaries showing ID, type, command summary, status, and duration. Results default to the last 24 hours unless from_date is set. Use from_date + ordering to poll for asynchronous results such as incoming SMS or USSD menu responses during a live session. Filter by status to find in-flight commands: status=P (pending), status=O (ongoing). To see which shell action TYPES can be sent, use list_shell_action_types.Related
What's next?
Last updated on