FleetDeckDocs

CLI command

fleetdeck media

Upload media in ordered one MiB chunks.

Usage

bash
fleetdeck media SESSION FILE image/jpeg|image/png|video/mp4
Example
fleetdeck media session_123 ./photo.png image/png

Arguments

ArgumentRequiredDescription
SESSIONrequiredAn active session with devices:media permission.
FILErequiredReadable file from 1 byte through 100 MiB.
MIMErequiredimage/jpeg, image/png or video/mp4, matching the real file bytes.

Supply FLEETDECK_API_KEY through the environment. See environment configuration.

Behavior

  • Accepts files from 1 byte through 100 MiB.
  • The CLI heartbeats before every chunk, uses a new request ID for each chunk and stops on a non-completed action.
  • Source bytes, MIME and extension must describe the real file. Imported acknowledges the phone agent import; inspect the gallery before relying on it.

Output and exit

Writes the final chunk action. A changed file, invalid MIME, validation failure or incomplete action exits 1.

Example stdout
{
  "id": "action_123",
  "requestId": "media-chunk-001",
  "status": "completed",
  "kind": "media_chunk",
  "createdAt": "2030-01-01T10:00:00.000Z",
  "finishedAt": "2030-01-01T10:00:00.000Z",
  "result": {
    "status": "imported",
    "verified": true
  }
}

Response fields and API errors: Submit one command.

See all exit codes and error recovery.