Skip to main content
POST
Upload media file for a creative.

Authorizations

Authorization
string
header
required

Bearer authentication. Pass the access token in the Authorization: Bearer <token> header.

Path Parameters

crid
string<uuid>
required

Body

multipart/form-data
file
file
required

Media file to upload. Accepted formats: image (PNG, JPEG, GIF) or video (MP4).

Response

Successful Response

created_at
string<date-time>
required
height
integer
required

Height of the creative in pixels.

Required range: x >= 0
id
string<uuid>
required

Unique identifier for the creative (UUID v7).

name
string
required

Human-readable name of the creative.

owner_id
string<uuid>
required

User ID of the admin/operator who created the creative.

type
enum<string>
required

Type of the creative (e.g., "banner", "video", "native").

Available options:
banner,
video,
native
updated_at
string<date-time>
required
width
integer
required

Width of the creative in pixels.

Required range: x >= 0
advertiser_domain
string | null

Advertiser domain using this creative.

advertiser_id
string<uuid> | null

Advertiser ID using this creative.

banner
BannerResponse · object | null

읽기/응답용 DTO — 저장된 AdCOM Banner를 그대로 노출. 검증 없음.

description
string | null

Optional description of the creative.

end_date
string<date-time> | null
ext
any
default:{}

extension for the creative

native
Native · object | null

Native creative content

no
integer | null
start_date
string<date-time> | null
status
enum<string>
default:inactive

Status of the creative.

Available options:
inactive,
active
video
Video · object | null