{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{"AccountIdHeader":{"description":"The identifier of an Amazon Ads Advertiser Account.","in":"header","name":"Amazon-Ads-AccountId","required":true,"schema":{"type":"string"}},"ClientIdHeader":{"description":"The identifier of a client associated with a \u0027Login with Amazon\u0027 account.","in":"header","name":"Amazon-Ads-ClientId","required":true,"schema":{"type":"string"}}},"requestBodies":{},"responses":{},"schemas":{"AdProduct":{"description":"**AdProduct Enum:**\n\n| AdProduct | Description |\n|------|------|\n| `AMAZON_DSP` | Amazon Demand-Side Platform ad product. |\n","enum":["AMAZON_DSP"],"type":"string"},"AmazonOwnedAndOperated":{"description":"Only deals from Amazon owned and operated supply sources are permitted. Open internet inventory is excluded.","properties":{"enabled":{"description":"Must be set to true to activate this supply filter. Setting enabled to false is invalid and will be rejected.","type":"boolean"}},"required":["enabled"],"type":"object"},"AutomaticDealSelectionControls":{"description":"Advertiser-configured preferences that constrain which deals the automated recommendation system can recommend. These preferences filter the candidate deal pool before recommendations are generated.","properties":{"adGroupId":{"description":"The ad group associated with these automatic deal selection controls.","type":"string"},"dealTypePreference":{"$ref":"#/components/schemas/DealTypePreference"},"supplyAllowlist":{"$ref":"#/components/schemas/SupplyAllowlist"}},"required":["adGroupId"],"type":"object"},"BadGatewayResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"BadRequestResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"ContentTooLargeResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"CreateAmazonOwnedAndOperated":{"description":"Only deals from Amazon owned and operated supply sources are permitted. Open internet inventory is excluded.","properties":{"enabled":{"description":"Must be set to true to activate this supply filter. Setting enabled to false is invalid and will be rejected.","type":"boolean"}},"required":["enabled"],"type":"object"},"CreateAutomaticDealSelectionControls":{"description":"Advertiser-configured preferences that constrain which deals the automated recommendation system can recommend. These preferences filter the candidate deal pool before recommendations are generated.","properties":{"adGroupId":{"description":"The ad group associated with these automatic deal selection controls.","type":"string"},"dealTypePreference":{"$ref":"#/components/schemas/DealTypePreference"},"supplyAllowlist":{"$ref":"#/components/schemas/CreateSupplyAllowlist"}},"required":["adGroupId"],"type":"object"},"CreateCurationSourceSettings":{"description":"Configuration settings specific to a curation source type. Each variant contains settings applicable to a particular curation mode.","oneOf":[{"properties":{"automaticDealSelectionControls":{"$ref":"#/components/schemas/CreateAutomaticDealSelectionControls"}},"required":["automaticDealSelectionControls"],"title":"automaticDealSelectionControls","type":"object"}]},"CreateCustomSources":{"description":"Only the specified supply sources are permitted.","properties":{"supplySourceIds":{"description":"Supply source identifiers permitted for deal recommendations.","items":{"type":"string"},"maxItems":1000,"minItems":1,"type":"array"}},"required":["supplySourceIds"],"type":"object"},"CreateInventoryGroupRequest":{"properties":{"inventoryGroups":{"items":{"$ref":"#/components/schemas/InventoryGroupCreate"},"maxItems":100,"minItems":1,"type":"array"}},"required":["inventoryGroups"],"type":"object"},"CreateOpenInternet":{"description":"Only deals from open internet supply sources are permitted. Amazon owned and operated inventory is excluded.","properties":{"enabled":{"description":"Must be set to true to activate this supply filter. Setting enabled to false is invalid and will be rejected.","type":"boolean"}},"required":["enabled"],"type":"object"},"CreateSupplyAllowlist":{"description":"Defines which supply sources are permitted for deal recommendations.","oneOf":[{"properties":{"customSources":{"$ref":"#/components/schemas/CreateCustomSources"}},"required":["customSources"],"title":"customSources","type":"object"},{"properties":{"amazonOwnedAndOperated":{"$ref":"#/components/schemas/CreateAmazonOwnedAndOperated"}},"required":["amazonOwnedAndOperated"],"title":"amazonOwnedAndOperated","type":"object"},{"properties":{"openInternet":{"$ref":"#/components/schemas/CreateOpenInternet"}},"required":["openInternet"],"title":"openInternet","type":"object"}]},"CurationSourceSettings":{"description":"Configuration settings specific to a curation source type. Each variant contains settings applicable to a particular curation mode.\n\n\n\n","oneOf":[{"properties":{"automaticDealSelectionControls":{"$ref":"#/components/schemas/AutomaticDealSelectionControls"}},"required":["automaticDealSelectionControls"],"title":"automaticDealSelectionControls","type":"object"}]},"CurationSourceType":{"description":"The source system or method used to curate the inventory group.\n**CurationSourceType Enum:**\n\n| CurationSourceType | Description |\n|------|------|\n| `ADVERTISER_CURATED` | Inventory group was manually curated by the advertiser or agency. |\n| `AMAZON_CURATED_AGENT` | Inventory group was created through the Automatic Deal Selection System, which uses machine learning to identify optimal deal combinations. |\n| `AMAZON_CURATED` | Inventory group was manually curated by Amazon. |\n","enum":["ADVERTISER_CURATED","AMAZON_CURATED","AMAZON_CURATED_AGENT"],"type":"string"},"CustomSources":{"description":"Only the specified supply sources are permitted.","properties":{"supplySourceIds":{"description":"Supply source identifiers permitted for deal recommendations.","items":{"type":"string"},"maxItems":1000,"minItems":1,"type":"array"}},"required":["supplySourceIds"],"type":"object"},"DealTypePreference":{"description":"Preference for filtering deals by marketplace listing status. Filters on AdvertisingDealTerms.marketplaceDeal in the advertising_deal module.\n**DealTypePreference Enum:**\n\n| DealTypePreference | Description |\n|------|------|\n| `ALL` | All deal types are eligible regardless of marketplace listing status. |\n| `EXCLUDE_PUBLICLY_AVAILABLE` | Only private deals (marketplaceDeal \u003d false) are eligible. Publicly available deals are excluded. |\n| `PUBLICLY_AVAILABLE_ONLY` | Only publicly available deals (marketplaceDeal \u003d true) are eligible. Private deals are excluded. |\n","enum":["ALL","EXCLUDE_PUBLICLY_AVAILABLE","PUBLICLY_AVAILABLE_ONLY"],"type":"string"},"Error":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"fieldLocation":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"ErrorCode":{"description":"**ErrorCode Enum:**\n\n| ErrorCode | Description |\n|------|------|\n| `ACTION_NOT_SUPPORTED` | The request is not supported. |\n| `BAD_REQUEST` | The request is not valid considering the documented schema. |\n| `CONTENT_TOO_LARGE` | The request is too large. Consider splitting it into multiple requests. |\n| `FIELD_VALUE_CANNOT_EDIT` | Field value cannot be edited. |\n| `FIELD_VALUE_CONTAINS_INVALID_CHARACTERS` | Remove the invalid characters and try again. |\n| `FIELD_VALUE_IS_INVALID` | Update the request with the required information for this resource. |\n| `FIELD_VALUE_NOT_FOUND` | Resource specified in the field value not found. Try again with valid value. |\n| `FORBIDDEN` | The caller is not authorized to make the given request. |\n| `INTERNAL_ERROR` | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n| `NOT_FOUND` | The requested resource does not exist. |\n| `RESOURCE_ID_NOT_FOUND` | Resource ID not found. Try again with valid ID. |\n| `TOO_MANY_REQUESTS` | There have been too many requests, please slow down your call rate. |\n| `UNAUTHORIZED` | The request lacks the necessary credentials. |\n","enum":["ACTION_NOT_SUPPORTED","BAD_REQUEST","CONTENT_TOO_LARGE","FIELD_VALUE_CANNOT_EDIT","FIELD_VALUE_CONTAINS_INVALID_CHARACTERS","FIELD_VALUE_IS_INVALID","FIELD_VALUE_NOT_FOUND","FORBIDDEN","INTERNAL_ERROR","NOT_FOUND","RESOURCE_ID_NOT_FOUND","TOO_MANY_REQUESTS","UNAUTHORIZED"],"type":"string"},"ErrorsIndex":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/Error"},"maxItems":20,"minItems":1,"type":"array"},"index":{"format":"int32","maximum":99,"minimum":0,"type":"integer"}},"required":["errors","index"],"type":"object"},"ForbiddenResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"GatewayTimeoutResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"InternalServerErrorResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"InventoryGroup":{"properties":{"adProduct":{"$ref":"#/components/schemas/AdProduct"},"advertisingDealIds":{"description":"Collection of advertising deal ids included in this inventory group. Maximum 100 deals per group for public APIs. Private APIs may support up to 1000 deals.","items":{"type":"string"},"maxItems":100,"minItems":0,"type":"array"},"creationDateTime":{"description":"The date and time the inventory group was created.","format":"date-time","type":"string"},"curationSourceSettings":{"$ref":"#/components/schemas/CurationSourceSettings"},"curationSourceType":{"$ref":"#/components/schemas/CurationSourceType"},"description":{"description":"Optional description of the inventory group. Provides additional context about the deals included and intended use.","type":"string"},"inventoryGroupId":{"description":"Unique identifier for the inventory group.","type":"string"},"inventoryType":{"$ref":"#/components/schemas/InventoryType"},"lastUpdatedDateTime":{"description":"The date and time the inventory group was last updated.","format":"date-time","type":"string"},"name":{"description":"The name of the inventory group.","type":"string"}},"required":["creationDateTime","inventoryGroupId","inventoryType","name"],"type":"object"},"InventoryGroupCreate":{"properties":{"adProduct":{"$ref":"#/components/schemas/AdProduct"},"advertisingDealIds":{"description":"Collection of advertising deal ids included in this inventory group. Maximum 100 deals per group for public APIs. Private APIs may support up to 1000 deals.","items":{"type":"string"},"maxItems":100,"minItems":0,"type":"array"},"curationSourceSettings":{"$ref":"#/components/schemas/CreateCurationSourceSettings"},"curationSourceType":{"$ref":"#/components/schemas/CurationSourceType"},"description":{"description":"Optional description of the inventory group. Provides additional context about the deals included and intended use.","type":"string"},"inventoryType":{"$ref":"#/components/schemas/InventoryType"},"name":{"description":"The name of the inventory group.","type":"string"}},"required":["inventoryType","name"],"type":"object"},"InventoryGroupCurationSourceTypeFilter":{"properties":{"include":{"description":"**CurationSourceType Enum:**\n| CurationSourceType | Description |\n| --- | --- |\n| `AMAZON_CURATED_AGENT` | Inventory group was created through the Automatic Deal Selection System, which uses machine learning to identify optimal deal combinations. |\n| `AMAZON_CURATED` | Inventory group was manually curated by Amazon. |\n| `ADVERTISER_CURATED` | Inventory group was manually curated by the advertiser or agency. |","items":{"$ref":"#/components/schemas/CurationSourceType"},"maxItems":3,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"InventoryGroupInventoryGroupIdFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"InventoryGroupInventoryTypeFilter":{"properties":{"include":{"description":"**InventoryType Enum:**\n| InventoryType | Description |\n| --- | --- |\n| `DISPLAY` |  |\n| `VIDEO` |  |\n| `AUDIO` | Audio ads that serve on streaming audio inventory. |","items":{"$ref":"#/components/schemas/InventoryType"},"maxItems":6,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"InventoryGroupMultiStatusResponse":{"properties":{"error":{"items":{"$ref":"#/components/schemas/ErrorsIndex"},"maxItems":100,"minItems":0,"type":"array"},"success":{"items":{"$ref":"#/components/schemas/InventoryGroupMultiStatusSuccess"},"maxItems":100,"minItems":0,"type":"array"}},"type":"object"},"InventoryGroupMultiStatusSuccess":{"properties":{"index":{"format":"int32","maximum":99,"minimum":0,"type":"integer"},"inventoryGroup":{"$ref":"#/components/schemas/InventoryGroup"}},"required":["index","inventoryGroup"],"type":"object"},"InventoryGroupNameFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":1,"minItems":1,"type":"array"},"queryTermMatchType":{"$ref":"#/components/schemas/InventoryGroupNameFilterType"}},"required":["include","queryTermMatchType"],"type":"object"},"InventoryGroupNameFilterType":{"description":"**InventoryGroupNameFilterType Enum:**\n| InventoryGroupNameFilterType | Description |\n| --- | --- |\n| `EXACT_MATCH` | Filter by exact match. |","enum":["EXACT_MATCH"],"type":"string"},"InventoryGroupSortOption":{"properties":{"by":{"$ref":"#/components/schemas/InventoryGroupSortOptionsFields"},"direction":{"$ref":"#/components/schemas/SortDirection"}},"required":["by"],"type":"object"},"InventoryGroupSortOptionsFields":{"description":"Specify which field to order by.\n| Field Name | Supported Ordering |\n| --- | --- |\n| creationDateTime | ASCENDING,DESCENDING |\n| inventoryGroupId | ASCENDING,DESCENDING |\n| inventoryType | ASCENDING,DESCENDING |\n| name | ASCENDING,DESCENDING |","enum":["creationDateTime","inventoryGroupId","inventoryType","name"],"type":"string"},"InventoryGroupSuccessResponse":{"properties":{"inventoryGroups":{"items":{"$ref":"#/components/schemas/InventoryGroup"},"maxItems":100,"minItems":0,"type":"array"},"nextToken":{"type":"string"},"totalResults":{"format":"int32","type":"integer"}},"type":"object"},"InventoryGroupUpdate":{"properties":{"advertisingDealIds":{"description":"Collection of advertising deal ids included in this inventory group. Maximum 100 deals per group for public APIs. Private APIs may support up to 1000 deals.","items":{"type":"string"},"maxItems":100,"minItems":0,"type":"array"},"curationSourceSettings":{"$ref":"#/components/schemas/UpdateCurationSourceSettings"},"description":{"description":"Optional description of the inventory group. Provides additional context about the deals included and intended use.","type":"string"},"inventoryGroupId":{"description":"Unique identifier for the inventory group.","type":"string"},"name":{"description":"The name of the inventory group.","type":"string"}},"required":["inventoryGroupId"],"type":"object"},"InventoryType":{"description":"**InventoryType Enum:**\n\n| InventoryType | Description |\n|------|------|\n| `AUDIO` | Audio ads that serve on streaming audio inventory. |\n| `DISPLAY` |  |\n| `VIDEO` |  |\n","enum":["AUDIO","DISPLAY","VIDEO"],"type":"string"},"NotFoundResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"OpenInternet":{"description":"Only deals from open internet supply sources are permitted. Amazon owned and operated inventory is excluded.","properties":{"enabled":{"description":"Must be set to true to activate this supply filter. Setting enabled to false is invalid and will be rejected.","type":"boolean"}},"required":["enabled"],"type":"object"},"QueryInventoryGroupRequest":{"properties":{"curationSourceTypeFilter":{"$ref":"#/components/schemas/InventoryGroupCurationSourceTypeFilter"},"inventoryGroupIdFilter":{"$ref":"#/components/schemas/InventoryGroupInventoryGroupIdFilter"},"inventoryTypeFilter":{"$ref":"#/components/schemas/InventoryGroupInventoryTypeFilter"},"maxResults":{"default":50,"format":"int32","maximum":100,"minimum":1,"type":"integer"},"nameFilter":{"$ref":"#/components/schemas/InventoryGroupNameFilter"},"nextToken":{"type":"string"},"sort":{"items":{"$ref":"#/components/schemas/InventoryGroupSortOption"},"maxItems":1,"minItems":0,"type":"array"}},"type":"object"},"ServiceUnavailableErrorResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"SortDirection":{"description":"**SortDirection Enum:**\n| SortDirection | Description |\n| --- | --- |\n| `ASCENDING` | Sort in ascending order |\n| `DESCENDING` | Sort in descending order |","enum":["ASCENDING","DESCENDING"],"type":"string"},"SupplyAllowlist":{"description":"Defines which supply sources are permitted for deal recommendations.\n\n\n\n","oneOf":[{"properties":{"amazonOwnedAndOperated":{"$ref":"#/components/schemas/AmazonOwnedAndOperated"}},"required":["amazonOwnedAndOperated"],"title":"amazonOwnedAndOperated","type":"object"},{"properties":{"customSources":{"$ref":"#/components/schemas/CustomSources"}},"required":["customSources"],"title":"customSources","type":"object"},{"properties":{"openInternet":{"$ref":"#/components/schemas/OpenInternet"}},"required":["openInternet"],"title":"openInternet","type":"object"}]},"TooManyRequestsResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"UnauthorizedResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"UpdateAmazonOwnedAndOperated":{"description":"Only deals from Amazon owned and operated supply sources are permitted. Open internet inventory is excluded.","properties":{"enabled":{"description":"Must be set to true to activate this supply filter. Setting enabled to false is invalid and will be rejected.","type":"boolean"}},"type":"object"},"UpdateAutomaticDealSelectionControls":{"description":"Advertiser-configured preferences that constrain which deals the automated recommendation system can recommend. These preferences filter the candidate deal pool before recommendations are generated.","properties":{"adGroupId":{"description":"The ad group associated with these automatic deal selection controls.","type":"string"},"dealTypePreference":{"$ref":"#/components/schemas/DealTypePreference"},"supplyAllowlist":{"$ref":"#/components/schemas/UpdateSupplyAllowlist"}},"type":"object"},"UpdateCurationSourceSettings":{"description":"Configuration settings specific to a curation source type. Each variant contains settings applicable to a particular curation mode.","oneOf":[{"nullable":true,"properties":{"automaticDealSelectionControls":{"$ref":"#/components/schemas/UpdateAutomaticDealSelectionControls"}},"required":["automaticDealSelectionControls"],"title":"automaticDealSelectionControls","type":"object"}]},"UpdateCustomSources":{"description":"Only the specified supply sources are permitted.","properties":{"supplySourceIds":{"description":"Supply source identifiers permitted for deal recommendations.","items":{"type":"string"},"maxItems":1000,"minItems":1,"type":"array"}},"type":"object"},"UpdateInventoryGroupRequest":{"properties":{"inventoryGroups":{"items":{"$ref":"#/components/schemas/InventoryGroupUpdate"},"maxItems":100,"minItems":1,"type":"array"}},"required":["inventoryGroups"],"type":"object"},"UpdateOpenInternet":{"description":"Only deals from open internet supply sources are permitted. Amazon owned and operated inventory is excluded.","properties":{"enabled":{"description":"Must be set to true to activate this supply filter. Setting enabled to false is invalid and will be rejected.","type":"boolean"}},"type":"object"},"UpdateSupplyAllowlist":{"description":"Defines which supply sources are permitted for deal recommendations.","oneOf":[{"properties":{"customSources":{"$ref":"#/components/schemas/UpdateCustomSources"}},"required":["customSources"],"title":"customSources","type":"object"},{"properties":{"amazonOwnedAndOperated":{"$ref":"#/components/schemas/UpdateAmazonOwnedAndOperated"}},"required":["amazonOwnedAndOperated"],"title":"amazonOwnedAndOperated","type":"object"},{"properties":{"openInternet":{"$ref":"#/components/schemas/UpdateOpenInternet"}},"required":["openInternet"],"title":"openInternet","type":"object"}]}},"securitySchemes":{"OAuth2":{"flows":{"authorizationCode":{"authorizationUrl":"https://www.amazon.com/ap/oa","scopes":{"advertising::audiences":"Grants access to data provider APIs","advertising::campaign_management":"Grants write access to campaign management.","advertising::test:create_account":"Grants write access to create test accounts functionality","cpc_advertising:campaign_management":"Grants write access to campaign management. Legacy name (no difference from advertising::campaign_management)"},"tokenUrl":"https://api.amazon.com/auth/o2/token"}},"type":"oauth2"}}},"info":{"description":"Amazon Ads API v1 is a reimagined approach to our Ads API, built to provide a seamless experience across all Amazon advertising products through a common model. [Learn more about Ads API v1.](https://advertising.amazon.com/API/docs/en-us/reference/amazon-ads/overview) To learn about prerequisites and header values, see [Getting started with Amazon Ads API v1](https://advertising.amazon.com/API/docs/en-us/reference/amazon-ads/getting-started).\n\n**Download Amazon Ads API V1 OpenAPI Spec** ([All Products](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPIALLMerged_prod_3p_ALL.json) | [SP](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISPMerged_prod_3p_ALL.json) | [SP Global](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISPGLOBALMerged_prod_3p_ALL.json) | [SB](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISBMerged_prod_3p_ALL.json) | [DSP](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPIDSPMerged_prod_3p_ALL.json) | [ST](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISTMerged_prod_3p_ALL.json) | [SD](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISDMerged_prod_3p_ALL.json))","title":"InventoryGroups API","version":"3.0"},"openapi":"3.0.1","paths":{"/adsApi/v1/create/inventoryGroups":{"post":{"description":"Create inventory groups\n\n**Requires one of these permissions**:\n[\"inventory_edit\"]","operationId":"AdsApiv1CreateInventoryGroup","parameters":[{"$ref":"#/components/parameters/AccountIdHeader"},{"$ref":"#/components/parameters/ClientIdHeader"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInventoryGroupRequest"}}},"required":true},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryGroupMultiStatusResponse"}}},"description":"AdsApiv1CreateInventoryGroup 207 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponseContent"}}},"description":"BadRequest 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponseContent"}}},"description":"Unauthorized 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponseContent"}}},"description":"Forbidden 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponseContent"}}},"description":"NotFound 404 response"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentTooLargeResponseContent"}}},"description":"ContentTooLarge 413 response"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponseContent"}}},"description":"TooManyRequests 429 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponseContent"}}},"description":"InternalServerError 500 response"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayResponseContent"}}},"description":"BadGateway 502 response"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableErrorResponseContent"}}},"description":"ServiceUnavailableError 503 response"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutResponseContent"}}},"description":"GatewayTimeout 504 response"}},"security":[{"OAuth2":["advertising::campaign_management"]}],"tags":["InventoryGroups"]}},"/adsApi/v1/query/inventoryGroups":{"post":{"description":"Query inventory groups with filters\n\n**Requires one of these permissions**:\n[\"inventory_edit\", \"inventory_view\"]","operationId":"AdsApiv1QueryInventoryGroup","parameters":[{"$ref":"#/components/parameters/AccountIdHeader"},{"$ref":"#/components/parameters/ClientIdHeader"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryInventoryGroupRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryGroupSuccessResponse"}}},"description":"AdsApiv1QueryInventoryGroup 200 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponseContent"}}},"description":"BadRequest 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponseContent"}}},"description":"Unauthorized 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponseContent"}}},"description":"Forbidden 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponseContent"}}},"description":"NotFound 404 response"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentTooLargeResponseContent"}}},"description":"ContentTooLarge 413 response"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponseContent"}}},"description":"TooManyRequests 429 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponseContent"}}},"description":"InternalServerError 500 response"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayResponseContent"}}},"description":"BadGateway 502 response"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableErrorResponseContent"}}},"description":"ServiceUnavailableError 503 response"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutResponseContent"}}},"description":"GatewayTimeout 504 response"}},"security":[{"OAuth2":["advertising::campaign_management"]}],"tags":["InventoryGroups"]}},"/adsApi/v1/update/inventoryGroups":{"post":{"description":"Update inventory groups\n\n**Requires one of these permissions**:\n[\"inventory_edit\"]","operationId":"AdsApiv1UpdateInventoryGroup","parameters":[{"$ref":"#/components/parameters/AccountIdHeader"},{"$ref":"#/components/parameters/ClientIdHeader"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateInventoryGroupRequest"}}},"required":true},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InventoryGroupMultiStatusResponse"}}},"description":"AdsApiv1UpdateInventoryGroup 207 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponseContent"}}},"description":"BadRequest 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponseContent"}}},"description":"Unauthorized 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponseContent"}}},"description":"Forbidden 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponseContent"}}},"description":"NotFound 404 response"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentTooLargeResponseContent"}}},"description":"ContentTooLarge 413 response"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponseContent"}}},"description":"TooManyRequests 429 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponseContent"}}},"description":"InternalServerError 500 response"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayResponseContent"}}},"description":"BadGateway 502 response"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableErrorResponseContent"}}},"description":"ServiceUnavailableError 503 response"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutResponseContent"}}},"description":"GatewayTimeout 504 response"}},"security":[{"OAuth2":["advertising::campaign_management"]}],"tags":["InventoryGroups"]}}},"servers":[{"description":"Production server for NA","url":"https://advertising-api.amazon.com"},{"description":"Production server for EU","url":"https://advertising-api-eu.amazon.com"},{"description":"Production server for FE","url":"https://advertising-api-fe.amazon.com"}]}