{
"id": "job_3f9a2c7e1b4d",
"object": "upload",
"filename": "interview.mp4",
"size": 734003200,
"status": "uploading",
"error": null,
"part_size": 16777216,
"part_count": 44,
"parts": [
{
"part_number": 1,
"url": "https://…"
},
{
"part_number": 2,
"url": "https://…"
}
],
"parts_expire_at": "2026-10-28T09:27:44Z"
}{
"id": "job_3f9a2c7e1b4d",
"object": "upload",
"filename": "interview.mp4",
"size": 0,
"status": "fetching",
"error": null,
"part_size": 8388608,
"part_count": 0,
"parts": [],
"parts_expire_at": null
}{
"error": {
"code": "UPLOAD_INCOMPLETE",
"message": "Complete the upload before dubbing it.",
"request_id": "req_8f2c1e0a9b7d6c5e4f3a",
"fields": [
{
"field": "target_languages",
"message": "Field required"
}
]
}
}{
"error": {
"code": "UPLOAD_INCOMPLETE",
"message": "Complete the upload before dubbing it.",
"request_id": "req_8f2c1e0a9b7d6c5e4f3a",
"fields": [
{
"field": "target_languages",
"message": "Field required"
}
]
}
}{
"error": {
"code": "UPLOAD_INCOMPLETE",
"message": "Complete the upload before dubbing it.",
"request_id": "req_8f2c1e0a9b7d6c5e4f3a",
"fields": [
{
"field": "target_languages",
"message": "Field required"
}
]
}
}{
"error": {
"code": "UPLOAD_INCOMPLETE",
"message": "Complete the upload before dubbing it.",
"request_id": "req_8f2c1e0a9b7d6c5e4f3a",
"fields": [
{
"field": "target_languages",
"message": "Field required"
}
]
}
}{
"error": {
"code": "UPLOAD_INCOMPLETE",
"message": "Complete the upload before dubbing it.",
"request_id": "req_8f2c1e0a9b7d6c5e4f3a",
"fields": [
{
"field": "target_languages",
"message": "Field required"
}
]
}
}Create an upload
Start uploading a video or audio file. Send each part with a PUT to its link (keep each response’s ETag), ask for more links with Sign more parts, then call Complete an upload.
{
"id": "job_3f9a2c7e1b4d",
"object": "upload",
"filename": "interview.mp4",
"size": 734003200,
"status": "uploading",
"error": null,
"part_size": 16777216,
"part_count": 44,
"parts": [
{
"part_number": 1,
"url": "https://…"
},
{
"part_number": 2,
"url": "https://…"
}
],
"parts_expire_at": "2026-10-28T09:27:44Z"
}{
"id": "job_3f9a2c7e1b4d",
"object": "upload",
"filename": "interview.mp4",
"size": 0,
"status": "fetching",
"error": null,
"part_size": 8388608,
"part_count": 0,
"parts": [],
"parts_expire_at": null
}{
"error": {
"code": "UPLOAD_INCOMPLETE",
"message": "Complete the upload before dubbing it.",
"request_id": "req_8f2c1e0a9b7d6c5e4f3a",
"fields": [
{
"field": "target_languages",
"message": "Field required"
}
]
}
}{
"error": {
"code": "UPLOAD_INCOMPLETE",
"message": "Complete the upload before dubbing it.",
"request_id": "req_8f2c1e0a9b7d6c5e4f3a",
"fields": [
{
"field": "target_languages",
"message": "Field required"
}
]
}
}{
"error": {
"code": "UPLOAD_INCOMPLETE",
"message": "Complete the upload before dubbing it.",
"request_id": "req_8f2c1e0a9b7d6c5e4f3a",
"fields": [
{
"field": "target_languages",
"message": "Field required"
}
]
}
}{
"error": {
"code": "UPLOAD_INCOMPLETE",
"message": "Complete the upload before dubbing it.",
"request_id": "req_8f2c1e0a9b7d6c5e4f3a",
"fields": [
{
"field": "target_languages",
"message": "Field required"
}
]
}
}{
"error": {
"code": "UPLOAD_INCOMPLETE",
"message": "Complete the upload before dubbing it.",
"request_id": "req_8f2c1e0a9b7d6c5e4f3a",
"fields": [
{
"field": "target_languages",
"message": "Field required"
}
]
}
}Authorizations
rk_live_… or rk_test_…, made in Reedapt under Developers.
Headers
Any unique string, up to 255 characters. Sending the same request again with the same key returns the first answer instead of doing the work twice. Kept for 24 hours.
"7c1f6a52-2d4e-4bb1-9e0a-5f3d8c2b1a90"
Body
The file's name, with its extension. With source_url, only if the link doesn't end in one.
1 - 255"interview.mp4"
The file's size in bytes (not with source_url).
x > 0734003200
A public http(s) link to the file. We download it ourselves; poll the upload until it is uploaded.
2048"https://example.com/media/interview.mp4"
Response
Successful Response
The upload's id. Its dubs are created from it.
"job_3f9a2c7e1b4d"
"interview.mp4"
In bytes. 0 while a source_url is still downloading.
734003200
uploading: waiting for its parts. fetching: we're downloading source_url. uploaded: ready to dub. used: already dubbed. failed: see error.
uploading, fetching, uploaded, used, failed "uploading"
Every part but the last is exactly this many bytes.
16777216
44
"upload"Why a fetch from source_url failed.
Signed links for the first parts. Ask for the rest with /parts.
Show child attributes
Show child attributes
When the links in parts stop working (15 minutes).