{"openapi":"3.0.3","info":{"title":"Creative API Resources","version":"2.0.0","description":"Buzz API v2"},"paths":{"/creative-addons":{"get":{"operationId":"creative_addons_list","description":"Retrieve a list of all creative add-ons in the account. Supports filtering by name, type, creative type, vendor, currency and status.","summary":"List creative add-ons","parameters":[{"in":"query","name":"active","schema":{"type":"boolean"}},{"in":"query","name":"active__in","schema":{"type":"array","items":{"type":"boolean"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"active__not_in","schema":{"type":"array","items":{"type":"boolean"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"advertiser_id","schema":{"type":"number"}},{"in":"query","name":"advertiser_id__equals_or_null","schema":{"type":"number"}},{"in":"query","name":"advertiser_id__gt","schema":{"type":"number"}},{"in":"query","name":"advertiser_id__gte","schema":{"type":"number"}},{"in":"query","name":"advertiser_id__in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"advertiser_id__isempty","schema":{"type":"boolean"}},{"in":"query","name":"advertiser_id__lt","schema":{"type":"number"}},{"in":"query","name":"advertiser_id__lte","schema":{"type":"number"}},{"in":"query","name":"advertiser_id__not","schema":{"type":"number"}},{"in":"query","name":"advertiser_id__not_in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"alternative_id","schema":{"type":"string"}},{"in":"query","name":"alternative_id__contains","schema":{"type":"string"}},{"in":"query","name":"alternative_id__in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"alternative_id__isempty","schema":{"type":"boolean"}},{"in":"query","name":"alternative_id__not","schema":{"type":"string"}},{"in":"query","name":"alternative_id__not_contains","schema":{"type":"string"}},{"in":"query","name":"alternative_id__not_in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"alternative_id__not_startswith","schema":{"type":"string"}},{"in":"query","name":"alternative_id__startswith","schema":{"type":"string"}},{"in":"query","name":"content","schema":{"type":"string"}},{"in":"query","name":"content__contains","schema":{"type":"string"}},{"in":"query","name":"content__in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"content__isempty","schema":{"type":"boolean"}},{"in":"query","name":"content__not","schema":{"type":"string"}},{"in":"query","name":"content__not_contains","schema":{"type":"string"}},{"in":"query","name":"content__not_in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"cpm_cost","schema":{"type":"number"}},{"in":"query","name":"cpm_cost__gt","schema":{"type":"number"}},{"in":"query","name":"cpm_cost__gte","schema":{"type":"number"}},{"in":"query","name":"cpm_cost__in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"cpm_cost__isempty","schema":{"type":"boolean"}},{"in":"query","name":"cpm_cost__lt","schema":{"type":"number"}},{"in":"query","name":"cpm_cost__lte","schema":{"type":"number"}},{"in":"query","name":"cpm_cost__not","schema":{"type":"number"}},{"in":"query","name":"cpm_cost__not_in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"create_date","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"create_date__gt","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"create_date__gte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"create_date__isempty","schema":{"type":"boolean"}},{"in":"query","name":"create_date__lt","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"create_date__lte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"create_date__not","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"create_date__range","schema":{"type":"string","format":"date-time","nullable":true,"enum":["future","last_14_complete_days","last_14_days","last_24_hours","last_30_complete_days","last_30_days","last_365_complete_days","last_365_days","last_7_complete_days","last_7_days","last_90_complete_days","last_90_days","last_month","last_quarter","last_week","last_year","past","this_month","this_quarter","this_week","this_year","today","until_past_24_hours","yesterday"]},"description":"The date and time the object was first created\n\n* `today` - From last midnight to next midnight\n* `yesterday` - The last complete calendar day\n* `last_24_hours` - The last 24 hours (as opposed to today, which is from midnight to midnight)\n* `this_week` - From midnight the previous Sunday until midnight the coming Sunday\n* `last_week` - The last complete calendar week\n* `this_year` - From the January 1 to December 31 this year\n* `last_year` - The last complete calendar year\n* `this_month` - From the first day to the last day of the current month\n* `last_month` - The last complete calendar month\n* `this_quarter` - From the first day to the last day of the current quarter\n* `last_quarter` - The last complete calendar quarter\n* `last_7_days` - From midnight 7 days ago to the present\n* `last_7_complete_days` - From midnight 7 days ago to last midnight\n* `last_14_days` - From midnight 14 days ago to the present\n* `last_14_complete_days` - From midnight 14 days ago to last midnight\n* `last_30_days` - From midnight 30 days ago to the present\n* `last_30_complete_days` - From midnight 30 days ago to last midnight\n* `last_90_days` - From midnight 90 days ago to the present\n* `last_90_complete_days` - From midnight 90 days ago to last midnight\n* `last_365_days` - From midnight 365 days ago to the present\n* `last_365_complete_days` - From midnight 365 days ago to last midnight\n* `past` - Any date in the past. Useful for Buzz queries against end_date and similar fields\n* `future` - Any date in the future. Useful for Buzz queries against end_date and similar fields\n* `until_past_24_hours` - From the very first date in the past and up until past 24 hours"},{"in":"query","name":"creative_type","schema":{"type":"array","items":{"type":"string","nullable":true}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"creative_type__in","schema":{"type":"array","items":{"type":"string","nullable":true}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"creative_type__isempty","schema":{"type":"boolean"}},{"in":"query","name":"creative_type__not","schema":{"type":"array","items":{"type":"string","nullable":true}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"creative_type__not_in","schema":{"type":"array","items":{"type":"string","nullable":true}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"currency","schema":{"type":"string"}},{"in":"query","name":"currency__contains","schema":{"type":"string"}},{"in":"query","name":"currency__in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"currency__isempty","schema":{"type":"boolean"}},{"in":"query","name":"currency__not","schema":{"type":"string"}},{"in":"query","name":"currency__not_contains","schema":{"type":"string"}},{"in":"query","name":"currency__not_in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"global","schema":{"type":"boolean"},"description":"Filter creative add-ons by global status."},{"in":"query","name":"global__in","schema":{"type":"array","items":{"type":"boolean"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"global__not_in","schema":{"type":"array","items":{"type":"boolean"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"id","schema":{"type":"number"}},{"in":"query","name":"id__gt","schema":{"type":"number"}},{"in":"query","name":"id__gte","schema":{"type":"number"}},{"in":"query","name":"id__in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"id__lt","schema":{"type":"number"}},{"in":"query","name":"id__lte","schema":{"type":"number"}},{"in":"query","name":"id__not","schema":{"type":"number"}},{"in":"query","name":"id__not_in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"include_by_default","schema":{"type":"boolean"}},{"in":"query","name":"include_by_default__in","schema":{"type":"array","items":{"type":"boolean"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"include_by_default__not_in","schema":{"type":"array","items":{"type":"boolean"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"name","schema":{"type":"string"}},{"in":"query","name":"name__contains","schema":{"type":"string"}},{"in":"query","name":"name__in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"name__isempty","schema":{"type":"boolean"}},{"in":"query","name":"name__not","schema":{"type":"string"}},{"in":"query","name":"name__not_contains","schema":{"type":"string"}},{"in":"query","name":"name__not_in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"name":"order","required":false,"in":"query","description":"Which field to use when ordering the results.","schema":{"type":"string"}},{"in":"query","name":"secure","schema":{"type":"boolean"}},{"in":"query","name":"secure__in","schema":{"type":"array","items":{"type":"boolean"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"secure__not_in","schema":{"type":"array","items":{"type":"boolean"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"type","schema":{"type":"string"}},{"in":"query","name":"type__in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"type__isempty","schema":{"type":"boolean"}},{"in":"query","name":"type__not","schema":{"type":"string"}},{"in":"query","name":"type__not_in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"update_date","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"update_date__gt","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"update_date__gte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"update_date__isempty","schema":{"type":"boolean"}},{"in":"query","name":"update_date__lt","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"update_date__lte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"update_date__not","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"update_date__range","schema":{"type":"string","format":"date-time","nullable":true,"enum":["future","last_14_complete_days","last_14_days","last_24_hours","last_30_complete_days","last_30_days","last_365_complete_days","last_365_days","last_7_complete_days","last_7_days","last_90_complete_days","last_90_days","last_month","last_quarter","last_week","last_year","past","this_month","this_quarter","this_week","this_year","today","until_past_24_hours","yesterday"]},"description":"The date and time the object was last updated\n\n* `today` - From last midnight to next midnight\n* `yesterday` - The last complete calendar day\n* `last_24_hours` - The last 24 hours (as opposed to today, which is from midnight to midnight)\n* `this_week` - From midnight the previous Sunday until midnight the coming Sunday\n* `last_week` - The last complete calendar week\n* `this_year` - From the January 1 to December 31 this year\n* `last_year` - The last complete calendar year\n* `this_month` - From the first day to the last day of the current month\n* `last_month` - The last complete calendar month\n* `this_quarter` - From the first day to the last day of the current quarter\n* `last_quarter` - The last complete calendar quarter\n* `last_7_days` - From midnight 7 days ago to the present\n* `last_7_complete_days` - From midnight 7 days ago to last midnight\n* `last_14_days` - From midnight 14 days ago to the present\n* `last_14_complete_days` - From midnight 14 days ago to last midnight\n* `last_30_days` - From midnight 30 days ago to the present\n* `last_30_complete_days` - From midnight 30 days ago to last midnight\n* `last_90_days` - From midnight 90 days ago to the present\n* `last_90_complete_days` - From midnight 90 days ago to last midnight\n* `last_365_days` - From midnight 365 days ago to the present\n* `last_365_complete_days` - From midnight 365 days ago to last midnight\n* `past` - Any date in the past. Useful for Buzz queries against end_date and similar fields\n* `future` - Any date in the future. Useful for Buzz queries against end_date and similar fields\n* `until_past_24_hours` - From the very first date in the past and up until past 24 hours"},{"in":"query","name":"vendor__buzz_key","schema":{"type":"string"}},{"in":"query","name":"vendor__buzz_key__contains","schema":{"type":"string"}},{"in":"query","name":"vendor__buzz_key__in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"vendor__buzz_key__isempty","schema":{"type":"boolean"}},{"in":"query","name":"vendor__buzz_key__not","schema":{"type":"string"}},{"in":"query","name":"vendor__buzz_key__not_contains","schema":{"type":"string"}},{"in":"query","name":"vendor__buzz_key__not_in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"vendor_id","schema":{"type":"number"}},{"in":"query","name":"vendor_id__gt","schema":{"type":"number"}},{"in":"query","name":"vendor_id__gte","schema":{"type":"number"}},{"in":"query","name":"vendor_id__in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"vendor_id__isempty","schema":{"type":"boolean"}},{"in":"query","name":"vendor_id__lt","schema":{"type":"number"}},{"in":"query","name":"vendor_id__lte","schema":{"type":"number"}},{"in":"query","name":"vendor_id__not","schema":{"type":"number"}},{"in":"query","name":"vendor_id__not_in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"}],"tags":["Creative Add-ons"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedCreativeAddonList"}}},"description":"Creative add-ons list retrieved successfully."},"400":{"description":"Invalid data provided."},"401":{"description":"Authentication credentials were not provided."},"403":{"description":"Permission denied. "},"404":{"description":"Creative add-on not found."},"500":{"description":"Internal Server Error"}}},"post":{"operationId":"creative_addons_create","description":"Create a new creative add-on with the provided details.","summary":"Create a creative add-on","tags":["Creative Add-ons"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeAddon"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/CreativeAddon"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CreativeAddon"}}},"required":true},"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeAddon"}}},"description":"Creative add-on created successfully."},"400":{"description":"Invalid data provided."},"401":{"description":"Authentication credentials were not provided."},"403":{"description":"Permission denied. "},"500":{"description":"Internal Server Error"}}}},"/creative-addons/bulk":{"post":{"operationId":"creative_addons_bulk_create","description":"Create multiple creative add-ons at once. The request body should contain a list of creative add-on objects.","summary":"Bulk create creative add-ons","tags":["Creative Add-ons"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeAddon"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/CreativeAddon"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CreativeAddon"}}},"required":true},"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedCreativeAddonList"}}},"description":"Creative add-ons created successfully."},"400":{"description":"Invalid data provided."},"401":{"description":"Authentication credentials were not provided."},"403":{"description":"Permission denied. "},"500":{"description":"Internal Server Error"}}},"patch":{"operationId":"creative_addons_bulk_partial_update","description":"Update multiple creative add-ons at once. The request body should contain a list of creative add-on objects with the fields to be updated.","summary":"Bulk update creative add-ons","tags":["Creative Add-ons"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedCreativeAddon"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedCreativeAddon"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedCreativeAddon"}}}},"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedCreativeAddonList"}}},"description":"Creative add-ons updated successfully."},"400":{"description":"Invalid data provided."},"401":{"description":"Authentication credentials were not provided."},"403":{"description":"Permission denied. "},"500":{"description":"Internal Server Error"}}},"delete":{"operationId":"creative_addons_bulk_destroy","description":"Soft delete multiple creative add-ons at once. Pass the IDs in the ids query parameter.","summary":"Bulk delete creative add-ons","tags":["Creative Add-ons"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"204":{"description":"Creative add-ons deleted successfully."},"400":{"description":"Invalid data provided."},"401":{"description":"Authentication credentials were not provided."},"403":{"description":"Permission denied. "},"404":{"description":"Creative add-on not found."},"500":{"description":"Internal Server Error"}}}},"/creative-addons/global":{"get":{"operationId":"creative_addons_global_list","description":"Retrieve a read-only list of creative add-ons visible to the account, including platform-wide global add-ons.","summary":"List global creative add-ons","parameters":[{"in":"query","name":"active","schema":{"type":"boolean"}},{"in":"query","name":"active__in","schema":{"type":"array","items":{"type":"boolean"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"active__not_in","schema":{"type":"array","items":{"type":"boolean"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"advertiser_id","schema":{"type":"number"}},{"in":"query","name":"advertiser_id__equals_or_null","schema":{"type":"number"}},{"in":"query","name":"advertiser_id__gt","schema":{"type":"number"}},{"in":"query","name":"advertiser_id__gte","schema":{"type":"number"}},{"in":"query","name":"advertiser_id__in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"advertiser_id__isempty","schema":{"type":"boolean"}},{"in":"query","name":"advertiser_id__lt","schema":{"type":"number"}},{"in":"query","name":"advertiser_id__lte","schema":{"type":"number"}},{"in":"query","name":"advertiser_id__not","schema":{"type":"number"}},{"in":"query","name":"advertiser_id__not_in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"alternative_id","schema":{"type":"string"}},{"in":"query","name":"alternative_id__contains","schema":{"type":"string"}},{"in":"query","name":"alternative_id__in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"alternative_id__isempty","schema":{"type":"boolean"}},{"in":"query","name":"alternative_id__not","schema":{"type":"string"}},{"in":"query","name":"alternative_id__not_contains","schema":{"type":"string"}},{"in":"query","name":"alternative_id__not_in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"alternative_id__not_startswith","schema":{"type":"string"}},{"in":"query","name":"alternative_id__startswith","schema":{"type":"string"}},{"in":"query","name":"content","schema":{"type":"string"}},{"in":"query","name":"content__contains","schema":{"type":"string"}},{"in":"query","name":"content__in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"content__isempty","schema":{"type":"boolean"}},{"in":"query","name":"content__not","schema":{"type":"string"}},{"in":"query","name":"content__not_contains","schema":{"type":"string"}},{"in":"query","name":"content__not_in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"cpm_cost","schema":{"type":"number"}},{"in":"query","name":"cpm_cost__gt","schema":{"type":"number"}},{"in":"query","name":"cpm_cost__gte","schema":{"type":"number"}},{"in":"query","name":"cpm_cost__in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"cpm_cost__isempty","schema":{"type":"boolean"}},{"in":"query","name":"cpm_cost__lt","schema":{"type":"number"}},{"in":"query","name":"cpm_cost__lte","schema":{"type":"number"}},{"in":"query","name":"cpm_cost__not","schema":{"type":"number"}},{"in":"query","name":"cpm_cost__not_in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"create_date","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"create_date__gt","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"create_date__gte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"create_date__isempty","schema":{"type":"boolean"}},{"in":"query","name":"create_date__lt","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"create_date__lte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"create_date__not","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"create_date__range","schema":{"type":"string","format":"date-time","nullable":true,"enum":["future","last_14_complete_days","last_14_days","last_24_hours","last_30_complete_days","last_30_days","last_365_complete_days","last_365_days","last_7_complete_days","last_7_days","last_90_complete_days","last_90_days","last_month","last_quarter","last_week","last_year","past","this_month","this_quarter","this_week","this_year","today","until_past_24_hours","yesterday"]},"description":"The date and time the object was first created\n\n* `today` - From last midnight to next midnight\n* `yesterday` - The last complete calendar day\n* `last_24_hours` - The last 24 hours (as opposed to today, which is from midnight to midnight)\n* `this_week` - From midnight the previous Sunday until midnight the coming Sunday\n* `last_week` - The last complete calendar week\n* `this_year` - From the January 1 to December 31 this year\n* `last_year` - The last complete calendar year\n* `this_month` - From the first day to the last day of the current month\n* `last_month` - The last complete calendar month\n* `this_quarter` - From the first day to the last day of the current quarter\n* `last_quarter` - The last complete calendar quarter\n* `last_7_days` - From midnight 7 days ago to the present\n* `last_7_complete_days` - From midnight 7 days ago to last midnight\n* `last_14_days` - From midnight 14 days ago to the present\n* `last_14_complete_days` - From midnight 14 days ago to last midnight\n* `last_30_days` - From midnight 30 days ago to the present\n* `last_30_complete_days` - From midnight 30 days ago to last midnight\n* `last_90_days` - From midnight 90 days ago to the present\n* `last_90_complete_days` - From midnight 90 days ago to last midnight\n* `last_365_days` - From midnight 365 days ago to the present\n* `last_365_complete_days` - From midnight 365 days ago to last midnight\n* `past` - Any date in the past. Useful for Buzz queries against end_date and similar fields\n* `future` - Any date in the future. Useful for Buzz queries against end_date and similar fields\n* `until_past_24_hours` - From the very first date in the past and up until past 24 hours"},{"in":"query","name":"creative_type","schema":{"type":"array","items":{"type":"string","nullable":true}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"creative_type__in","schema":{"type":"array","items":{"type":"string","nullable":true}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"creative_type__isempty","schema":{"type":"boolean"}},{"in":"query","name":"creative_type__not","schema":{"type":"array","items":{"type":"string","nullable":true}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"creative_type__not_in","schema":{"type":"array","items":{"type":"string","nullable":true}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"currency","schema":{"type":"string"}},{"in":"query","name":"currency__contains","schema":{"type":"string"}},{"in":"query","name":"currency__in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"currency__isempty","schema":{"type":"boolean"}},{"in":"query","name":"currency__not","schema":{"type":"string"}},{"in":"query","name":"currency__not_contains","schema":{"type":"string"}},{"in":"query","name":"currency__not_in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"global","schema":{"type":"boolean"},"description":"Filter creative add-ons by global status."},{"in":"query","name":"global__in","schema":{"type":"array","items":{"type":"boolean"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"global__not_in","schema":{"type":"array","items":{"type":"boolean"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"global_account_id","schema":{"type":"number"}},{"in":"query","name":"global_account_id__gt","schema":{"type":"number"}},{"in":"query","name":"global_account_id__gte","schema":{"type":"number"}},{"in":"query","name":"global_account_id__in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"global_account_id__isempty","schema":{"type":"boolean"}},{"in":"query","name":"global_account_id__lt","schema":{"type":"number"}},{"in":"query","name":"global_account_id__lte","schema":{"type":"number"}},{"in":"query","name":"global_account_id__not","schema":{"type":"number"}},{"in":"query","name":"global_account_id__not_in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"id","schema":{"type":"number"}},{"in":"query","name":"id__gt","schema":{"type":"number"}},{"in":"query","name":"id__gte","schema":{"type":"number"}},{"in":"query","name":"id__in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"id__lt","schema":{"type":"number"}},{"in":"query","name":"id__lte","schema":{"type":"number"}},{"in":"query","name":"id__not","schema":{"type":"number"}},{"in":"query","name":"id__not_in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"include_by_default","schema":{"type":"boolean"}},{"in":"query","name":"include_by_default__in","schema":{"type":"array","items":{"type":"boolean"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"include_by_default__not_in","schema":{"type":"array","items":{"type":"boolean"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"name","schema":{"type":"string"}},{"in":"query","name":"name__contains","schema":{"type":"string"}},{"in":"query","name":"name__in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"name__isempty","schema":{"type":"boolean"}},{"in":"query","name":"name__not","schema":{"type":"string"}},{"in":"query","name":"name__not_contains","schema":{"type":"string"}},{"in":"query","name":"name__not_in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"name":"order","required":false,"in":"query","description":"Which field to use when ordering the results.","schema":{"type":"string"}},{"in":"query","name":"secure","schema":{"type":"boolean"}},{"in":"query","name":"secure__in","schema":{"type":"array","items":{"type":"boolean"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"secure__not_in","schema":{"type":"array","items":{"type":"boolean"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"type","schema":{"type":"string"}},{"in":"query","name":"type__in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"type__isempty","schema":{"type":"boolean"}},{"in":"query","name":"type__not","schema":{"type":"string"}},{"in":"query","name":"type__not_in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"update_date","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"update_date__gt","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"update_date__gte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"update_date__isempty","schema":{"type":"boolean"}},{"in":"query","name":"update_date__lt","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"update_date__lte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"update_date__not","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"update_date__range","schema":{"type":"string","format":"date-time","nullable":true,"enum":["future","last_14_complete_days","last_14_days","last_24_hours","last_30_complete_days","last_30_days","last_365_complete_days","last_365_days","last_7_complete_days","last_7_days","last_90_complete_days","last_90_days","last_month","last_quarter","last_week","last_year","past","this_month","this_quarter","this_week","this_year","today","until_past_24_hours","yesterday"]},"description":"The date and time the object was last updated\n\n* `today` - From last midnight to next midnight\n* `yesterday` - The last complete calendar day\n* `last_24_hours` - The last 24 hours (as opposed to today, which is from midnight to midnight)\n* `this_week` - From midnight the previous Sunday until midnight the coming Sunday\n* `last_week` - The last complete calendar week\n* `this_year` - From the January 1 to December 31 this year\n* `last_year` - The last complete calendar year\n* `this_month` - From the first day to the last day of the current month\n* `last_month` - The last complete calendar month\n* `this_quarter` - From the first day to the last day of the current quarter\n* `last_quarter` - The last complete calendar quarter\n* `last_7_days` - From midnight 7 days ago to the present\n* `last_7_complete_days` - From midnight 7 days ago to last midnight\n* `last_14_days` - From midnight 14 days ago to the present\n* `last_14_complete_days` - From midnight 14 days ago to last midnight\n* `last_30_days` - From midnight 30 days ago to the present\n* `last_30_complete_days` - From midnight 30 days ago to last midnight\n* `last_90_days` - From midnight 90 days ago to the present\n* `last_90_complete_days` - From midnight 90 days ago to last midnight\n* `last_365_days` - From midnight 365 days ago to the present\n* `last_365_complete_days` - From midnight 365 days ago to last midnight\n* `past` - Any date in the past. Useful for Buzz queries against end_date and similar fields\n* `future` - Any date in the future. Useful for Buzz queries against end_date and similar fields\n* `until_past_24_hours` - From the very first date in the past and up until past 24 hours"},{"in":"query","name":"vendor__buzz_key","schema":{"type":"string"}},{"in":"query","name":"vendor__buzz_key__contains","schema":{"type":"string"}},{"in":"query","name":"vendor__buzz_key__in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"vendor__buzz_key__isempty","schema":{"type":"boolean"}},{"in":"query","name":"vendor__buzz_key__not","schema":{"type":"string"}},{"in":"query","name":"vendor__buzz_key__not_contains","schema":{"type":"string"}},{"in":"query","name":"vendor__buzz_key__not_in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"vendor_id","schema":{"type":"number"}},{"in":"query","name":"vendor_id__gt","schema":{"type":"number"}},{"in":"query","name":"vendor_id__gte","schema":{"type":"number"}},{"in":"query","name":"vendor_id__in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"vendor_id__isempty","schema":{"type":"boolean"}},{"in":"query","name":"vendor_id__lt","schema":{"type":"number"}},{"in":"query","name":"vendor_id__lte","schema":{"type":"number"}},{"in":"query","name":"vendor_id__not","schema":{"type":"number"}},{"in":"query","name":"vendor_id__not_in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"}],"tags":["Creative Add-ons"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedCreativeAddonGlobalList"}}},"description":"Global creative add-ons list retrieved successfully."},"401":{"description":"Authentication credentials were not provided."},"403":{"description":"Permission denied. "},"500":{"description":"Internal Server Error"}}}},"/creative-addons/global/{creative_addon_id}":{"get":{"operationId":"creative_addons_global_retrieve","description":"Retrieve the read-only details of a global creative add-on using its ID.","summary":"Get a global creative add-on by ID","parameters":[{"in":"path","name":"creative_addon_id","schema":{"type":"integer"},"description":"A unique integer value identifying this creative addon.","required":true}],"tags":["Creative Add-ons"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeAddonGlobal"}}},"description":"Global creative add-on details retrieved successfully."},"401":{"description":"Authentication credentials were not provided."},"403":{"description":"Permission denied. "},"404":{"description":"Creative add-on not found."},"500":{"description":"Internal Server Error"}}}},"/creative-addons/{creative_addon_id}":{"get":{"operationId":"creative_addons_retrieve","description":"Retrieve the details of a specific creative add-on using its ID.","summary":"Get a creative add-on by ID","parameters":[{"in":"path","name":"creative_addon_id","schema":{"type":"integer"},"description":"A unique integer value identifying this creative addon.","required":true}],"tags":["Creative Add-ons"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeAddon"}}},"description":"Creative add-on details retrieved successfully."},"401":{"description":"Authentication credentials were not provided."},"403":{"description":"Permission denied. "},"404":{"description":"Creative add-on not found."},"500":{"description":"Internal Server Error"}}},"put":{"operationId":"creative_addons_update","description":"Update the details of a specific creative add-on using its ID.","summary":"Update a creative add-on by ID","parameters":[{"in":"path","name":"creative_addon_id","schema":{"type":"integer"},"description":"A unique integer value identifying this creative addon.","required":true}],"tags":["Creative Add-ons"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeAddon"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/CreativeAddon"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CreativeAddon"}}},"required":true},"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeAddon"}}},"description":"Creative add-on updated successfully."},"401":{"description":"Authentication credentials were not provided."},"403":{"description":"Permission denied. "},"404":{"description":"Creative add-on not found."},"500":{"description":"Internal Server Error"}}},"patch":{"operationId":"creative_addons_partial_update","description":"Update one or more fields of a specific creative add-on using its ID.","summary":"Partially update a creative add-on by ID","parameters":[{"in":"path","name":"creative_addon_id","schema":{"type":"integer"},"description":"A unique integer value identifying this creative addon.","required":true}],"tags":["Creative Add-ons"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedCreativeAddon"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedCreativeAddon"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedCreativeAddon"}}}},"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeAddon"}}},"description":"Creative add-on updated successfully."},"400":{"description":"Invalid data provided."},"401":{"description":"Authentication credentials were not provided."},"403":{"description":"Permission denied. "},"404":{"description":"Creative add-on not found."},"500":{"description":"Internal Server Error"}}},"delete":{"operationId":"creative_addons_destroy","description":"Soft delete a specific creative add-on using its ID. The record is retained and its active state is set to deleted.","summary":"Delete a creative add-on by ID","parameters":[{"in":"path","name":"creative_addon_id","schema":{"type":"integer"},"description":"A unique integer value identifying this creative addon.","required":true}],"tags":["Creative Add-ons"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"204":{"description":"Creative add-on deleted successfully."},"401":{"description":"Authentication credentials were not provided."},"403":{"description":"Permission denied. "},"404":{"description":"Creative add-on not found."},"500":{"description":"Internal Server Error"}}}},"/creative-addons/{creative_addon_id}/duplicate":{"get":{"operationId":"creative_addons_duplicate_retrieve","description":"Return a pre-filled duplication template for a creative add-on. Nothing is created by this call.","summary":"Preview creative add-on duplication","parameters":[{"in":"path","name":"creative_addon_id","schema":{"type":"integer"},"description":"A unique integer value identifying this creative addon.","required":true}],"tags":["Creative Add-ons"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeAddonDuplicate"}}},"description":"Duplication template retrieved successfully."},"401":{"description":"Authentication credentials were not provided."},"403":{"description":"Permission denied. "},"404":{"description":"Creative add-on not found."},"500":{"description":"Internal Server Error"}}},"post":{"operationId":"creative_addons_duplicate_create","description":"Create a copy of a creative add-on in the target account. The duplicate list must include resource.","summary":"Duplicate a creative add-on","parameters":[{"in":"path","name":"creative_addon_id","schema":{"type":"integer"},"description":"A unique integer value identifying this creative addon.","required":true}],"tags":["Creative Add-ons"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeAddonDuplicate"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/CreativeAddonDuplicate"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CreativeAddonDuplicate"}}},"required":true},"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeAddonDuplicate"}}},"description":"Creative add-on duplicated successfully."},"400":{"description":"Invalid data provided."},"401":{"description":"Authentication credentials were not provided."},"403":{"description":"Permission denied. "},"404":{"description":"Creative add-on not found."},"500":{"description":"Internal Server Error"}}}},"/creative-addons/{creative_addon_id}/versions":{"get":{"operationId":"creative_addons_versions_list","description":"Retrieve the change history for a creative add-on.","summary":"List versions of a creative add-on","parameters":[{"in":"path","name":"creative_addon_id","schema":{"type":"integer"},"description":"A unique integer value identifying this creative addon.","required":true}],"tags":["Creative Add-ons"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedCreativeAddonList"}}},"description":"Creative add-on versions retrieved successfully."},"401":{"description":"Authentication credentials were not provided."},"403":{"description":"Permission denied. "},"404":{"description":"Creative add-on not found."},"500":{"description":"Internal Server Error"}}}},"/creative-approval":{"get":{"operationId":"creative_approval_list","description":"Retrieves all creative approval requests with optional filtering. Read-only viewset, supports filtering by multiple attributes.","summary":"List creative approval requests (read-only)","parameters":[{"in":"query","name":"account_id","schema":{"type":"number"}},{"in":"query","name":"account_id__in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"account_id__not","schema":{"type":"number"}},{"in":"query","name":"account_id__not_in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"creative_id","schema":{"type":"number"}},{"name":"order","required":false,"in":"query","description":"Which field to use when ordering the results.","schema":{"type":"string"}},{"in":"query","name":"request_status","schema":{"type":"integer"},"description":"Filter by request status ID"},{"in":"query","name":"request_status__in","schema":{"type":"array","items":{"type":"integer"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"vendor","schema":{"type":"integer"},"description":"Filter by vendor ID"},{"in":"query","name":"vendor_id__in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"}],"tags":["Creative Approval"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedCreativeApprovalQueueList"}}},"description":"Creative approval requests retrieved successfully."},"401":{"description":"Authentication credentials were not provided."},"500":{"description":"Internal server error."}}}},"/creative-approval-queue":{"get":{"operationId":"creative_approval_queue_list","description":"Retrieves all creative approval requests with optional filtering. Supports filtering by multiple attributes when available.","summary":"List creative approval requests","parameters":[{"in":"query","name":"account_id","schema":{"type":"number"}},{"in":"query","name":"account_id__in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"account_id__not","schema":{"type":"number"}},{"in":"query","name":"account_id__not_in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"creative_id","schema":{"type":"number"}},{"in":"query","name":"end_date","schema":{"type":"string"},"description":"Filter requests created before this date"},{"name":"order","required":false,"in":"query","description":"Which field to use when ordering the results.","schema":{"type":"string"}},{"in":"query","name":"request_status","schema":{"type":"integer"},"description":"Filter by request status ID"},{"in":"query","name":"request_status__in","schema":{"type":"array","items":{"type":"integer"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"start_date","schema":{"type":"string"},"description":"Filter requests created after this date"},{"in":"query","name":"vendor","schema":{"type":"integer"},"description":"Filter by vendor ID"},{"in":"query","name":"vendor_id__in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"}],"tags":["Creative Approval"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedCreativeApprovalQueueList"}}},"description":"Creative approval requests retrieved successfully."},"401":{"description":"Authentication credentials were not provided."},"500":{"description":"Internal server error."}}},"post":{"operationId":"creative_approval_queue_create","description":"Creates a new creative approval request based on the provided data.","summary":"Create a creative approval request","tags":["Creative Approval"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeApprovalQueue"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/CreativeApprovalQueue"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CreativeApprovalQueue"}}},"required":true},"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeApprovalQueue"}}},"description":"Creative approval request created successfully."},"400":{"description":"Invalid data provided."},"401":{"description":"Authentication credentials were not provided."},"500":{"description":"Internal server error."}}}},"/creative-approval-queue-history":{"get":{"operationId":"creative_approval_queue_history_list","description":"Retrieve a list of all creative approval queue history records with optional filtering. Supports filtering by vendor, request status, dates, and other available fields.","summary":"Get a list of creative approval queue history records","parameters":[{"in":"query","name":"account_id","schema":{"type":"number"}},{"in":"query","name":"account_id__in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"account_id__not","schema":{"type":"number"}},{"in":"query","name":"account_id__not_in","schema":{"type":"array","items":{"type":"number"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"creative_approval","schema":{"type":"integer"}},{"in":"query","name":"end_date","schema":{"type":"string"},"description":"Filter records created before this date"},{"name":"order","required":false,"in":"query","description":"Which field to use when ordering the results.","schema":{"type":"string"}},{"in":"query","name":"request_status","schema":{"type":"integer"},"description":"Filter by request status ID"},{"in":"query","name":"start_date","schema":{"type":"string"},"description":"Filter records created after this date"},{"in":"query","name":"vendor","schema":{"type":"integer"},"description":"Filter by vendor ID"}],"tags":["Creative Approval"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedCreativeApprovalQueueHistoryList"}}},"description":"Creative approval queue history retrieved successfully."},"401":{"description":"Authentication credentials were not provided."},"500":{"description":"Internal server error."}}}},"/creative-approval-queue/{creative_approval_id}":{"get":{"operationId":"creative_approval_queue_retrieve","description":"Retrieves detailed information about a specific creative approval request.","summary":"Retrieve a creative approval request","parameters":[{"in":"path","name":"creative_approval_id","schema":{"type":"integer"},"description":"A unique integer value identifying this creative approval queue.","required":true}],"tags":["Creative Approval"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeApprovalQueue"}}},"description":"Creative approval request retrieved successfully."},"401":{"description":"Authentication credentials were not provided."},"404":{"description":"Creative approval request not found."},"500":{"description":"Internal server error."}}},"patch":{"operationId":"creative_approval_queue_partial_update","description":"Updates fields of an existing creative approval request.","summary":"Update a creative approval request","parameters":[{"in":"path","name":"creative_approval_id","schema":{"type":"integer"},"description":"A unique integer value identifying this creative approval queue.","required":true}],"tags":["Creative Approval"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedCreativeApprovalQueue"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedCreativeApprovalQueue"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedCreativeApprovalQueue"}}}},"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeApprovalQueue"}}},"description":"Creative approval request updated successfully."},"400":{"description":"Invalid data provided."},"401":{"description":"Authentication credentials were not provided."},"404":{"description":"Creative approval request not found."},"500":{"description":"Internal server error."}}}},"/creative-approval/{creative_approval_id}":{"get":{"operationId":"creative_approval_retrieve","description":"Retrieves detailed information about a specific creative approval request.","summary":"Retrieve a creative approval request (read-only)","parameters":[{"in":"path","name":"creative_approval_id","schema":{"type":"integer"},"description":"A unique integer value identifying this creative approval queue.","required":true}],"tags":["Creative Approval"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeApprovalQueue"}}},"description":"Creative approval request retrieved successfully."},"401":{"description":"Authentication credentials were not provided."},"404":{"description":"Creative approval request not found."},"500":{"description":"Internal server error."}}}},"/creative_assets":{"get":{"operationId":"creative_assets_list","description":"Retrieve a list of creative assets with optional filtering.","summary":"Get a list of creative assets","parameters":[{"in":"query","name":"advertiser_id","schema":{"type":"integer"},"description":"Filter by advertiser ID"},{"in":"query","name":"advertiser_id__in","schema":{"type":"array","items":{"type":"integer"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"asset_type","schema":{"type":"string"},"description":"* `IMAGE` - Image\n* `SOURCE_VIDEO` - Source Video\n* `ENCODED_VIDEO` - Encoded Video\n* `HTML` - Html\n* `AUDIO` - Audio"},{"in":"query","name":"asset_type__in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"creative_asset_id","schema":{"type":"integer"}},{"in":"query","name":"creative_asset_id__in","schema":{"type":"array","items":{"type":"integer"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"creative_asset_name__contains","schema":{"type":"string"}},{"in":"query","name":"mime_type","schema":{"type":"string"},"description":"Filter by MIME type"},{"in":"query","name":"mime_type__in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"update_date__gte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"update_date__lte","schema":{"type":"string","format":"date-time"}}],"tags":["Creative Assets"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedCreativeAssetList"}}},"description":""}}},"post":{"operationId":"creative_assets_create","description":"Upload a new creative asset.","summary":"Insert a new asset","parameters":[{"in":"query","name":"id","schema":{"type":"integer"},"description":"ID of the asset to upload"}],"tags":["Creative Assets"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeAsset"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/CreativeAsset"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CreativeAsset"}}},"required":true},"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeAsset"}}},"description":""}}}},"/creative_assets/{creative_asset_id}":{"get":{"operationId":"creative_assets_retrieve","description":"Retrieve a specific creative asset by its ID.","summary":"Get an asset by ID","parameters":[{"in":"query","name":"advertiser_id","schema":{"type":"integer"},"description":"Filter by advertiser ID"},{"in":"query","name":"asset_type","schema":{"type":"string"},"description":"* `IMAGE` - Image\n* `SOURCE_VIDEO` - Source Video\n* `ENCODED_VIDEO` - Encoded Video\n* `HTML` - Html\n* `AUDIO` - Audio"},{"in":"path","name":"creative_asset_id","schema":{"type":"integer"},"description":"A unique integer value identifying this creative asset.","required":true},{"in":"query","name":"mime_type","schema":{"type":"string"},"description":"Filter by MIME type"}],"tags":["Creative Assets"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeAsset"}}},"description":""}}}},"/creatives":{"get":{"operationId":"creatives_list","description":"Retrieve a list of creatives with optional filters.","summary":"List creatives","parameters":[{"in":"query","name":"active","schema":{"type":"integer","enum":[-1,0,1]},"description":"Whether the object is active\n\n* `1` - Active\n* `0` - Inactive\n* `-1` - Deleted"},{"in":"query","name":"active__in","schema":{"type":"array","items":{"type":"integer"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"advertiser_id","schema":{"type":"integer"},"description":"Advertiser ID"},{"in":"query","name":"advertiser_id__in","schema":{"type":"array","items":{"type":"integer"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"alternative_id","schema":{"type":"string"},"description":"Alternative creative ID"},{"in":"query","name":"alternative_id__in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"asset_type","schema":{"type":"string","enum":["AUDIO","ENCODED_VIDEO","HTML","IMAGE","SOURCE_VIDEO"]},"description":"* `IMAGE` - Image\n* `SOURCE_VIDEO` - Source Video\n* `ENCODED_VIDEO` - Encoded Video\n* `HTML` - Html\n* `AUDIO` - Audio"},{"in":"query","name":"create_date","schema":{"type":"string"},"description":"Date when creative was created"},{"in":"query","name":"create_date__gte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"create_date__lte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"end_date","schema":{"type":"string"},"description":"End date for the creative"},{"in":"query","name":"end_date__gte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"end_date__lte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"id","schema":{"type":"integer"}},{"in":"query","name":"id__in","schema":{"type":"array","items":{"type":"integer"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"name","schema":{"type":"string"},"description":"Name of the creative"},{"in":"query","name":"name__contains","schema":{"type":"string"}},{"in":"query","name":"template_id","schema":{"type":"integer"},"description":"Template ID"},{"in":"query","name":"template_id__in","schema":{"type":"array","items":{"type":"integer"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"type","schema":{"type":"integer"},"description":"Unique ID of the line item type"},{"in":"query","name":"type__in","schema":{"type":"array","items":{"type":"integer","maximum":127,"minimum":-128}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"update_date__gte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"update_date__lte","schema":{"type":"string","format":"date-time"}}],"tags":["Creatives"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedCreativeList"}}},"description":"List of creatives retrieved successfully."},"401":{"description":"Unauthorized."},"403":{"description":"Permission denied."},"500":{"description":"Internal server error."}}},"post":{"operationId":"creatives_create","description":"Create a new creative using the provided payload.","summary":"Create a creative","tags":["Creatives"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Creative"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Creative"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Creative"}}},"required":true},"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Creative"}}},"description":"Creative created successfully."},"400":{"description":"Invalid or incomplete data."},"401":{"description":"Unauthorized."},"403":{"description":"Permission denied."},"500":{"description":"Unexpected error occurred during creation."}}}},"/creatives/tag-preview":{"post":{"operationId":"creatives_tag_preview_create","description":"Generate a preview of a creative tag using the provided `content_tag`, `rule_key`, and optional `template_id`. The response contains the rendered tag preview along with any validation errors or warnings.","summary":"Render creative tag preview","tags":["Creatives"],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"content_tag":{"type":"string","example":"<div>{{creative}}</div>"},"rule_key":{"type":"string","example":"RULE_123"},"template_id":{"type":"integer","example":42}},"required":["content_tag"]}}}},"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object","properties":{"content_tag_preview":{"type":"string","example":"<div>Rendered output</div>"},"errors":{"type":"array","items":{"type":"string"},"example":["Invalid tag format"]},"warnings":{"type":"array","items":{"type":"string"},"example":["Deprecated variable used"]}}}}},"description":"Preview rendered successfully."},"400":{"description":"Invalid request data or template ID not found."},"401":{"description":"Authentication credentials were not provided."},"500":{"description":"Unexpected internal server error."}}}},"/creatives/{id}":{"get":{"operationId":"creatives_retrieve","description":"Retrieve a creative using its unique ID.","summary":"Retrieve a creative","parameters":[{"in":"query","name":"active","schema":{"type":"integer","enum":[-1,0,1]},"description":"Whether the object is active\n\n* `1` - Active\n* `0` - Inactive\n* `-1` - Deleted"},{"in":"query","name":"advertiser_id","schema":{"type":"integer"},"description":"Advertiser ID"},{"in":"query","name":"alternative_id","schema":{"type":"string"},"description":"Alternative creative ID"},{"in":"query","name":"asset_type","schema":{"type":"string","enum":["AUDIO","ENCODED_VIDEO","HTML","IMAGE","SOURCE_VIDEO"]},"description":"* `IMAGE` - Image\n* `SOURCE_VIDEO` - Source Video\n* `ENCODED_VIDEO` - Encoded Video\n* `HTML` - Html\n* `AUDIO` - Audio"},{"in":"query","name":"create_date","schema":{"type":"string"},"description":"Date when creative was created"},{"in":"query","name":"end_date","schema":{"type":"string"},"description":"End date for the creative"},{"in":"path","name":"id","schema":{"type":"integer"},"description":"A unique integer value identifying this creative.","required":true},{"in":"query","name":"name","schema":{"type":"string"},"description":"Name of the creative"},{"in":"query","name":"template_id","schema":{"type":"integer"},"description":"Template ID"},{"in":"query","name":"type","schema":{"type":"integer"},"description":"Unique ID of the line item type"}],"tags":["Creatives"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Creative"}}},"description":""}}},"put":{"operationId":"creatives_update","description":"Update a creative by ID.","summary":"Update a creative","parameters":[{"in":"path","name":"id","schema":{"type":"integer"},"description":"A unique integer value identifying this creative.","required":true}],"tags":["Creatives"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Creative"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Creative"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Creative"}}},"required":true},"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Creative"}}},"description":"Creative updated successfully."},"400":{"description":"Validation errors."},"404":{"description":"Creative not found."},"500":{"description":"Internal server error."}}},"patch":{"operationId":"creatives_partial_update","description":"Update one or more fields of a creative.","summary":"Partially update a creative","parameters":[{"in":"path","name":"id","schema":{"type":"integer"},"description":"A unique integer value identifying this creative.","required":true}],"tags":["Creatives"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchedCreative"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/PatchedCreative"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/PatchedCreative"}}}},"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Creative"}}},"description":"Creative partially updated successfully."},"400":{"description":"Validation errors."},"404":{"description":"Creative not found."}}},"delete":{"operationId":"creatives_destroy","description":"Delete a creative by its ID. This also removes it from the approval queue.","summary":"Delete a creative","parameters":[{"in":"path","name":"id","schema":{"type":"integer"},"description":"A unique integer value identifying this creative.","required":true}],"tags":["Creatives"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"204":{"description":"Creative deleted successfully."},"400":{"description":"Validation errors or delete blocked."},"404":{"description":"Creative not found."},"500":{"description":"Internal server error."}}}},"/creatives/{id}/duplicate":{"get":{"operationId":"creatives_duplicate_retrieve","description":"Retrieve a preview of the duplicate creative with the provided parameters.","summary":"Preview creative duplication","parameters":[{"in":"path","name":"id","schema":{"type":"integer"},"description":"A unique integer value identifying this creative.","required":true}],"tags":["Creatives"],"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeDuplicate"}}},"description":""}}},"post":{"operationId":"creatives_duplicate_create","description":"Create duplicated creatives based on parameters supplied in the request body.","summary":"Duplicate creative","parameters":[{"in":"query","name":"active","schema":{"type":"integer","enum":[-1,0,1]},"description":"Whether the object is active\n\n* `1` - Active\n* `0` - Inactive\n* `-1` - Deleted"},{"in":"query","name":"active__in","schema":{"type":"array","items":{"type":"integer"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"advertiser_id","schema":{"type":"integer"}},{"in":"query","name":"advertiser_id__in","schema":{"type":"array","items":{"type":"integer"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"alternative_id","schema":{"type":"string"}},{"in":"query","name":"alternative_id__in","schema":{"type":"array","items":{"type":"string"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"create_date","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"create_date__gte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"create_date__lte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"end_date","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"end_date__gte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"end_date__lte","schema":{"type":"string","format":"date-time"}},{"in":"path","name":"id","schema":{"type":"integer"},"description":"A unique integer value identifying this creative.","required":true},{"in":"query","name":"id","schema":{"type":"integer"}},{"in":"query","name":"id__in","schema":{"type":"array","items":{"type":"integer"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"name","schema":{"type":"string"}},{"in":"query","name":"name__contains","schema":{"type":"string"}},{"in":"query","name":"template_id","schema":{"type":"integer"}},{"in":"query","name":"template_id__in","schema":{"type":"array","items":{"type":"integer"}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"type","schema":{"type":"integer","maximum":127,"minimum":-128},"description":"Unique ID of the line item type"},{"in":"query","name":"type__in","schema":{"type":"array","items":{"type":"integer","maximum":127,"minimum":-128}},"description":"Multiple values may be separated by commas.","explode":false,"style":"form"},{"in":"query","name":"update_date__gte","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"update_date__lte","schema":{"type":"string","format":"date-time"}}],"tags":["Creatives"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreativeDuplicate"}},"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/CreativeDuplicate"}},"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CreativeDuplicate"}}}},"security":[{"nestSessionAuth":[]},{"nestBasicAuth":[]}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedCreativeList"}}},"description":""}}}}},"components":{"schemas":{"ActionEnum":{"enum":["CREATE","UPDATE","DELETE","PAUSE","RESUME"],"type":"string","description":"* `CREATE` - Create\n* `UPDATE` - Update\n* `DELETE` - Delete\n* `PAUSE` - Pause\n* `RESUME` - Resume"},"AssetTypeEnum":{"enum":["IMAGE","SOURCE_VIDEO","ENCODED_VIDEO","HTML","AUDIO"],"type":"string","description":"* `IMAGE` - Image\n* `SOURCE_VIDEO` - Source Video\n* `ENCODED_VIDEO` - Encoded Video\n* `HTML` - Html\n* `AUDIO` - Audio"},"Creative":{"type":"object","description":"A mixin that should be inherited by a custom serializer to include the logic for validating warnings.\n\nThis mixin works by recursively descending into nested levels of the root serializer,\ncollecting warnings in a dictionary structure, and raising them at a higher level.\n\nTo implement warnings in a custom serializer, two types of methods must be used.\nThe first type is used to handle field errors: `warn_<field name>()`.\nThe second type is used for non-field warnings: `warn()`.\n\nUsage:\n    class NestedSerializer(WarningsSerializerMixin, serializers.Serializer):\n        baz = serializers.IntegerField()\n\n        def warn_baz(self, value):\n            ...\n\n        def warn(self, attrs):\n            ....\n\n    class RootSerializer(WarningsSerializerMixin, serializers.Serializer):\n        foo = NestedSerializer()\n        bar = serializers.CharField()\n\n        def warn_bar(self, value):\n            ...\n\n        def warn(self, attrs):\n            ...","properties":{"strict_validation":{"type":"boolean","writeOnly":true,"default":true},"id":{"type":"integer","readOnly":true},"create_date":{"type":"string","format":"date-time","readOnly":true,"nullable":true,"description":"The date and time the object was first created"},"update_date":{"type":"string","format":"date-time","readOnly":true,"nullable":true,"description":"The date and time the object was last updated"},"account_id":{"type":"integer","description":"Defaults to the account in the active session"},"active":{"type":"boolean","default":true},"name":{"type":"string","maxLength":280},"template_id":{"type":"integer"},"advertiser_id":{"type":"integer","nullable":true},"alternative_id":{"type":"string","nullable":true,"description":"An ID that may be used for any reporting or administrative purpose. Limited to 191 characters.","maxLength":200},"type":{"type":"integer","maximum":127,"minimum":-128,"description":"Unique ID of the line item type"},"status_id":{"type":"integer","maximum":127,"minimum":-128},"width":{"type":"integer","maximum":2147483647,"minimum":-2147483648,"nullable":true},"height":{"type":"integer","maximum":2147483647,"minimum":-2147483648,"nullable":true},"sizeless":{"type":"integer","maximum":127,"minimum":-128},"click_url":{"type":"string","nullable":true,"description":"Target URL when a user clicks on the ad","format":"uri"},"content_tag":{"type":"string","nullable":true},"attributes":{"$ref":"#/components/schemas/CreativeAttributes"},"approvals":{"default":[]},"assets":{"nullable":true,"default":[]},"addons":{"nullable":true,"default":[]},"content":{"default":{},"description":"JSON document dynamically populated based on template needs (see Creative Context docs)"},"pixels":{"nullable":true,"default":[]},"scripts":{"default":[]},"click_trackers":{"nullable":true,"default":[]},"events":{"nullable":true,"default":[]},"progress_events":{"nullable":true,"default":[]},"content_munge":{"type":"string","nullable":true},"frequency_cap":{"nullable":true,"default":[]},"primary_asset":{"type":"integer","nullable":true},"secondary_asset":{"type":"integer","nullable":true},"native_offer":{"type":"integer","nullable":true},"thumbnail_url":{"type":"string","nullable":true,"maxLength":255},"preview_token":{"type":"string","description":"read-only, for internal use. Unique token for generated UI preview"},"start_date":{"type":"string","format":"date-time","nullable":true,"description":"Date/time when this creative is available for serving"},"end_date":{"type":"string","format":"date-time","nullable":true,"description":"Date/time when this creative become unavailable"},"pushed_to_server":{"type":"string","format":"date-time","nullable":true,"description":"read-only, for internal use. Indicates creative has been delivered to ad servers"},"content_update_date":{"type":"string","format":"date-time","nullable":true},"secure":{"type":"integer","maximum":127,"minimum":-128,"nullable":true},"rule_id":{"type":"integer","nullable":true},"rule_key":{"type":"string","nullable":true,"maxLength":20},"vendor_fees":{"type":"array","items":{"$ref":"#/components/schemas/VendorFee"},"description":"The list of the vendor fees objects."},"notes":{"type":"string","nullable":true,"description":"Free-form notes of up to 255 characters.","maxLength":255},"video_encoding_profile_type":{"type":"string","readOnly":true,"description":"Video encoding profile type derived from the primary asset."}},"required":["account_id","create_date","id","name","template_id","update_date","video_encoding_profile_type"]},"CreativeAddon":{"type":"object","description":"Read-side shape shared by the detail and global-view serializers.","properties":{"id":{"type":"integer","readOnly":true},"account_id":{"type":"integer","description":"Defaults to the account in the active session"},"advertiser_id":{"type":"integer","nullable":true,"description":"The advertiser the add-on belongs to. Null for account-level add-ons."},"name":{"type":"string","pattern":"^[\\w[('-]","maxLength":191},"content":{"type":"string","description":"URL or payload that defines the pixel/script or other tag executed by this creative add-on"},"type":{"allOf":[{"$ref":"#/components/schemas/TypeEnum"}],"description":"The kind of add-on markup carried in content.\n\n* `SCRIPT` - Script\n* `PIXEL` - Pixel\n* `WRAPPER` - Wrapper"},"creative_type":{"type":"string","nullable":true,"description":"The creative type the add-on applies to: banner, video, native or any. Defaults to banner."},"include_by_default":{"type":"boolean","default":false,"description":"Whether this add-on is automatically applied to all new creatives of the same creative type"},"secure":{"type":"boolean","default":false,"description":"Whether the add-on's URL is SSL-compliant (HTTPS) and safe for secure inventory environments"},"vendor":{"type":"object","properties":{"id":{"type":"integer","nullable":true},"buzz_key":{"type":"string","nullable":true}},"readOnly":true,"description":"The vendor associated with the add-on."},"vendor_id":{"type":"integer","writeOnly":true,"nullable":true,"description":"Numeric ID of the vendor associated with this creative add-on; references the Vendor object for billing and configuration."},"vendor_buzz_key":{"type":"string","writeOnly":true,"nullable":true,"description":"Canonical vendor key string (for example 'IAS', 'HUMAN', 'MOAT') that identifies the vendor in the Vendor configuration","maxLength":20},"global_field":{"type":"boolean","default":false},"cpm_cost":{"type":"string","format":"decimal","pattern":"^-?\\d{0,2}(?:\\.\\d{0,3})?$","nullable":true,"description":"Cost per thousand impressions charged by the vendor, from 0 to 99.99 with up to 3 decimal places."},"currency":{"type":"string","description":"Currency key, for example USD. Defaults to the account's CURRENCIES_DEFAULT setting.","nullable":true},"active":{"type":"boolean","default":true},"alternative_id":{"type":"string","nullable":true,"description":"An ID that may be used for any reporting or administrative purpose. Limited to 191 characters.","maxLength":200},"notes":{"type":"string","nullable":true,"description":"Free-form notes of up to 255 characters.","maxLength":255},"create_date":{"type":"string","format":"date-time","readOnly":true,"nullable":true,"description":"The date and time the object was first created"},"update_date":{"type":"string","format":"date-time","readOnly":true,"nullable":true,"description":"The date and time the object was last updated"}},"required":["account_id","content","create_date","id","name","type","update_date","vendor"]},"CreativeAddonDuplicate":{"type":"object","properties":{"account_id":{"type":"integer","description":"The account to create the duplicate in."},"advertiser_id":{"type":"integer","nullable":true,"description":"The advertiser to assign the duplicate to. Optional."},"name":{"type":"string","description":"Name for the duplicated add-on.","maxLength":191},"duplicate":{"type":"array","items":{"$ref":"#/components/schemas/DuplicateEnum"},"description":"The list of entities to duplicate. Must include 'resource'."}},"required":["account_id","duplicate","name"]},"CreativeAddonGlobal":{"type":"object","description":"Read-side shape shared by the detail and global-view serializers.","properties":{"id":{"type":"integer"},"account_id":{"type":"integer","readOnly":true},"advertiser_id":{"type":"integer","nullable":true,"readOnly":true},"global_account_id":{"type":"integer","readOnly":true},"name":{"type":"string"},"content":{"type":"string"},"creative_type":{"type":"object","properties":{"id":{"type":"integer","nullable":true},"label":{"type":"string","nullable":true}},"readOnly":true,"description":"The creative type as an ID and label. Labels are banner, video, any and native."},"type":{"type":"string"},"include_by_default":{"type":"boolean"},"vendor":{"type":"string","readOnly":true},"secure":{"type":"boolean"},"cpm_cost":{"type":"string","format":"decimal","pattern":"^-?\\d{0,2}(?:\\.\\d{0,3})?$","nullable":true},"currency":{"type":"string"},"alternative_id":{"type":"string","nullable":true,"description":"An ID that may be used for any reporting or administrative purpose. Limited to 191 characters.","maxLength":200},"global_field":{"type":"boolean"},"active":{"type":"boolean"}},"required":["account_id","active","advertiser_id","content","creative_type","currency","global_account_id","global_field","id","include_by_default","name","secure","type","vendor"]},"CreativeApprovalQueue":{"type":"object","properties":{"account_id":{"type":"integer","readOnly":true},"action":{"$ref":"#/components/schemas/ActionEnum"},"alternative_id":{"type":"string","nullable":true,"maxLength":200},"approved":{"type":"integer","maximum":1,"minimum":0,"description":"0: Pending, 1: Approved"},"buzz_key":{"type":"string","readOnly":true},"creative_approval_id":{"type":"integer","readOnly":true},"creative_id":{"type":"integer","nullable":true,"readOnly":true},"request_date":{"type":"string","format":"date-time"},"request_status":{"type":"integer","maximum":127,"minimum":-128},"vendor_id":{"type":"integer","description":"The ID of the creative approval vendor","nullable":true,"readOnly":true},"update_date":{"type":"string","format":"date-time","nullable":true}},"required":["account_id","action","buzz_key","creative_approval_id","creative_id","request_date","vendor_id"]},"CreativeApprovalQueueHistory":{"type":"object","properties":{"id":{"type":"integer"},"account_id":{"type":"integer","readOnly":true},"action":{"$ref":"#/components/schemas/ActionEnum"},"approval_status":{"type":"string"},"approval_status_message":{"type":"string","nullable":true},"approved":{"type":"integer","maximum":1,"minimum":0,"description":"0: Pending, 1: Approved"},"buzz_key":{"type":"string","readOnly":true},"creative_id":{"type":"integer","nullable":true,"readOnly":true},"creative_approval_id":{"type":"integer","readOnly":true},"request_date":{"type":"string","format":"date-time"},"request_status":{"type":"integer","maximum":127,"minimum":-128},"update_date":{"type":"string","format":"date-time","nullable":true},"vendor_name":{"type":"string"}},"required":["account_id","action","approval_status","buzz_key","creative_approval_id","creative_id","id","request_date","vendor_name"]},"CreativeAsset":{"type":"object","properties":{"active":{"type":"boolean","default":false,"description":"Creative Asset will be created as inactive by default, it will be set to active when the file is uploaded"},"id":{"type":"integer","readOnly":true},"name":{"type":"string"},"asset_type":{"readOnly":true,"nullable":true,"description":"Creative Asset will be created without asset_type by default, it will be set automatically based on mime_type when the file is uploaded\n\n* `IMAGE` - Image\n* `SOURCE_VIDEO` - Source Video\n* `ENCODED_VIDEO` - Encoded Video\n* `HTML` - Html\n* `AUDIO` - Audio","oneOf":[{"$ref":"#/components/schemas/AssetTypeEnum"},{"$ref":"#/components/schemas/NullEnum"}]},"size_in_bytes":{"type":"integer","maximum":2147483647,"minimum":-2147483648},"metadata":{"type":"string","readOnly":true,"nullable":true},"account_id":{"type":"integer","description":"Defaults to the account in the active session"},"advertiser_id":{"type":"integer","nullable":true},"mime_type":{"type":"string","readOnly":true,"nullable":true,"description":"Creative Asset will be created without mime_type by default, it will be set automatically based on the type of the file when the file is uploaded"},"video_encoding_profile_id":{"type":"integer","maximum":2147483647,"minimum":-2147483648,"nullable":true},"video_encoding_profile_name":{"type":"string","readOnly":true,"nullable":true},"video_status":{"type":"integer","maximum":127,"minimum":-128,"readOnly":true,"nullable":true},"creative_thumbnail_url":{"type":"string","readOnly":true},"media_host":{"type":"string","readOnly":true,"nullable":true},"asset_url":{"type":"string","readOnly":true,"nullable":true},"notes":{"type":"string","nullable":true,"description":"Free-form notes of up to 255 characters.","maxLength":255},"create_date":{"type":"string","format":"date-time","readOnly":true,"nullable":true,"description":"The date and time the object was first created"},"update_date":{"type":"string","format":"date-time","readOnly":true,"nullable":true,"description":"The date and time the object was last updated"}},"required":["account_id","advertiser_id","asset_type","asset_url","create_date","creative_thumbnail_url","id","media_host","metadata","mime_type","name","size_in_bytes","update_date","video_encoding_profile_name","video_status"]},"CreativeAttributeAdvertiser":{"type":"object","properties":{"advertiser_app_bundle":{"type":"array","items":{"type":"string","maxLength":255},"nullable":true,"description":"The app bundle ID of the advertiser. Some ad exchanges require any ad advertising another app to declare the app bundle of the advertised app. Max of one value is allowed in the list. When tracking using Apple's SKAdNetwork is enabled we only also setting this value at the Advertiser level, not at the Creative level."},"advertiser_category":{"type":"array","items":{"type":"string"},"description":"Canonical list of categories based on the IAB's content categories."},"advertiser_domain":{"type":"array","items":{"type":"string","description":"Top-level domain of the Advertiser without any path information. Required on most exchanges.","format":"uri","maxLength":255}},"advertiser_index_id":{"type":"array","items":{"type":"string"},"nullable":true,"description":"Canonical list of unique Advertisers based on Google's master list. Every Creative should belong to one and only one Advertiser."},"landing_page_url":{"type":"array","items":{"type":"string","format":"uri","maxLength":2000},"nullable":true,"description":"Complete URL where creatives will ultimately land. Required for running on Google AdX. If not provided the URL defined in the advertiser will be used"}},"required":["advertiser_category","advertiser_domain"]},"CreativeAttributeApproval":{"type":"object","properties":{"adx_gdpr_provider":{"type":"array","items":{"type":"integer"},"nullable":true},"creative_technology_vendor":{"type":"array","items":{"type":"integer"},"nullable":true,"description":"List of technologies used by the Creative, based on Google's list. Beeswax is #632."},"iab_gdpr_provider":{"type":"array","items":{"type":"integer"},"nullable":true},"creative_vendor_iab_gdpr_providers":{"type":"array","items":{"type":"integer"},"nullable":true},"vendor_id":{"type":"array","items":{"type":"string"},"nullable":true,"description":"List of optional Creative Approval Queue vendors for Creative to be submitted. Note, these vendors are distinct from the creative_technology_vendor list, which are just declarations of which technologies are used in the creative."},"xandr_region":{"type":"array","items":{"type":"string","maxLength":20},"nullable":true}}},"CreativeAttributeAudio":{"type":"object","properties":{"audio_duration":{"type":"array","items":{"type":"integer"},"description":"Duration of the audio, in seconds"},"audio_bit_rate":{"type":"array","items":{"type":"integer"},"description":"Bit rate of the audio"},"audio_protocol":{"type":"array","items":{"type":"integer"},"nullable":true},"audio_mime":{"type":"array","items":{"type":"string"},"description":"MIME type of the audio, one of audio/mpeg, audio/ogg, audio/wav, audio/x-ms-wma"},"audio_companion_size":{"type":"array","items":{"type":"string","maxLength":20},"description":"Size of the companion, if provided, in bytes"},"audio_companion_type":{"type":"array","items":{"type":"integer"},"nullable":true,"description":"MIME type of audio companion, one of image/jpg, image/jpeg, image/png, image/gif"}}},"CreativeAttributeTechnical":{"type":"object","properties":{"banner_mime":{"type":"array","items":{"type":"string"},"nullable":true,"description":"MIME type for this banner, eg. image/png"},"expandable_direction":{"type":"array","items":{"type":"string"},"nullable":true,"description":"The direction the ad will expand, as defined in OpenRTB 5.5. Multiple directions may be indicated. 1=left, 2=right, 3=up, 4=down, 5=full screen"},"expandable_type":{"type":"array","items":{"type":"string"},"nullable":true,"description":"The type of expandable as defined by OpenRTB 5.3. Only one type may be set. 3=automatic, 4=user initiated (click), 5=user initiated - rollover"},"tag_type":{"type":"array","items":{"type":"string"},"nullable":true,"description":"1=XTHML text ad, 2=XHTML banner ad, 3=Javascript ad, 4=iFrame"},"ksize":{"type":"array","items":{"type":"integer"},"nullable":true,"description":"Size of the creative in bytes"}}},"CreativeAttributeVideo":{"type":"object","properties":{"ad_id":{"type":"array","items":{"type":"string","maxLength":255},"description":"user-provided identifier for the ad"},"clock_number":{"type":"array","items":{"type":"string","maxLength":255}},"moat_in_app":{"type":"array","items":{"type":"boolean"},"nullable":true,"description":"*deprecated*"},"moat_vpaid":{"type":"array","items":{"type":"boolean"},"nullable":true,"description":"*deprecated*"},"skippable":{"type":"array","items":{"type":"boolean"},"description":"Boolean value to indicate whether the video may be skipped by the user"},"universal_id_type":{"type":"array","items":{"type":"integer"}},"video_autoplay":{"type":"array","items":{"type":"string"},"nullable":true,"description":"Value to indicate whether the ad contains autoplay video. 0=autoplay, 1=click-to-play"},"video_api":{"type":"array","items":{"type":"string"}},"video_duration":{"type":"array","items":{"type":"integer"},"description":"Duration of the video in seconds as an Integer. Default is 30."},"video_bit_rate":{"type":"array","items":{"type":"integer"},"description":"Bit rate(s) of videos within the Creative."},"video_protocol":{"type":"array","items":{"type":"string"},"description":"A canonical list of video protocols from the IAB's OpenRTB 6.7. Example 2=VAST 2.0."},"video_companion_type":{"type":"array","items":{"type":"string"},"description":"A canonical list of video protocols from the IAB's OpenRTB 6.17. Example 2=HTML."},"video_companion_size":{"type":"array","items":{"type":"string","maxLength":20},"description":"Size, in pixels, of the video's companion ad in the format <width>x<height>. Size combination is validated against the creative_sizes table."},"video_mime":{"type":"array","items":{"type":"string"},"description":"Mime types of the video within the Creative. Note, this is kept separate from banner_mime to conform with the IAB's OpenRTB schema and a single video creative can include multiple mime declarations."}}},"CreativeAttributes":{"type":"object","properties":{"advertiser":{"allOf":[{"$ref":"#/components/schemas/CreativeAttributeAdvertiser"}],"nullable":true},"approval":{"allOf":[{"$ref":"#/components/schemas/CreativeAttributeApproval"}],"nullable":true},"mobile":{"allOf":[{"$ref":"#/components/schemas/CreativeAttributesMobile"}],"nullable":true},"technical":{"allOf":[{"$ref":"#/components/schemas/CreativeAttributeTechnical"}],"nullable":true},"video":{"allOf":[{"$ref":"#/components/schemas/CreativeAttributeVideo"}],"nullable":true,"description":"Only for video templates"},"audio":{"allOf":[{"$ref":"#/components/schemas/CreativeAttributeAudio"}],"nullable":true,"description":"Only for audio templates"}}},"CreativeAttributesMobile":{"type":"object","properties":{"mraid_playable":{"type":"array","items":{"type":"boolean"},"nullable":true,"description":"Whether the creative is a playable game in MRAID. This is required to be set when running on MoPub. Note, this is different from declaring general MRAID support, which should be accomplished using the video.video_api field (per OpenRTB)"}}},"CreativeDuplicate":{"type":"object","properties":{"name":{"type":"string","description":"The name that will be used to create names of copied creatives"},"number_of_copies":{"type":"integer","default":1,"description":"Number of copies to be created."},"advertiser_id":{"type":"integer","description":"Optional advertiser to assign the duplicated creatives to."}}},"DuplicateEnum":{"enum":["resource"],"type":"string","description":"* `resource` - resource"},"NullEnum":{"enum":[null]},"PaginatedCreativeAddonGlobalList":{"type":"object","required":["count","results"],"properties":{"count":{"type":"integer","example":123},"next":{"type":"string","nullable":true,"format":"uri","example":"http://api.example.org/accounts/?page=4"},"previous":{"type":"string","nullable":true,"format":"uri","example":"http://api.example.org/accounts/?page=2"},"results":{"type":"array","items":{"$ref":"#/components/schemas/CreativeAddonGlobal"}}}},"PaginatedCreativeAddonList":{"type":"object","required":["count","results"],"properties":{"count":{"type":"integer","example":123},"next":{"type":"string","nullable":true,"format":"uri","example":"http://api.example.org/accounts/?page=4"},"previous":{"type":"string","nullable":true,"format":"uri","example":"http://api.example.org/accounts/?page=2"},"results":{"type":"array","items":{"$ref":"#/components/schemas/CreativeAddon"}}}},"PaginatedCreativeApprovalQueueHistoryList":{"type":"object","required":["count","results"],"properties":{"count":{"type":"integer","example":123},"next":{"type":"string","nullable":true,"format":"uri","example":"http://api.example.org/accounts/?page=4"},"previous":{"type":"string","nullable":true,"format":"uri","example":"http://api.example.org/accounts/?page=2"},"results":{"type":"array","items":{"$ref":"#/components/schemas/CreativeApprovalQueueHistory"}}}},"PaginatedCreativeApprovalQueueList":{"type":"object","required":["count","results"],"properties":{"count":{"type":"integer","example":123},"next":{"type":"string","nullable":true,"format":"uri","example":"http://api.example.org/accounts/?page=4"},"previous":{"type":"string","nullable":true,"format":"uri","example":"http://api.example.org/accounts/?page=2"},"results":{"type":"array","items":{"$ref":"#/components/schemas/CreativeApprovalQueue"}}}},"PaginatedCreativeAssetList":{"type":"object","required":["count","results"],"properties":{"count":{"type":"integer","example":123},"next":{"type":"string","nullable":true,"format":"uri","example":"http://api.example.org/accounts/?page=4"},"previous":{"type":"string","nullable":true,"format":"uri","example":"http://api.example.org/accounts/?page=2"},"results":{"type":"array","items":{"$ref":"#/components/schemas/CreativeAsset"}}}},"PaginatedCreativeList":{"type":"object","required":["count","results"],"properties":{"count":{"type":"integer","example":123},"next":{"type":"string","nullable":true,"format":"uri","example":"http://api.example.org/accounts/?page=4"},"previous":{"type":"string","nullable":true,"format":"uri","example":"http://api.example.org/accounts/?page=2"},"results":{"type":"array","items":{"$ref":"#/components/schemas/Creative"}}}},"PatchedCreative":{"type":"object","description":"A mixin that should be inherited by a custom serializer to include the logic for validating warnings.\n\nThis mixin works by recursively descending into nested levels of the root serializer,\ncollecting warnings in a dictionary structure, and raising them at a higher level.\n\nTo implement warnings in a custom serializer, two types of methods must be used.\nThe first type is used to handle field errors: `warn_<field name>()`.\nThe second type is used for non-field warnings: `warn()`.\n\nUsage:\n    class NestedSerializer(WarningsSerializerMixin, serializers.Serializer):\n        baz = serializers.IntegerField()\n\n        def warn_baz(self, value):\n            ...\n\n        def warn(self, attrs):\n            ....\n\n    class RootSerializer(WarningsSerializerMixin, serializers.Serializer):\n        foo = NestedSerializer()\n        bar = serializers.CharField()\n\n        def warn_bar(self, value):\n            ...\n\n        def warn(self, attrs):\n            ...","properties":{"strict_validation":{"type":"boolean","writeOnly":true,"default":true},"id":{"type":"integer","readOnly":true},"create_date":{"type":"string","format":"date-time","readOnly":true,"nullable":true,"description":"The date and time the object was first created"},"update_date":{"type":"string","format":"date-time","readOnly":true,"nullable":true,"description":"The date and time the object was last updated"},"account_id":{"type":"integer","description":"Defaults to the account in the active session"},"active":{"type":"boolean","default":true},"name":{"type":"string","maxLength":280},"template_id":{"type":"integer"},"advertiser_id":{"type":"integer","nullable":true},"alternative_id":{"type":"string","nullable":true,"description":"An ID that may be used for any reporting or administrative purpose. Limited to 191 characters.","maxLength":200},"type":{"type":"integer","maximum":127,"minimum":-128,"description":"Unique ID of the line item type"},"status_id":{"type":"integer","maximum":127,"minimum":-128},"width":{"type":"integer","maximum":2147483647,"minimum":-2147483648,"nullable":true},"height":{"type":"integer","maximum":2147483647,"minimum":-2147483648,"nullable":true},"sizeless":{"type":"integer","maximum":127,"minimum":-128},"click_url":{"type":"string","nullable":true,"description":"Target URL when a user clicks on the ad","format":"uri"},"content_tag":{"type":"string","nullable":true},"attributes":{"$ref":"#/components/schemas/CreativeAttributes"},"approvals":{"default":[]},"assets":{"nullable":true,"default":[]},"addons":{"nullable":true,"default":[]},"content":{"default":{},"description":"JSON document dynamically populated based on template needs (see Creative Context docs)"},"pixels":{"nullable":true,"default":[]},"scripts":{"default":[]},"click_trackers":{"nullable":true,"default":[]},"events":{"nullable":true,"default":[]},"progress_events":{"nullable":true,"default":[]},"content_munge":{"type":"string","nullable":true},"frequency_cap":{"nullable":true,"default":[]},"primary_asset":{"type":"integer","nullable":true},"secondary_asset":{"type":"integer","nullable":true},"native_offer":{"type":"integer","nullable":true},"thumbnail_url":{"type":"string","nullable":true,"maxLength":255},"preview_token":{"type":"string","description":"read-only, for internal use. Unique token for generated UI preview"},"start_date":{"type":"string","format":"date-time","nullable":true,"description":"Date/time when this creative is available for serving"},"end_date":{"type":"string","format":"date-time","nullable":true,"description":"Date/time when this creative become unavailable"},"pushed_to_server":{"type":"string","format":"date-time","nullable":true,"description":"read-only, for internal use. Indicates creative has been delivered to ad servers"},"content_update_date":{"type":"string","format":"date-time","nullable":true},"secure":{"type":"integer","maximum":127,"minimum":-128,"nullable":true},"rule_id":{"type":"integer","nullable":true},"rule_key":{"type":"string","nullable":true,"maxLength":20},"vendor_fees":{"type":"array","items":{"$ref":"#/components/schemas/VendorFee"},"description":"The list of the vendor fees objects."},"notes":{"type":"string","nullable":true,"description":"Free-form notes of up to 255 characters.","maxLength":255},"video_encoding_profile_type":{"type":"string","readOnly":true,"description":"Video encoding profile type derived from the primary asset."}}},"PatchedCreativeAddon":{"type":"object","description":"Read-side shape shared by the detail and global-view serializers.","properties":{"id":{"type":"integer","readOnly":true},"account_id":{"type":"integer","description":"Defaults to the account in the active session"},"advertiser_id":{"type":"integer","nullable":true,"description":"The advertiser the add-on belongs to. Null for account-level add-ons."},"name":{"type":"string","pattern":"^[\\w[('-]","maxLength":191},"content":{"type":"string","description":"URL or payload that defines the pixel/script or other tag executed by this creative add-on"},"type":{"allOf":[{"$ref":"#/components/schemas/TypeEnum"}],"description":"The kind of add-on markup carried in content.\n\n* `SCRIPT` - Script\n* `PIXEL` - Pixel\n* `WRAPPER` - Wrapper"},"creative_type":{"type":"string","nullable":true,"description":"The creative type the add-on applies to: banner, video, native or any. Defaults to banner."},"include_by_default":{"type":"boolean","default":false,"description":"Whether this add-on is automatically applied to all new creatives of the same creative type"},"secure":{"type":"boolean","default":false,"description":"Whether the add-on's URL is SSL-compliant (HTTPS) and safe for secure inventory environments"},"vendor":{"type":"object","properties":{"id":{"type":"integer","nullable":true},"buzz_key":{"type":"string","nullable":true}},"readOnly":true,"description":"The vendor associated with the add-on."},"vendor_id":{"type":"integer","writeOnly":true,"nullable":true,"description":"Numeric ID of the vendor associated with this creative add-on; references the Vendor object for billing and configuration."},"vendor_buzz_key":{"type":"string","writeOnly":true,"nullable":true,"description":"Canonical vendor key string (for example 'IAS', 'HUMAN', 'MOAT') that identifies the vendor in the Vendor configuration","maxLength":20},"global_field":{"type":"boolean","default":false},"cpm_cost":{"type":"string","format":"decimal","pattern":"^-?\\d{0,2}(?:\\.\\d{0,3})?$","nullable":true,"description":"Cost per thousand impressions charged by the vendor, from 0 to 99.99 with up to 3 decimal places."},"currency":{"type":"string","description":"Currency key, for example USD. Defaults to the account's CURRENCIES_DEFAULT setting.","nullable":true},"active":{"type":"boolean","default":true},"alternative_id":{"type":"string","nullable":true,"description":"An ID that may be used for any reporting or administrative purpose. Limited to 191 characters.","maxLength":200},"notes":{"type":"string","nullable":true,"description":"Free-form notes of up to 255 characters.","maxLength":255},"create_date":{"type":"string","format":"date-time","readOnly":true,"nullable":true,"description":"The date and time the object was first created"},"update_date":{"type":"string","format":"date-time","readOnly":true,"nullable":true,"description":"The date and time the object was last updated"}}},"PatchedCreativeApprovalQueue":{"type":"object","properties":{"account_id":{"type":"integer","readOnly":true},"action":{"$ref":"#/components/schemas/ActionEnum"},"alternative_id":{"type":"string","nullable":true,"maxLength":200},"approved":{"type":"integer","maximum":1,"minimum":0,"description":"0: Pending, 1: Approved"},"buzz_key":{"type":"string","readOnly":true},"creative_approval_id":{"type":"integer","readOnly":true},"creative_id":{"type":"integer","nullable":true,"readOnly":true},"request_date":{"type":"string","format":"date-time"},"request_status":{"type":"integer","maximum":127,"minimum":-128},"vendor_id":{"type":"integer","description":"The ID of the creative approval vendor","nullable":true,"readOnly":true},"update_date":{"type":"string","format":"date-time","nullable":true}}},"TypeEnum":{"enum":["SCRIPT","PIXEL","WRAPPER"],"type":"string","description":"* `SCRIPT` - Script\n* `PIXEL` - Pixel\n* `WRAPPER` - Wrapper"},"VendorFee":{"type":"object","properties":{"object_id":{"type":"integer"},"object_type":{"type":"string","description":"The object_type of the VendorFee. Like line_item, campaign or creative"},"id":{"type":"integer"},"vendor":{"type":"string","description":"The vendor associated with the vendor fee. Note that if `vendor_id` is also provided, both fields must be the same."},"vendor_id":{"type":"integer","description":"The unique identifier of the vendor associated with the vendor fee. Note that if `vendor` is also provided, both fields must be the same."},"name":{"type":"string","description":"The descriptive name of the vendor fee.","maxLength":100},"cpm_currency":{"type":"string","description":"The currency code for the CPM fee amount, e.g. USD.","nullable":true},"cpm_amount":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,3})?$","nullable":true,"description":"The fee amount of the CPM, e.g. 90.123. Note that only one of `cpm_amount` and `percentage` can be specified."},"percentage":{"type":"string","format":"decimal","pattern":"^-?\\d{0,3}(?:\\.\\d{0,3})?$","nullable":true,"description":"The fee amount in a percentage."},"read_only":{"type":"boolean","readOnly":true,"default":false,"description":"If the vendor fee is read-only."},"create_date":{"type":"string","format":"date-time","nullable":true,"description":"The date and time the object was first created"},"update_date":{"type":"string","format":"date-time","readOnly":true,"nullable":true,"description":"The date and time the object was last updated"},"alternative_id":{"type":"string","nullable":true,"description":"An ID that may be used for any reporting or administrative purpose. Limited to 191 characters.","maxLength":200},"notes":{"type":"string","nullable":true,"description":"Free-form notes of up to 255 characters.","maxLength":255},"fee_type":{"type":"string","description":"The key of the fee type","nullable":true}},"required":["name"]}},"securitySchemes":{"nestBasicAuth":{"type":"http","scheme":"basic","description":"Form-based Basic Authentication"},"nestSessionAuth":{"type":"http","scheme":"basic","description":"Form-based Basic Authentication"}}},"x-explorer-enabled":false,"x-samples-languages":["curl","node","ruby","javascript","python","php","java"],"servers":[{"url":"https://{buzz_key}.api.beeswax.com/rest/v2","variables":{"buzz_key":{"default":"stingersbx","description":"Unique customer ID assigned by the Beeswax"}}}]}