Sign in
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 any file by id regardless of source (uploaded or captured), and the file must already be ready - finish an uploaded file with POST /files/{file_id}/complete before delivering it. 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

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 any file id regardless of source.

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"
  }
}

Changes