CLI command
fleetdeck acquire
Acquire an exclusive automation session.
Usage
bash
fleetdeck acquire DEVICEExample
fleetdeck acquire device_123Arguments
| Argument | Required | Description |
|---|---|---|
DEVICE | required | Exact granted device ID. The default session TTL is 120 seconds, capped by key expiry. |
Supply FLEETDECK_API_KEY through the environment. See environment configuration.
Behavior
- Requires devices:read. The CLI uses the server default TTL of 120 seconds.
- Keep the returned session id and expiresAt. A job child credential can cap the session below the requested TTL.
Output and exit
Writes formatted JSON to stdout. Errors are one JSON object on stderr.
Example stdout
{
"id": "session_123",
"deviceId": "device_123",
"expiresAt": "2030-01-01T10:00:00.000Z"
}Response fields and API errors: Acquire a phone session.
See all exit codes and error recovery.
