curl --request POST \
--url https://api.rask.ai/v3/uploads \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"filename": "q3-webinar-teaser.mp4",
"content_type": "video/mp4",
"size_bytes": 18874368
}
'{
"object": "upload",
"id": "a41f7c2d-9e3b-4d5a-b8c1-6f2e0d9a7b14",
"status": "pending",
"filename": "q3-webinar-teaser.mp4",
"content_type": "video/mp4",
"size_bytes": 18874368,
"purpose": "project_source",
"transfer": {
"method": "single",
"url": "https://storage.example.com/q3-webinar-teaser.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=3b9f0c",
"headers": {
"Content-Type": "video/mp4",
"Content-Length": "18874368"
},
"expires_at": "2026-11-03T10:00:00Z"
},
"media_id": null,
"import_job_id": null,
"expires_at": "2026-11-04T09:00:00Z",
"created_at": "2026-11-03T09:00:00Z"
}Create a presigned upload
Creates an upload and returns one presigned PUT URL for the whole file, up to the plan’s limit (at most 5 GB).
curl --request POST \
--url https://api.rask.ai/v3/uploads \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"filename": "q3-webinar-teaser.mp4",
"content_type": "video/mp4",
"size_bytes": 18874368
}
'{
"object": "upload",
"id": "a41f7c2d-9e3b-4d5a-b8c1-6f2e0d9a7b14",
"status": "pending",
"filename": "q3-webinar-teaser.mp4",
"content_type": "video/mp4",
"size_bytes": 18874368,
"purpose": "project_source",
"transfer": {
"method": "single",
"url": "https://storage.example.com/q3-webinar-teaser.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=3600&X-Amz-Signature=3b9f0c",
"headers": {
"Content-Type": "video/mp4",
"Content-Length": "18874368"
},
"expires_at": "2026-11-03T10:00:00Z"
},
"media_id": null,
"import_job_id": null,
"expires_at": "2026-11-04T09:00:00Z",
"created_at": "2026-11-03T09:00:00Z"
}Content-Length and Content-Type: PUT the bytes without an Authorization header and with exactly the listed headers, then call completeUpload. URLs live 1 hour; getUpload re-signs them. Voice samples (purpose: voice_sample) may be audio (<= 11 MB) or video (<= 500 MB, its audio is extracted to MP3 on import); larger files fail with 413 media_too_large.
When to use: to send a local file as a project source or a voice sample. For a public URL use importMedia.
Side effects: Reserves an upload that expires after 24 hours; nothing is processed until completeUpload.
Cost: Free. Counts against the upload-hour rate limit and the payer’s caps of 20 open uploads (upload-open) and declared bytes per day (upload-bytes-day); 429 rate_limited names the policy.
Idempotency: Idempotency-Key accepted (SDKs send one); retries within 24 h replay the first response with freshly signed URLs.
Required scopes: media:write
Errors: unsupported_media_type (415), media_too_large (413)Authorizations
API key from Settings -> API keys, sent as Authorization: Bearer <key> (SDK environment variable RASK_API_KEY). Bound to one workspace and one acting user. Operations list the scopes they need (OpenAPI 3.1 scopes on a bearer scheme).
Scopes
Headers
Optional. A unique key per logical request (SDKs send a bare UUIDv4; an RFC 9651 quoted string is accepted and unquoted); reuse it unchanged on retries to replay the first response.
1 - 255^[\x20-\x7E]+$Body
Body of createUpload.
File name without /, \ or control characters.
1 - 255^[^/\\\x00-\x1F\x7F]+$Accepted upload content types. voice_sample uploads accept audio (<= 11 MB, kept as uploaded) and video (<= 500 MB; its audio is extracted to MP3 on import).
video/mp4: acceptedvideo/quicktime: acceptedvideo/x-matroska: acceptedvideo/webm: acceptedvideo/x-msvideo: acceptedvideo/x-m4v: acceptedvideo/3gpp: acceptedaudio/mpeg: acceptedaudio/wav: acceptedaudio/x-wav: acceptedaudio/flac: acceptedaudio/x-flac: acceptedaudio/mp4: acceptedaudio/x-m4a: accepted
video/mp4, video/quicktime, video/x-matroska, video/webm, video/x-msvideo, video/x-m4v, video/3gpp, audio/mpeg, audio/wav, audio/x-wav, audio/flac, audio/x-flac, audio/mp4, audio/x-m4a Exact size in bytes (<= getPlan.limits.max_upload_bytes).
1 <= x <= 5000000000project_source (default) or voice_sample (audio <= 11 MB, or video <= 500 MB whose audio is extracted to MP3).
project_source, voice_sample Response
Created: Upload.
A presigned upload. Bytes go straight to storage, never through the API host.
Always upload.
upload Upload id.
Upload status.
pending: waiting for bytes; transfer URLs are validcompleting: completeUpload is runningcompleted: registered as mediaaborted: deleted before completionexpired: not completed within 24 hours
pending, completing, completed, aborted, expired File name.
Accepted upload content types. voice_sample uploads accept audio (<= 11 MB, kept as uploaded) and video (<= 500 MB; its audio is extracted to MP3 on import).
video/mp4: acceptedvideo/quicktime: acceptedvideo/x-matroska: acceptedvideo/webm: acceptedvideo/x-msvideo: acceptedvideo/x-m4v: acceptedvideo/3gpp: acceptedaudio/mpeg: acceptedaudio/wav: acceptedaudio/x-wav: acceptedaudio/flac: acceptedaudio/x-flac: acceptedaudio/mp4: acceptedaudio/x-m4a: accepted
video/mp4, video/quicktime, video/x-matroska, video/webm, video/x-msvideo, video/x-m4v, video/3gpp, audio/mpeg, audio/wav, audio/x-wav, audio/flac, audio/x-flac, audio/mp4, audio/x-m4a Declared size.
What a media item is for.
project_source: the source of a project (default)voice_sample: a sample for createVoiceClone (audio, or video whose audio is extracted to MP3 on import)
project_source, voice_sample Presigned URLs while pending, for a key with media:write; otherwise and afterwards null.
Show child attributes
Show child attributes
Media created by completeUpload.
The media_import job.
The upload expires 24 hours after creation.
Creation time.