Upsert audits
const url = 'https://portal.staging.arago-tech.com/audits';const options = { method: 'PUT', headers: {Authorization: '<Authorization>', 'Content-Type': 'application/json'}, body: '{"audits":[{"id":"63e2d42a27ad5f2b345ca123","creative_id":"63e2d42a27ad5f2b345ca123","dynamic_content_optimization_id":"63e2d42a27ad5f2b345ca123","advertiser_domains":["example.com","another.example.com"],"ad_product_categories":[1028,1032]}]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://portal.staging.arago-tech.com/audits \ --header 'Authorization: <Authorization>' \ --header 'Content-Type: application/json' \ --data '{ "audits": [ { "id": "63e2d42a27ad5f2b345ca123", "creative_id": "63e2d42a27ad5f2b345ca123", "dynamic_content_optimization_id": "63e2d42a27ad5f2b345ca123", "advertiser_domains": [ "example.com", "another.example.com" ], "ad_product_categories": [ 1028, 1032 ] } ] }'Creates or updates multiple audits.
Authorizations
Section titled “Authorizations”Request Body
Section titled “Request Body”Request to bulk upsert audits.
Request to bulk upsert audits.
object
List of audits to upsert
Audit details for upsert
object
The unique identifier of the audit. If not provided, a new audit will be created.
Example
63e2d42a27ad5f2b345ca123The unique identifier of the creative in hexadecimal format
Example
63e2d42a27ad5f2b345ca123The unique identifier of the dynamic content optimization in hexadecimal format
Example
63e2d42a27ad5f2b345ca123List of advertiser domains associated with the audit
Example
[ "example.com", "another.example.com"]List of ad product categories associated with the creative. These are numeric identifiers representing different categories as per https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/develop/Ad%20Product%20Taxonomies/Ad%20Product%20Taxonomy%202.0.tsv.
Example
[ 1028, 1032]Responses
Section titled “ Responses ”A successful response.
object
Audit details
object
Unique identifier for the audit.
The unique identifier of the creative in hexadecimal format
The unique identifier of the dynamic content optimization in hexadecimal format
List of advertiser domains associated with the audit
List of ad product categories associated with the creative. These are numeric identifiers representing different categories as per https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/develop/Ad%20Product%20Taxonomies/Ad%20Product%20Taxonomy%202.0.tsv.
Feedback provided by the auditor.
The status of the audit.
The UTC created date of the audit
The UTC last updated date of the audit
Example
{ "audits": [ { "id": "63e2d42a27ad5f2b345ca124", "creative_id": "63e2d42a27ad5f2b345ca123", "dynamic_content_optimization_id": "63e2d42a27ad5f2b345ca123", "advertiser_domains": [ "example.com", "another.example.com" ], "ad_product_categories": [ 1028, 1032 ], "feedback": "The creative is compliant with the guidelines.", "status": "AUDIT_STATUS_UNSPECIFIED", "created_at": "2023-01-01T00:00:00Z", "updated_at": "2023-01-01T00:00:00Z" } ]}Bad request
object
Example
{ "error": { "code": "BAD_REQUEST", "details": [ { "code": "MAX_ITEMS", "field": "line_items", "message": "value must contain no more than 3000 item(s)", "params": { "max": "3000" } } ], "message": "Bad request" }}Unauthorized
object
Example
{ "error": { "code": "UNAUTHORIZED", "message": "Unauthorized" }}Internal server error
object
Example
{ "error": { "code": "INTERNAL_ERROR", "message": "Internal server error" }}default
Section titled “default”An unexpected error response.
object
object
Examplegenerated
{ "code": 1, "message": "example", "details": [ { "@type": "example" } ]}