---
title: "Upload Media from URL"
method: POST
path: "/library/uploadUrl"
tags: ["library"]
---

# Upload Media from URL

`POST /library/uploadUrl`

Upload Media to CMS library from an external URL

## Response `201`

successful operation

- Media — Class Media
  - `mediaId` integer — The Media ID
  - `ownerId` integer — The ID of the User that owns this Media
  - `parentId` integer — The Parent ID of this Media if it has been revised
  - `name` string — The Name of this Media
  - `mediaType` string — The module type of this Media
  - `storedAs` string — The file name of the media as stored in the library
  - `fileName` string — The original file name as it was uploaded
  - `tags` TagLink[] — Tags associated with this Media, array of TagLink objects
    - `tag` string — The Tag
    - `tagId` integer — The Tag ID
    - `value` string — The Tag Value
  - `fileSize` integer — The file size in bytes
  - `duration` integer — The duration to use when assigning this media to a Layout widget
  - `valid` integer — Flag indicating whether this media is valid.
  - `moduleSystemFile` integer — DEPRECATED: Flag indicating whether this media is a system file or not
  - `expires` integer — Timestamp indicating when this media should expire
  - `retired` integer — Flag indicating whether this media is retired
  - `isEdited` integer — Flag indicating whether this media has been edited and replaced with a newer file
  - `md5` string — A MD5 checksum of the stored media file
  - `owner` string — The username of the User that owns this media
  - `groupsWithPermissions` string — A comma separated list of groups/users with permissions to this Media
  - `released` integer — A flag indicating whether this media has been released
  - `apiRef` string — An API reference
  - `createdDt` string — The datetime the Media was created
  - `modifiedDt` string — The datetime the Media was last modified
  - `enableStat` string — The option to enable the collection of Media Proof of Play statistics
  - `orientation` string — The orientation of the Media file
  - `width` integer — The width of the Media file
  - `height` integer — The height of the Media file
  - `folderId` integer — The id of the Folder this Media belongs to
  - `permissionsFolderId` integer — The id of the Folder responsible for providing permissions for this Media

---

[API](https://skmtc.net/xibosignage/apis/xibo-api.md) · [All operations](https://skmtc.net/xibosignage/apis/xibo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xibosignage/xibo-api/versions/fe497e811c7f/schema)