Skip to main content
POST

Path parameters

integer
required
Space ID.

Request body

string
required
Direct link to the file, up to 255 characters, no authorization.
string
required
Title up to 255 characters, ends with the file extension.
string
required
MIME type of the file.

Response

integer
Recording ID. While the file downloads, the recording is hidden from the list.
After the response, wait for is_uploaded: true in Upload status for that audio_id, then start processing. If the file can’t be downloaded, the recording stays at is_uploaded: false with no separate error. Learn more: Uploading by URL.
Last modified on October 17, 2026