Skip to main content
PATCH
Update buyer operator domain

Authorizations

Authorization
string
header
required

API key or access token

Body

application/json

Confirm or change the authenticated buyer account's commercial operator domain.

operatorDomain
string
required

Corporate domain of the organization operating this buyer account.

Maximum string length: 255
Pattern: ^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$
Example:

"northstar.media"

operatorScope
enum<string>

Whether this account represents the whole operator or one specific operating unit. Required for a confirmed AdCP 3.2 identity; omitted only by legacy clients.

Available options:
whole_operator,
specific_unit
Example:

"specific_unit"

operatorUnitId
string

Stable operator-issued identifier for the office, team, region, or seat. It is seller-visible and is not an Interchange database ID.

Required string length: 1 - 255
Pattern: ^[A-Za-z0-9][A-Za-z0-9._:/-]*$
Example:

"east-coast"

Response

Update buyer operator domain

Confirmed buyer-account operator identity. Authentication organization membership is unchanged.

id
integer
required
Required range: 0 < x <= 9007199254740991
operatorDomain
string
required
operatorScope
enum<string> | null
required
Available options:
whole_operator,
specific_unit
operatorUnitId
string | null
required
scopeConfirmedAt
string<date-time> | null
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
lockedAt
string<date-time> | null
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
verified
boolean
required
source
enum<string>
required
Available options:
user_confirmed
confirmedAt
string<date-time>
required
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$