Upload Assets

Upload assets to project

POST /api/v2/assets

Headers

Name	Type	Description
Authorization	string	Bearer token
Content-Type	string	multipart/form-data

Request Body

Name	Type	Description
files	string	Files to upload
items	string	URLs to images

201

// OK

Example

POST /api/v2/spaces/:space_id/assets

Path Parameters

Name	Type	Description
space_id	string	Space UUID

Headers

Name	Type	Description
Authorization	string	Bearer token
Content-Type	string	multipart/form-data

Request

------WebKitFormBoundaryVlVAGbSHnrzHifqA
Content-Disposition: form-data; name="files"; filename="vh001.jpeg"
Content-Type: image/jpeg


------WebKitFormBoundaryVlVAGbSHnrzHifqA
Content-Disposition: form-data; name="files"; filename="vh002.jpeg"
Content-Type: image/jpeg


------WebKitFormBoundaryVlVAGbSHnrzHifqA--

Attributes

Name	Type	Description
files	array of strings (binary)	Files tp upload
urls	array of strings (binary)	URLs to assets

Response

201 Created

{
  "data": [
    {
      "id": "a8e22ad3-b8b1-4fe2-a08a-45e5ba39df7d",
      "type": "assets",
      "attributes": {
        "name": "VH 1",
        "alt_text": "vh1",
        "file_name": "vh001.jpg",
        "path": "assets/43/43f6358e-dcbb-45f9-a9d7-25156a3f9707/orig",
        "thumbnail_path": "assets/43/43f6358e-dcbb-45f9-a9d7-25156a3f9707/thumbnail",
        "size": 123456,
        "mime_type": "image/jpeg",
        "image_width": 1920,
        "image_height": 1080,
        "created_at": "2021-01-01T00:00:00Z",
        "uploader_name": "John Doe",
        "uploader_email": "[e-mail]"
      },
      "relationships": {
        "asset_tags": {
          "data": [
            {
              "type": "asset_tags",
              "id": "123e4567-e89b-12d3-a456-426614174000"
            }
          ]
        }
      }
    }
    {
      "id": "b8e22ad3-b8b1-4fe2-a08a-45e5ba39df7d",
      "type": "assets",
      "attributes": {
        "name": "VH 2",
        "alt_text": "vh2",
        "file_name": "vh002.jpg",
        "path": "assets/13/13f6358e-dcbb-45f9-a9d7-25156a3f9707/orig",
        "thumbnail_path": "assets/13/13f6358e-dcbb-45f9-a9d7-25156a3f9707/thumbnail",
        "size": 123456,
        "mime_type": "image/jpeg",
        "image_width": 1920,
        "image_height": 1080,
        "created_at": "2021-01-01T00:00:00Z",
        "uploader_name": "John Doe",
        "uploader_email": "[e-mail]"
      },
      "relationships": {
        "asset_tags": {
          "data": [
            {
              "type": "asset_tags",
              "id": "123e4567-e89b-12d3-a456-426614174000"
            }
          ]
        }
      }
    }  
  ],
  "meta": {
    "page": {
      "current": 1,
      "total_pages": 13,
      "total_count": 1239,
      "per_page": 100
    }
  }
}

Example

curl -i -X POST \                                                                                                                                                                                                           17:52:24
  -H "Authorization: Bearer rJURvA6XuuHxG5RHauqR1yy64JQcTfGu" \
  -F "files=@/file/path/playerOne.jpeg" \
  -F "files=@/file/path/playerTwo.webp" \
  https://environment.monterosa.cloud/api/v2/spaces/2dae6dc6-c2c5-4220-b69d-4bda57f79bf2/assets