Files

Start file import

Start importing a file from a URL. Supports:

  • Google Drive links
  • Dropbox links
  • YouTube video URLs
  • A direct http or https link to a video, audio or image file on any public host

The import runs asynchronously. Use the status endpoint to track progress. File name is derived from the source and cannot be customized.

A direct link must return the media file itself. Its content type decides whether it is a video, audio or image file; application/octet-stream falls back to the file extension. The file must fit your plan's max file size, and a video counts against your storage quota like a Studio upload. A URL that resolves to a private or internal address is refused with URL_NOT_ALLOWED, also when a redirect leads there. If the address turns private while the file downloads, the import ends with status error. A host that does not resolve is refused with URL_NOT_RESOLVED. A refused direct link answers 400 IMPORT_FAILED with the reason; a Google Drive, Dropbox or YouTube failure keeps its 500 IMPORT_FAILED.

curl -X POST https://api.livereacting.com/v1/external/files/import \
  -H "Authorization: Bearer $LR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://cdn.example.com/videos/intro.mp4", "type": "video"}'
post/files/import

Request

  • Base URL: https://api.livereacting.com/v1/external
  • URL: https://api.livereacting.com/v1/external/files/import
  • Auth: HTTP bearer

Request body

urlstring uri required

URL to import from. Supported sources:

  • Google Drive links
  • YouTube video URLs (audio/video extraction)
  • Dropbox links
  • A direct http or https link to a video, audio or image file on any public host

A direct link must return the file itself, not a web page. URLs that point to a private or internal address are refused with URL_NOT_ALLOWED.

type'video' | 'image' | 'audio' required

Type of file being imported

folderIdstring nullable

Optional folder ID to import file into. The folder must belong to the authenticated user and match the import type (e.g., video folder for video import). If not provided or null, file is imported to root level.

Example request

{
  "url": "https://drive.google.com/file/d/abc123/view",
  "type": "video",
  "folderId": "507f1f77bcf86cd799439011"
}

Response

Import started successfully

fileIdstring

ID of the file being imported

statusstring

Example response

{
  "fileId": "507f1f77bcf86cd799439011",
  "status": "in_progress"
}

Changes

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