Add files to an unsent transfer
curl --request POST \
--url https://yungle.co/api/v1/transfers/{id}/files \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"files": [],
"imports": [
{
"url": "<string>",
"name": "<string>",
"path": "<string>"
}
]
}
'import requests
url = "https://yungle.co/api/v1/transfers/{id}/files"
payload = {
"files": [],
"imports": [
{
"url": "<string>",
"name": "<string>",
"path": "<string>"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({files: [], imports: [{url: '<string>', name: '<string>', path: '<string>'}]})
};
fetch('https://yungle.co/api/v1/transfers/{id}/files', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://yungle.co/api/v1/transfers/{id}/files",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'files' => [
],
'imports' => [
[
'url' => '<string>',
'name' => '<string>',
'path' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://yungle.co/api/v1/transfers/{id}/files"
payload := strings.NewReader("{\n \"files\": [],\n \"imports\": [\n {\n \"url\": \"<string>\",\n \"name\": \"<string>\",\n \"path\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://yungle.co/api/v1/transfers/{id}/files")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"files\": [],\n \"imports\": [\n {\n \"url\": \"<string>\",\n \"name\": \"<string>\",\n \"path\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://yungle.co/api/v1/transfers/{id}/files")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"files\": [],\n \"imports\": [\n {\n \"url\": \"<string>\",\n \"name\": \"<string>\",\n \"path\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"tusEndpoint": "<string>",
"files": [
{
"id": "<string>",
"name": "<string>",
"size": 1,
"uploadToken": "<string>",
"uploadTokenExpiresAt": "2023-11-07T05:31:56Z"
}
],
"imports": [
{
"fileId": "<string>",
"name": "<string>",
"size": 1,
"source": "<string>",
"status": "<string>"
}
]
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}Transfers
Add files to an unsent transfer
POST
/
transfers
/
{id}
/
files
Add files to an unsent transfer
curl --request POST \
--url https://yungle.co/api/v1/transfers/{id}/files \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"files": [],
"imports": [
{
"url": "<string>",
"name": "<string>",
"path": "<string>"
}
]
}
'import requests
url = "https://yungle.co/api/v1/transfers/{id}/files"
payload = {
"files": [],
"imports": [
{
"url": "<string>",
"name": "<string>",
"path": "<string>"
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({files: [], imports: [{url: '<string>', name: '<string>', path: '<string>'}]})
};
fetch('https://yungle.co/api/v1/transfers/{id}/files', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://yungle.co/api/v1/transfers/{id}/files",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'files' => [
],
'imports' => [
[
'url' => '<string>',
'name' => '<string>',
'path' => '<string>'
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://yungle.co/api/v1/transfers/{id}/files"
payload := strings.NewReader("{\n \"files\": [],\n \"imports\": [\n {\n \"url\": \"<string>\",\n \"name\": \"<string>\",\n \"path\": \"<string>\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://yungle.co/api/v1/transfers/{id}/files")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"files\": [],\n \"imports\": [\n {\n \"url\": \"<string>\",\n \"name\": \"<string>\",\n \"path\": \"<string>\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://yungle.co/api/v1/transfers/{id}/files")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"files\": [],\n \"imports\": [\n {\n \"url\": \"<string>\",\n \"name\": \"<string>\",\n \"path\": \"<string>\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"tusEndpoint": "<string>",
"files": [
{
"id": "<string>",
"name": "<string>",
"size": 1,
"uploadToken": "<string>",
"uploadTokenExpiresAt": "2023-11-07T05:31:56Z"
}
],
"imports": [
{
"fileId": "<string>",
"name": "<string>",
"size": 1,
"source": "<string>",
"status": "<string>"
}
]
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"details": {},
"docs": "<string>"
}
}Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer yk_live_…. Scopes: transfers:read, transfers:write, collections:read, collections:write, contacts:read, contacts:write, webhooks:read, webhooks:write. A write scope implies read of the same resource.
Path Parameters
Transfer id. Never the share slug, which is a capability.
Body
application/json
Files you will upload yourself.
Maximum array length:
500Show child attributes
Show child attributes
Files Yungle fetches from URLs itself, so the bytes never pass through you. Up to 20 per call. Each is created like an upload (quota, size ceilings, API metering) and imported in the background; follow it with GET /imports/{fileId}.
Maximum array length:
20Show child attributes
Show child attributes
Response
Upload targets for the new files.
