media

Import media from a URL

Import a file from a remote URL into the media library. The API fetches the file server-side, checking that the URL does not point to a disallowed destination, stores its bytes, and creates the media asset record. This is the same path used by the upload_media_from_url tool.

Fetches a public http(s) URL into the library. SVG is refused.

Notes.

  • The response is the row as built for insert, not the GET shape: tags is a JSON string (not an array), sourceUrl is present but not stored, and most columns (state, fit, width, …) are absent. Read GET /v1/media/{id} for the settled asset.
post/v1/media/import-url

Request

  • Base URL: https://api.brixsignage.com
  • URL: https://api.brixsignage.com/v1/media/import-url
  • Auth: HTTP bearer

Request body

urlstring required

Public http(s) address of the file.

namestring

Display name; defaults to the file name in the URL.

folderIdstring
nodeIdstring

Home location; defaults to your own.

tagsstring[]
autoCaptionboolean

Videos: generate captions.

autoSmartFitboolean

Images: detect a focal region (default true).

Response

Success.

Changes

No recorded changes to this operation across all 2 revisions of this API.