phones

Deliver a library file to a phone

Changed on

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

Request

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

    • breaking

      removed the enum value DCIM of the request property

    • breaking

      removed the enum value Movies of the request property

    • breaking

      removed the enum value Pictures of the request property

    • info

      added the new dcim enum value to the request property

    • info

      added the new movies enum value to the request property

    • info

      added the new pictures enum value to the request property

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      the endpoint scheme security bearerAuth was removed from the API