Change an exact advertiser admission role bundle
curl --request PUT \
--url https://api.interchange.io/api/v2/organization/advertisers/{advertiserId}/admissions/{admissionId}/capabilities \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"expectedRevision": "<string>",
"requestedCapabilities": [],
"reason": "<string>",
"idempotencyKey": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://api.interchange.io/api/v2/organization/advertisers/{advertiserId}/admissions/{admissionId}/capabilities"
payload = {
"expectedRevision": "<string>",
"requestedCapabilities": [],
"reason": "<string>",
"idempotencyKey": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
expectedRevision: '<string>',
requestedCapabilities: [],
reason: '<string>',
idempotencyKey: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
})
};
fetch('https://api.interchange.io/api/v2/organization/advertisers/{advertiserId}/admissions/{admissionId}/capabilities', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": {
"admissionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"advertiserId": "<string>",
"revision": "<string>",
"requestedRoleSlug": "advertiser-viewer",
"requestedCapabilities": [
"read"
]
},
"error": null
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}Advertisers
Change an exact advertiser admission role bundle
Replace the canonical advertiser role bundle for one current approved admission as a directly authenticated Seller administrator. The current role, expected revision, exact capabilities, and idempotency key fail closed on stale or changed requests. Billing, payment, and Campaign execution capabilities are not part of this contract.
PUT
/
organization
/
advertisers
/
{advertiserId}
/
admissions
/
{admissionId}
/
capabilities
Change an exact advertiser admission role bundle
curl --request PUT \
--url https://api.interchange.io/api/v2/organization/advertisers/{advertiserId}/admissions/{admissionId}/capabilities \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"expectedRevision": "<string>",
"requestedCapabilities": [],
"reason": "<string>",
"idempotencyKey": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://api.interchange.io/api/v2/organization/advertisers/{advertiserId}/admissions/{admissionId}/capabilities"
payload = {
"expectedRevision": "<string>",
"requestedCapabilities": [],
"reason": "<string>",
"idempotencyKey": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
expectedRevision: '<string>',
requestedCapabilities: [],
reason: '<string>',
idempotencyKey: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
})
};
fetch('https://api.interchange.io/api/v2/organization/advertisers/{advertiserId}/admissions/{admissionId}/capabilities', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": {
"admissionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"advertiserId": "<string>",
"revision": "<string>",
"requestedRoleSlug": "advertiser-viewer",
"requestedCapabilities": [
"read"
]
},
"error": null
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}Authorizations
API key or access token
Path Parameters
Pattern:
^[1-9][0-9]*$Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Body
application/json
Pattern:
^[1-9][0-9]*$Available options:
advertiser-viewer, advertiser-editor, advertiser-admin Available options:
advertiser-viewer, advertiser-editor, advertiser-admin Required array length:
1 - 3 elementsAvailable options:
read, write, admin Required string length:
3 - 1000Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$