Skip to main content
POST
/
acceptance-policy
Create a new acceptance-policy version
curl --request POST \
  --url https://api.interchange.io/api/v2/storefront/acceptance-policy \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "<string>"
}
'
{
  "id": "42",
  "storefrontId": "1234",
  "version": 3,
  "content": "<string>",
  "notes": "<string>",
  "isActive": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "createdBy": "<string>"
}

Authorizations

​
Authorization
string
header
required

API key or access token

Body

application/json

Request body for creating a new acceptance-policy version.

​
content
string
required

Markdown acceptance policy used to evaluate advertiser categories, buyer-submitted creatives, and approval workflow requirements.

Required string length: 1 - 50000
​
notes
string

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

Maximum string length: 2000

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.

​
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.