Skip to main content
POST
/
api
/
v1
/
media
Create Media Assets
curl --request POST \
  --url http://localhost:8000/api/v1/media/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'files=<string>' \
  --form files.items='@example-file'
[
  {
    "id": 123,
    "filename": "<string>",
    "url": "<string>",
    "file_size": 123,
    "mime_type": "<string>",
    "date_added": "2023-11-07T05:31:56Z",
    "date_updated": "2023-11-07T05:31:56Z",
    "width": 123,
    "height": 123,
    "external_id": "<string>",
    "external_metadata": {},
    "tags": [
      "<string>"
    ],
    "alt_text": "<string>"
  }
]

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

​
company_id
integer
required

Company ID

Body

multipart/form-data
​
files
file[]
required

Files to upload (max 50MB total)

​
tags
string[]

Tags for uploaded files

Response

Successful Response

​
id
integer
required
​
filename
string
required
​
url
string
required
​
file_size
integer
required
​
mime_type
string
required
​
source_type
enum<string>
required
Available options:
upload,
stock,
ai_generated
​
date_added
string<date-time>
required
​
date_updated
string<date-time>
required
​
width
integer | null
​
height
integer | null
​
external_id
string | null
​
external_metadata
External Metadata · object
​
tags
string[]
​
alt_text
string | null