{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{},"requestBodies":{},"responses":{},"schemas":{"AdvertiserListOperationType":{"enum":["ADD","REMOVE"],"type":"string"},"AdvertiserPermissionRequestStrategy":{"enum":["ALLOW","BLOCK"],"type":"string"},"AdvertiserPermissionResponseStrategy":{"enum":["ALLOW","BLOCK"],"type":"string"},"CreateDealAdvertiserPermissionsRequestBody":{"properties":{"strategy":{"$ref":"#/components/schemas/AdvertiserPermissionRequestStrategy"}},"required":["strategy"],"type":"object"},"DspBadRequestExceptionV1ResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/DspSubErrorV1"},"maxItems":100,"minItems":1,"type":"array"},"message":{"type":"string"},"requestId":{"type":"string"}},"type":"object"},"DspForbiddenExceptionV1ResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/DspSubErrorV1"},"maxItems":100,"minItems":1,"type":"array"},"message":{"type":"string"},"requestId":{"type":"string"}},"type":"object"},"DspInternalServerExceptionV1ResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/DspSubErrorV1"},"maxItems":100,"minItems":1,"type":"array"},"message":{"type":"string"},"requestId":{"type":"string"}},"type":"object"},"DspNotFoundExceptionV1ResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/DspSubErrorV1"},"maxItems":100,"minItems":1,"type":"array"},"message":{"type":"string"},"requestId":{"type":"string"}},"type":"object"},"DspSubErrorV1":{"properties":{"errorType":{"type":"string"},"fieldName":{"type":"string"},"message":{"type":"string"}},"required":["errorType","message"],"type":"object"},"DspUnauthorizedExceptionV1ResponseContent":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/DspSubErrorV1"},"maxItems":100,"minItems":1,"type":"array"},"message":{"type":"string"},"requestId":{"type":"string"}},"type":"object"},"FailedAdvertiser":{"properties":{"advertiserId":{"type":"string"},"description":{"type":"string"},"index":{"type":"number"}},"type":"object"},"FailedRecommendedAdvertiser":{"properties":{"advertiserId":{"type":"string"},"description":{"type":"string"},"index":{"type":"number"}},"type":"object"},"GetAdvertiserListDspDealsResponseContent":{"description":"Successful operation.","properties":{"advertiserIds":{"description":"List of Advertiser Ids currently used as advertiser permissions.","items":{"type":"string"},"maxItems":1000,"minItems":0,"type":"array"},"nextToken":{"description":"Used for pagination, a string that can be sent in the next request to get the next page of results.","type":"string"},"totalResults":{"description":"The number of results returned.","type":"number"}},"type":"object"},"GetDealAdvertiserPermissionsDspDealsResponseContent":{"description":"Successful operation.","properties":{"strategy":{"$ref":"#/components/schemas/AdvertiserPermissionResponseStrategy"}},"type":"object"},"ListRecommendedAdvertiserDspDealsRequestContent":{"properties":{"maxResults":{"description":"Sets the maximum number of results in the returned collection. Used in conjunction with \u0027nextToken\u0027 to \t\tcontrol pagination. Values less than 1 are considered invalid and will result in an error response.","maximum":1000,"minimum":1,"type":"number"},"nextToken":{"description":"Used for pagination, a string that can be sent in the next request to get the next page of results.","type":"string"}},"type":"object"},"ListRecommendedAdvertiserDspDealsResponseContent":{"description":"Successful operation.","properties":{"advertiserIds":{"description":"List of Recommended Advertiser Ids.","items":{"type":"string"},"maxItems":1000,"minItems":0,"type":"array"},"nextToken":{"description":"Used for pagination, a string that can be sent in the next request to get the next page of results.","type":"string"},"totalResults":{"description":"The number of results returned.","type":"number"}},"type":"object"},"RecommendedAdvertiserListOperationType":{"enum":["ADD","REMOVE"],"type":"string"},"SuccessfulAdvertiser":{"properties":{"advertiserId":{"type":"string"},"index":{"type":"number"}},"type":"object"},"SuccessfulRecommendedAdvertiser":{"properties":{"advertiserId":{"type":"string"},"index":{"type":"number"}},"type":"object"},"UpdateAdvertiserListDspDealsResponseContent":{"description":"Successful operation.","properties":{"errors":{"description":"List of Advertiser Ids that failed to be added or removed from the advertiser permissions list.","items":{"$ref":"#/components/schemas/FailedAdvertiser"},"maxItems":20,"minItems":0,"type":"array"},"success":{"description":"List of Advertiser Ids that were successfully added or removed from the advertiser permissions list.","items":{"$ref":"#/components/schemas/SuccessfulAdvertiser"},"maxItems":20,"minItems":0,"type":"array"}},"type":"object"},"UpdateAdvertiserListRequestBody":{"properties":{"advertiserIds":{"description":"A list of Advertiser Ids to be added or removed from the advertiser permissions list.","items":{"type":"string"},"maxItems":20,"minItems":1,"type":"array"},"operationType":{"$ref":"#/components/schemas/AdvertiserListOperationType"}},"required":["advertiserIds","operationType"],"type":"object"},"UpdateRecommendedAdvertiserListDspDealsResponseContent":{"description":"Successful operation.","properties":{"errors":{"description":"List of Advertiser Ids that failed to be added or removed from the recommended advertiser list.","items":{"$ref":"#/components/schemas/FailedRecommendedAdvertiser"},"maxItems":20,"minItems":0,"type":"array"},"success":{"description":"List of Advertiser Ids that were successfully added or removed from recommended advertiser list.","items":{"$ref":"#/components/schemas/SuccessfulRecommendedAdvertiser"},"maxItems":20,"minItems":0,"type":"array"}},"type":"object"},"UpdateRecommendedAdvertiserListRequestBody":{"properties":{"advertiserIds":{"description":"A list of Advertiser Ids to be added or removed from the recommended advertiser list.","items":{"type":"string"},"maxItems":20,"minItems":1,"type":"array"},"operationType":{"$ref":"#/components/schemas/RecommendedAdvertiserListOperationType"}},"required":["advertiserIds","operationType"],"type":"object"}},"securitySchemes":{}},"info":{"description":"\t\tA Deal is an object representing an inventory agreement between a buyer (advertiser or agency) and a seller \t\t(publisher or exchange). Depending on the specific type of deal, the terms, and implementation can vary. \t\tOnce created within an entity, a Deal object may be targeted by one or several line items, which sit \t\thierarchically under orders and advertisers.","title":"Deal Advertiser Permissions","version":"3.0"},"openapi":"3.0.1","paths":{"/dsp/inventory/deals/{dealId}/advertiserPermissions":{"delete":{"description":"Deletes both the permission strategy and associated advertisers from the deal advertiser permissions.\n\n**Requires one of these permissions**:\n[]","operationId":"DeleteDealAdvertiserPermissionsDspDeals","parameters":[{"description":"Amazon assigned ID unique to each Deal.","in":"path","name":"dealId","required":true,"schema":{"description":"Amazon assigned ID unique to each Deal.","type":"string"}},{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input. For DSP profiles, the `type` field of the `accountInfo` object must be set to `agency` and the `subType` field must not be `AMAZON_ATTRIBUTION`.","in":"header","name":"Amazon-Advertising-API-Scope","required":true,"schema":{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input. For DSP profiles, the `type` field of the `accountInfo` object must be set to `agency` and the `subType` field must not be `AMAZON_ATTRIBUTION`.","type":"string"}}],"responses":{"200":{"description":"DeleteDealAdvertiserPermissionsDspDeals 200 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspBadRequestExceptionV1ResponseContent"}}},"description":"DspBadRequestExceptionV1 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspUnauthorizedExceptionV1ResponseContent"}}},"description":"DspUnauthorizedExceptionV1 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspForbiddenExceptionV1ResponseContent"}}},"description":"DspForbiddenExceptionV1 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspNotFoundExceptionV1ResponseContent"}}},"description":"DspNotFoundExceptionV1 404 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspInternalServerExceptionV1ResponseContent"}}},"description":"DspInternalServerExceptionV1 500 response"}},"tags":["Deal Advertiser Permissions"]},"get":{"description":"Gets the advertiser permissions strategy type for a given deal.\n\n**Requires one of these permissions**:\n[]","operationId":"GetDealAdvertiserPermissionsDspDeals","parameters":[{"description":"Amazon assigned ID unique to each Deal.","in":"path","name":"dealId","required":true,"schema":{"description":"Amazon assigned ID unique to each Deal.","type":"string"}},{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input. For DSP profiles, the `type` field of the `accountInfo` object must be set to `agency` and the `subType` field must not be `AMAZON_ATTRIBUTION`.","in":"header","name":"Amazon-Advertising-API-Scope","required":true,"schema":{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input. For DSP profiles, the `type` field of the `accountInfo` object must be set to `agency` and the `subType` field must not be `AMAZON_ATTRIBUTION`.","type":"string"}}],"responses":{"200":{"content":{"application/vnd.dspDealAdvertiserPermissionsResource.v1+json":{"schema":{"$ref":"#/components/schemas/GetDealAdvertiserPermissionsDspDealsResponseContent"}}},"description":"GetDealAdvertiserPermissionsDspDeals 200 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspBadRequestExceptionV1ResponseContent"}}},"description":"DspBadRequestExceptionV1 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspUnauthorizedExceptionV1ResponseContent"}}},"description":"DspUnauthorizedExceptionV1 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspForbiddenExceptionV1ResponseContent"}}},"description":"DspForbiddenExceptionV1 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspNotFoundExceptionV1ResponseContent"}}},"description":"DspNotFoundExceptionV1 404 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspInternalServerExceptionV1ResponseContent"}}},"description":"DspInternalServerExceptionV1 500 response"}},"tags":["Deal Advertiser Permissions"]},"post":{"description":"Assigns permissions to deal object, by applying a permission strategy and a list of advertisers to this deal object.\n\n**Requires one of these permissions**:\n[]","operationId":"CreateDealAdvertiserPermissionsDspDeals","parameters":[{"description":"Amazon assigned ID unique to each Deal.","in":"path","name":"dealId","required":true,"schema":{"description":"Amazon assigned ID unique to each Deal.","type":"string"}},{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input. For DSP profiles, the `type` field of the `accountInfo` object must be set to `agency` and the `subType` field must not be `AMAZON_ATTRIBUTION`.","in":"header","name":"Amazon-Advertising-API-Scope","required":true,"schema":{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input. For DSP profiles, the `type` field of the `accountInfo` object must be set to `agency` and the `subType` field must not be `AMAZON_ATTRIBUTION`.","type":"string"}}],"requestBody":{"content":{"application/vnd.dspDealAdvertiserPermissionsResource.v1+json":{"schema":{"$ref":"#/components/schemas/CreateDealAdvertiserPermissionsRequestBody"}}},"required":true},"responses":{"201":{"description":"CreateDealAdvertiserPermissionsDspDeals 201 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspBadRequestExceptionV1ResponseContent"}}},"description":"DspBadRequestExceptionV1 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspUnauthorizedExceptionV1ResponseContent"}}},"description":"DspUnauthorizedExceptionV1 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspForbiddenExceptionV1ResponseContent"}}},"description":"DspForbiddenExceptionV1 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspNotFoundExceptionV1ResponseContent"}}},"description":"DspNotFoundExceptionV1 404 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspInternalServerExceptionV1ResponseContent"}}},"description":"DspInternalServerExceptionV1 500 response"}},"tags":["Deal Advertiser Permissions"]}},"/dsp/inventory/deals/{dealId}/advertiserPermissions/advertiserList":{"get":{"description":"Gets list of advertisers assigned to the deal and its advertiser permissions strategy type.\n\n**Requires one of these permissions**:\n[]","operationId":"GetAdvertiserListDspDeals","parameters":[{"description":"Amazon assigned ID unique to each Deal.","in":"path","name":"dealId","required":true,"schema":{"description":"Amazon assigned ID unique to each Deal.","type":"string"}},{"description":"Used for pagination, a string that can be sent in the next request to get the next page of results.","in":"query","name":"nextToken","schema":{"description":"Used for pagination, a string that can be sent in the next request to get the next page of results.","type":"string"}},{"description":"\t\tSets the maximum number of results in the returned collection. Used in conjunction with \u0027nextToken\u0027 to \t\tcontrol pagination. Values less than 1 are considered invalid and will result in an error response.","in":"query","name":"pageSize","schema":{"description":"Sets the maximum number of results in the returned collection. Used in conjunction with \u0027nextToken\u0027 to \t\tcontrol pagination. Values less than 1 are considered invalid and will result in an error response.","minimum":1,"type":"number"}},{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input. For DSP profiles, the `type` field of the `accountInfo` object must be set to `agency` and the `subType` field must not be `AMAZON_ATTRIBUTION`.","in":"header","name":"Amazon-Advertising-API-Scope","required":true,"schema":{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input. For DSP profiles, the `type` field of the `accountInfo` object must be set to `agency` and the `subType` field must not be `AMAZON_ATTRIBUTION`.","type":"string"}}],"responses":{"200":{"content":{"application/vnd.dspAdvertiserListResource.v1+json":{"schema":{"$ref":"#/components/schemas/GetAdvertiserListDspDealsResponseContent"}}},"description":"GetAdvertiserListDspDeals 200 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspBadRequestExceptionV1ResponseContent"}}},"description":"DspBadRequestExceptionV1 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspUnauthorizedExceptionV1ResponseContent"}}},"description":"DspUnauthorizedExceptionV1 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspForbiddenExceptionV1ResponseContent"}}},"description":"DspForbiddenExceptionV1 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspNotFoundExceptionV1ResponseContent"}}},"description":"DspNotFoundExceptionV1 404 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspInternalServerExceptionV1ResponseContent"}}},"description":"DspInternalServerExceptionV1 500 response"}},"tags":["Deal Advertiser Permissions"]},"put":{"description":"Update Advertiser Permissions by adding advertisers to, or removing advertisers from, the advertiser permission list in the existing permission strategy.\n\n**Requires one of these permissions**:\n[]","operationId":"UpdateAdvertiserListDspDeals","parameters":[{"description":"Amazon assigned ID unique to each Deal.","in":"path","name":"dealId","required":true,"schema":{"description":"Amazon assigned ID unique to each Deal.","type":"string"}},{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input. For DSP profiles, the `type` field of the `accountInfo` object must be set to `agency` and the `subType` field must not be `AMAZON_ATTRIBUTION`.","in":"header","name":"Amazon-Advertising-API-Scope","required":true,"schema":{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input. For DSP profiles, the `type` field of the `accountInfo` object must be set to `agency` and the `subType` field must not be `AMAZON_ATTRIBUTION`.","type":"string"}}],"requestBody":{"content":{"application/vnd.dspAdvertiserListResource.v1+json":{"schema":{"$ref":"#/components/schemas/UpdateAdvertiserListRequestBody"}}},"required":true},"responses":{"207":{"content":{"application/vnd.dspAdvertiserListResource.v1+json":{"schema":{"$ref":"#/components/schemas/UpdateAdvertiserListDspDealsResponseContent"}}},"description":"UpdateAdvertiserListDspDeals 207 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspBadRequestExceptionV1ResponseContent"}}},"description":"DspBadRequestExceptionV1 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspUnauthorizedExceptionV1ResponseContent"}}},"description":"DspUnauthorizedExceptionV1 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspForbiddenExceptionV1ResponseContent"}}},"description":"DspForbiddenExceptionV1 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspNotFoundExceptionV1ResponseContent"}}},"description":"DspNotFoundExceptionV1 404 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspInternalServerExceptionV1ResponseContent"}}},"description":"DspInternalServerExceptionV1 500 response"}},"tags":["Deal Advertiser Permissions"]}},"/dsp/inventory/deals/{dealId}/advertiserPermissions/recommendedAdvertiser/list":{"post":{"description":"Gets list of recommended advertisers for a given single deal.\n\n**Requires one of these permissions**:\n[]","operationId":"ListRecommendedAdvertiserDspDeals","parameters":[{"description":"Amazon assigned ID unique to each Deal.","in":"path","name":"dealId","required":true,"schema":{"description":"Amazon assigned ID unique to each Deal.","type":"string"}},{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input. For DSP profiles, the `type` field of the `accountInfo` object must be set to `agency` and the `subType` field must not be `AMAZON_ATTRIBUTION`.","in":"header","name":"Amazon-Advertising-API-Scope","required":true,"schema":{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input. For DSP profiles, the `type` field of the `accountInfo` object must be set to `agency` and the `subType` field must not be `AMAZON_ATTRIBUTION`.","type":"string"}}],"requestBody":{"content":{"application/vnd.dspDealRecommendedAdvertiser.v1+json":{"schema":{"$ref":"#/components/schemas/ListRecommendedAdvertiserDspDealsRequestContent"}}}},"responses":{"200":{"content":{"application/vnd.dspDealRecommendedAdvertiser.v1+json":{"schema":{"$ref":"#/components/schemas/ListRecommendedAdvertiserDspDealsResponseContent"}}},"description":"ListRecommendedAdvertiserDspDeals 200 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspBadRequestExceptionV1ResponseContent"}}},"description":"DspBadRequestExceptionV1 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspUnauthorizedExceptionV1ResponseContent"}}},"description":"DspUnauthorizedExceptionV1 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspForbiddenExceptionV1ResponseContent"}}},"description":"DspForbiddenExceptionV1 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspNotFoundExceptionV1ResponseContent"}}},"description":"DspNotFoundExceptionV1 404 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspInternalServerExceptionV1ResponseContent"}}},"description":"DspInternalServerExceptionV1 500 response"}},"tags":["Deal Advertiser Permissions"]}},"/dsp/inventory/deals/{dealId}/advertiserPermissions/recommendedAdvertisers":{"delete":{"description":"Deletes the list of recommended Advertisers for a given single deal.\n\n**Requires one of these permissions**:\n[]","operationId":"DeleteRecommendedAdvertiserListDspDeals","parameters":[{"description":"Amazon assigned ID unique to each Deal.","in":"path","name":"dealId","required":true,"schema":{"description":"Amazon assigned ID unique to each Deal.","type":"string"}},{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input. For DSP profiles, the `type` field of the `accountInfo` object must be set to `agency` and the `subType` field must not be `AMAZON_ATTRIBUTION`.","in":"header","name":"Amazon-Advertising-API-Scope","required":true,"schema":{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input. For DSP profiles, the `type` field of the `accountInfo` object must be set to `agency` and the `subType` field must not be `AMAZON_ATTRIBUTION`.","type":"string"}}],"responses":{"200":{"description":"DeleteRecommendedAdvertiserListDspDeals 200 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspBadRequestExceptionV1ResponseContent"}}},"description":"DspBadRequestExceptionV1 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspUnauthorizedExceptionV1ResponseContent"}}},"description":"DspUnauthorizedExceptionV1 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspForbiddenExceptionV1ResponseContent"}}},"description":"DspForbiddenExceptionV1 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspNotFoundExceptionV1ResponseContent"}}},"description":"DspNotFoundExceptionV1 404 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspInternalServerExceptionV1ResponseContent"}}},"description":"DspInternalServerExceptionV1 500 response"}},"tags":["Deal Advertiser Permissions"]},"put":{"description":"Update Recommended Advertiser Permissions by adding advertisers to, or removing advertisers from, the advertiser permission list for given single deal.\n\n**Requires one of these permissions**:\n[]","operationId":"UpdateRecommendedAdvertiserListDspDeals","parameters":[{"description":"Amazon assigned ID unique to each Deal.","in":"path","name":"dealId","required":true,"schema":{"description":"Amazon assigned ID unique to each Deal.","type":"string"}},{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input. For DSP profiles, the `type` field of the `accountInfo` object must be set to `agency` and the `subType` field must not be `AMAZON_ATTRIBUTION`.","in":"header","name":"Amazon-Advertising-API-Scope","required":true,"schema":{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input. For DSP profiles, the `type` field of the `accountInfo` object must be set to `agency` and the `subType` field must not be `AMAZON_ATTRIBUTION`.","type":"string"}}],"requestBody":{"content":{"application/vnd.dspDealRecommendedAdvertiser.v1+json":{"schema":{"$ref":"#/components/schemas/UpdateRecommendedAdvertiserListRequestBody"}}},"required":true},"responses":{"207":{"content":{"application/vnd.dspDealRecommendedAdvertiser.v1+json":{"schema":{"$ref":"#/components/schemas/UpdateRecommendedAdvertiserListDspDealsResponseContent"}}},"description":"UpdateRecommendedAdvertiserListDspDeals 207 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspBadRequestExceptionV1ResponseContent"}}},"description":"DspBadRequestExceptionV1 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspUnauthorizedExceptionV1ResponseContent"}}},"description":"DspUnauthorizedExceptionV1 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspForbiddenExceptionV1ResponseContent"}}},"description":"DspForbiddenExceptionV1 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspNotFoundExceptionV1ResponseContent"}}},"description":"DspNotFoundExceptionV1 404 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DspInternalServerExceptionV1ResponseContent"}}},"description":"DspInternalServerExceptionV1 500 response"}},"tags":["Deal Advertiser Permissions"]}}}}