Skip to main content
POST
Error

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
assetKind
enum<string>
required

Purpose of the asset; determines the allowed contentType and max size on upload (see InitUploadRequest.contentType). PROJECT_LOGO — project logo (light/dark variants). CAMPAIGN_MEDIA — campaign creative.

Available options:
PROJECT_LOGO,
CAMPAIGN_MEDIA
​
contentType
string
required

MIME type of the file. Allowed values depend on assetKind: PROJECT_LOGO — image/png, image/jpeg, image/svg+xml (max 5 MB); CAMPAIGN_MEDIA — image/png, image/jpeg, image/gif, video/mp4 (max 25 MB). The server also verifies the actual file bytes against the declared contentType and sizeBytes.

Example:

"image/png"

​
sizeBytes
integer<int64>
required
​
originalName
string | null

Response

Success

​
uploadId
string<uuid>
required
​
assetKind
enum<string>
required

Purpose of the asset; determines the allowed contentType and max size on upload (see InitUploadRequest.contentType). PROJECT_LOGO — project logo (light/dark variants). CAMPAIGN_MEDIA — campaign creative.

Available options:
PROJECT_LOGO,
CAMPAIGN_MEDIA
​
contentType
string
required
​
sizeBytes
integer<int64>
required
​
state
enum<string>
required
Available options:
INITIATED,
UPLOADING,
CLEANING,
COMPLETED,
FAILED,
EXPIRED
​
expiresAt
string<date-time>
required
​
originalName
string | null