Skip to main content
POST
Create a new acceptance-policy version

Authorizations

Authorization
string
header
required

API key or access token

Body

application/json

Request body for creating a new acceptance-policy version and optionally activating it atomically.

content
string

Markdown acceptance policy used to evaluate advertiser categories, buyer-submitted creatives, and approval workflow requirements. Stored as given, so an unmarked policy keeps applying to both Brief Acceptance and Creative Policy. Send either content or both briefAcceptancePolicy and creativePolicy.

Required string length: 1 - 50000
briefAcceptancePolicy
string

Rules applied before responding to a buyer brief or accepting a media buy. Send together with creativePolicy; the API composes both into one stored policy with an explicit section boundary. Use an empty string to clear a section.

Maximum string length: 50000
creativePolicy
string

Rules applied only to submitted creative. Send together with briefAcceptancePolicy.

Maximum string length: 50000
notes
string

Operator note describing why this version was created. Not surfaced to buyers.

Maximum string length: 2000
activate
boolean
default:false

When true, atomically make the new version active as part of the create. Defaults to false.

Response

Create a new acceptance-policy version

A single acceptance-policy version for a storefront. Versions are immutable; updates produce a new row.

id
string
required

Surrogate id of the version row (BIGINT serialized).

Example:

"42"

storefrontId
string
required

Storefront the version belongs to (BIGINT serialized as string).

Example:

"1234"

version
integer
required

Per-storefront version number.

Required range: 1 <= x <= 9007199254740991
Example:

3

content
string
required

Markdown acceptance policy.

briefAcceptancePolicy
string
required

The Brief Acceptance section of content, for an editor to show and send back. An unmarked policy applies to both gates, so both sections carry it whole.

creativePolicy
string
required

The Creative Policy section of content, for an editor to show and send back.

notes
string | null
required

Operator note about why this version was authored.

isActive
boolean
required

Whether this version is the Storefront's active acceptance policy.

createdAt
string<date-time>
required

Creation timestamp (ISO 8601).

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))$
createdBy
string | null
required

User id of the operator who authored the version (BIGINT serialized as string). Null when authored by a system or service-token caller.