FleetDeckDocs

CLI command

fleetdeck acquire

Acquire an exclusive automation session.

Usage

bash
fleetdeck acquire DEVICE
Example
fleetdeck acquire device_123

Arguments

ArgumentRequiredDescription
DEVICErequiredExact 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.