v12

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-014994227.2 KB

phones

Deliver a library file to a phone

Sends a library file to a phone the caller's org holds: the phone downloads it over its own connection and inserts it into the media gallery, where app pickers can select it. Accepts either an upload or a download by id. Returns 202 with the delivery record once the phone acknowledges the download started; watch GET /phones/{phone_id}/deliveries or the live preview for completion. Optionally choose the target collection (DCIM / Pictures / Movies).

post/phones/{phone_id}/deliveries

Path parameters

phone_idstring required

target phone_id

Request body

$schemastring uri

A URL to the JSON Schema for this object.

collection'DCIM' | 'Pictures' | 'Movies'

Media collection to insert into on the phone; defaults to Pictures for images and Movies for videos.

file_idstring uuid required

Library file to deliver; accepts an upload or a download id.

Example request

{
  "$schema": "/api/v1/FileDeliveryCreateRequest.json"
}

Response

Accepted

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "/api/v1/FilePushResponse.json",
  "delivery": {
    "$schema": "/api/v1/FileDeliverySummary.json"
  }
}