RErendley
Uploads

Import an upload from a URL

One-call upload for a file that is already hosted: the server downloads it from a public HTTPS direct link, stores it and returns the completed upload. Use the returned media_id as the media reference of AI actions. No client-side hashing or presigned PUT is needed. The host must report Content-Length; files are capped at 5 GB and must be video, audio or images. Dropbox and Google Drive share links are converted to direct downloads. With async: true the link is checked and the upload returned at once with status importing; the download runs in the background (follow it with GET /projects/{projectId}/uploads/{media_id}/status).

post/projects/{projectId}/uploads/import

Request

  • Base URL
    https://api.rendley.com/v1
  • Auth
    API key in header Authorization

Path parameters

projectIdstring required

Project ID

Request body

asyncboolean

Async returns the row at once and downloads in the background; follow it with the upload status endpoint.

download_urlstring required
file_namestring
mime_typestring
project_idstring
role'library' | 'pending' | 'staged' | 'transient'

Role/Source follow the same defaults as UploadInput.

source'editor' | 'mcp' | 'agent' | 'export' | 'ai' | 'duplicate'

Response

OK

metaunknown

Example response

{
  "data": {
    "file_hash": "c6c8ec4f9a6fdd9d",
    "media_id": "c448b6e3-2b78-4bda-b369-d1afc6aec07f"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.