RErendley
Library

Import a Library asset from a URL

The server downloads a public HTTPS file and stores it as a Library asset. The host must report Content-Length. Dropbox and Google Drive share links are converted to direct downloads. With async: true the link is checked and the asset returned at once with status importing; follow it with GET /library/{workspaceId}/uploads/{uploadId}/status.

post/library/{workspaceId}/uploads/import

Request

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

Path parameters

workspaceIdstring required

Workspace 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.