Skip to main content
POST
Update LineItems

Body

application/json
budget
number<double>
required

Total budget of the line item

end_date
string<date-time>
required

End date of the line item (UTC)

goal
string
required

Goal of the line item (click, reach, impression, conversion)

id
string<uuid>
required

ID of the line item (uuid7)

name
string
required

Name of the line item

oid
string<uuid>
required

ID of the parent order

owner_id
string<uuid>
required

Owner ID of the line item

start_date
string<date-time>
required

Start date of the line item (UTC)

status
enum<string>
required

Status of the line item (draft, ready, preparing, delivering, archived)

Available options:
draft,
ready,
preparing,
delivering,
archived
target_cpa
number<double>
required

Target cost per acquisition (CPA) for the line item

ad_type
string
default:standard

Ad type for the line item (e.g., "standard", "decision")

audience_segments
object | null

Optional audience segments associated with the line item

bid_strategy
string
default:highest_volume

Bid strategy for the line item (default: "highest_volume")

creative_rotation
object

Creative rotation strategy for the line item

custom_targeting
object | null

Optional custom targeting conditions for the line item

daily_budget
number<double> | null

Optional daily budget of the line item

description
string | null

Optional description of the line item

ext
any

Optional extension for the line item

max_bid
number<double>
default:0

Maximum bid amount for the line item (default: 0.0)

min_daily_imp
number<double>
default:1000

Minimum daily impressions for the line item (default: 1000.0)

pace_method
string
default:evenly

Pacing method for the line item

priority
integer<uint32>
default:8

Priority of the line item

Required range: x >= 0
schedule
object | null

Optional schedule for the line item

sub_goal
string
default:maximize_volume

Sub-goal of the line item (default: "maximize_volume")

target_cpm
number<double>
default:0

Target cost per thousand impressions (CPM) for the line item (default: 0.0)

target_volume
number<double>
default:0

Target volume for the line item (default: 0.0)

Response

Success