---
title: "Media Transfer"
method: POST
path: "/v0/media/transfer"
tags: ["MediaTransfer"]
---

# Media Transfer

`POST /v0/media/transfer`

## Request

- Base URL: `https://api.skydio.com/api`
- URL: `https://api.skydio.com/api/v0/media/transfer`
- Auth: API key in header `Authorization`

Start a media transfer to a given url.

## Request body

- object: Arguments to the POST /media/transfer endpoint
  - `default` object: Default values applied to all requests that do not have the field set
    - `destination_headers` object: Custom headers to send to the destination url
    - `destination_method` 'POST' | 'PUT': HTTP method to use for the destination url
  - `notification` object: Where to send a notification when the media transfer completes
    - `webhook_url` string, uri
  - `requests` object[], required: List of files to transfer (max 100)
    - `destination_headers` object: Custom headers to send to the destination url
    - `destination_method` 'POST' | 'PUT': HTTP method to use for the destination url
    - `destination_url` string, uri, required: URL to upload the file to
    - `file_uuid` string, uuid, required

## Response `200`

Response returned by the POST /media/transfer endpoint

- object
  - `data` object, required: Response returned by the POST /media/transfer endpoint
    - `transaction_id` string, required
  - `error_message` string
  - `meta` object, required
    - `time` number
  - `skydio_error_code` integer, required
  - `status_code` integer, required

## Other responses

- `403`: You do not have permission to start a media transfer.
- `404`: Not Found

## Changes

- **2026-11-03** `6589167ebe70`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/skydio/apis/skydio-cloud-api/changes/v0/media/transfer/post.md)

---

[API](https://skmtc.dev/skydio/apis/skydio-cloud-api.md) - [All operations](https://skmtc.dev/skydio/apis/skydio-cloud-api/llms.txt) - [OpenAPI document](https://skmtc.dev/skydio/apis/skydio-cloud-api/revisions/6589167ebe70?raw)