{"openapi":"3.1.1","paths":{"/api/v1/spec/datadoe_api.md":{"get":{"operationId":"SpecificationController_getDatadoeMd","parameters":[],"responses":{"200":{"description":"Download markdown file with agent instructions."},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Agent Instructions"]}},"/api/v1/spec/data-scheme":{"get":{"operationId":"SpecificationController_getDataScheme","parameters":[{"name":"query","required":false,"in":"query","description":"Optional full-text search query across source names, table names, descriptions, and columns.","schema":{"nullable":true,"example":"order items","type":"string"}},{"name":"sourceType","required":false,"in":"query","description":"Optional connection type filter. Omit it to return every source type.","schema":{"nullable":true,"example":"SELLER_CENTRAL","type":"string","enum":["SELLER_CENTRAL","VENDOR_CENTRAL","AMAZON_ADS"]}},{"name":"containsPii","required":false,"in":"query","description":"Optional filter for tables that contain personally identifiable information (PII).","schema":{"nullable":true,"example":true,"type":"boolean"}}],"responses":{"200":{"description":"Get searchable DataDoe data scheme with a recommended sources list. Sources can include dataAvailability with intraday or real-time update details.","schema":{"$ref":"#/components/schemas/ExportSourcesResponse"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportSourcesResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Agent Instructions"]}},"/api/v1/spec/webhook-scheme":{"get":{"operationId":"SpecificationController_getWebhookScheme","parameters":[],"responses":{"200":{"description":"Get the full DataDoe webhook scheme, including message summaries and details."},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Agent Instructions"]}},"/api/v1/exports":{"post":{"operationId":"ExportsApiController_createExport","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportRequest"}}}},"responses":{"202":{"description":"Create a new export request.","schema":{"$ref":"#/components/schemas/ExportResponse"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Exports"]},"get":{"operationId":"ExportsApiController_listExports","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}},{"name":"exportIds","required":false,"in":"query","description":"Optional list of export IDs to filter by. If not provided, returns paginated exports.","schema":{"nullable":true,"example":["1a2b3c4d-5678-90ab-cdef-112233445566","2b3c4d5e-6789-01bc-def0-223344556677"],"type":"array","items":{"type":"string"}}},{"name":"page","required":false,"in":"query","description":"Page number for paginated export listing","schema":{"minimum":1,"default":1,"type":"number"}},{"name":"pageSize","required":false,"in":"query","description":"Number of exports per page","schema":{"minimum":1,"maximum":25,"default":25,"type":"number"}}],"responses":{"200":{"description":"Fetch exports by a list of IDs or the most recent paginated exports.","schema":{"$ref":"#/components/schemas/ExportsResponse"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportsResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Exports"]}},"/api/v1/exports/schedules":{"get":{"operationId":"ExportsApiController_listSchedules","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}},{"name":"active","required":false,"in":"query","description":"Filter schedules by their active state","schema":{"nullable":false,"type":"boolean"}}],"responses":{"200":{"description":"Fetch API-created export schedules.","schema":{"$ref":"#/components/schemas/ExportSchedulesResponse"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportSchedulesResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Exports"]},"post":{"operationId":"ExportsApiController_createSchedule","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportScheduleRequest"}}}},"responses":{"201":{"description":"Create a new API export schedule.","schema":{"$ref":"#/components/schemas/ExportScheduleWithIntegrationsResponse"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportScheduleWithIntegrationsResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Exports"]}},"/api/v1/exports/schedules/{scheduleId}":{"get":{"operationId":"ExportsApiController_getSchedule","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}},{"name":"scheduleId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Fetch API-created export schedule by ID.","schema":{"$ref":"#/components/schemas/ExportScheduleWithIntegrationsResponse"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportScheduleWithIntegrationsResponse"}}}},"404":{"description":"Export schedule not found or not accessible for this organization.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNotFoundResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Exports"]},"put":{"operationId":"ExportsApiController_updateSchedule","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}},{"name":"scheduleId","required":true,"in":"path","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportScheduleRequest"}}}},"responses":{"200":{"description":"Update an API export schedule.","schema":{"$ref":"#/components/schemas/ExportScheduleWithIntegrationsResponse"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportScheduleWithIntegrationsResponse"}}}},"404":{"description":"Export schedule not found or not accessible for this organization.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNotFoundResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Exports"]},"delete":{"operationId":"ExportsApiController_deleteSchedule","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}},{"name":"scheduleId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Delete an API export schedule."},"404":{"description":"Export schedule not found or not accessible for this organization.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNotFoundResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Exports"]}},"/api/v1/exports/schedules/{scheduleId}/latest":{"get":{"operationId":"ExportsApiController_getLatestScheduleResult","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}},{"name":"scheduleId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Redirect to latest export result for an API-created schedule."},"404":{"description":"Export schedule or latest export result not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNotFoundResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Exports"]}},"/api/v1/exports/{exportId}":{"get":{"operationId":"ExportsApiController_getExport","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}},{"name":"exportId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Fetch a single export by its ID.","schema":{"$ref":"#/components/schemas/ExportResponse"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportResponse"}}}},"402":{"description":"Your organization has no AI Tokens left. Visit the organization page to increase your spending limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNoTokensResponse"}}}},"404":{"description":"Export not found or not accessible for this organization.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNotFoundResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Exports"]},"delete":{"operationId":"ExportsApiController_deleteExport","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}},{"name":"exportId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Delete an export by its ID."},"404":{"description":"Export not found or not accessible for this organization.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNotFoundResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Exports"]}},"/api/v1/exports/sources":{"get":{"operationId":"ExportsApiController_getSources","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}},{"name":"sellerOrVendorIds","required":true,"in":"query","description":"Seller or vendor identifiers for the report","schema":{"nullable":false,"example":["1a2b3c4d-5678-90ab-cdef-112233445566"],"type":"array","items":{"type":"string"}}},{"name":"query","required":false,"in":"query","description":"Optional full-text search query across source names, table names, descriptions, and columns.","schema":{"nullable":true,"example":"order items","type":"string"}},{"name":"sourceType","required":false,"in":"query","description":"Optional connection type filter. Omit it to return every source type.","schema":{"nullable":true,"example":"SELLER_CENTRAL","type":"string","enum":["SELLER_CENTRAL","VENDOR_CENTRAL","AMAZON_ADS"]}},{"name":"containsPii","required":false,"in":"query","description":"Optional filter for tables that contain personally identifiable information (PII).","schema":{"nullable":true,"example":true,"type":"boolean"}},{"name":"enabled","required":false,"in":"query","description":"Optional filter for organization-enabled export sources. Omit to return both enabled and disabled sources.","schema":{"nullable":true,"example":true,"type":"boolean"}}],"responses":{"200":{"description":"Search export sources available for given sellers or vendors.","schema":{"$ref":"#/components/schemas/ExportSourcesResponse"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportSourcesResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Exports"]}},"/api/v1/exports/{exportId}/raw":{"get":{"operationId":"ExportsApiController_getRawExport","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}},{"name":"exportId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Export is still processing and the raw file is not yet available."},"302":{"description":"Redirect to raw export file URL.","headers":{"Location":{"description":"URL to the raw export file.","schema":{"type":"string","format":"uri"}}}},"404":{"description":"Export or raw file not found for this organization.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNotFoundResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Exports"]}},"/api/v1/util/sellers-and-vendors/invite":{"post":{"operationId":"UtilityApiController_createPublicInvitation","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePublicInvitationRequest"}}}},"responses":{"201":{"description":"Create a public Seller or Vendor invitation link.","schema":{"$ref":"#/components/schemas/CreatePublicInvitationResponse"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePublicInvitationResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Utility"]}},"/api/v1/util/organization":{"get":{"operationId":"UtilityApiController_getOrganization","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Organization utility information.","schema":{"$ref":"#/components/schemas/UtilityOrganizationResponseDto"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UtilityOrganizationResponseDto"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Utility"]}},"/api/v1/util/sellers-and-vendors":{"get":{"operationId":"UtilityApiController_getSellersAndVendors","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}},{"name":"page","required":false,"in":"query","schema":{"minimum":1,"nullable":true,"default":1,"type":"number"}},{"name":"pageSize","required":false,"in":"query","schema":{"minimum":1,"maximum":100,"nullable":true,"default":100,"type":"number"}},{"name":"query","required":false,"in":"query","description":"Case-insensitive substring search on seller and vendor names.","schema":{"maxLength":256,"nullable":true,"type":"string"}},{"name":"marketplaceCountryCode","required":false,"in":"query","description":"Two-letter marketplace country code (e.g. US, PL).","schema":{"minLength":2,"maxLength":2,"nullable":true,"example":"US","type":"string"}}],"responses":{"200":{"description":"Paginated sellers and vendors connected to the organization.","schema":{"$ref":"#/components/schemas/SellersAndVendorsResponseDto"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SellersAndVendorsResponseDto"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Utility"]}},"/api/v1/files":{"post":{"operationId":"FilesApiController_create","parameters":[{"name":"datadoe-api-key","in":"header","description":"DataDoe REST API key. Use the `datadoe-api-key` header (not `X-Api-Key` or `Authorization`).","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDataFileRequest"}}}},"responses":{"201":{"description":"Create a new data file and receive an upload URL.","schema":{"$ref":"#/components/schemas/DataFileCreateResponse"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataFileCreateResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Files"]},"get":{"operationId":"FilesApiController_list","parameters":[{"name":"datadoe-api-key","in":"header","description":"DataDoe REST API key. Use the `datadoe-api-key` header (not `X-Api-Key` or `Authorization`).","required":true,"schema":{"type":"string"}},{"name":"group","required":false,"in":"query","schema":{"type":"string","enum":["LISTING_IMAGES","APLUS_IMAGES"]}},{"name":"page","required":false,"in":"query","schema":{"minimum":1,"default":1,"type":"number"}},{"name":"pageSize","required":false,"in":"query","schema":{"minimum":1,"maximum":100,"default":25,"type":"number"}},{"name":"query","required":false,"in":"query","schema":{"type":"string"}},{"name":"statuses","required":false,"in":"query","schema":{"type":"array","items":{"type":"string","enum":["WAITING_FOR_UPLOAD","UPLOADED","EXPIRED","DELETED"]}}},{"name":"types","required":false,"in":"query","schema":{"type":"array","items":{"type":"string","enum":["PNG","TIFF","JPG"]}}},{"name":"sources","required":false,"in":"query","schema":{"type":"array","items":{"type":"string","enum":["API","MCP","DATA","UI"]}}},{"name":"sellerOrVendorIds","required":false,"in":"query","schema":{"type":"array","items":{"type":"string"}}}],"responses":{"200":{"description":"List data files.","schema":{"$ref":"#/components/schemas/DataFilesResponse"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataFilesResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Files"]}},"/api/v1/files/{fileId}":{"get":{"operationId":"FilesApiController_getById","parameters":[{"name":"datadoe-api-key","in":"header","description":"DataDoe REST API key. Use the `datadoe-api-key` header (not `X-Api-Key` or `Authorization`).","required":true,"schema":{"type":"string"}},{"name":"fileId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Get data file details.","schema":{"$ref":"#/components/schemas/DataFileResponse"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataFileResponse"}}}},"404":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNotFoundResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Files"]},"delete":{"operationId":"FilesApiController_delete","parameters":[{"name":"datadoe-api-key","in":"header","description":"DataDoe REST API key. Use the `datadoe-api-key` header (not `X-Api-Key` or `Authorization`).","required":true,"schema":{"type":"string"}},{"name":"fileId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"204":{"description":"Delete data file."},"404":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNotFoundResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Files"]}},"/api/v1/files/{fileId}/download":{"get":{"operationId":"FilesApiController_download","parameters":[{"name":"datadoe-api-key","in":"header","description":"DataDoe REST API key. Use the `datadoe-api-key` header (not `X-Api-Key` or `Authorization`).","required":true,"schema":{"type":"string"}},{"name":"fileId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"Redirect to file download URL."},"404":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNotFoundResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Files"]}},"/api/v1/actions":{"post":{"operationId":"ActionsApiController_startAction","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string","$ref":"#/components/schemas/ActionRequest"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionRequest"}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionStartResponse"}}}},"202":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionStartResponse"}}}},"400":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiBadRequestResponse"}}}},"402":{"description":"Your organization has no AI Tokens left. Visit the organization page to increase your spending limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNoTokensResponse"}}}},"404":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNotFoundResponse"}}}},"412":{"description":"Action execution is disabled for this organization. Ask an organization owner to enable it in DataDoe Settings > Actions or contact support."},"429":{"description":"Live action limit exceeded. Too many actions are currently pending, in progress, or waiting for external processing. Combine multiple operations into a single action request when possible.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiLiveActionLimitResponse"}}}},"501":{"description":"Actions are available in private beta only. You can sign up for it at contact@datadoe.com."},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Actions"]},"get":{"operationId":"ActionsApiController_listActions","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string","$ref":"#/components/schemas/ActionRequest"}},{"name":"page","required":false,"in":"query","schema":{"minimum":1,"nullable":true,"default":1,"type":"number"}},{"name":"pageSize","required":false,"in":"query","schema":{"minimum":1,"maximum":100,"nullable":true,"default":20,"type":"number"}},{"name":"statuses","required":false,"in":"query","description":"Filter by action status.","schema":{"maxItems":16,"nullable":true,"type":"array","items":{"type":"string","enum":["PENDING","IN_PROGRESS","WAITING_EXTERNAL_PROCESSING","COMPLETED","PARTIALLY_COMPLETED","COMPLETED_WITH_ISSUES","ERROR","BLOCKED_NO_TOKENS","BLOCKED_INVALID_INPUT","VALIDATED","CANCELED"]}}},{"name":"types","required":false,"in":"query","description":"Filter by action type.","schema":{"maxItems":16,"nullable":true,"type":"array","items":{"type":"string","enum":["AMAZON_LISTINGS_UPDATE","AMAZON_LISTINGS_DETAILS_UPDATE","AMAZON_LISTINGS_CREATE","AMAZON_LISTINGS_FIND","AMAZON_LISTINGS_FEES_ESTIMATE","AMAZON_LISTINGS_FEATURED_PRICE_ESTIMATE","AMAZON_LISTINGS_COMPETITIVE_SUMMARY_FIND","AMAZON_LISTINGS_PRODUCT_TYPES_FIND","AMAZON_LISTINGS_PRODUCT_TYPE_SUGGEST","AMAZON_LISTINGS_PRODUCT_TYPE_DEFINITION_FIND","AMAZON_ORDERS_CANCEL","AMAZON_ORDERS_CONFIRM_SHIPMENT","AMAZON_ORDERS_SOLICITATION_FEEDBACK_SEND","AMAZON_FBA_REMOVAL_ORDERS_ADD","AMAZON_APLUS_CONTENT_ADD","AMAZON_APLUS_CONTENT_UPDATE","AMAZON_APLUS_CONTENT_FIND","AMAZON_APLUS_CONTENT_ASINS_UPDATE","AMAZON_APLUS_CONTENT_ASINS_FIND","AMAZON_APLUS_CONTENT_VALIDATE","AMAZON_APLUS_CONTENT_PUBLISH","AMAZON_APLUS_CONTENT_SUSPEND","AMAZON_APLUS_CONTENT_PUBLISH_RECORDS_FIND","AMAZON_ADS_CAMPAIGNS_ADD","AMAZON_ADS_CAMPAIGNS_REMOVE","AMAZON_ADS_CAMPAIGNS_UPDATE","AMAZON_ADS_AD_GROUPS_ADD","AMAZON_ADS_AD_GROUPS_REMOVE","AMAZON_ADS_AD_GROUPS_UPDATE","AMAZON_ADS_TARGETS_ADD","AMAZON_ADS_TARGETS_REMOVE","AMAZON_ADS_TARGETS_UPDATE","AMAZON_ADS_ADS_ADD","AMAZON_ADS_ADS_REMOVE","AMAZON_ADS_ADS_UPDATE","AMAZON_ADS_AD_ASSOCIATIONS_ADD","AMAZON_ADS_AD_ASSOCIATIONS_REMOVE","AMAZON_ADS_AD_ASSOCIATIONS_UPDATE","AMAZON_ADS_CAMPAIGNS_FIND","AMAZON_ADS_AD_GROUPS_FIND","AMAZON_ADS_TARGETS_FIND","AMAZON_ADS_ADS_FIND","AMAZON_ADS_AD_ASSOCIATIONS_FIND","AMAZON_ADS_PORTFOLIOS_ADD","AMAZON_ADS_PORTFOLIOS_UPDATE","AMAZON_ADS_PORTFOLIOS_FIND","AMAZON_ADS_SP_BID_RECOMMENDATIONS_FIND","AMAZON_ADS_SP_TARGET_RECOMMENDATIONS_FIND","AMAZON_MCF_ORDERS_ADD","AMAZON_MCF_ORDERS_UPDATE","AMAZON_MCF_ORDERS_FIND","AMAZON_MCF_ORDERS_CANCEL","AMAZON_MCF_ORDERS_PREVIEW","AMAZON_MCF_DELIVERY_OFFERS_PREVIEW","AMAZON_MCF_FEATURES_MARKETPLACE_FIND","AMAZON_MCF_FEATURES_SKU_FIND"]}}},{"name":"creators","required":false,"in":"query","description":"Filter by action creator.","schema":{"maxItems":8,"nullable":true,"type":"array","items":{"type":"string","enum":["API","MCP","SYSTEM"]}}},{"name":"createdAtFrom","required":false,"in":"query","schema":{"format":"date-time","nullable":true,"type":"string"}},{"name":"createdAtTo","required":false,"in":"query","schema":{"format":"date-time","nullable":true,"type":"string"}},{"name":"updatedAtFrom","required":false,"in":"query","schema":{"format":"date-time","nullable":true,"type":"string"}},{"name":"updatedAtTo","required":false,"in":"query","schema":{"format":"date-time","nullable":true,"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionHistoryResponse"}}}},"400":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiBadRequestResponse"}}}},"402":{"description":"Your organization has no AI Tokens left. Visit the organization page to increase your spending limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNoTokensResponse"}}}},"404":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNotFoundResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"501":{"description":"Actions are available in private beta only. You can sign up for it at contact@datadoe.com."},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Actions"]}},"/api/v1/actions/{actionId}":{"get":{"operationId":"ActionsApiController_getAction","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string","$ref":"#/components/schemas/ActionRequest"}},{"name":"actionId","required":true,"in":"path","schema":{"format":"uuid","nullable":false,"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionStatusResponse"}}}},"402":{"description":"Your organization has no AI Tokens left. Visit the organization page to increase your spending limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNoTokensResponse"}}}},"404":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNotFoundResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"501":{"description":"Actions are available in private beta only. You can sign up for it at contact@datadoe.com."},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Actions"]}},"/api/v1/cogs":{"post":{"operationId":"CogsApiController_upsertCogs","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CogsUpsertRequest"}}}},"responses":{"200":{"description":"Upsert COGS rows for a seller or vendor.","schema":{"$ref":"#/components/schemas/CogsUpsertResponse"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CogsUpsertResponse"}}}},"402":{"description":"Your organization has no AI Tokens left. Visit the organization page to increase your spending limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNoTokensResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Cogs"]},"delete":{"operationId":"CogsApiController_deleteCogs","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}},{"name":"sellerOrVendorId","required":true,"in":"query","description":"The ID of the seller or vendor to delete COGS for.","schema":{"nullable":false,"type":"string"}},{"name":"from","required":false,"in":"query","description":"Optional inclusive start date filter.","schema":{"format":"date","nullable":true,"type":"string"}},{"name":"to","required":false,"in":"query","description":"Optional inclusive end date filter.","schema":{"format":"date","nullable":true,"type":"string"}},{"name":"sku","required":false,"in":"query","description":"Optional SKU filter.","schema":{"nullable":true,"type":"string"}},{"name":"asin","required":false,"in":"query","description":"Optional ASIN filter.","schema":{"nullable":true,"type":"string"}}],"responses":{"204":{"description":"Delete COGS rows matching the given filters."},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Cogs"]}},"/api/v1/vendor-codes":{"post":{"operationId":"VendorCodesApiController_upsertVendorCodes","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VendorCodeUpsertRequest"}}}},"responses":{"200":{"description":"Upsert Vendor Code rows for a seller or vendor.","schema":{"$ref":"#/components/schemas/VendorCodeUpsertResponse"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VendorCodeUpsertResponse"}}}},"402":{"description":"Your organization has no AI Tokens left. Visit the organization page to increase your spending limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiNoTokensResponse"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Vendor Codes"]},"delete":{"operationId":"VendorCodesApiController_deleteVendorCodes","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}},{"name":"sellerOrVendorId","required":true,"in":"query","description":"The ID of the seller or vendor to delete Vendor Codes for.","schema":{"nullable":false,"type":"string"}},{"name":"sku","required":false,"in":"query","description":"Optional SKU filter.","schema":{"nullable":true,"type":"string"}},{"name":"asin","required":false,"in":"query","description":"Optional ASIN filter.","schema":{"nullable":true,"type":"string"}}],"responses":{"204":{"description":"Delete Vendor Code rows matching the given filters."},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Vendor Codes"]}},"/api/v1/usage-logs":{"get":{"operationId":"UsageLogsApiController_list","parameters":[{"name":"datadoe-api-key","in":"header","description":"API key for the organization","required":true,"schema":{"type":"string"}},{"name":"page","required":false,"in":"query","schema":{"minimum":1,"default":1,"type":"number"}},{"name":"pageSize","required":false,"in":"query","schema":{"minimum":1,"maximum":100,"default":100,"type":"number"}},{"name":"usedAtFrom","required":false,"in":"query","schema":{"format":"date-time","type":"string"}},{"name":"usedAtTo","required":false,"in":"query","schema":{"format":"date-time","type":"string"}},{"name":"usageTypes","required":false,"in":"query","schema":{"type":"array","items":{"type":"string","enum":["EXPORTS","AI","INTEGRATIONS_BIGQUERY","INTEGRATIONS_API","ACTIONS","COGS","VENDOR_CODE","PLUGINS","INTEGRATIONS","TOKENS","ORGANIZATION","CONNECTIONS","SETTINGS"]}}},{"name":"usagePools","required":false,"in":"query","schema":{"type":"array","items":{"type":"string","enum":["FREE","CREDIT","PLAN","BUNDLE","EXTRA"]}}},{"name":"specificUsageTypes","required":false,"in":"query","schema":{"type":"array","items":{"type":"string","enum":["AI_CHAT_STANDARD_MODE","AI_CHAT_ANALYST_MODE","AI_CHAT_INVESTIGATION_MODE","AI_SCHEDULED_PROMPT_STANDARD_MODE","AI_SCHEDULED_PROMPT_ANALYST_MODE","AI_API_PROMPT_STANDARD_MODE","AI_API_PROMPT_ANALYST_MODE","AI_MCP_PROMPT_STANDARD_MODE","AI_MCP_PROMPT_ANALYST_MODE","INTEGRATIONS_API_SP_API_PROXY_STANDARD","INTEGRATIONS_API_ADS_API_PROXY_STANDARD","INTEGRATIONS_WEBHOOKS_STANDARD","INTEGRATIONS_BIGQUERY_RAW","INTEGRATIONS_BIGQUERY_INTEGRATED","ACTIONS_API_STANDARD","ACTIONS_MCP_STANDARD","EXPORTS_UI_STANDARD","EXPORTS_EXPLORER_STANDARD","EXPORTS_API_STANDARD","EXPORTS_MCP_STANDARD","EXPORTS_HOME_STANDARD","EXPORTS_AUTOMATION_STANDARD","EXPORTS_REPORTS_STANDARD","EXPORTS_RECURRING_STANDARD","COGS_API_STANDARD","COGS_MCP_STANDARD","VENDOR_CODE_API_STANDARD","VENDOR_CODE_MCP_STANDARD","PLUGINS_GET","PLUGINS_CREATE","PLUGINS_EDIT","PLUGINS_ENABLE","PLUGINS_DISABLE","PLUGINS_SKILLS_GET","EXPORTS_API_GET","EXPORTS_API_LIST","EXPORTS_MCP_GET","ACTIONS_API_GET","ACTIONS_API_LIST","ACTIONS_MCP_GET","ACTIONS_MCP_LIST","INTEGRATIONS_API_KEY_CREATE","INTEGRATIONS_MCP_KEY_CREATE","INTEGRATIONS_OAUTH_AUTHORIZE","INTEGRATIONS_WEBHOOK_CREATE","INTEGRATIONS_WEBHOOK_REMOVE","TOKENS_BUNDLE_PURCHASE","TOKENS_BUNDLE_EXHAUSTION","TOKENS_BUNDLE_EXPIRATION","ORGANIZATION_SPENDING_LIMIT_CHANGE","ORGANIZATION_USER_ADD","ORGANIZATION_USER_REMOVE","CONNECTIONS_SELLER_OR_VENDOR_ADD","CONNECTIONS_SELLER_OR_VENDOR_REMOVE","CONNECTIONS_CONNECTION_ADD","CONNECTIONS_CONNECTION_REMOVE","SETTINGS_TABLE_ENABLE","SETTINGS_TABLE_DISABLE","SETTINGS_ACTION_TYPE_ENABLE","SETTINGS_ACTION_TYPE_DISABLE"]}}}],"responses":{"200":{"description":"Paginated usage logs for the current organization.","schema":{"$ref":"#/components/schemas/UsageLogsResponseDto"},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageLogsResponseDto"}}}},"429":{"description":"Rate limit exceeded. Maximum is 2 requests per second per organization. Header Retry-After contains retry delay in seconds.","headers":{"Retry-After":{"description":"Number of seconds to wait before retrying request.","schema":{"type":"string","example":"1"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiRateLimitResponse"}}}},"default":{"headers":{"datadoe-api-request-id":{"description":"Unique request ID generated by the server. Add it to your error reports to help us investigate the issue.","required":true,"schema":{"type":"string","format":"uuid"},"example":"123e4567-e89b-12d3-a456-426614174000"}}}},"tags":["Usage Logs"]}}},"info":{"title":"DataDoe REST API","description":"<!-- AI agents: jump to \"## Use with AI agents\" below and follow the required first step. -->\n\n\n## Introduction\n\nThis REST API is used to interact with the [DataDoe](https://app.datadoe.com) platform. It is the main interface for building integrations and automations.\n\n## Authorization\n\nAll requests must be authenticated using the `datadoe-api-key` header. The key can be generated in the [DataDoe REST API Integration dashboard](https://app.datadoe.com/integrations/rest-api). The key is a secret and should be kept confidential.\n\nThe exceptions to this rule are the specification endpoints: this document (`/api/v1/docs`), the JSON version of this document (`/api/v1/docs/json`), and the _Agent Instructions_ endpoints, which are publicly available to help you understand DataDoe and its capabilities.\n\n## Rate limiting\n\nIntegration endpoints are rate-limited to **2 requests per second per organization**.\n\nWhen the limit is exceeded, the API responds with `HTTP 429` and `Retry-After: 1`.\n\nThe documentation/specification endpoints are excluded from rate limiting: `/api/v1/docs`, `/api/v1/docs/json`, `/api/v1/spec/datadoe_api.md`, `/api/v1/spec/data-scheme`, and `/api/v1/spec/webhook-scheme`.\n\n## Traceability\n\nAll responses contain a `datadoe-api-request-id` header that can be used to trace the request through the system. Add it to your error reports to help us investigate the issue.\n\n## Use with AI agents\n\n**Required first step (before calling any endpoint other than documentation/spec endpoints):** fetch `GET /api/v1/spec/datadoe_api.md` and follow its instructions.\n\nDo **not** call any other DataDoe API endpoints until you have successfully retrieved and read `datadoe_api.md`. If you cannot access it, stop and request the missing access/context.\n\n## Other Integrations\n\nDataDoe also provides an MCP integration for AI agents. An MCP key can be generated in the [DataDoe MCP Integration dashboard](https://app.datadoe.com/integrations/mcp).\n\n## Questions and Support\n\nFeel free to contact us at [contact@datadoe.com](mailto:contact@datadoe.com) for any questions or support.","version":"0.0.1","contact":{},"termsOfService":"https://www.datadoe.com/terms-of-service"},"tags":[],"servers":[{"url":"https://api.datadoe.com"}],"components":{"schemas":{"ActionAdsAdAssociationsFindResult":{"type":"object","properties":{"adAssociations":{"type":"array","items":{"type":"object"}},"nextToken":{"type":"string"}},"description":"Amazon Ads queryAdAssociation response for AMAZON_ADS_AD_ASSOCIATIONS_FIND actions.","title":"ActionAdsAdAssociationsFindResult"},"ActionAdsAdGroupsFindResult":{"type":"object","properties":{"adGroups":{"type":"array","items":{"type":"object"}},"nextToken":{"type":"string"}},"description":"Amazon Ads queryAdGroup response for AMAZON_ADS_AD_GROUPS_FIND actions.","title":"ActionAdsAdGroupsFindResult"},"ActionAdsAdsFindResult":{"type":"object","properties":{"ads":{"type":"array","items":{"type":"object"}},"nextToken":{"type":"string"}},"description":"Amazon Ads queryAd response for AMAZON_ADS_ADS_FIND actions.","title":"ActionAdsAdsFindResult"},"ActionAdsCampaignsFindResult":{"type":"object","properties":{"campaigns":{"type":"array","items":{"type":"object"}},"nextToken":{"type":"string"}},"description":"Amazon Ads queryCampaign response for AMAZON_ADS_CAMPAIGNS_FIND actions.","title":"ActionAdsCampaignsFindResult"},"ActionAdsMutateIssuesResult":{"type":"object","properties":{"status":{"type":"string","enum":["COMPLETED_WITH_ISSUES","PARTIALLY_COMPLETED"],"nullable":false},"message":{"type":"string","nullable":false,"description":"User-friendly summary of item-level Amazon Ads issues."},"successCount":{"type":"number","nullable":false},"partialSuccessCount":{"type":"number","nullable":false},"errorCount":{"type":"number","nullable":false},"totalCount":{"type":"number","nullable":false}},"description":"Summary of partially successful Amazon Ads mutate actions with item-level issue messages.","required":["status","message","successCount","partialSuccessCount","errorCount","totalCount"],"title":"ActionAdsMutateIssuesResult"},"ActionAdsMutateSuccessResult":{"type":"object","properties":{"success":{"type":"array","items":{"type":"object"},"nullable":false},"partialSuccess":{"type":"array","items":{"type":"object"},"nullable":false},"error":{"type":"array","items":{"type":"object"},"nullable":false}},"description":"Amazon Ads mutate response for successfully completed ADD, UPDATE, and REMOVE actions.","required":["success","partialSuccess","error"],"title":"ActionAdsMutateSuccessResult"},"ActionAdsSpRecommendationsFindResult":{"type":"object","properties":{"success":{"type":"array","items":{"type":"object"},"nullable":false,"description":"Successful recommendation items keyed by original request index."},"error":{"type":"array","items":{"type":"object"},"nullable":false,"description":"Failed recommendation items keyed by original request index."}},"description":"Sponsored Products bid or target recommendation response for AMAZON_ADS_SP_BID_RECOMMENDATIONS_FIND and AMAZON_ADS_SP_TARGET_RECOMMENDATIONS_FIND actions.","required":["success","error"],"title":"ActionAdsSpRecommendationsFindResult"},"ActionAdsTargetsFindResult":{"type":"object","properties":{"targets":{"type":"array","items":{"type":"object"}},"nextToken":{"type":"string"},"totalResults":{"type":"number"}},"description":"Amazon Ads queryTarget response for AMAZON_ADS_TARGETS_FIND actions.","title":"ActionAdsTargetsFindResult"},"ActionError":{"type":"object","properties":{},"description":"Error payload when the action failed.","title":"ActionError","additionalProperties":true},"ActionExecutionErrorResult":{"type":"object","properties":{"status":{"type":"string","enum":["ERROR"],"nullable":false},"code":{"type":"string","enum":["AMAZON_ADS_INSUFFICIENT_PERMISSIONS","AMAZON_ADS_MISSING_ADS_ACCOUNT_ID","LISTINGS_CREATE_SCHEMA_VALIDATION_FAILED","LISTINGS_DETAILS_SCHEMA_VALIDATION_FAILED","EXECUTION_FAILED"],"nullable":false},"message":{"type":"string","nullable":false,"description":"User-friendly explanation of why the action failed and what to do next."},"issues":{"type":"array","description":"Attribute-level validation issues for listings schema failures."}},"description":"User-friendly execution error for failed actions.","required":["status","code","message"],"title":"ActionExecutionErrorResult","additionalProperties":true},"ActionHistoryItem":{"type":"object","properties":{"actionId":{"type":"string","format":"uuid","nullable":false},"type":{"type":"string","enum":["AMAZON_LISTINGS_UPDATE","AMAZON_LISTINGS_DETAILS_UPDATE","AMAZON_LISTINGS_CREATE","AMAZON_LISTINGS_FIND","AMAZON_LISTINGS_FEES_ESTIMATE","AMAZON_LISTINGS_FEATURED_PRICE_ESTIMATE","AMAZON_LISTINGS_COMPETITIVE_SUMMARY_FIND","AMAZON_LISTINGS_PRODUCT_TYPES_FIND","AMAZON_LISTINGS_PRODUCT_TYPE_SUGGEST","AMAZON_LISTINGS_PRODUCT_TYPE_DEFINITION_FIND","AMAZON_ORDERS_CANCEL","AMAZON_ORDERS_CONFIRM_SHIPMENT","AMAZON_ORDERS_SOLICITATION_FEEDBACK_SEND","AMAZON_FBA_REMOVAL_ORDERS_ADD","AMAZON_APLUS_CONTENT_ADD","AMAZON_APLUS_CONTENT_UPDATE","AMAZON_APLUS_CONTENT_FIND","AMAZON_APLUS_CONTENT_ASINS_UPDATE","AMAZON_APLUS_CONTENT_ASINS_FIND","AMAZON_APLUS_CONTENT_VALIDATE","AMAZON_APLUS_CONTENT_PUBLISH","AMAZON_APLUS_CONTENT_SUSPEND","AMAZON_APLUS_CONTENT_PUBLISH_RECORDS_FIND","AMAZON_ADS_CAMPAIGNS_ADD","AMAZON_ADS_CAMPAIGNS_REMOVE","AMAZON_ADS_CAMPAIGNS_UPDATE","AMAZON_ADS_AD_GROUPS_ADD","AMAZON_ADS_AD_GROUPS_REMOVE","AMAZON_ADS_AD_GROUPS_UPDATE","AMAZON_ADS_TARGETS_ADD","AMAZON_ADS_TARGETS_REMOVE","AMAZON_ADS_TARGETS_UPDATE","AMAZON_ADS_ADS_ADD","AMAZON_ADS_ADS_REMOVE","AMAZON_ADS_ADS_UPDATE","AMAZON_ADS_AD_ASSOCIATIONS_ADD","AMAZON_ADS_AD_ASSOCIATIONS_REMOVE","AMAZON_ADS_AD_ASSOCIATIONS_UPDATE","AMAZON_ADS_CAMPAIGNS_FIND","AMAZON_ADS_AD_GROUPS_FIND","AMAZON_ADS_TARGETS_FIND","AMAZON_ADS_ADS_FIND","AMAZON_ADS_AD_ASSOCIATIONS_FIND","AMAZON_ADS_PORTFOLIOS_ADD","AMAZON_ADS_PORTFOLIOS_UPDATE","AMAZON_ADS_PORTFOLIOS_FIND","AMAZON_ADS_SP_BID_RECOMMENDATIONS_FIND","AMAZON_ADS_SP_TARGET_RECOMMENDATIONS_FIND","AMAZON_MCF_ORDERS_ADD","AMAZON_MCF_ORDERS_UPDATE","AMAZON_MCF_ORDERS_FIND","AMAZON_MCF_ORDERS_CANCEL","AMAZON_MCF_ORDERS_PREVIEW","AMAZON_MCF_DELIVERY_OFFERS_PREVIEW","AMAZON_MCF_FEATURES_MARKETPLACE_FIND","AMAZON_MCF_FEATURES_SKU_FIND"],"nullable":false},"sellerOrVendorId":{"type":"string","format":"uuid","nullable":false},"status":{"type":"string","enum":["PENDING","IN_PROGRESS","WAITING_EXTERNAL_PROCESSING","COMPLETED","PARTIALLY_COMPLETED","COMPLETED_WITH_ISSUES","ERROR","BLOCKED_NO_TOKENS","BLOCKED_INVALID_INPUT","CANCELED"],"nullable":false},"details":{"nullable":false,"oneOf":[{"$ref":"#/components/schemas/ActionRequestUpdateListingDetails"},{"$ref":"#/components/schemas/ActionRequestListingsDetailsUpdateDetails"},{"$ref":"#/components/schemas/ActionRequestListingsCreateDetails"},{"$ref":"#/components/schemas/ActionRequestListingsFindDetails"},{"$ref":"#/components/schemas/ActionRequestListingsFeesEstimateDetails"},{"$ref":"#/components/schemas/ActionRequestFeaturedPriceEstimateDetails"},{"$ref":"#/components/schemas/ActionRequestCompetitiveSummaryFindDetails"},{"$ref":"#/components/schemas/ActionRequestListingsProductTypesFindDetails"},{"$ref":"#/components/schemas/ActionRequestListingsProductTypeSuggestDetails"},{"$ref":"#/components/schemas/ActionRequestListingsProductTypeDefinitionFindDetails"},{"$ref":"#/components/schemas/ActionRequestOrdersCancelDetails"},{"$ref":"#/components/schemas/ActionRequestOrdersConfirmShipmentDetails"},{"$ref":"#/components/schemas/ActionRequestOrdersSolicitationFeedbackSendDetails"},{"$ref":"#/components/schemas/ActionRequestFbaRemovalOrdersAddDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentAddDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentUpdateDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentFindDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentAsinsUpdateDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentAsinsFindDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentValidateDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentPublishDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentSuspendDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentPublishRecordsFindDetails"},{"$ref":"#/components/schemas/ActionRequestMcfOrdersAddDetails"},{"$ref":"#/components/schemas/ActionRequestMcfOrdersUpdateDetails"},{"$ref":"#/components/schemas/ActionRequestMcfOrdersFindDetails"},{"$ref":"#/components/schemas/ActionRequestMcfOrdersCancelDetails"},{"$ref":"#/components/schemas/ActionRequestMcfOrdersPreviewDetails"},{"$ref":"#/components/schemas/ActionRequestMcfDeliveryOffersPreviewDetails"},{"$ref":"#/components/schemas/ActionRequestMcfFeaturesMarketplaceFindDetails"},{"$ref":"#/components/schemas/ActionRequestMcfFeaturesSkuFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsCampaignDetails"},{"$ref":"#/components/schemas/ActionRequestAdsAdGroupDetails"},{"$ref":"#/components/schemas/ActionRequestAdsTargetDetails"},{"$ref":"#/components/schemas/ActionRequestAdsAdDetails"},{"$ref":"#/components/schemas/ActionRequestAdsAdAssociationDetails"},{"$ref":"#/components/schemas/ActionRequestAdsCampaignFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsAdGroupFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsTargetFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsAdFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsAdAssociationFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsPortfolioDetails"},{"$ref":"#/components/schemas/ActionRequestAdsPortfolioFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsSpBidRecommendationsFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsSpTargetRecommendationsFindDetails"}],"description":"Action-specific details submitted when the action was started."},"result":{"nullable":true,"oneOf":[{"$ref":"#/components/schemas/ActionSpApiFeedResult"},{"$ref":"#/components/schemas/ActionAdsCampaignsFindResult"},{"$ref":"#/components/schemas/ActionAdsAdGroupsFindResult"},{"$ref":"#/components/schemas/ActionAdsTargetsFindResult"},{"$ref":"#/components/schemas/ActionAdsAdsFindResult"},{"$ref":"#/components/schemas/ActionAdsAdAssociationsFindResult"},{"$ref":"#/components/schemas/ActionAdsPortfoliosFindResult"},{"$ref":"#/components/schemas/ActionAdsSpRecommendationsFindResult"},{"$ref":"#/components/schemas/ActionExecutionErrorResult"},{"$ref":"#/components/schemas/ActionAdsMutateIssuesResult"},{"$ref":"#/components/schemas/ActionAdsMutateSuccessResult"}],"description":"Action result. For SP-API feed actions, returns feed status fields when finished. For Ads FIND actions, returns the Amazon Ads query response. For SP bid and target recommendation actions, returns success and error item arrays. For successfully completed Ads mutate actions, returns the Amazon Ads mutate response with created or updated entities. For failed actions, returns a user-friendly execution error. For partially successful Ads mutate actions, returns issue summary with item-level messages. Null for in-progress actions."},"queuedAt":{"format":"date-time","type":"string","nullable":true},"startedAt":{"format":"date-time","type":"string","nullable":true},"completedAt":{"format":"date-time","type":"string","nullable":true},"creator":{"type":"string","enum":["API","MCP","SYSTEM"],"nullable":false},"tokenCost":{"type":"number","nullable":false},"chargedAt":{"format":"date-time","type":"string","nullable":true},"createdAt":{"format":"date-time","type":"string","nullable":false},"updatedAt":{"format":"date-time","type":"string","nullable":false}},"required":["actionId","type","sellerOrVendorId","status","details","result","queuedAt","startedAt","completedAt","creator","tokenCost","chargedAt","createdAt","updatedAt"],"title":"ActionHistoryItem"},"ActionHistoryResponse":{"type":"object","properties":{"data":{"description":"List of actions","type":"array","items":{"$ref":"#/components/schemas/ActionHistoryItem"}},"meta":{"$ref":"#/components/schemas/PaginatedMeta"}},"required":["data","meta"],"title":"ActionHistoryResponse"},"ActionRequest":{"type":"object","properties":{"type":{"type":"string","description":"Action type.","enum":["AMAZON_LISTINGS_UPDATE","AMAZON_LISTINGS_DETAILS_UPDATE","AMAZON_LISTINGS_CREATE","AMAZON_LISTINGS_FIND","AMAZON_LISTINGS_FEES_ESTIMATE","AMAZON_LISTINGS_FEATURED_PRICE_ESTIMATE","AMAZON_LISTINGS_COMPETITIVE_SUMMARY_FIND","AMAZON_LISTINGS_PRODUCT_TYPES_FIND","AMAZON_LISTINGS_PRODUCT_TYPE_SUGGEST","AMAZON_LISTINGS_PRODUCT_TYPE_DEFINITION_FIND","AMAZON_ORDERS_CANCEL","AMAZON_ORDERS_CONFIRM_SHIPMENT","AMAZON_ORDERS_SOLICITATION_FEEDBACK_SEND","AMAZON_FBA_REMOVAL_ORDERS_ADD","AMAZON_APLUS_CONTENT_ADD","AMAZON_APLUS_CONTENT_UPDATE","AMAZON_APLUS_CONTENT_FIND","AMAZON_APLUS_CONTENT_ASINS_UPDATE","AMAZON_APLUS_CONTENT_ASINS_FIND","AMAZON_APLUS_CONTENT_VALIDATE","AMAZON_APLUS_CONTENT_PUBLISH","AMAZON_APLUS_CONTENT_SUSPEND","AMAZON_APLUS_CONTENT_PUBLISH_RECORDS_FIND","AMAZON_ADS_CAMPAIGNS_ADD","AMAZON_ADS_CAMPAIGNS_REMOVE","AMAZON_ADS_CAMPAIGNS_UPDATE","AMAZON_ADS_AD_GROUPS_ADD","AMAZON_ADS_AD_GROUPS_REMOVE","AMAZON_ADS_AD_GROUPS_UPDATE","AMAZON_ADS_TARGETS_ADD","AMAZON_ADS_TARGETS_REMOVE","AMAZON_ADS_TARGETS_UPDATE","AMAZON_ADS_ADS_ADD","AMAZON_ADS_ADS_REMOVE","AMAZON_ADS_ADS_UPDATE","AMAZON_ADS_AD_ASSOCIATIONS_ADD","AMAZON_ADS_AD_ASSOCIATIONS_REMOVE","AMAZON_ADS_AD_ASSOCIATIONS_UPDATE","AMAZON_ADS_CAMPAIGNS_FIND","AMAZON_ADS_AD_GROUPS_FIND","AMAZON_ADS_TARGETS_FIND","AMAZON_ADS_ADS_FIND","AMAZON_ADS_AD_ASSOCIATIONS_FIND","AMAZON_ADS_PORTFOLIOS_ADD","AMAZON_ADS_PORTFOLIOS_UPDATE","AMAZON_ADS_PORTFOLIOS_FIND","AMAZON_ADS_SP_BID_RECOMMENDATIONS_FIND","AMAZON_ADS_SP_TARGET_RECOMMENDATIONS_FIND","AMAZON_MCF_ORDERS_ADD","AMAZON_MCF_ORDERS_UPDATE","AMAZON_MCF_ORDERS_FIND","AMAZON_MCF_ORDERS_CANCEL","AMAZON_MCF_ORDERS_PREVIEW","AMAZON_MCF_DELIVERY_OFFERS_PREVIEW","AMAZON_MCF_FEATURES_MARKETPLACE_FIND","AMAZON_MCF_FEATURES_SKU_FIND"],"nullable":false},"sellerOrVendorId":{"type":"string","description":"Seller or vendor identifier.","format":"uuid"},"dryRun":{"type":"boolean","description":"Validate without creating an action.","default":false},"details":{"nullable":false,"oneOf":[{"$ref":"#/components/schemas/ActionRequestUpdateListingDetails"},{"$ref":"#/components/schemas/ActionRequestListingsDetailsUpdateDetails"},{"$ref":"#/components/schemas/ActionRequestListingsCreateDetails"},{"$ref":"#/components/schemas/ActionRequestListingsFindDetails"},{"$ref":"#/components/schemas/ActionRequestListingsFeesEstimateDetails"},{"$ref":"#/components/schemas/ActionRequestFeaturedPriceEstimateDetails"},{"$ref":"#/components/schemas/ActionRequestCompetitiveSummaryFindDetails"},{"$ref":"#/components/schemas/ActionRequestListingsProductTypesFindDetails"},{"$ref":"#/components/schemas/ActionRequestListingsProductTypeSuggestDetails"},{"$ref":"#/components/schemas/ActionRequestListingsProductTypeDefinitionFindDetails"},{"$ref":"#/components/schemas/ActionRequestOrdersCancelDetails"},{"$ref":"#/components/schemas/ActionRequestOrdersConfirmShipmentDetails"},{"$ref":"#/components/schemas/ActionRequestOrdersSolicitationFeedbackSendDetails"},{"$ref":"#/components/schemas/ActionRequestFbaRemovalOrdersAddDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentAddDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentUpdateDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentFindDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentAsinsUpdateDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentAsinsFindDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentValidateDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentPublishDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentSuspendDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentPublishRecordsFindDetails"},{"$ref":"#/components/schemas/ActionRequestMcfOrdersAddDetails"},{"$ref":"#/components/schemas/ActionRequestMcfOrdersUpdateDetails"},{"$ref":"#/components/schemas/ActionRequestMcfOrdersFindDetails"},{"$ref":"#/components/schemas/ActionRequestMcfOrdersCancelDetails"},{"$ref":"#/components/schemas/ActionRequestMcfOrdersPreviewDetails"},{"$ref":"#/components/schemas/ActionRequestMcfDeliveryOffersPreviewDetails"},{"$ref":"#/components/schemas/ActionRequestMcfFeaturesMarketplaceFindDetails"},{"$ref":"#/components/schemas/ActionRequestMcfFeaturesSkuFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsCampaignDetails"},{"$ref":"#/components/schemas/ActionRequestAdsAdGroupDetails"},{"$ref":"#/components/schemas/ActionRequestAdsTargetDetails"},{"$ref":"#/components/schemas/ActionRequestAdsAdDetails"},{"$ref":"#/components/schemas/ActionRequestAdsAdAssociationDetails"},{"$ref":"#/components/schemas/ActionRequestAdsCampaignFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsAdGroupFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsTargetFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsAdFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsAdAssociationFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsPortfolioDetails"},{"$ref":"#/components/schemas/ActionRequestAdsPortfolioFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsSpBidRecommendationsFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsSpTargetRecommendationsFindDetails"}]}},"required":["type","sellerOrVendorId","details"],"title":"ActionRequest"},"ActionRequestAdsAdAssociationDetails":{"type":"object","properties":{"adAssociations":{"nullable":false,"maxItems":250,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAdsAdAssociationItem"}}},"required":["adAssociations"],"title":"ActionRequestAdsAdAssociationDetails"},"ActionRequestAdsAdAssociationFindDetails":{"type":"object","properties":{"adAssociationQuery":{"$ref":"#/components/schemas/ActionRequestAdsAdAssociationQuery","nullable":false}},"required":["adAssociationQuery"],"title":"ActionRequestAdsAdAssociationFindDetails"},"ActionRequestAdsAdAssociationItem":{"type":"object","properties":{"adAssociationId":{"type":"string","nullable":true},"adGroupId":{"type":"string","nullable":true},"adId":{"type":"string","nullable":true},"state":{"type":"string","enum":["ENABLED","PAUSED"],"nullable":true},"weight":{"type":"number","nullable":true},"startDateTime":{"type":"string","nullable":true},"endDateTime":{"type":"string","nullable":true}},"title":"ActionRequestAdsAdAssociationItem"},"ActionRequestAdsAdAssociationQuery":{"type":"object","properties":{"adAssociationIdFilter":{"$ref":"#/components/schemas/ActionRequestAdsIncludeStringFilter"},"adGroupIdFilter":{"$ref":"#/components/schemas/ActionRequestAdsIncludeStringFilter"},"adIdFilter":{"$ref":"#/components/schemas/ActionRequestAdsIncludeStringFilter"},"maxResults":{"type":"number","minimum":1,"maximum":100},"nextToken":{"type":"string"}},"title":"ActionRequestAdsAdAssociationQuery"},"ActionRequestAdsAdDetails":{"type":"object","properties":{"ads":{"nullable":false,"maxItems":250,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAdsAdItem"}}},"required":["ads"],"title":"ActionRequestAdsAdDetails"},"ActionRequestAdsAdFindDetails":{"type":"object","properties":{"adQuery":{"$ref":"#/components/schemas/ActionRequestAdsAdQuery","nullable":false}},"required":["adQuery"],"title":"ActionRequestAdsAdFindDetails"},"ActionRequestAdsAdGroupDetails":{"type":"object","properties":{"adGroups":{"nullable":false,"maxItems":250,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAdsAdGroupItem"}}},"required":["adGroups"],"title":"ActionRequestAdsAdGroupDetails"},"ActionRequestAdsAdGroupFindDetails":{"type":"object","properties":{"adGroupQuery":{"$ref":"#/components/schemas/ActionRequestAdsAdGroupQuery","nullable":false}},"required":["adGroupQuery"],"title":"ActionRequestAdsAdGroupFindDetails"},"ActionRequestAdsAdGroupItem":{"type":"object","properties":{"adGroupId":{"type":"string","nullable":true},"campaignId":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"adProduct":{"type":"string","enum":["AMAZON_DSP","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"],"nullable":true},"state":{"type":"string","enum":["ENABLED","PAUSED"],"nullable":true},"adSettings":{"type":"object","nullable":true},"advertisedProductCategoryIds":{"nullable":true,"type":"array","items":{"type":"string"}},"defaultBid":{"type":"number","nullable":true},"baseBid":{"type":"number","nullable":true},"maxAverageBid":{"type":"number","nullable":true},"marketplaceSettings":{"nullable":true,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAdsMarketplaceBidSetting"}},"budgets":{"nullable":true,"type":"array","items":{"type":"object"}},"creativeRotationType":{"type":"string","enum":["RANDOM","WEIGHTED"],"nullable":true},"creativeType":{"type":"string","enum":["IMAGE","VIDEO"],"nullable":true},"endDateTime":{"type":"string","nullable":true},"fees":{"nullable":true,"type":"array","items":{"type":"object"}},"frequencies":{"nullable":true,"type":"array","items":{"type":"object"}},"inventoryType":{"type":"string","enum":["AAP_MOBILE_APP","AMAZON_MOBILE_DISPLAY","AUDIO","AUDIO_AMAZON_DEAL","DISPLAY","LIVE_EVENTS","ONLINE_VIDEO","PODCAST","STANDARD_DISPLAY","STREAMING_TV","STREAMING_TV_AMAZON_DEAL","VIDEO"],"nullable":true},"marketplaceConfigurations":{"nullable":true,"type":"array","items":{"type":"object"}},"marketplaceScope":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"],"nullable":true},"marketplaces":{"type":"array","nullable":true,"items":{"type":"string","enum":["AE","AU","BE","BR","CA","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NL","PL","SA","SE","SG","TR","US","ZA"]}},"optimization":{"type":"object","nullable":true},"pacing":{"type":"object","nullable":true},"purchaseOrderNumber":{"type":"string","nullable":true},"startDateTime":{"type":"string","nullable":true},"tags":{"nullable":true,"type":"array","items":{"type":"object"}},"targetingSettings":{"type":"object","nullable":true}},"title":"ActionRequestAdsAdGroupItem"},"ActionRequestAdsAdGroupQuery":{"type":"object","properties":{"adProductFilter":{"$ref":"#/components/schemas/ActionRequestAdsAdProductFilter","nullable":false},"adGroupIdFilter":{"$ref":"#/components/schemas/ActionRequestAdsIncludeStringFilter"},"campaignIdFilter":{"$ref":"#/components/schemas/ActionRequestAdsIncludeStringFilter"},"marketplaceScopeFilter":{"$ref":"#/components/schemas/ActionRequestAdsMarketplaceScopeFilter"},"nameFilter":{"$ref":"#/components/schemas/ActionRequestAdsNameFilter"},"stateFilter":{"$ref":"#/components/schemas/ActionRequestAdsFilterStateFilter"},"maxResults":{"type":"number","minimum":1,"maximum":100},"nextToken":{"type":"string"}},"required":["adProductFilter"],"title":"ActionRequestAdsAdGroupQuery"},"ActionRequestAdsAdItem":{"type":"object","properties":{"adId":{"type":"string","nullable":true},"adGroupId":{"type":"string","nullable":true},"adProduct":{"type":"string","enum":["AMAZON_DSP","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"],"nullable":true},"adType":{"type":"string","enum":["AUDIO","COMPONENT","DISPLAY","PRODUCT_AD","THIRD_PARTY","VIDEO"],"nullable":true},"creative":{"type":"object","nullable":true},"name":{"type":"string","nullable":true},"state":{"type":"string","enum":["ENABLED","PAUSED"],"nullable":true},"marketplaceConfigurations":{"nullable":true,"type":"array","items":{"type":"object"}},"marketplaceScope":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"],"nullable":true},"marketplaces":{"type":"array","nullable":true,"items":{"type":"string","enum":["AE","AU","BE","BR","CA","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NL","PL","SA","SE","SG","TR","US","ZA"]}},"tags":{"nullable":true,"type":"array","items":{"type":"object"}}},"title":"ActionRequestAdsAdItem"},"ActionRequestAdsAdProductFilter":{"type":"object","properties":{"include":{"type":"array","nullable":false,"minItems":1,"maxItems":1,"items":{"type":"string","enum":["AMAZON_DSP","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"]}}},"required":["include"],"title":"ActionRequestAdsAdProductFilter"},"ActionRequestAdsAdQuery":{"type":"object","properties":{"adProductFilter":{"$ref":"#/components/schemas/ActionRequestAdsAdProductFilter","nullable":false},"adGroupIdFilter":{"$ref":"#/components/schemas/ActionRequestAdsIncludeStringFilter"},"adIdFilter":{"$ref":"#/components/schemas/ActionRequestAdsIncludeStringFilter"},"campaignIdFilter":{"$ref":"#/components/schemas/ActionRequestAdsIncludeStringFilter"},"marketplaceScopeFilter":{"$ref":"#/components/schemas/ActionRequestAdsMarketplaceScopeFilter"},"nameFilter":{"$ref":"#/components/schemas/ActionRequestAdsNameFilter"},"stateFilter":{"$ref":"#/components/schemas/ActionRequestAdsFilterStateFilter"},"maxResults":{"type":"number","minimum":1,"maximum":100},"nextToken":{"type":"string"}},"required":["adProductFilter"],"title":"ActionRequestAdsAdQuery"},"ActionRequestAdsBooleanFilter":{"type":"object","properties":{"include":{"nullable":false,"type":"array","items":{"type":"boolean"}}},"required":["include"],"title":"ActionRequestAdsBooleanFilter"},"ActionRequestAdsCampaignAudienceBidAdjustment":{"type":"object","properties":{"audienceId":{"type":"string","nullable":false},"percentage":{"type":"number","nullable":false,"minimum":0,"maximum":900}},"required":["audienceId","percentage"],"title":"ActionRequestAdsCampaignAudienceBidAdjustment"},"ActionRequestAdsCampaignCreativeBidAdjustment":{"type":"object","properties":{"creativeType":{"type":"string","enum":["SPOTLIGHT"],"nullable":true},"percentage":{"type":"number","nullable":false,"minimum":0,"maximum":900}},"required":["percentage"],"title":"ActionRequestAdsCampaignCreativeBidAdjustment"},"ActionRequestAdsCampaignDetails":{"type":"object","properties":{"campaigns":{"nullable":false,"maxItems":250,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAdsCampaignItem"}}},"required":["campaigns"],"title":"ActionRequestAdsCampaignDetails"},"ActionRequestAdsCampaignFindDetails":{"type":"object","properties":{"campaignQuery":{"$ref":"#/components/schemas/ActionRequestAdsCampaignQuery","nullable":false}},"required":["campaignQuery"],"title":"ActionRequestAdsCampaignFindDetails"},"ActionRequestAdsCampaignItem":{"type":"object","properties":{"campaignId":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"adProduct":{"type":"string","enum":["AMAZON_DSP","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"],"nullable":true},"state":{"type":"string","enum":["ENABLED","PAUSED"],"nullable":true},"adomains":{"nullable":true,"type":"array","items":{"type":"string"}},"autoCreationSettings":{"type":"object","nullable":true},"brandId":{"type":"string","nullable":true},"budgets":{"nullable":true,"type":"array","items":{"type":"object"}},"costType":{"type":"string","enum":["CPC","CPM","FIXED_PRICE","VCPM"],"nullable":true},"countries":{"type":"array","nullable":true,"items":{"type":"string","enum":["AE","AT","AU","BE","BH","BR","CA","CH","DE","DK","EG","ES","FI","FR","GB","IE","IL","IN","IT","JO","JP","KW","LU","MA","MK","MX","NL","NO","NZ","OM","PL","QA","SA","SE","SG","TR","US","ZA"]}},"endDateTime":{"type":"string","nullable":true},"fees":{"nullable":true,"type":"array","items":{"type":"object"}},"flights":{"nullable":true,"type":"array","items":{"type":"object"}},"frequencies":{"nullable":true,"type":"array","items":{"type":"object"}},"marketplaceConfigurations":{"nullable":true,"type":"array","items":{"type":"object"}},"marketplaceScope":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"],"nullable":true},"marketplaces":{"type":"array","nullable":true,"items":{"type":"string","enum":["AE","AU","BE","BR","CA","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NL","PL","SA","SE","SG","TR","US","ZA"]}},"bidStrategy":{"type":"string","enum":["MANUAL","NEW_TO_BRAND","PRIORITIZE_KPI_TARGET","RULE_BASED","SALES_DOWN_ONLY","SALES_UP_AND_DOWN","SPEND_BUDGET_IN_FULL","USE_CAMPAIGN_STRATEGY"],"nullable":true},"placementBidAdjustments":{"nullable":true,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAdsCampaignPlacementBidAdjustment"}},"audienceBidAdjustments":{"nullable":true,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAdsCampaignAudienceBidAdjustment"}},"creativeBidAdjustments":{"nullable":true,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAdsCampaignCreativeBidAdjustment"}},"portfolioId":{"type":"string","nullable":true},"purchaseOrderNumber":{"type":"string","nullable":true},"salesChannel":{"type":"string","enum":["AMAZON","OFF_AMAZON"],"nullable":true},"siteRestrictions":{"type":"array","nullable":true,"items":{"type":"string","enum":["AMAZON_BUSINESS","AMAZON_HAUL"]}},"skanAppId":{"type":"string","nullable":true},"startDateTime":{"type":"string","nullable":true},"tags":{"nullable":true,"type":"array","items":{"type":"object"}},"targetedPGDealId":{"type":"string","nullable":true}},"title":"ActionRequestAdsCampaignItem"},"ActionRequestAdsCampaignPlacementBidAdjustment":{"type":"object","properties":{"placement":{"type":"string","enum":["HOME_PAGE","PRODUCT_PAGE","REST_OF_SEARCH","SITE_AMAZON_BUSINESS","TOP_OF_SEARCH"],"nullable":false},"percentage":{"type":"number","nullable":false,"minimum":0,"maximum":900}},"required":["placement","percentage"],"title":"ActionRequestAdsCampaignPlacementBidAdjustment"},"ActionRequestAdsCampaignQuery":{"type":"object","properties":{"adProductFilter":{"$ref":"#/components/schemas/ActionRequestAdsAdProductFilter","nullable":false},"campaignIdFilter":{"$ref":"#/components/schemas/ActionRequestAdsIncludeStringFilter"},"goalFilter":{"$ref":"#/components/schemas/ActionRequestAdsGoalFilter"},"marketplaceScopeFilter":{"$ref":"#/components/schemas/ActionRequestAdsMarketplaceScopeFilter"},"nameFilter":{"$ref":"#/components/schemas/ActionRequestAdsNameFilter"},"portfolioIdFilter":{"$ref":"#/components/schemas/ActionRequestAdsIncludeStringFilter"},"stateFilter":{"$ref":"#/components/schemas/ActionRequestAdsFilterStateFilter"},"maxResults":{"type":"number","minimum":1,"maximum":100},"nextToken":{"type":"string"}},"required":["adProductFilter"],"title":"ActionRequestAdsCampaignQuery"},"ActionRequestAdsFilterStateFilter":{"type":"object","properties":{"include":{"type":"array","nullable":false,"items":{"type":"string","enum":["ARCHIVED","ENABLED","PAUSED"]}}},"required":["include"],"title":"ActionRequestAdsFilterStateFilter"},"ActionRequestAdsGoalFilter":{"type":"object","properties":{"include":{"type":"array","nullable":false,"items":{"type":"string","enum":["AWARENESS","CONSIDERATION","CONVERSIONS"]}}},"required":["include"],"title":"ActionRequestAdsGoalFilter"},"ActionRequestAdsIncludeStringFilter":{"type":"object","properties":{"include":{"nullable":false,"type":"array","items":{"type":"string"}}},"required":["include"],"title":"ActionRequestAdsIncludeStringFilter"},"ActionRequestAdsInventorySourceTypeFilter":{"type":"object","properties":{"include":{"type":"array","nullable":false,"items":{"type":"string","enum":["AMAZON","APD","DEAL","INVENTORY_GROUP","THIRD_PARTY_EXCHANGE"]}}},"required":["include"],"title":"ActionRequestAdsInventorySourceTypeFilter"},"ActionRequestAdsLanguageLocaleFilter":{"type":"object","properties":{"include":{"type":"array","nullable":false,"items":{"type":"string","enum":["ak_GH","am_ET","an_ES","ar_AE","as_IN","av_RU","ay_BO","ba_RU","be_BY","bg_BG","bh_IN","bi_VU","bm_ML","bo_CN","bs_BA","ca_ES","ce_RU","ch_GU","de_DE","el_GR","en_US","eo_INT","es_ES","et_EE","eu_ES","fa_IR","fi_FI","fj_FJ","fo_FO","fr_FR","fy_NL","ga_IE","gd_GB","gl_ES","gn_PY","gu_IN","gv_IM","ha_NG","he_IL","hi_IN","ho_PG","hr_HR","ht_HT","hu_HU","hy_AM","hz_NA","ia_INT","id_ID","ie_INT","ig_NG","ii_CN","ik_US","io_INT","is_IS","it_IT","iu_CA","ja_JP","jv_ID","ka_GE","kg_CD","ki_KE","kj_NA","kk_KZ","kl_GL","km_KH","kn_IN","ko_KR","kr_NG","ks_IN","ku_TR","kv_RU","kw_GB","ky_KG","la_VA","lb_LU","lg_UG","li_NL","ln_CD","lo_LA","lt_LT","lu_CD","lv_LV","mg_MG","mh_MH","mi_NZ","mk_MK","ml_IN","mn_MN","mr_IN","ms_MY","mt_MT","my_MM","na_NR","nb_NO","nd_ZW","ne_NP","ng_NA","nl_NL","nn_NO","no_NO","nr_ZA","nv_US","ny_MW","oc_FR","oj_CA","om_ET","or_IN","os_RU","pa_IN","pi_IN","pl_PL","ps_AF","pt_PT","qu_PE","rm_CH","rn_BI","ro_RO","ru_RU","rw_RW","sa_IN","sc_IT","sd_PK","se_NO","sg_CF","si_LK","sk_SK","sl_SI","sm_WS","sn_ZW","so_SO","sq_AL","sr_RS","ss_SZ","st_LS","su_ID","sv_SE","sw_TZ","ta_IN","te_IN","tg_TJ","th_TH","ti_ET","tk_TM","tl_PH","tn_BW","to_TO","tr_TR","ts_ZA","tt_RU","tw_GH","ty_PF","ug_CN","uk_UA","ur_PK","uz_UZ","ve_ZA","vi_VN","vo_INT","wa_BE","wo_SN","xh_ZA","yi_IL","yo_NG","za_CN","zh_CN","zu_ZA"]}}},"required":["include"],"title":"ActionRequestAdsLanguageLocaleFilter"},"ActionRequestAdsMarketplaceBidSetting":{"type":"object","properties":{"marketplace":{"type":"string","enum":["AE","AU","BE","BR","CA","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NL","PL","SA","SE","SG","TR","US","ZA"],"nullable":false},"currencyCode":{"type":"string","nullable":false},"bid":{"type":"number","nullable":true},"defaultBid":{"type":"number","nullable":true}},"required":["marketplace","currencyCode"],"title":"ActionRequestAdsMarketplaceBidSetting"},"ActionRequestAdsMarketplaceScopeFilter":{"type":"object","properties":{"include":{"type":"array","nullable":false,"items":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"]}}},"required":["include"],"title":"ActionRequestAdsMarketplaceScopeFilter"},"ActionRequestAdsMarketplaceStringValue":{"type":"object","properties":{"defaultValue":{"type":"string"}},"title":"ActionRequestAdsMarketplaceStringValue"},"ActionRequestAdsMarketplaceStringValueFilter":{"type":"object","properties":{"include":{"nullable":false,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAdsMarketplaceStringValue"}}},"required":["include"],"title":"ActionRequestAdsMarketplaceStringValueFilter"},"ActionRequestAdsMatchTypeFilter":{"type":"object","properties":{"include":{"type":"array","nullable":false,"items":{"type":"string","enum":["BROAD","EXACT","INTERESTED_AUDIENCE","KEYWORDS_CLOSE_MATCH","KEYWORDS_LOOSE_MATCH","KEYWORDS_RELATED_TO_GIFTS","KEYWORDS_RELATED_TO_PEER_BRANDS_PRODUCT_CATEGORY","KEYWORDS_RELATED_TO_PRIME_DAY","KEYWORDS_RELATED_TO_YOUR_BRAND","KEYWORDS_RELATED_TO_YOUR_LANDING_PAGES","KEYWORDS_RELATED_TO_YOUR_PRODUCT_CATEGORY","PHRASE","PRODUCTS_SIMILAR_TO_ADVERTISED_PRODUCTS","PRODUCT_COMPLEMENTS","PRODUCT_EXACT","PRODUCT_REMARKETING","PRODUCT_SIMILAR","PRODUCT_SUBSTITUTES"]}}},"required":["include"],"title":"ActionRequestAdsMatchTypeFilter"},"ActionRequestAdsNameFilter":{"type":"object","properties":{"include":{"nullable":false,"type":"array","items":{"type":"string"}},"queryTermMatchType":{"type":"string","enum":["BROAD_MATCH","EXACT_MATCH"],"nullable":false}},"required":["include","queryTermMatchType"],"title":"ActionRequestAdsNameFilter"},"ActionRequestAdsPortfolioBudget":{"type":"object","properties":{"amount":{"type":"number","nullable":true},"currencyCode":{"type":"string","enum":["USD","CAD","GBP","EUR","CNY","JPY","INR","MXN","AUD","AED","BRL","SGD","SEK","TRY","SAR","EGP","PLN","CLP","COP","NGN","ZAR"],"nullable":true},"endDate":{"type":"string","nullable":true},"policy":{"type":"string","enum":["DATE_RANGE","MONTHLY_RECURRING","NO_CAP","OTHER"],"nullable":true},"startDate":{"type":"string","nullable":true}},"title":"ActionRequestAdsPortfolioBudget"},"ActionRequestAdsPortfolioBudgetControls":{"type":"object","properties":{"campaignUnspentBudgetSharing":{"type":"object","nullable":true}},"title":"ActionRequestAdsPortfolioBudgetControls"},"ActionRequestAdsPortfolioDetails":{"type":"object","properties":{"portfolios":{"nullable":false,"maxItems":250,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAdsPortfolioItem"}}},"required":["portfolios"],"title":"ActionRequestAdsPortfolioDetails"},"ActionRequestAdsPortfolioEntityStateFilter":{"type":"object","properties":{"include":{"type":"array","nullable":false,"items":{"type":"string","enum":["ENABLED"]}}},"required":["include"],"title":"ActionRequestAdsPortfolioEntityStateFilter"},"ActionRequestAdsPortfolioFindDetails":{"type":"object","properties":{"portfolioQuery":{"$ref":"#/components/schemas/ActionRequestAdsPortfolioQuery","nullable":false}},"required":["portfolioQuery"],"title":"ActionRequestAdsPortfolioFindDetails"},"ActionRequestAdsPortfolioItem":{"type":"object","properties":{"portfolioId":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"state":{"type":"string","enum":["ENABLED"],"nullable":true},"budget":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/ActionRequestAdsPortfolioBudget"}]},"budgetControls":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/ActionRequestAdsPortfolioBudgetControls"}]}},"title":"ActionRequestAdsPortfolioItem"},"ActionRequestAdsPortfolioQuery":{"type":"object","properties":{"portfolioIdFilter":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/ActionRequestAdsIncludeStringFilter"}]},"stateFilter":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/ActionRequestAdsPortfolioEntityStateFilter"}]},"nameFilter":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/ActionRequestAdsNameFilter"}]},"nextToken":{"type":"string","nullable":true},"includeExtendedDataFields":{"type":"boolean","nullable":true}},"title":"ActionRequestAdsPortfolioQuery"},"ActionRequestAdsSpBidRecommendationItem":{"type":"object","properties":{"adGroupId":{"type":"string","nullable":false,"description":"Existing Sponsored Products ad group id."},"targetings":{"nullable":false,"minItems":1,"maxItems":100,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAdsSpBidRecommendationTargeting"}}},"required":["adGroupId","targetings"],"title":"ActionRequestAdsSpBidRecommendationItem"},"ActionRequestAdsSpBidRecommendationTargeting":{"type":"object","properties":{"type":{"type":"string","enum":["CLOSE_MATCH","LOOSE_MATCH","SUBSTITUTES","COMPLEMENTS","KEYWORD_BROAD_MATCH","KEYWORD_EXACT_MATCH","KEYWORD_PHRASE_MATCH","PAT_ASIN","PAT_CATEGORY","PAT_CATEGORY_REFINEMENT","KEYWORD_GROUP"],"nullable":false,"description":"Sponsored Products targeting expression type. Keyword, product, and keyword-group types require value."},"value":{"type":"string","nullable":false,"maxLength":4096,"description":"Targeting expression value. Required for keyword, product, and keyword-group types. Optional for auto types CLOSE_MATCH, LOOSE_MATCH, SUBSTITUTES, and COMPLEMENTS."}},"required":["type"],"title":"ActionRequestAdsSpBidRecommendationTargeting"},"ActionRequestAdsSpBidRecommendationsFindDetails":{"type":"object","properties":{"bidRecommendations":{"nullable":false,"minItems":1,"maxItems":50,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAdsSpBidRecommendationItem"}}},"required":["bidRecommendations"],"title":"ActionRequestAdsSpBidRecommendationsFindDetails"},"ActionRequestAdsSpTargetRecommendationItem":{"type":"object","properties":{"adGroupId":{"type":"string","nullable":false,"description":"Existing Sponsored Products ad group id."},"maxRecommendations":{"type":"number","nullable":false,"minimum":1,"maximum":200,"description":"Maximum number of keyword recommendations to return. Defaults to 200."},"sortDimension":{"type":"string","enum":["CLICKS","CONVERSIONS","DEFAULT"],"nullable":false,"description":"Sort dimension for ranked keyword recommendations. Defaults to CONVERSIONS."},"locale":{"type":"string","enum":["ar_EG","de_DE","en_AE","en_AU","en_CA","en_GB","en_IN","en_SA","en_SG","en_US","es_ES","es_MX","fr_FR","it_IT","ja_JP","nl_NL","pl_PL","pt_BR","sv_SE","tr_TR","zh_CN"],"nullable":false,"description":"Locale used to localize recommended keywords."}},"required":["adGroupId"],"title":"ActionRequestAdsSpTargetRecommendationItem"},"ActionRequestAdsSpTargetRecommendationsFindDetails":{"type":"object","properties":{"targetRecommendations":{"nullable":false,"minItems":1,"maxItems":50,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAdsSpTargetRecommendationItem"}}},"required":["targetRecommendations"],"title":"ActionRequestAdsSpTargetRecommendationsFindDetails"},"ActionRequestAdsTargetDetails":{"type":"object","properties":{"targets":{"nullable":false,"maxItems":250,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAdsTargetItem"}}},"required":["targets"],"title":"ActionRequestAdsTargetDetails"},"ActionRequestAdsTargetFindDetails":{"type":"object","properties":{"targetQuery":{"$ref":"#/components/schemas/ActionRequestAdsTargetQuery","nullable":false}},"required":["targetQuery"],"title":"ActionRequestAdsTargetFindDetails"},"ActionRequestAdsTargetItem":{"type":"object","properties":{"targetId":{"type":"string","nullable":true},"campaignId":{"type":"string","nullable":true},"adGroupId":{"type":"string","nullable":true},"adProduct":{"type":"string","enum":["AMAZON_DSP","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"],"nullable":true},"state":{"type":"string","enum":["ENABLED","PAUSED"],"nullable":true},"negative":{"type":"boolean","nullable":true},"targetType":{"type":"string","enum":["AD_INITIATION","AD_PLAYER_SIZE","APP","AUDIENCE","BRAND_SAFETY_CATEGORY","BRAND_SAFETY_TIER","CONTENT_CATEGORY","CONTENT_GENRE","CONTENT_INSTREAM_POSITION","CONTENT_OUTSTREAM_POSITION","CONTENT_RATING","DAYPART","DEVICE","DOMAIN","FOLD_POSITION","INVENTORY_SOURCE","KEYWORD","LOCATION","NATIVE_CONTENT_POSITION","PLACEMENT_TYPE","PRODUCT","PRODUCT_AUDIENCE","PRODUCT_CATEGORY","THEME","THIRD_PARTY","VIDEO_AD_FORMAT","VIDEO_CONTENT_DURATION"],"nullable":true},"targetDetails":{"type":"object","description":"Amazon Ads CreateTargetDetails object with exactly one wrapper key (for example keywordTarget). When targetType is provided, flat inner fields are also accepted and normalized before execution.","nullable":true,"examples":{"keywordTarget":{"value":{"keywordTarget":{"keyword":"running shoes","matchType":"EXACT"}}}}},"bid":{"type":"number","nullable":true},"marketplaceSettings":{"nullable":true,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAdsMarketplaceBidSetting"}},"marketplaceConfigurations":{"nullable":true,"type":"array","items":{"type":"object"}},"marketplaceScope":{"type":"string","enum":["GLOBAL","SINGLE_MARKETPLACE"],"nullable":true},"marketplaces":{"type":"array","nullable":true,"items":{"type":"string","enum":["AE","AU","BE","BR","CA","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NL","PL","SA","SE","SG","TR","US","ZA"]}},"tags":{"nullable":true,"type":"array","items":{"type":"object"}}},"title":"ActionRequestAdsTargetItem"},"ActionRequestAdsTargetQuery":{"type":"object","properties":{"adProductFilter":{"$ref":"#/components/schemas/ActionRequestAdsAdProductFilter","nullable":false},"adGroupIdFilter":{"$ref":"#/components/schemas/ActionRequestAdsIncludeStringFilter"},"campaignIdFilter":{"$ref":"#/components/schemas/ActionRequestAdsIncludeStringFilter"},"inventorySourceIdFilter":{"$ref":"#/components/schemas/ActionRequestAdsMarketplaceStringValueFilter"},"inventorySourceTypeFilter":{"$ref":"#/components/schemas/ActionRequestAdsInventorySourceTypeFilter"},"keywordFilter":{"$ref":"#/components/schemas/ActionRequestAdsNameFilter"},"marketplaceScopeFilter":{"$ref":"#/components/schemas/ActionRequestAdsMarketplaceScopeFilter"},"matchTypeFilter":{"$ref":"#/components/schemas/ActionRequestAdsMatchTypeFilter"},"nativeLanguageLocaleFilter":{"$ref":"#/components/schemas/ActionRequestAdsLanguageLocaleFilter"},"negativeFilter":{"$ref":"#/components/schemas/ActionRequestAdsBooleanFilter"},"productIdFilter":{"$ref":"#/components/schemas/ActionRequestAdsNameFilter"},"stateFilter":{"$ref":"#/components/schemas/ActionRequestAdsFilterStateFilter"},"targetIdFilter":{"$ref":"#/components/schemas/ActionRequestAdsIncludeStringFilter"},"targetTypeFilter":{"$ref":"#/components/schemas/ActionRequestAdsTargetTypeFilter"},"maxResults":{"type":"number","minimum":1,"maximum":100},"nextToken":{"type":"string"}},"required":["adProductFilter"],"title":"ActionRequestAdsTargetQuery"},"ActionRequestAdsTargetTypeFilter":{"type":"object","properties":{"include":{"type":"array","nullable":false,"items":{"type":"string","enum":["AD_INITIATION","AD_PLAYER_SIZE","APP","AUDIENCE","BRAND_SAFETY_CATEGORY","BRAND_SAFETY_TIER","CONTENT_CATEGORY","CONTENT_GENRE","CONTENT_INSTREAM_POSITION","CONTENT_OUTSTREAM_POSITION","CONTENT_RATING","DAYPART","DEVICE","DOMAIN","FOLD_POSITION","INVENTORY_SOURCE","KEYWORD","LOCATION","NATIVE_CONTENT_POSITION","PLACEMENT_TYPE","PRODUCT","PRODUCT_AUDIENCE","PRODUCT_CATEGORY","THEME","THIRD_PARTY","VIDEO_AD_FORMAT","VIDEO_CONTENT_DURATION"]}}},"required":["include"],"title":"ActionRequestAdsTargetTypeFilter"},"ActionRequestAplusContentAddDetails":{"type":"object","properties":{"documents":{"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAplusContentAddItem"}}},"required":["documents"],"title":"ActionRequestAplusContentAddDetails"},"ActionRequestAplusContentAddItem":{"type":"object","properties":{"contentDocument":{"$ref":"#/components/schemas/ActionRequestAplusContentDocument"},"asins":{"type":"array","items":{"type":"string"}}},"required":["contentDocument"],"title":"ActionRequestAplusContentAddItem"},"ActionRequestAplusContentAsinsFindDetails":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAplusContentAsinsFindItem"}}},"required":["items"],"title":"ActionRequestAplusContentAsinsFindDetails"},"ActionRequestAplusContentAsinsFindItem":{"type":"object","properties":{"contentReferenceKey":{"type":"string"}},"required":["contentReferenceKey"],"title":"ActionRequestAplusContentAsinsFindItem"},"ActionRequestAplusContentAsinsUpdateDetails":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAplusContentAsinsUpdateItem"}}},"required":["items"],"title":"ActionRequestAplusContentAsinsUpdateDetails"},"ActionRequestAplusContentAsinsUpdateItem":{"type":"object","properties":{"contentReferenceKey":{"type":"string"},"asins":{"type":"array","items":{"type":"string"}}},"required":["contentReferenceKey","asins"],"title":"ActionRequestAplusContentAsinsUpdateItem"},"ActionRequestAplusContentDocument":{"type":"object","properties":{"name":{"type":"string"},"contentType":{"type":"string","enum":["EBC","EMC"]},"contentSubType":{"type":"string"},"locale":{"type":"string"},"contentModuleList":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["name","contentType","locale","contentModuleList"],"title":"ActionRequestAplusContentDocument"},"ActionRequestAplusContentFindDetails":{"type":"object","properties":{"contentReferenceKeys":{"type":"array","items":{"type":"string"}},"includedData":{"type":"array","items":{"type":"string","enum":["METADATA","CONTENTS"]}}},"title":"ActionRequestAplusContentFindDetails"},"ActionRequestAplusContentPublishDetails":{"type":"object","properties":{"contentReferenceKeys":{"type":"array","items":{"type":"string"}}},"required":["contentReferenceKeys"],"title":"ActionRequestAplusContentPublishDetails"},"ActionRequestAplusContentPublishRecordsFindDetails":{"type":"object","properties":{"asins":{"type":"array","items":{"type":"string"}}},"required":["asins"],"title":"ActionRequestAplusContentPublishRecordsFindDetails"},"ActionRequestAplusContentSuspendDetails":{"type":"object","properties":{"contentReferenceKeys":{"type":"array","items":{"type":"string"}}},"required":["contentReferenceKeys"],"title":"ActionRequestAplusContentSuspendDetails"},"ActionRequestAplusContentUpdateDetails":{"type":"object","properties":{"documents":{"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAplusContentUpdateItem"}}},"required":["documents"],"title":"ActionRequestAplusContentUpdateDetails"},"ActionRequestAplusContentUpdateItem":{"type":"object","properties":{"contentReferenceKey":{"type":"string"},"contentDocument":{"$ref":"#/components/schemas/ActionRequestAplusContentDocument"}},"required":["contentReferenceKey","contentDocument"],"title":"ActionRequestAplusContentUpdateItem"},"ActionRequestAplusContentValidateDetails":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ActionRequestAplusContentValidateItem"}}},"required":["items"],"title":"ActionRequestAplusContentValidateDetails"},"ActionRequestAplusContentValidateItem":{"type":"object","properties":{"contentDocument":{"$ref":"#/components/schemas/ActionRequestAplusContentDocument"},"asins":{"type":"array","items":{"type":"string"}}},"required":["contentDocument"],"title":"ActionRequestAplusContentValidateItem"},"ActionRequestCompetitiveSummaryFindDetails":{"type":"object","properties":{"includedData":{"type":"array","nullable":false,"default":["featuredBuyingOptions","referencePrices","lowestPricedOffers","similarItems"],"description":"Competitive summary data groups to include for every ASIN.","items":{"type":"string","enum":["featuredBuyingOptions","referencePrices","lowestPricedOffers","similarItems"]}},"competitiveSummaries":{"nullable":false,"maxItems":60,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestCompetitiveSummaryItem"}}},"required":["competitiveSummaries"],"title":"ActionRequestCompetitiveSummaryFindDetails"},"ActionRequestCompetitiveSummaryItem":{"type":"object","properties":{"asin":{"type":"string","nullable":false,"pattern":"^[A-Z0-9]{10}$","description":"Amazon ASIN (10 uppercase alphanumeric characters)."},"lowestPricedOffersInputs":{"nullable":false,"maxItems":5,"description":"Optional lowest-priced offer filters. Requires includedData to contain lowestPricedOffers.","type":"array","items":{"$ref":"#/components/schemas/ActionRequestCompetitiveSummaryLowestPricedOffersInput"}}},"required":["asin"],"title":"ActionRequestCompetitiveSummaryItem"},"ActionRequestCompetitiveSummaryLowestPricedOffersInput":{"type":"object","properties":{"itemCondition":{"type":"string","enum":["New","Used","Collectible","Refurbished","Club"],"nullable":false,"description":"Item condition filter for lowest-priced offers."},"offerType":{"type":"string","enum":["Consumer"],"nullable":false,"description":"Offer type filter for lowest-priced offers."}},"required":["itemCondition","offerType"],"title":"ActionRequestCompetitiveSummaryLowestPricedOffersInput"},"ActionRequestFbaRemovalOrder":{"type":"object","properties":{"merchantRemovalOrderId":{"type":"string","nullable":false,"pattern":"^[A-Za-z0-9]{1,10}$","maxLength":10},"removalDisposition":{"type":"string","enum":["return","dispose","liquidate"],"nullable":false},"contactPhoneNumber":{"type":"string","nullable":true,"maxLength":32,"description":"Required when removalDisposition is return."},"shippingNotes":{"type":"string","nullable":true,"maxLength":256},"address":{"nullable":true,"description":"Required when removalDisposition is return.","type":"object","allOf":[{"$ref":"#/components/schemas/ActionRequestFbaRemovalOrderAddress"}]},"items":{"nullable":false,"minItems":1,"maxItems":5000,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestFbaRemovalOrderItem"}}},"required":["merchantRemovalOrderId","removalDisposition","items"],"title":"ActionRequestFbaRemovalOrder"},"ActionRequestFbaRemovalOrderAddress":{"type":"object","properties":{"name":{"type":"string","nullable":false,"maxLength":50},"addressLine1":{"type":"string","nullable":false,"maxLength":60},"addressLine2":{"type":"string","nullable":true,"maxLength":60},"addressLine3":{"type":"string","nullable":true,"maxLength":60},"city":{"type":"string","nullable":false,"maxLength":50},"stateOrRegion":{"type":"string","nullable":false,"maxLength":50},"postalCode":{"type":"string","nullable":false,"maxLength":32},"countryCode":{"type":"string","nullable":false,"pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code."}},"required":["name","addressLine1","city","stateOrRegion","postalCode","countryCode"],"title":"ActionRequestFbaRemovalOrderAddress"},"ActionRequestFbaRemovalOrderItem":{"type":"object","properties":{"sku":{"type":"string","nullable":false,"maxLength":64},"sellableQuantity":{"type":"number","nullable":false,"minimum":0},"unsellableQuantity":{"type":"number","nullable":false,"minimum":0}},"required":["sku","sellableQuantity","unsellableQuantity"],"title":"ActionRequestFbaRemovalOrderItem"},"ActionRequestFbaRemovalOrdersAddDetails":{"type":"object","properties":{"removalOrders":{"nullable":false,"minItems":1,"maxItems":5000,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestFbaRemovalOrder"}}},"required":["removalOrders"],"title":"ActionRequestFbaRemovalOrdersAddDetails"},"ActionRequestFeaturedPriceEstimateDetails":{"type":"object","properties":{"featuredPriceEstimates":{"nullable":false,"maxItems":120,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestFeaturedPriceEstimateItem"}}},"required":["featuredPriceEstimates"],"title":"ActionRequestFeaturedPriceEstimateDetails"},"ActionRequestFeaturedPriceEstimateItem":{"type":"object","properties":{"sku":{"type":"string","nullable":false,"maxLength":64,"description":"Seller SKU used to estimate the featured offer expected price."},"segment":{"$ref":"#/components/schemas/ActionRequestFeaturedPriceEstimateSegment","nullable":false,"description":"Optional simplified sample location used for the featured price estimate."}},"required":["sku"],"title":"ActionRequestFeaturedPriceEstimateItem"},"ActionRequestFeaturedPriceEstimateSegment":{"type":"object","properties":{"countryCode":{"type":"string","nullable":false,"pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code for the sample location."},"postalCode":{"type":"string","nullable":false,"maxLength":32,"description":"Postal code for the sample location used in the featured price estimate."}},"required":["countryCode","postalCode"],"title":"ActionRequestFeaturedPriceEstimateSegment"},"ActionRequestListingChange":{"type":"object","properties":{"sku":{"type":"string","description":"Listing SKU.","nullable":false,"maxLength":64},"name":{"type":"string","nullable":true,"maxLength":75},"description":{"type":"string","nullable":true,"maxLength":4096},"bulletPoints":{"nullable":true,"maxItems":5,"type":"array","items":{"type":"string"}},"price":{"type":"number","nullable":true,"description":"Listing price. Supported for Seller Central accounts only."},"genericKeyword":{"type":"string","nullable":true,"maxLength":256},"itemTypeKeyword":{"type":"string","nullable":true,"maxLength":256,"description":"Item type keyword to set for the listing. Supported in all marketplaces."},"itemHighlight":{"type":"string","nullable":true,"maxLength":125,"description":"Item highlight to set for the listing. Maps to Amazon title_differentiation attribute."},"language_tag":{"type":"string","nullable":true,"maxLength":16,"description":"Required when name, description, bulletPoints, genericKeyword, or itemHighlight is provided. POSIX locale format, for example en_US."},"images":{"nullable":true,"description":"Listing image updates. Upload images via Files API (group LISTING_IMAGES) for the same seller or vendor, then reference file UUIDs. Omitted image fields are left unchanged.","type":"object","allOf":[{"$ref":"#/components/schemas/ActionRequestListingImages"}]}},"required":["sku"],"title":"ActionRequestListingChange"},"ActionRequestListingImages":{"type":"object","properties":{"mainImage":{"type":"string","format":"uuid","nullable":true,"description":"UUID of an uploaded LISTING_IMAGES DataFile for the main image (main_product_image_locator). Upload via POST /api/v1/files with group LISTING_IMAGES first. Set null to remove (Seller Central only)."},"image1":{"type":"string","format":"uuid","nullable":true,"description":"Gallery image slot 1 (other_product_image_locator_1). UUID or null to remove."},"image2":{"type":"string","format":"uuid","nullable":true,"description":"Gallery image slot 2 (other_product_image_locator_2). UUID or null to remove."},"image3":{"type":"string","format":"uuid","nullable":true,"description":"Gallery image slot 3 (other_product_image_locator_3). UUID or null to remove."},"image4":{"type":"string","format":"uuid","nullable":true,"description":"Gallery image slot 4 (other_product_image_locator_4). UUID or null to remove."},"image5":{"type":"string","format":"uuid","nullable":true,"description":"Gallery image slot 5 (other_product_image_locator_5). UUID or null to remove."},"image6":{"type":"string","format":"uuid","nullable":true,"description":"Gallery image slot 6 (other_product_image_locator_6). UUID or null to remove."},"image7":{"type":"string","format":"uuid","nullable":true,"description":"Gallery image slot 7 (other_product_image_locator_7). UUID or null to remove."},"image8":{"type":"string","format":"uuid","nullable":true,"description":"Gallery image slot 8 (other_product_image_locator_8). UUID or null to remove."},"variationSwatchImage":{"type":"string","format":"uuid","nullable":true,"description":"UUID of an uploaded LISTING_IMAGES DataFile for the variation swatch (swatch_product_image_locator). Set null to remove (Seller Central only)."}},"title":"ActionRequestListingImages"},"ActionRequestListingsFeesEstimateDetails":{"type":"object","properties":{"feesEstimates":{"nullable":false,"maxItems":2500,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestListingsFeesEstimateItem"}}},"required":["feesEstimates"],"title":"ActionRequestListingsFeesEstimateDetails"},"ActionRequestListingsFeesEstimateItem":{"type":"object","properties":{"identifierType":{"type":"string","enum":["ASIN","SKU"],"nullable":false,"description":"Product identifier type accepted by the Amazon Product Fees API."},"identifier":{"type":"string","nullable":false,"maxLength":64,"description":"Product identifier value to estimate fees for."},"isFBA":{"type":"boolean","nullable":false,"description":"When true, the offer is fulfilled by Amazon."},"fbaProgram":{"type":"string","enum":["FBA_CORE","FBA_SNL","FBA_EFN"],"nullable":true,"description":"Optional FBA enrollment program when isFBA is true."},"currency":{"type":"string","nullable":false,"pattern":"^[A-Z]{3}$","description":"ISO 4217 currency code for price values."},"listingPriceValue":{"type":"number","nullable":false,"minimum":0,"description":"Listing price amount used to estimate fees."},"shippingPriceValue":{"type":"number","nullable":false,"minimum":0,"description":"Shipping price amount used to estimate fees."}},"required":["identifierType","identifier","isFBA","currency","listingPriceValue","shippingPriceValue"],"title":"ActionRequestListingsFeesEstimateItem"},"ActionRequestListingsFindChange":{"type":"object","properties":{"identifierType":{"type":"string","enum":["ASIN","EAN","FNSKU","GTIN","ISBN","JAN","MINSAN","SKU","UPC"],"nullable":false,"description":"Product identifier type accepted by the Amazon Listings Items search API."},"identifier":{"type":"string","nullable":false,"maxLength":64,"description":"Product identifier value to search for."}},"required":["identifierType","identifier"],"title":"ActionRequestListingsFindChange"},"ActionRequestListingsFindDetails":{"type":"object","properties":{"vendorCode":{"type":"string","nullable":true,"maxLength":32,"description":"Amazon vendor code used as Listings Items API sellerId. Required for Vendor Central accounts."},"listingIdentifiers":{"nullable":false,"maxItems":5000,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestListingsFindChange"}}},"required":["listingIdentifiers"],"title":"ActionRequestListingsFindDetails"},"ActionRequestOrderCancellation":{"type":"object","properties":{"orderId":{"type":"string","nullable":false,"pattern":"^\\w{3}-\\w{7}-\\w{7}$"},"orderItemId":{"type":"string","nullable":false,"pattern":"^\\d{1,64}$"},"cancellationReasonCode":{"type":"string","enum":["NoInventory","BuyerCanceled","ShippingAddressUndeliverable","CarrierCoverageFailure","CustomerReturn","CouldNotShip","GeneralAdjustment"],"nullable":false}},"required":["orderId","orderItemId","cancellationReasonCode"],"title":"ActionRequestOrderCancellation"},"ActionRequestOrdersCancelDetails":{"type":"object","properties":{"cancellations":{"nullable":false,"maxItems":5000,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestOrderCancellation"}}},"required":["cancellations"],"title":"ActionRequestOrdersCancelDetails"},"ActionRequestOrdersConfirmShipmentDetails":{"type":"object","properties":{"shipments":{"nullable":false,"maxItems":5000,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestShipmentConfirmation"}}},"required":["shipments"],"title":"ActionRequestOrdersConfirmShipmentDetails"},"ActionRequestOrdersSolicitationFeedbackSendDetails":{"type":"object","properties":{"solicitations":{"nullable":false,"maxItems":300,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestSolicitationFeedbackSend"}}},"required":["solicitations"],"title":"ActionRequestOrdersSolicitationFeedbackSendDetails"},"ActionRequestShipmentConfirmation":{"type":"object","properties":{"orderId":{"type":"string","nullable":false,"pattern":"^\\w{3}-\\w{7}-\\w{7}$"},"orderItemId":{"type":"string","nullable":false,"pattern":"^\\d{1,64}$"},"quantity":{"type":"number","nullable":false},"shipDate":{"type":"string","description":"Ship date as YYYY-MM-DD or ISO datetime.","nullable":false},"carrierCode":{"type":"string","nullable":false,"maxLength":50},"carrierName":{"type":"string","nullable":true,"maxLength":256},"shipMethod":{"type":"string","nullable":true,"maxLength":256},"trackingNumber":{"type":"string","nullable":true,"maxLength":256},"shipFromSupplySourceId":{"type":"string","nullable":true,"maxLength":64}},"required":["orderId","orderItemId","quantity","shipDate","carrierCode"],"title":"ActionRequestShipmentConfirmation"},"ActionRequestSolicitationFeedbackSend":{"type":"object","properties":{"amazonOrderId":{"type":"string","nullable":false,"pattern":"^\\w{3}-\\w{7}-\\w{7}$"}},"required":["amazonOrderId"],"title":"ActionRequestSolicitationFeedbackSend"},"ActionRequestUpdateListingDetails":{"type":"object","properties":{"vendorCode":{"type":"string","nullable":true,"maxLength":32,"description":"Amazon vendor code for the listing update feed header. Required for Vendor Central accounts."},"changes":{"nullable":false,"maxItems":5000,"type":"array","items":{"$ref":"#/components/schemas/ActionRequestListingChange"}}},"required":["changes"],"title":"ActionRequestUpdateListingDetails"},"ActionResult":{"type":"object","properties":{},"description":"Action-specific result payload. Shape depends on action type and status.","title":"ActionResult","additionalProperties":true},"ActionSpApiFeedResult":{"type":"object","properties":{"amazonSpApiFeedId":{"type":"string","nullable":true},"amazonSpApiFeedStatus":{"type":"string","nullable":true},"amazonSpApiFeedRawResult":{"type":"string","nullable":true,"description":"Raw feed processing result document content."}},"description":"Amazon SP-API feed result for finished feed-based actions.","required":["amazonSpApiFeedId","amazonSpApiFeedStatus","amazonSpApiFeedRawResult"],"title":"ActionSpApiFeedResult","additionalProperties":true},"ActionStartResponse":{"type":"object","properties":{"actionId":{"type":"string","nullable":true},"status":{"type":"string","enum":["VALIDATED","PENDING","IN_PROGRESS","WAITING_EXTERNAL_PROCESSING","COMPLETED","PARTIALLY_COMPLETED","COMPLETED_WITH_ISSUES","ERROR","BLOCKED_NO_TOKENS","BLOCKED_INVALID_INPUT","CANCELED"],"nullable":false},"dryRun":{"type":"boolean","nullable":false},"request":{"$ref":"#/components/schemas/ActionRequest","nullable":false,"description":"The request that started the action."},"validation":{"$ref":"#/components/schemas/ActionValidationResult","nullable":false},"result":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/ActionResult"}]},"error":{"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/ActionError"}]},"cause":{"type":"string","nullable":true},"queuedAt":{"format":"date-time","type":"string","nullable":true}},"required":["actionId","status","dryRun","request","validation","result","error","cause","queuedAt"],"title":"ActionStartResponse"},"ActionStatusResponse":{"type":"object","properties":{"actionId":{"type":"string","format":"uuid","nullable":false},"type":{"type":"string","enum":["AMAZON_LISTINGS_UPDATE","AMAZON_LISTINGS_DETAILS_UPDATE","AMAZON_LISTINGS_CREATE","AMAZON_LISTINGS_FIND","AMAZON_LISTINGS_FEES_ESTIMATE","AMAZON_LISTINGS_FEATURED_PRICE_ESTIMATE","AMAZON_LISTINGS_COMPETITIVE_SUMMARY_FIND","AMAZON_LISTINGS_PRODUCT_TYPES_FIND","AMAZON_LISTINGS_PRODUCT_TYPE_SUGGEST","AMAZON_LISTINGS_PRODUCT_TYPE_DEFINITION_FIND","AMAZON_ORDERS_CANCEL","AMAZON_ORDERS_CONFIRM_SHIPMENT","AMAZON_ORDERS_SOLICITATION_FEEDBACK_SEND","AMAZON_FBA_REMOVAL_ORDERS_ADD","AMAZON_APLUS_CONTENT_ADD","AMAZON_APLUS_CONTENT_UPDATE","AMAZON_APLUS_CONTENT_FIND","AMAZON_APLUS_CONTENT_ASINS_UPDATE","AMAZON_APLUS_CONTENT_ASINS_FIND","AMAZON_APLUS_CONTENT_VALIDATE","AMAZON_APLUS_CONTENT_PUBLISH","AMAZON_APLUS_CONTENT_SUSPEND","AMAZON_APLUS_CONTENT_PUBLISH_RECORDS_FIND","AMAZON_ADS_CAMPAIGNS_ADD","AMAZON_ADS_CAMPAIGNS_REMOVE","AMAZON_ADS_CAMPAIGNS_UPDATE","AMAZON_ADS_AD_GROUPS_ADD","AMAZON_ADS_AD_GROUPS_REMOVE","AMAZON_ADS_AD_GROUPS_UPDATE","AMAZON_ADS_TARGETS_ADD","AMAZON_ADS_TARGETS_REMOVE","AMAZON_ADS_TARGETS_UPDATE","AMAZON_ADS_ADS_ADD","AMAZON_ADS_ADS_REMOVE","AMAZON_ADS_ADS_UPDATE","AMAZON_ADS_AD_ASSOCIATIONS_ADD","AMAZON_ADS_AD_ASSOCIATIONS_REMOVE","AMAZON_ADS_AD_ASSOCIATIONS_UPDATE","AMAZON_ADS_CAMPAIGNS_FIND","AMAZON_ADS_AD_GROUPS_FIND","AMAZON_ADS_TARGETS_FIND","AMAZON_ADS_ADS_FIND","AMAZON_ADS_AD_ASSOCIATIONS_FIND","AMAZON_ADS_PORTFOLIOS_ADD","AMAZON_ADS_PORTFOLIOS_UPDATE","AMAZON_ADS_PORTFOLIOS_FIND","AMAZON_ADS_SP_BID_RECOMMENDATIONS_FIND","AMAZON_ADS_SP_TARGET_RECOMMENDATIONS_FIND","AMAZON_MCF_ORDERS_ADD","AMAZON_MCF_ORDERS_UPDATE","AMAZON_MCF_ORDERS_FIND","AMAZON_MCF_ORDERS_CANCEL","AMAZON_MCF_ORDERS_PREVIEW","AMAZON_MCF_DELIVERY_OFFERS_PREVIEW","AMAZON_MCF_FEATURES_MARKETPLACE_FIND","AMAZON_MCF_FEATURES_SKU_FIND"],"nullable":false},"sellerOrVendorId":{"type":"string","format":"uuid","nullable":false},"status":{"type":"string","enum":["PENDING","IN_PROGRESS","WAITING_EXTERNAL_PROCESSING","COMPLETED","PARTIALLY_COMPLETED","COMPLETED_WITH_ISSUES","ERROR","BLOCKED_NO_TOKENS","BLOCKED_INVALID_INPUT","CANCELED"],"nullable":false},"details":{"nullable":false,"oneOf":[{"$ref":"#/components/schemas/ActionRequestUpdateListingDetails"},{"$ref":"#/components/schemas/ActionRequestListingsDetailsUpdateDetails"},{"$ref":"#/components/schemas/ActionRequestListingsCreateDetails"},{"$ref":"#/components/schemas/ActionRequestListingsFindDetails"},{"$ref":"#/components/schemas/ActionRequestListingsFeesEstimateDetails"},{"$ref":"#/components/schemas/ActionRequestFeaturedPriceEstimateDetails"},{"$ref":"#/components/schemas/ActionRequestCompetitiveSummaryFindDetails"},{"$ref":"#/components/schemas/ActionRequestListingsProductTypesFindDetails"},{"$ref":"#/components/schemas/ActionRequestListingsProductTypeSuggestDetails"},{"$ref":"#/components/schemas/ActionRequestListingsProductTypeDefinitionFindDetails"},{"$ref":"#/components/schemas/ActionRequestOrdersCancelDetails"},{"$ref":"#/components/schemas/ActionRequestOrdersConfirmShipmentDetails"},{"$ref":"#/components/schemas/ActionRequestOrdersSolicitationFeedbackSendDetails"},{"$ref":"#/components/schemas/ActionRequestFbaRemovalOrdersAddDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentAddDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentUpdateDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentFindDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentAsinsUpdateDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentAsinsFindDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentValidateDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentPublishDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentSuspendDetails"},{"$ref":"#/components/schemas/ActionRequestAplusContentPublishRecordsFindDetails"},{"$ref":"#/components/schemas/ActionRequestMcfOrdersAddDetails"},{"$ref":"#/components/schemas/ActionRequestMcfOrdersUpdateDetails"},{"$ref":"#/components/schemas/ActionRequestMcfOrdersFindDetails"},{"$ref":"#/components/schemas/ActionRequestMcfOrdersCancelDetails"},{"$ref":"#/components/schemas/ActionRequestMcfOrdersPreviewDetails"},{"$ref":"#/components/schemas/ActionRequestMcfDeliveryOffersPreviewDetails"},{"$ref":"#/components/schemas/ActionRequestMcfFeaturesMarketplaceFindDetails"},{"$ref":"#/components/schemas/ActionRequestMcfFeaturesSkuFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsCampaignDetails"},{"$ref":"#/components/schemas/ActionRequestAdsAdGroupDetails"},{"$ref":"#/components/schemas/ActionRequestAdsTargetDetails"},{"$ref":"#/components/schemas/ActionRequestAdsAdDetails"},{"$ref":"#/components/schemas/ActionRequestAdsAdAssociationDetails"},{"$ref":"#/components/schemas/ActionRequestAdsCampaignFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsAdGroupFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsTargetFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsAdFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsAdAssociationFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsPortfolioDetails"},{"$ref":"#/components/schemas/ActionRequestAdsPortfolioFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsSpBidRecommendationsFindDetails"},{"$ref":"#/components/schemas/ActionRequestAdsSpTargetRecommendationsFindDetails"}],"description":"Action-specific details submitted when the action was started."},"result":{"nullable":true,"oneOf":[{"$ref":"#/components/schemas/ActionSpApiFeedResult"},{"$ref":"#/components/schemas/ActionAdsCampaignsFindResult"},{"$ref":"#/components/schemas/ActionAdsAdGroupsFindResult"},{"$ref":"#/components/schemas/ActionAdsTargetsFindResult"},{"$ref":"#/components/schemas/ActionAdsAdsFindResult"},{"$ref":"#/components/schemas/ActionAdsAdAssociationsFindResult"},{"$ref":"#/components/schemas/ActionAdsPortfoliosFindResult"},{"$ref":"#/components/schemas/ActionAdsSpRecommendationsFindResult"},{"$ref":"#/components/schemas/ActionExecutionErrorResult"},{"$ref":"#/components/schemas/ActionAdsMutateIssuesResult"},{"$ref":"#/components/schemas/ActionAdsMutateSuccessResult"}],"description":"Action result. For SP-API feed actions, returns feed status fields when finished. For Ads FIND actions, returns the Amazon Ads query response. For SP bid and target recommendation actions, returns success and error item arrays. For successfully completed Ads mutate actions, returns the Amazon Ads mutate response with created or updated entities. For failed actions, returns a user-friendly execution error. For partially successful Ads mutate actions, returns issue summary with item-level messages. Null for in-progress actions."},"queuedAt":{"format":"date-time","type":"string","nullable":true},"startedAt":{"format":"date-time","type":"string","nullable":true},"completedAt":{"format":"date-time","type":"string","nullable":true}},"required":["actionId","type","sellerOrVendorId","status","details","result","queuedAt","startedAt","completedAt"],"title":"ActionStatusResponse"},"ActionValidationIssue":{"type":"object","properties":{"path":{"nullable":false,"type":"array","items":{"type":"string"}},"code":{"type":"string","nullable":false},"message":{"type":"string","nullable":false}},"required":["path","code","message"],"title":"ActionValidationIssue"},"ActionValidationResult":{"type":"object","properties":{"valid":{"type":"boolean","nullable":false},"issues":{"nullable":false,"type":"array","items":{"$ref":"#/components/schemas/ActionValidationIssue"}}},"required":["valid","issues"],"title":"ActionValidationResult"},"ApiBadRequestResponse":{"type":"object","properties":{"message":{"example":["prompt should not be empty"],"description":"The error messages","type":"array","items":{"type":"string"}},"error":{"type":"string","example":"Bad Request","description":"The error type"},"statusCode":{"type":"number","example":400,"description":"The HTTP status code"}},"required":["message","error","statusCode"],"title":"ApiBadRequestResponse"},"ApiLiveActionLimitConfig":{"type":"object","properties":{"message":{"type":"string","example":"Too many in-progress actions for this connection (25/25, sellerOrVendorId=22222222-2222-4222-8222-222222222222). Wait for existing actions to complete or combine multiple operations into a single action request.","description":"Live action limit violation message"},"scope":{"type":"string","example":"CONNECTION","enum":["CONNECTION","ORGANIZATION"],"description":"Whether the organization-wide or per-connection limit was exceeded"},"limit":{"type":"number","example":25,"description":"Maximum allowed live actions for the exceeded scope"},"current":{"type":"number","example":25,"description":"Current number of live actions for the exceeded scope"},"sellerOrVendorId":{"type":"object","example":"22222222-2222-4222-8222-222222222222","nullable":true,"description":"Seller or vendor id when the connection scope limit was exceeded"}},"required":["message","scope","limit","current","sellerOrVendorId"],"title":"ApiLiveActionLimitConfig"},"ApiLiveActionLimitResponse":{"type":"object","properties":{"status":{"type":"number","example":429,"description":"HTTP status code for the error"},"entityType":{"type":"string","example":"LIVE_ACTION_LIMIT","description":"The type of entity that triggered the error"},"config":{"$ref":"#/components/schemas/ApiLiveActionLimitConfig","description":"Live action limit details"}},"required":["status","entityType","config"],"title":"ApiLiveActionLimitResponse"},"ApiNoTokensConfig":{"type":"object","properties":{"message":{"type":"string","description":"No tokens violation message"},"refillUrl":{"type":"string","example":"https://app.datadoe.com/organizations/org-id","description":"URL to refill AI tokens for the organization"}},"required":["message","refillUrl"],"title":"ApiNoTokensConfig"},"ApiNoTokensResponse":{"type":"object","properties":{"status":{"type":"number","example":402,"description":"HTTP status code for the error"},"entityType":{"type":"string","example":"NO_TOKENS","description":"The type of entity that triggered the error"},"message":{"type":"string","description":"No tokens violation message"},"config":{"$ref":"#/components/schemas/ApiNoTokensConfig","description":"No tokens details"}},"required":["status","entityType","message","config"],"title":"ApiNoTokensResponse"},"ApiNotFoundResponse":{"type":"object","properties":{"status":{"type":"number","example":404,"description":"HTTP status code for the error"},"entityType":{"type":"string","example":"EXPORT","description":"The type of entity that was not found"},"config":{"type":"object","example":{"exportId":"export-123"},"description":"Configuration details that identify the missing entity"}},"required":["status","entityType","config"],"title":"ApiNotFoundResponse"},"ApiRateLimitConfig":{"type":"object","properties":{"message":{"type":"string","example":"Rate limit exceeded. Maximum is 2 requests per second per organization.","description":"Rate limit violation message"},"retryAfterSeconds":{"type":"number","example":1,"description":"Number of seconds to wait before retrying request"}},"required":["message","retryAfterSeconds"],"title":"ApiRateLimitConfig"},"ApiRateLimitResponse":{"type":"object","properties":{"status":{"type":"number","example":429,"description":"HTTP status code for the error"},"entityType":{"type":"string","example":"RATE_LIMIT","description":"The type of entity that triggered the error"},"config":{"$ref":"#/components/schemas/ApiRateLimitConfig","description":"Rate limit details"}},"required":["status","entityType","config"],"title":"ApiRateLimitResponse"},"CogsUpsertRequest":{"type":"object","properties":{"sellerOrVendorId":{"type":"string","description":"The ID of the seller or vendor to upsert COGS for.","nullable":false},"cogsToUpsert":{"description":"COGS rows to upsert. Max 1000 rows per request.","nullable":false,"minItems":1,"maxItems":1000,"type":"array","items":{"$ref":"#/components/schemas/CogsUpsertRowRequest"}}},"required":["sellerOrVendorId","cogsToUpsert"],"title":"CogsUpsertRequest"},"CogsUpsertResponse":{"type":"object","properties":{"sellerOrVendorId":{"type":"string","description":"The ID of the seller or vendor COGS were upserted for.","nullable":false},"upsertedCount":{"type":"number","description":"Number of COGS rows upserted.","nullable":false}},"required":["sellerOrVendorId","upsertedCount"],"title":"CogsUpsertResponse"},"CogsUpsertRowRequest":{"type":"object","properties":{"asin":{"type":"string","description":"Cogs ASIN","nullable":false},"sku":{"type":"string","description":"Cogs SKU","nullable":false},"costCurrency":{"type":"string","description":"Cogs currency code","nullable":false},"fromDate":{"type":"string","format":"date","description":"Cogs from date","nullable":false},"costItemValue":{"type":"number","description":"Cogs item value","nullable":false},"costItemShippingValue":{"type":"number","description":"Cogs item shipping value","nullable":false},"itemSupplierName":{"type":"string","description":"Optional supplier name for this COGS row","nullable":true,"maxLength":128}},"required":["asin","sku","costCurrency","fromDate","costItemValue","costItemShippingValue"],"title":"CogsUpsertRowRequest"},"CreateDataFileRequest":{"type":"object","properties":{"name":{"type":"string"},"group":{"type":"string","enum":["LISTING_IMAGES","APLUS_IMAGES"]},"type":{"type":"string","enum":["PNG","TIFF","JPG"]},"sellerOrVendorId":{"type":"string","format":"uuid"},"ttlHours":{"type":"number","minimum":1,"maximum":720}},"required":["name","group","type","sellerOrVendorId"],"title":"CreateDataFileRequest"},"CreatePublicInvitationRequest":{"type":"object","properties":{"name":{"type":"string","description":"Name/label for the invitation link","maxLength":255},"tenantType":{"type":"string","enum":["SELLER","VENDOR"],"description":"Amazon account type."},"accessLevel":{"type":"string","enum":["READ_ONLY","READ_AND_WRITE"]},"redirectUrl":{"type":"string","description":"HTTPS URL to receive the invitation result query parameters.","example":"https://example.com/datadoe/callback"}},"required":["name","tenantType","accessLevel","redirectUrl"],"title":"CreatePublicInvitationRequest"},"CreatePublicInvitationResponse":{"type":"object","properties":{"invitationUrl":{"type":"string","description":"One-time invitation URL."},"expiresAt":{"format":"date-time","type":"string","description":"Invitation expiration timestamp."}},"required":["invitationUrl","expiresAt"],"title":"CreatePublicInvitationResponse"},"DataFileCreateResponse":{"type":"object","properties":{"file":{"$ref":"#/components/schemas/DataFileResponse"},"uploadUrl":{"type":"string","format":"uri"}},"required":["file","uploadUrl"],"title":"DataFileCreateResponse"},"DataFileResponse":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"group":{"type":"string","enum":["LISTING_IMAGES","APLUS_IMAGES"]},"type":{"type":"string","enum":["PNG","TIFF","JPG"]},"status":{"type":"string","enum":["WAITING_FOR_UPLOAD","UPLOADED","EXPIRED","DELETED"]},"source":{"type":"string","enum":["API","MCP","DATA","UI"]},"sellerOrVendorId":{"type":"string"},"connectionId":{"type":"string"},"sizeBytes":{"type":"number","nullable":true},"ttlHours":{"type":"number"},"expiresAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","name","group","type","status","source","sellerOrVendorId","connectionId","sizeBytes","ttlHours","expiresAt","createdAt","updatedAt"],"title":"DataFileResponse"},"DataFilesResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object"}},"meta":{"$ref":"#/components/schemas/PaginatedMeta"}},"required":["data","meta"],"title":"DataFilesResponse"},"ExportAggregation":{"type":"object","properties":{"column":{"type":"string","description":"Column to aggregate","example":"sales","nullable":false},"aggregation":{"type":"string","description":"Type of aggregation. sum requires a numeric column. min, max, and avg accept numeric or date/datetime columns. count/countDistinct accept any column.","example":"sum","enum":["count","countDistinct","sum","avg","min","max"],"nullable":false},"alias":{"type":"string","description":"Optional alias for the aggregation result","example":"total_sales","nullable":true}},"required":["column","aggregation"],"title":"ExportAggregation"},"ExportColumn":{"type":"object","properties":{"name":{"type":"string","description":"Name of the column","example":"sales","nullable":false,"minLength":2,"maxLength":128},"type":{"type":"string","enum":["TEXT","NUMBER","LOGIC","DATE","JSON"],"description":"Type of the column","example":"NUMBER","nullable":false},"nullable":{"type":"boolean","description":"True if the column can contain null values","example":false,"nullable":false},"description":{"type":"string","description":"Description of the column content","nullable":true},"bigQueryOnly":{"type":"boolean","description":"True if the column is available only in direct BigQuery integration","nullable":false}},"required":["name","type","nullable"],"title":"ExportColumn"},"ExportRequest":{"type":"object","properties":{"sellerOrVendorIds":{"description":"Seller or vendor identifiers for the report","example":["1a2b3c4d-5678-90ab-cdef-112233445566"],"nullable":false,"minItems":0,"maxItems":5,"type":"array","items":{"type":"string"}},"sourceId":{"type":"string","description":"ID of the report source","example":"0f3afbdde3","nullable":false,"minLength":10,"maxLength":64,"pattern":"^(?:[a-f0-9]{10}|[a-f0-9]{64})$"},"columns":{"description":"Columns to include in the report. Can include source columns and aggregation aliases. Each export includes default utility columns that identify the seller or vendor and marketplace of each row. You do not need to request those columns.","example":["child_asin","total_sales_sum"],"nullable":false,"maxItems":256,"type":"array","items":{"type":"string"}},"from":{"format":"date-time","type":"string","description":"Start date for the report. Only allowed when the source has a date column; required together with to for those sources.","example":"2023-01-01","nullable":false},"to":{"format":"date-time","type":"string","description":"End date for the report. Only allowed when the source has a date column; required together with from for those sources.","example":"2023-01-31","nullable":false},"filters":{"description":"Filters applied to the report","example":{"combinator":"and","rules":[{"field":"date","operator":">=","value":"2023-01-01","not":false},{"field":"ad_campaign_type","operator":"=","value":"SPONSORED_PRODUCTS","not":false}]},"nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/FilterGroupMessage"}]},"groupBy":{"description":"Fields to group by in the report","example":["date","ad_type"],"nullable":true,"minItems":0,"maxItems":16,"type":"array","items":{"type":"string"}},"aggregations":{"description":"Filters applied to the report","example":[{"column":"sales","aggregation":"sum"},{"column":"orders","aggregation":"countDistinct"}],"nullable":true,"minItems":0,"maxItems":16,"type":"array","items":{"$ref":"#/components/schemas/ExportAggregation"}},"orderByColumn":{"type":"string","description":"Column to order the report by. Can be a source column or an aggregation alias.","example":"total_sales_sum","nullable":true},"orderByDirection":{"type":"string","enum":["ASC","DESC"],"description":"Order direction of the report","example":"ASC","nullable":true},"limit":{"type":"number","description":"Limit the number of rows in the report.","example":100,"nullable":true},"skip":{"type":"number","description":"Number of rows to skip before returning the export results. Use 0 for the first page and combine with `limit` to paginate the results.","example":100,"nullable":true},"dateInterval":{"type":"string","enum":["DAY","WEEK","MONTH"],"description":"Optional interval to truncate date column in the export","example":"MONTH","nullable":true},"outputType":{"type":"string","enum":["CSV","JSON","EXCEL","TSV","XML"],"description":"Output type of the report","example":"CSV"},"sendTo":{"description":"Emails to send the report to","example":["user@example.com","admin@example.com"],"minItems":0,"maxItems":5,"nullable":true,"type":"array","items":{"type":"string"}},"sendToAllOrganizationMembers":{"type":"boolean","description":"Whether to send the report to all organization members","example":true,"default":false}},"description":"Create an export. Each export includes default utility columns that identify the seller or vendor and marketplace of each row. You do not need to request those columns.","required":["sellerOrVendorIds","sourceId","columns","outputType","sendToAllOrganizationMembers"],"title":"ExportRequest"},"ExportResponse":{"type":"object","properties":{"id":{"type":"string","description":"Report ID","example":"e0d7e0e0-4b2d-4f2f-8d0f-2c5d5e0d7e0e","nullable":false},"organizationId":{"type":"string","description":"Organization ID","example":"a1b2c3d4-5678-90ab-cdef-1234567890ab","nullable":false},"sellerOrVendorIds":{"description":"Seller or vendor identifiers","example":["1a2b3c4d-5678-90ab-cdef-112233445566"],"nullable":false,"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["PENDING","IN_PROGRESS","COMPLETED","ERROR","BLOCKED_NO_TOKENS"],"description":"Report status","example":"PENDING","nullable":false},"sourceId":{"type":"string","description":"Report source id","example":"3f1700d6da","nullable":false,"minLength":10,"maxLength":10},"sourceName":{"type":"string","description":"Report source name","example":"Sales & Traffic by ASIN & Date","nullable":false},"dataSourceIssues":{"description":"Informational issues associated with the export source.","nullable":false,"type":"array","items":{"$ref":"#/components/schemas/ExportSourceIssue"}},"name":{"type":"string","description":"Optional friendly name set for the report","example":"Weekly Ad Report","nullable":true},"columns":{"description":"Columns included in the report","example":["col1","col2"],"nullable":false,"type":"array","items":{"type":"string"}},"from":{"format":"date-time","type":"string","description":"Report start date","example":"2025-07-01T00:00:00Z","nullable":true},"to":{"format":"date-time","type":"string","description":"Report end date","example":"2025-07-31T23:59:59Z","nullable":true},"filters":{"type":"object","description":"Filters applied to the report","nullable":true},"groupBy":{"type":"object","description":"Fields to group by in the report","example":["date","ad_type"],"nullable":true},"orderByColumn":{"type":"string","description":"Column to order the report by. Can be a source column or an aggregation alias.","example":"total_sales_sum","nullable":true},"orderByDirection":{"type":"string","enum":["ASC","DESC"],"description":"Order direction of the report","nullable":true},"limit":{"type":"number","description":"Limit the number of rows in the report","example":100,"nullable":true},"skip":{"type":"number","description":"Number of rows skipped before returning the report results","example":100,"nullable":true},"outputType":{"type":"string","enum":["CSV","JSON","EXCEL","TSV","XML"],"description":"Report output type","example":"CSV","nullable":false},"rowCount":{"type":"number","description":"Number of data rows in the generated report","example":1250,"nullable":true},"sendTo":{"description":"Email addresses to send the report to","example":["user@example.com"],"type":"array","items":{"type":"string"}},"sendToAllOrganizationMembers":{"type":"boolean","description":"Should report be sent to all organization members","example":true},"creator":{"type":"string","enum":["USER","AUTOMATION","EXPLORER","SCHEDULE","API","MCP","REPORTS","HOME"],"description":"Entity that created the export","example":"API","nullable":false},"createdAt":{"format":"date-time","type":"string","description":"Creation date","example":"2025-07-28T12:00:00Z","nullable":false},"updatedAt":{"format":"date-time","type":"string","description":"Last update date","example":"2025-07-28T12:00:00Z","nullable":false},"expiresAt":{"format":"date-time","type":"string","description":"Expiration date. One-time exports remain downloadable for 24 hours. Recurring schedule exports remain downloadable for 14 days.","example":"2025-08-28T12:00:00Z","nullable":true}},"required":["id","organizationId","sellerOrVendorIds","status","sourceId","sourceName","dataSourceIssues","name","columns","from","to","filters","groupBy","orderByColumn","orderByDirection","limit","skip","outputType","rowCount","sendTo","sendToAllOrganizationMembers","creator","createdAt","updatedAt","expiresAt"],"title":"ExportResponse"},"ExportScheduleIntegrationsResponse":{"type":"object","properties":{"googleSheetsFormula":{"description":"Google Sheets integration details","nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/GoogleSheetsFormulaIntegration"}]},"powerQuery":{"description":"Excel PowerQuery integration details","nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/PowerQueryIntegration"}]},"staticUrl":{"description":"Static download URL integration details","nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/StaticUrlIntegration"}]}},"required":["googleSheetsFormula","powerQuery","staticUrl"],"title":"ExportScheduleIntegrationsResponse"},"ExportScheduleRequest":{"type":"object","properties":{"sellerOrVendorIds":{"description":"Seller or vendor identifiers associated with the export schedule","example":["1a2b3c4d-5678-90ab-cdef-112233445566"],"nullable":false,"type":"array","items":{"type":"string"}},"sourceId":{"type":"string","description":"ID of the report source","example":"0f3afbdde3","nullable":false,"minLength":10,"maxLength":64,"pattern":"^(?:[a-f0-9]{10}|[a-f0-9]{64})$"},"columns":{"description":"Columns to include in the export schedule. Each export includes default utility columns that identify the seller or vendor and marketplace of each row. You do not need to request those columns.","example":["sales","revenue"],"nullable":false,"type":"array","items":{"type":"string"}},"interval":{"type":"string","enum":["DAY","WEEK","MONTH"],"description":"Aggregation interval used for grouped metrics","example":"DAY"},"relativeInterval":{"type":"string","enum":["DAY","WEEK","MONTH","QUARTER","YEAR"],"description":"Relative interval unit used to resolve the schedule window","example":"WEEK"},"relativeCount":{"type":"number","description":"Number of relative intervals included in the schedule window","example":4},"relativeOffsetCount":{"type":"number","description":"Relative intervals skipped after resolving the base window","example":1,"default":0},"refreshedEveryDays":{"type":"number","description":"Minimum number of days before the period is refreshed again","example":5,"default":0},"filters":{"type":"object","description":"Filters applied to the export schedule","nullable":true},"groupBy":{"description":"Fields to group by","example":["date","ad_type"],"nullable":true,"type":"array","items":{"type":"string"}},"aggregations":{"description":"Aggregations applied to the export schedule","nullable":true,"type":"array","items":{"$ref":"#/components/schemas/ExportAggregation"}},"orderByColumn":{"type":"string","description":"Column to order the schedule by","example":"date","nullable":true},"orderByDirection":{"type":"string","enum":["ASC","DESC"],"description":"Order direction","example":"ASC","nullable":true},"limit":{"type":"number","description":"Row limit for the schedule.","example":100,"nullable":true},"outputType":{"type":"string","enum":["CSV","JSON","EXCEL","TSV","XML"],"description":"Output type of the scheduled export","example":"CSV"},"sendTo":{"description":"Emails to send the export to","example":["user@example.com","admin@example.com"],"nullable":false,"type":"array","items":{"type":"string"}},"sendToAllOrganizationMembers":{"type":"boolean","description":"Send the export to all organization members","example":true,"nullable":false},"name":{"type":"string","description":"Friendly name for the export schedule","example":"Weekly Sales Export","nullable":true},"active":{"type":"boolean","description":"Whether the export schedule is active","example":true,"nullable":false}},"description":"Create an export schedule. Each export includes default utility columns that identify the seller or vendor and marketplace of each row. You do not need to request those columns.","required":["sellerOrVendorIds","sourceId","columns","interval","relativeInterval","relativeCount","outputType","sendTo","sendToAllOrganizationMembers"],"title":"ExportScheduleRequest"},"ExportScheduleWithIntegrationsResponse":{"type":"object","properties":{"schedule":{"$ref":"#/components/schemas/PublicExportScheduleDto","nullable":false,"description":"Export schedule details"},"integrations":{"$ref":"#/components/schemas/ExportScheduleIntegrationsResponse","nullable":false,"description":"Integrations available for the export schedule"}},"required":["schedule","integrations"],"title":"ExportScheduleWithIntegrationsResponse"},"ExportSchedulesResponse":{"type":"object","properties":{"data":{"description":"List of export schedules with integrations","type":"array","items":{"$ref":"#/components/schemas/ExportScheduleWithIntegrationsResponse"}},"meta":{"$ref":"#/components/schemas/PaginatedMeta"}},"required":["data","meta"],"title":"ExportSchedulesResponse"},"ExportSourceDataAvailability":{"type":"object","properties":{"type":{"type":"string","enum":["INTRADAY","REAL_TIME"],"description":"Type of lower-latency data availability.","example":"INTRADAY","nullable":false},"description":{"type":"string","description":"Description of the lower-latency data availability.","example":"Intraday updates are available when source data changes during the day.","nullable":false},"refreshAt":{"type":"string","description":"Local time when DataDoe refreshes the table during the day, if applicable.","example":"1pm","nullable":true}},"required":["type","description"],"title":"ExportSourceDataAvailability"},"ExportSourceIssue":{"type":"object","properties":{"title":{"type":"string","description":"Issue title.","nullable":false},"description":{"type":"string","description":"Optional Markdown issue description.","nullable":true}},"required":["title"],"title":"ExportSourceIssue"},"ExportSourceResponse":{"type":"object","properties":{"id":{"type":"string","description":"ID of the export source","example":"0f3afbdde3","nullable":false,"minLength":10,"maxLength":10},"name":{"type":"string","description":"Name of the export source","example":"asin_sales","nullable":false},"tableName":{"type":"string","description":"Name of the BigQuery table available in direct BigQuery connection","example":"amazon_sales_and_traffic_with_cogs","nullable":false},"type":{"type":"string","enum":["SELLER_CENTRAL","VENDOR_CENTRAL","AMAZON_ADS"],"description":"Type of the export source","examples":["SELLER_CENTRAL","AMAZON_ADS"],"nullable":false},"columns":{"description":"Columns available in the export source","example":[{"name":"date","type":"DATE","nullable":false,"description":"Single date may occur multiple times."},{"name":"ad_sales","type":"NUMBER","nullable":false,"description":null}],"nullable":false,"type":"array","items":{"$ref":"#/components/schemas/ExportColumn"}},"description":{"type":"string","description":"Description of the export source","example":"Daily sales data for ASINs","nullable":false},"issues":{"description":"Informational issues associated with the export source.","nullable":false,"type":"array","items":{"$ref":"#/components/schemas/ExportSourceIssue"}},"userManaged":{"type":"boolean","description":"True if the data in the table is managed by the user","example":true,"nullable":false},"isPremium":{"type":"boolean","description":"True if the export source is a premium table with combined data and higher processing cost (5 AI tokens per Export).","example":false,"nullable":false},"defaultDataset":{"type":"boolean","description":"True if the table is part of the default dataset and cannot be disabled.","example":false,"nullable":false},"enabled":{"type":"boolean","description":"False when a user disabled this table for the organization in DataDoe settings. Disabled sources cannot be used to create exports.","example":true,"nullable":false},"rowCountBilling":{"type":"boolean","description":"True if row count from this table is included in billing.","example":true,"nullable":false},"fetchPeriods":{"description":"Fetch periods of the export source","example":[{"type":"INITIAL","numberOfDays":30},{"type":"RECURRING_DAILY","numberOfDays":1}],"nullable":false,"type":"array","items":{"$ref":"#/components/schemas/TableFetchPeriod"}},"dataAvailability":{"description":"Lower-latency availability details for tables with intraday or real-time updates.","nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/ExportSourceDataAvailability"}]},"sources":{"type":"array","description":"Raw component tables that this export source is built from in the direct BigQuery integration.","example":["connections","raw_sp_api_report_fba_inventory_planning"],"nullable":false,"items":{"type":"string","enum":["connections","currency_rates","raw_ads_api_ams_adgroups","raw_ads_api_ams_ads","raw_ads_api_ams_budget_usage","raw_ads_api_ams_campaign_diagnostics","raw_ads_api_ams_campaigns","raw_ads_api_ams_sb_clickstream","raw_ads_api_ams_sb_conversion","raw_ads_api_ams_sb_rich_media","raw_ads_api_ams_sb_traffic","raw_ads_api_ams_sd_conversion","raw_ads_api_ams_sd_traffic","raw_ads_api_ams_sp_budget_recommendations","raw_ads_api_ams_sp_conversion","raw_ads_api_ams_sp_traffic","raw_ads_api_ams_targets","raw_ads_api_creative_assets","raw_ads_api_entity_history","raw_ads_api_export_ad_groups","raw_ads_api_export_ads","raw_ads_api_export_campaigns","raw_ads_api_export_targets","raw_ads_api_report_ad_group_sd","raw_ads_api_report_advertised_products_sd","raw_ads_api_report_advertised_products_sp","raw_ads_api_report_brand_metrics","raw_ads_api_report_campaign_placement_sp","raw_ads_api_report_campaign_placement_sp_amazon_business","raw_ads_api_report_campaign_sd","raw_ads_api_report_campaign_sp","raw_ads_api_report_gross_and_invalid_traffic_sb","raw_ads_api_report_gross_and_invalid_traffic_sd","raw_ads_api_report_gross_and_invalid_traffic_sp","raw_ads_api_report_legacy_ad_group_sb_all","raw_ads_api_report_legacy_ad_sb_all","raw_ads_api_report_legacy_campaign_sb_all","raw_ads_api_report_legacy_placement_sb_all","raw_ads_api_report_legacy_search_term_sb_all","raw_ads_api_report_legacy_targeting_sb_all","raw_ads_api_report_prompt_ad_extension_sb","raw_ads_api_report_prompt_ad_extension_sp","raw_ads_api_report_purchased_products_sd","raw_ads_api_report_purchased_products_sp","raw_ads_api_report_purchased_products_sb","raw_ads_api_report_search_term_sp","raw_ads_api_report_targeting_sd","raw_ads_api_report_targeting_sp","raw_ads_api_report_video_ad_extension_sp","raw_amazon_cogs","raw_amazon_vendor_codes","raw_sp_api_awd_inbound_shipment_line_items","raw_sp_api_awd_inbound_shipments","raw_sp_api_awd_inventory","raw_sp_api_awd_replenishment_order_line_items","raw_sp_api_awd_replenishment_orders","raw_sp_api_fba_inbound_shipments","raw_sp_api_item_offers","raw_sp_api_listings_items","raw_sp_api_myi_unsuppressed_inventory_data","raw_sp_api_notifications_account_status_changed","raw_sp_api_notifications_any_offer_changed","raw_sp_api_notifications_b2b_any_offer_changed","raw_sp_api_notifications_branded_item_content_change","raw_sp_api_notifications_detail_page_traffic_event","raw_sp_api_notifications_fba_inventory_availability_changes","raw_sp_api_notifications_fba_outbound_shipment_status","raw_sp_api_notifications_fee_promotion","raw_sp_api_notifications_item_inventory_event_change","raw_sp_api_notifications_item_product_type_change","raw_sp_api_notifications_item_sales_event_change","raw_sp_api_notifications_listings_item_issues_change","raw_sp_api_notifications_listings_item_mfn_quantity_change","raw_sp_api_notifications_listings_item_status_change","raw_sp_api_notifications_order_change","raw_sp_api_notifications_transaction_update","raw_sp_api_orders_details_pii","raw_sp_api_replenishment_metrics_by_date","raw_sp_api_replenishment_metrics_by_sku_and_date","raw_sp_api_replenishment_offers","raw_sp_api_report_brand_analytics_market_basket_by_month","raw_sp_api_report_brand_analytics_repeat_purchase","raw_sp_api_report_brand_analytics_search_catalog_performance","raw_sp_api_report_brand_analytics_search_query_performance","raw_sp_api_report_brand_analytics_search_query_weekly","raw_sp_api_report_brand_analytics_search_terms_daily","raw_sp_api_report_brand_analytics_search_terms_monthly","raw_sp_api_report_brand_analytics_search_terms_weekly","raw_sp_api_report_afn_shipments","raw_sp_api_report_coupon_performance","raw_sp_api_report_fba_fulfillment_customer_returns","raw_sp_api_report_fba_fulfillment_longterm_storage_fee_charges","raw_sp_api_report_fba_inventory_planning","raw_sp_api_report_fba_ledger_detail","raw_sp_api_report_fba_ledger_summary","raw_sp_api_report_fba_overage_fee_charges","raw_sp_api_report_fba_reimbursements","raw_sp_api_report_fba_recommended_removal","raw_sp_api_report_fba_removal_orders","raw_sp_api_report_fba_removal_shipments","raw_sp_api_report_fba_shipment_replacement","raw_sp_api_report_fba_storage_fee_charges","raw_sp_api_report_restock_inventory","raw_sp_api_report_flat_file_returns_data_by_return_date","raw_sp_api_report_listings_data","raw_sp_api_report_orders","raw_sp_api_report_promotion_performance","raw_sp_api_report_referral_fee_preview","raw_sp_api_report_restock_inventory","raw_sp_api_report_sales_and_traffic","raw_sp_api_report_settlements","raw_sp_api_report_seller_feedback_data","raw_sp_api_report_v2_seller_performance","raw_sp_api_dk_vendor_analytics_manufacturing","raw_sp_api_dk_vendor_analytics_sourcing","raw_sp_api_dk_vendor_product_availability_manufacturing","raw_sp_api_dk_vendor_product_availability_sourcing","raw_sp_api_report_vendor_forecasting_retail","raw_sp_api_report_vendor_inventory_manufacturing_retail","raw_sp_api_report_vendor_inventory_sourcing_retail","raw_sp_api_report_vendor_net_pure_product_margin","raw_sp_api_report_vendor_real_time_inventory","raw_sp_api_report_vendor_real_time_sales","raw_sp_api_report_vendor_real_time_traffic","raw_sp_api_report_vendor_sales_manufacturing_retail","raw_sp_api_report_vendor_sales_sourcing_retail","raw_sp_api_report_vendor_traffic","raw_sp_api_vendor_df_orders","raw_sp_api_vendor_df_orders_pii","raw_sp_api_vendor_purchase_orders","raw_sp_api_vendor_shipments","refined_ads_estimated_sb_performance_by_asin","refined_ads_negative_keywords","refined_amazon_fba_inventory_by_asin_by_country","refined_amazon_fba_inventory_by_fnsku","refined_products_by_child_asin","refined_sp_api_finances_transactions"]}},"containsPii":{"type":"boolean","description":"True if this table contains personally identifiable information (PII).","example":false,"nullable":false}},"required":["id","name","tableName","type","columns","description","issues","userManaged","isPremium","defaultDataset","enabled","rowCountBilling","fetchPeriods","sources","containsPii"],"title":"ExportSourceResponse"},"ExportSourcesResponse":{"type":"object","properties":{"sources":{"description":"Matching export sources.","nullable":false,"type":"array","items":{"$ref":"#/components/schemas/ExportSourceResponse"}},"recommendedSources":{"description":"Recommended export sources to try next.","nullable":false,"type":"array","items":{"$ref":"#/components/schemas/ExportSourceResponse"}}},"required":["sources","recommendedSources"],"title":"ExportSourcesResponse"},"ExportsResponse":{"type":"object","properties":{"data":{"description":"List of exports","type":"array","items":{"$ref":"#/components/schemas/ExportResponse"}},"meta":{"$ref":"#/components/schemas/PaginatedMeta"}},"required":["data","meta"],"title":"ExportsResponse"},"FilterGroupMessage":{"type":"object","properties":{"combinator":{"type":"string","enum":["and","or"],"description":"Combinator to use for the filter group","example":"and","nullable":false},"rules":{"description":"Rules to use for the filter group","example":[{"field":"date","operator":"=","value":"2023-01-01","not":false},{"field":"ad_campaign_type","operator":"=","value":"SPONSORED_PRODUCTS","not":false}],"nullable":false,"minItems":0,"maxItems":16,"type":"array","items":{"$ref":"#/components/schemas/FilterRuleMessage"}}},"required":["combinator","rules"],"title":"FilterGroupMessage"},"FilterRuleMessage":{"type":"object","properties":{"field":{"type":"string","description":"Field to filter by","example":"date","nullable":false},"operator":{"type":"string","enum":["=","!=",">",">=","<","<=","contains","beginsWith","endsWith","doesNotContain","doesNotBeginWith","doesNotEndWith","in","notIn","between","notBetween","null","notNull"],"description":"Operator to filter by","example":"=","nullable":false},"value":{"type":"string","description":"Value to filter by","example":"2023-01-01","nullable":false},"not":{"type":"boolean","description":"Negate the filter","example":false,"nullable":false}},"required":["field","operator","value","not"],"title":"FilterRuleMessage"},"GoogleSheetsFormulaIntegration":{"type":"object","properties":{"formula":{"type":"string","description":"Google Sheets formula to fetch the latest export","example":"IMPORTDATA(\"https://api.datadoe.com/api/v1/exports/schedules/.../latest\")","nullable":false}},"required":["formula"],"title":"GoogleSheetsFormulaIntegration"},"PaginatedMeta":{"type":"object","properties":{"currentPageSize":{"type":"number","description":"The number of items in the current page"},"pageSize":{"type":"number","description":"The maximum number of items per page"},"currentPage":{"type":"number","description":"The current page number"},"totalPages":{"type":"number","description":"The total number of pages"},"hasPreviousPage":{"type":"boolean","description":"Whether there is a previous page"},"hasNextPage":{"type":"boolean","description":"Whether there is a next page"},"results":{"type":"number","description":"The number of items in the current page"},"totalResults":{"type":"number","description":"The total number of items"}},"required":["currentPageSize","pageSize","currentPage","totalPages","hasPreviousPage","hasNextPage","results","totalResults"],"title":"PaginatedMeta"},"PowerQueryIntegration":{"type":"object","properties":{"query":{"type":"string","description":"Excel PowerQuery script to fetch the latest export","example":"let ... in ...","nullable":false}},"required":["query"],"title":"PowerQueryIntegration"},"PublicExportScheduleDto":{"type":"object","properties":{"id":{"type":"string","description":"Export schedule ID","example":"e0d7e0e0-4b2d-4f2f-8d0f-2c5d5e0d7e0e","nullable":false},"organizationId":{"type":"string","description":"Organization ID","example":"a1b2c3d4-5678-90ab-cdef-1234567890ab","nullable":false},"sellerOrVendorIds":{"description":"Seller or vendor identifiers associated with the schedule","example":["1a2b3c4d-5678-90ab-cdef-112233445566"],"nullable":false,"type":"array","items":{"type":"string"}},"name":{"type":"string","description":"Optional friendly name for the schedule","example":"Weekly Sales Export","nullable":true},"active":{"type":"boolean","description":"Whether the export schedule is active","example":true,"nullable":false},"source":{"type":"string","description":"Report source name","example":"Orders Report","nullable":false},"sourceId":{"type":"string","description":"Report source id","example":"3f1700d6da0b58030c0ddfc54ae6bfdb583bd6c9c9b1fa4d14eab16f3fab4f39","nullable":false},"sourceName":{"type":"string","description":"Report source name","example":"Sales & Traffic by ASIN & Date","nullable":true},"columns":{"description":"Columns included in the export schedule","example":["col1","col2"],"nullable":false,"type":"array","items":{"type":"string"}},"relativeInterval":{"type":"string","enum":["DAY","WEEK","MONTH","QUARTER","YEAR"],"description":"Relative interval used to compute the schedule window","example":"WEEK","nullable":false},"relativeCount":{"type":"number","description":"Number of relative intervals composing the schedule window","example":4,"nullable":false},"relativeOffsetCount":{"type":"number","description":"Relative intervals skipped after evaluation (e.g. completed periods)","example":1,"nullable":false},"refreshedEveryDays":{"type":"number","description":"Minimum number of days between automatic refreshes","example":5,"nullable":false},"filters":{"type":"object","description":"Filters applied to the export schedule","nullable":true},"groupBy":{"description":"Fields to group by","example":["date","ad_type"],"nullable":false,"type":"array","items":{"type":"string"}},"aggregations":{"description":"Aggregations applied to the export schedule","example":[{"column":"sales","aggregation":"sum","alias":null}],"nullable":true,"type":"array","items":{"type":"string"}},"orderByColumn":{"type":"string","description":"Column used for ordering","example":"date","nullable":true},"orderByDirection":{"type":"string","enum":["ASC","DESC"],"description":"Order direction","nullable":true},"limit":{"type":"number","description":"Row limit for the export","example":100,"nullable":true},"outputType":{"type":"string","enum":["CSV","JSON","EXCEL","TSV","XML"],"description":"Output type for the export","example":"CSV","nullable":false},"sendTo":{"description":"Email recipients","example":["user@example.com"],"nullable":false,"type":"array","items":{"type":"string"}},"sendToAllOrganizationMembers":{"type":"boolean","description":"Whether to send to all organization members","example":true,"nullable":false},"creator":{"type":"string","enum":["USER","API"],"description":"Entity that created the schedule","example":"API","nullable":false},"latestExport":{"description":"Most recent completed export generated from this schedule","nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/PublicExportScheduleLatestExportDto"}]},"createdAt":{"format":"date-time","type":"string","description":"Creation date","nullable":false},"updatedAt":{"format":"date-time","type":"string","description":"Last update date","nullable":false},"createdBy":{"type":"string","description":"User who created the schedule","nullable":false},"updatedBy":{"type":"string","description":"User who last updated the schedule","nullable":false}},"required":["id","organizationId","sellerOrVendorIds","name","active","source","sourceId","sourceName","columns","relativeInterval","relativeCount","relativeOffsetCount","refreshedEveryDays","filters","groupBy","aggregations","orderByColumn","orderByDirection","limit","outputType","sendTo","sendToAllOrganizationMembers","creator","latestExport","createdAt","updatedAt","createdBy","updatedBy"],"title":"PublicExportScheduleDto"},"PublicExportScheduleLatestExportDto":{"type":"object","properties":{"id":{"type":"string","description":"Export ID","example":"e0d7e0e0-4b2d-4f2f-8d0f-2c5d5e0d7e0e","nullable":false},"createdAt":{"format":"date-time","type":"string","description":"Export creation date","example":"2024-01-15T10:30:00Z","nullable":false}},"required":["id","createdAt"],"title":"PublicExportScheduleLatestExportDto"},"SellersAndVendorsConnectionDto":{"type":"object","properties":{"id":{"type":"string","description":"Connection ID","nullable":true},"name":{"type":"string","description":"Connection name","nullable":true},"rowCount":{"type":"number","description":"Connection row count","nullable":true},"initialLoadComplete":{"type":"boolean","description":"Whether the initial load is complete","nullable":true}},"required":["id","name","rowCount","initialLoadComplete"],"title":"SellersAndVendorsConnectionDto"},"SellersAndVendorsItemDto":{"type":"object","properties":{"id":{"type":"string","description":"Seller or vendor identifier"},"name":{"type":"string","description":"Seller or vendor name"},"accountType":{"type":"string","enum":["SELLER","VENDOR","ADS_ONLY"],"description":"Account type: SELLER (Seller Central, optional Ads), VENDOR (Vendor Central, optional Ads), or ADS_ONLY (Amazon Ads only). Use this field instead of null connection objects."},"rowCount":{"type":"number","description":"Total row count for Seller Central, Vendor Central, and Amazon Ads connections"},"marketplaceId":{"type":"string","description":"Amazon marketplace ID","nullable":true},"marketplaceCountryCode":{"type":"string","description":"Amazon marketplace country code","nullable":true},"marketplaceCountryName":{"type":"string","description":"Amazon marketplace country name","nullable":true},"sellerCentralConnection":{"description":"Seller Central connection details","nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/SellersAndVendorsConnectionDto"}]},"vendorCentralConnection":{"description":"Vendor Central connection details","nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/SellersAndVendorsConnectionDto"}]},"amazonAdsConnection":{"description":"Amazon Ads connection details","nullable":true,"type":"object","allOf":[{"$ref":"#/components/schemas/SellersAndVendorsConnectionDto"}]}},"required":["id","name","accountType","rowCount","marketplaceId","marketplaceCountryCode","marketplaceCountryName","sellerCentralConnection","vendorCentralConnection","amazonAdsConnection"],"title":"SellersAndVendorsItemDto"},"SellersAndVendorsParamsDto":{"type":"object","properties":{"page":{"type":"number","nullable":true,"description":"Query page parameter given by the caller."},"pageSize":{"type":"number","nullable":true,"description":"Query pageSize parameter given by the caller."},"query":{"type":"string","nullable":true,"description":"Query search parameter given by the caller."},"marketplaceCountryCode":{"type":"string","nullable":true,"description":"Query marketplaceCountryCode parameter given by the caller."}},"title":"SellersAndVendorsParamsDto"},"SellersAndVendorsResponseDto":{"type":"object","properties":{"data":{"description":"Paginated sellers and vendors","type":"array","items":{"$ref":"#/components/schemas/SellersAndVendorsItemDto"}},"meta":{"$ref":"#/components/schemas/PaginatedMeta"},"params":{"$ref":"#/components/schemas/SellersAndVendorsParamsDto","description":"Query parameters given by the caller"}},"required":["data","meta","params"],"title":"SellersAndVendorsResponseDto"},"StaticUrlIntegration":{"type":"object","properties":{"url":{"type":"string","description":"Static download URL for the latest export","example":"https://api.datadoe.com/api/v1/exports/schedules/.../latest","nullable":false},"pythonSnippet":{"type":"string","description":"Python code snippet to fetch the latest export","nullable":false},"typescriptSnippet":{"type":"string","description":"TypeScript code snippet to fetch the latest export","nullable":false},"javascriptSnippet":{"type":"string","description":"JavaScript code snippet to fetch the latest export","nullable":false},"javaSnippet":{"type":"string","description":"Java code snippet to fetch the latest export","nullable":false},"phpSnippet":{"type":"string","description":"PHP code snippet to fetch the latest export","nullable":false},"csharpSnippet":{"type":"string","description":"C# code snippet to fetch the latest export","nullable":false},"curlSnippet":{"type":"string","description":"cURL command to fetch the latest export","nullable":false}},"required":["url","pythonSnippet","typescriptSnippet","javascriptSnippet","javaSnippet","phpSnippet","csharpSnippet","curlSnippet"],"title":"StaticUrlIntegration"},"TableFetchPeriod":{"type":"object","properties":{"type":{"type":"string","description":"Period type","enum":["CONTINUOUS","INITIAL","RECURRING_DAILY","RECURRING_WEEKLY","RECURRING_MONTHLY"],"example":"INITIAL","nullable":false},"numberOfDays":{"type":"number","description":"Number of days of data fetched","example":30,"nullable":false},"shiftDays":{"type":"number","description":"Shift the resulting date range by this many days","example":0,"nullable":true}},"required":["type","numberOfDays"],"title":"TableFetchPeriod"},"UsageLogResponseDto":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"usedBy":{"type":"string","format":"uuid","nullable":true},"usedByEmail":{"type":"string","nullable":true},"tokensUsed":{"type":"number"},"usagePool":{"type":"string","enum":["FREE","CREDIT","PLAN","BUNDLE","EXTRA"]},"balanceAfter":{"type":"number"},"extraTokensAfter":{"type":"number"},"organizationAiTokenBundleId":{"type":"string","format":"uuid","nullable":true},"bundleTokensBefore":{"type":"number","nullable":true},"bundleTokensAfter":{"type":"number","nullable":true},"usageType":{"type":"string","enum":["EXPORTS","AI","INTEGRATIONS_BIGQUERY","INTEGRATIONS_API","ACTIONS","COGS","VENDOR_CODE","PLUGINS","INTEGRATIONS","TOKENS","ORGANIZATION","CONNECTIONS","SETTINGS"]},"specificUsageType":{"type":"string","enum":["AI_CHAT_STANDARD_MODE","AI_CHAT_ANALYST_MODE","AI_CHAT_INVESTIGATION_MODE","AI_SCHEDULED_PROMPT_STANDARD_MODE","AI_SCHEDULED_PROMPT_ANALYST_MODE","AI_API_PROMPT_STANDARD_MODE","AI_API_PROMPT_ANALYST_MODE","AI_MCP_PROMPT_STANDARD_MODE","AI_MCP_PROMPT_ANALYST_MODE","INTEGRATIONS_API_SP_API_PROXY_STANDARD","INTEGRATIONS_API_ADS_API_PROXY_STANDARD","INTEGRATIONS_WEBHOOKS_STANDARD","INTEGRATIONS_BIGQUERY_RAW","INTEGRATIONS_BIGQUERY_INTEGRATED","ACTIONS_API_STANDARD","ACTIONS_MCP_STANDARD","EXPORTS_UI_STANDARD","EXPORTS_EXPLORER_STANDARD","EXPORTS_API_STANDARD","EXPORTS_MCP_STANDARD","EXPORTS_HOME_STANDARD","EXPORTS_AUTOMATION_STANDARD","EXPORTS_REPORTS_STANDARD","EXPORTS_RECURRING_STANDARD","COGS_API_STANDARD","COGS_MCP_STANDARD","VENDOR_CODE_API_STANDARD","VENDOR_CODE_MCP_STANDARD","PLUGINS_GET","PLUGINS_CREATE","PLUGINS_EDIT","PLUGINS_ENABLE","PLUGINS_DISABLE","PLUGINS_SKILLS_GET","EXPORTS_API_GET","EXPORTS_API_LIST","EXPORTS_MCP_GET","ACTIONS_API_GET","ACTIONS_API_LIST","ACTIONS_MCP_GET","ACTIONS_MCP_LIST","INTEGRATIONS_API_KEY_CREATE","INTEGRATIONS_MCP_KEY_CREATE","INTEGRATIONS_OAUTH_AUTHORIZE","INTEGRATIONS_WEBHOOK_CREATE","INTEGRATIONS_WEBHOOK_REMOVE","TOKENS_BUNDLE_PURCHASE","TOKENS_BUNDLE_EXHAUSTION","TOKENS_BUNDLE_EXPIRATION","ORGANIZATION_SPENDING_LIMIT_CHANGE","ORGANIZATION_USER_ADD","ORGANIZATION_USER_REMOVE","CONNECTIONS_SELLER_OR_VENDOR_ADD","CONNECTIONS_SELLER_OR_VENDOR_REMOVE","CONNECTIONS_CONNECTION_ADD","CONNECTIONS_CONNECTION_REMOVE","SETTINGS_TABLE_ENABLE","SETTINGS_TABLE_DISABLE","SETTINGS_ACTION_TYPE_ENABLE","SETTINGS_ACTION_TYPE_DISABLE"]},"usageDetails":{"type":"object","nullable":true,"additionalProperties":true},"relatedEntityId":{"type":"string","format":"uuid","nullable":true},"usedAt":{"format":"date-time","type":"string"}},"required":["id","organizationId","usedBy","usedByEmail","tokensUsed","usagePool","balanceAfter","extraTokensAfter","organizationAiTokenBundleId","bundleTokensBefore","bundleTokensAfter","usageType","specificUsageType","usageDetails","relatedEntityId","usedAt"],"title":"UsageLogResponseDto"},"UsageLogsResponseDto":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/UsageLogResponseDto"}},"meta":{"$ref":"#/components/schemas/PaginatedMeta"}},"required":["data","meta"],"title":"UsageLogsResponseDto"},"UtilityBillingDto":{"type":"object","properties":{"monthlyCost":{"type":"number","description":"Current monthly cost","nullable":true},"nextBillingDate":{"format":"date-time","type":"string","description":"Next billing date","nullable":true}},"required":["monthlyCost","nextBillingDate"],"title":"UtilityBillingDto"},"UtilityCurrentMaxDto":{"type":"object","properties":{"current":{"type":"number","description":"Current value"},"max":{"type":"number","description":"Max allowed value"}},"required":["current","max"],"title":"UtilityCurrentMaxDto"},"UtilityOrganizationDto":{"type":"object","properties":{"id":{"type":"string","description":"Organization ID"},"name":{"type":"string","description":"Organization name"}},"required":["id","name"],"title":"UtilityOrganizationDto"},"UtilityOrganizationResponseDto":{"type":"object","properties":{"organization":{"$ref":"#/components/schemas/UtilityOrganizationDto","description":"Organization metadata"},"aiTokens":{"$ref":"#/components/schemas/UtilityCurrentMaxDto","description":"AI tokens values"},"dataRows":{"$ref":"#/components/schemas/UtilityCurrentMaxDto","description":"Data rows values"},"billing":{"$ref":"#/components/schemas/UtilityBillingDto","description":"Billing metadata"}},"required":["organization","aiTokens","dataRows","billing"],"title":"UtilityOrganizationResponseDto"},"VendorCodeUpsertRequest":{"type":"object","properties":{"sellerOrVendorId":{"type":"string","description":"The ID of the seller or vendor to upsert Vendor Codes for.","nullable":false},"vendorCodesToUpsert":{"description":"Vendor Code rows to upsert. Max 1000 rows per request.","nullable":false,"minItems":1,"maxItems":1000,"type":"array","items":{"$ref":"#/components/schemas/VendorCodeUpsertRowRequest"}}},"required":["sellerOrVendorId","vendorCodesToUpsert"],"title":"VendorCodeUpsertRequest"},"VendorCodeUpsertResponse":{"type":"object","properties":{"sellerOrVendorId":{"type":"string","description":"The ID of the seller or vendor Vendor Codes were upserted for.","nullable":false},"upsertedCount":{"type":"number","description":"Number of Vendor Code rows upserted.","nullable":false}},"required":["sellerOrVendorId","upsertedCount"],"title":"VendorCodeUpsertResponse"},"VendorCodeUpsertRowRequest":{"type":"object","properties":{"asin":{"type":"string","description":"Vendor code ASIN. Exactly one of asin or sku must be provided.","nullable":true},"sku":{"type":"string","description":"Vendor code SKU. Exactly one of asin or sku must be provided.","nullable":true},"vendorCode":{"type":"string","description":"Vendor code","nullable":false}},"required":["vendorCode"],"title":"VendorCodeUpsertRowRequest"}}}}