Skip to main content
Browse Documentation
Upload asset file

Upload asset file

Created by r.turner, last modified by m.summerfield on 03 May 2022

A file is required to be uploaded to the asset resource endpoint before an asset can be created. A content type of multipart/form-data is used to perform the upload. A file id is returned for a successful upload which then can be used as a file reference in a AssetFile field when creating an asset. Multiple files can be uploaded in a single request with the resulting file ids returning in the same order as they are uploaded. It is not possible to have an upload larger than 2GB, though depending on your connection speed to the CMS, your upload may time out before reaching that limit.

POST /api/management/projects/{projectId}/assets/

Parameters

Name Parameter type Type Format Description
projectId path string   The project identifier.
JSON
POST /api/management/projects/website/assets HTTP/1.1 Authorization: Bearer [YOUR_AUTH_TOKEN] Content-Type: multipart/form-data; Content-Length: 230563 boundary=--upload_boundary --upload_boundary Content-Type: image/jpeg [JPEG_DATA] --upload_boundary Content-Type: image/jpeg [JPEG_DATA] --upload_boundary--

Response message

HTTP status code Reason Response model
201 Created Array of file id objects
401 Unauthorized Error
500 InternalServerError Error
JSON
[ { "fileId": "25bd73bb-cbb0-454f-a762-2bee08a68cbe.jpg" }, { "fileId": "97d70ad2-017f-46ff-8d9e-f8d054652d9c.jpg" } ]