Update Creative by ID

Marketplace DSP API

/API Reference/

Request

Update an individual creative. Specify only the properties you want to update. Properties you omit remain unchanged.

Security

SessionCookie

Path

idstringrequired

Bodyapplication/jsonrequired

pixel_urlstring

Example:"https://apixelurl.com"

campaign_idsArray of strings

Example:

[
  "juIGaOygS0CBBqtmXHamqA"
]

category_idsArray of strings

Example:

[
  "juIGaOygS0CBBqtmXHamqA"
]

insertion_order_idsArray of strings

Example:

[
  "juIGaOygS0CBBqtmXHamqA"
]

curl -i -X PATCH \
  'https://platform-api.vistarmedia.com/api/dsp/v1/creatives/{id}' \
  -H 'Content-Type: application/json' \
  -H 'Cookie: YOUR_API_KEY_HERE' \
  -d '{
    "pixel_url": "https://apixelurl.com",
    "campaign_ids": [
      "juIGaOygS0CBBqtmXHamqA"
    ],
    "category_ids": [
      "juIGaOygS0CBBqtmXHamqA"
    ],
    "insertion_order_ids": [
      "juIGaOygS0CBBqtmXHamqA"
    ]
  }'

Responses

Operation completed successfully.

Bodyapplication/json

idstring

Example:"juIGaOygS0CBBqtmXHamqA"

campaign_idsArray of strings

Example:

[
  "juIGaOygS0CBBqtmXHamqA"
]

create_timestring, (date-time)

Example:"2004-09-22T16:16:42Z"

namestring

Example:"Some-Advertising-Campaign-2025.jpg"

thumbnail_urlstring

Example:"https://transcodes.vistarmedia.com.s3.amazonaws.com/abc123/thumb.png"

pixel_urlstring

Example:"https://apixelurl.com"

duration_msinteger, (int32)

Example:1500

category_idsArray of strings

Example:

[
  "juIGaOygS0CBBqtmXHamqA"
]

archivedboolean

Example:false

typestring(api.dsp.v1.Creative.CreativeType)

Default:"NONE"

Enum:"NONE""DYNAMIC""SAGE_AND_ARCHER_DYNAMIC""IMAGE""VIDEO""AUDIO""UNKNOWN"

requires_audioboolean

Example:true

processing_statusstring(api.dsp.v1.Creative.CreativeStatus)

Default:"PROCESSING"

Enum:"PROCESSING""PROCESSED""FAILED"

assetobject(api.dsp.v1.Creative.Asset)

auditsArray of objects(api.dsp.v1.Creative.Audit)

advertiser_idstring

Example:"juIGaOygS0CBBqtmXHamqA"

insertion_order_idsArray of strings

Example:

[
  "juIGaOygS0CBBqtmXHamqA"
]

Response

{
  "id": "juIGaOygS0CBBqtmXHamqA",
  "campaign_ids": [
    "juIGaOygS0CBBqtmXHamqA"
  ],
  "create_time": "2004-09-22T16:16:42Z",
  "name": "Some-Advertising-Campaign-2025.jpg",
  "thumbnail_url": "https://transcodes.vistarmedia.com.s3.amazonaws.com/abc123/thumb.png",
  "pixel_url": "https://apixelurl.com",
  "duration_ms": 1500,
  "category_ids": [
    "juIGaOygS0CBBqtmXHamqA"
  ],
  "archived": false,
  "type": "NONE",
  "requires_audio": true,
  "processing_status": "PROCESSING",
  "asset": {
    "url": "https://transcodes.vistarmedia.com.s3.amazonaws.com/abc123/abc123-1920x1080.png",
    "height": 1080,
    "width": 1920,
    "format": "video/mp4",
    "file_size_bytes": 1024
  },
  "audits": [
    { … }
  ],
  "advertiser_id": "juIGaOygS0CBBqtmXHamqA",
  "insertion_order_ids": [
    "juIGaOygS0CBBqtmXHamqA"
  ]
}