{"openapi":"3.1.0","paths":{"/public/v2/websites":{"get":{"operationId":"PublicApiV2AnalyticsController_listWebsites","parameters":[{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","required":false,"in":"query","schema":{"type":"string","minLength":1,"maxLength":22000}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"domain_url":{"type":"string","format":"uri"},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"language":{"anyOf":[{"type":"string","minLength":1,"maxLength":128},{"type":"null"}]},"industry_niche":{"anyOf":[{"type":"string","minLength":1,"maxLength":500},{"type":"null"}]},"last_analysis_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["id","domain_url","country","language","industry_niche","last_analysis_at"],"additionalProperties":{}}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"has_more":{"type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"scan_upper_bound":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["request_id","has_more","next_cursor"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}}},"security":[{"bearer":[]}],"summary":"List websites available to the workspace","tags":["Public API V2"]}},"/public/v2/websites/{website_id}":{"get":{"operationId":"PublicApiV2AnalyticsController_getWebsite","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"domain_url":{"type":"string","format":"uri"},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"language":{"anyOf":[{"type":"string","minLength":1,"maxLength":128},{"type":"null"}]},"industry_niche":{"anyOf":[{"type":"string","minLength":1,"maxLength":500},{"type":"null"}]},"last_analysis_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["id","domain_url","country","language","industry_niche","last_analysis_at"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}}},"security":[{"bearer":[]}],"summary":"Get one website","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/analytics":{"get":{"operationId":"PublicApiV2AnalyticsController_latest","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}},{"name":"include","required":false,"in":"query","schema":{"type":"string","pattern":"^\\s*(?:providers|competitors)(?:\\s*,\\s*(?:providers|competitors))*\\s*$"},"description":"Comma-separated providers and competitors expansions."}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"analysis_id":{"anyOf":[{"type":"string","maxLength":128,"pattern":"^ana_[A-Za-z0-9_-]+$"},{"type":"null"}]},"as_of":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"available_at":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"metrics":{"type":"object","properties":{"visibility":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"share_of_voice":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"sentiment":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"citation_share":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"average_mention_position":{"anyOf":[{"type":"number","minimum":1},{"type":"null"}]}},"required":["visibility","share_of_voice","sentiment","citation_share","average_mention_position"],"additionalProperties":{}},"counts":{"type":"object","properties":{"visibility_mentioned_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"visibility_eligible_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"visibility_eligible_providers":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_brand_mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_competitor_mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_pool_mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_eligible_providers":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sentiment_scored_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sentiment_eligible_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"brand_citations":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"competitor_citations":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"citation_pool":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"positioned_mention_sentences":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["visibility_mentioned_responses","visibility_eligible_responses","visibility_eligible_providers","sov_brand_mentions","sov_competitor_mentions","sov_pool_mentions","sov_eligible_providers","sentiment_scored_responses","sentiment_eligible_responses","brand_citations","competitor_citations","citation_pool","positioned_mention_sentences"],"additionalProperties":{}},"providers":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9]+(?:[-_][a-z0-9]+)*$"},"metrics":{"type":"object","properties":{"visibility":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"share_of_voice":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"sentiment":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"citation_share":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"average_mention_position":{"anyOf":[{"type":"number","minimum":1},{"type":"null"}]}},"required":["visibility","share_of_voice","sentiment","citation_share","average_mention_position"],"additionalProperties":{}},"counts":{"type":"object","properties":{"visibility_mentioned_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"visibility_eligible_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_brand_mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_competitor_mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_pool_mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sentiment_scored_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sentiment_eligible_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"brand_citations":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"competitor_citations":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"citation_pool":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"positioned_mention_sentences":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["visibility_mentioned_responses","visibility_eligible_responses","sov_brand_mentions","sov_competitor_mentions","sov_pool_mentions","sentiment_scored_responses","sentiment_eligible_responses","brand_citations","competitor_citations","citation_pool","positioned_mention_sentences"],"additionalProperties":{}},"unavailable_reasons":{"type":"object","propertyNames":{"type":"string","enum":["visibility","share_of_voice","sentiment","citation_share","average_mention_position"]},"additionalProperties":{"type":"string","enum":["no_finalized_analysis","no_eligible_responses","visibility_facts_unavailable","no_tracked_mentions","sov_facts_unavailable","no_scored_responses","sentiment_scoring_failed","sentiment_evidence_unavailable","no_competitive_citations","citation_extraction_failed","citation_evidence_unavailable","no_brand_mentions","mention_position_evidence_unavailable"]}}},"required":["provider","metrics","counts","unavailable_reasons"],"additionalProperties":{}}},"competitors":{"type":"array","items":{"type":"object","properties":{"competitor_domain":{"type":"string","minLength":1,"maxLength":253},"metrics":{"type":"object","properties":{"visibility":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"share_of_voice":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"citation_share":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"average_mention_position":{"anyOf":[{"type":"number","minimum":1},{"type":"null"}]}},"required":["visibility","share_of_voice","citation_share","average_mention_position"],"additionalProperties":{}},"counts":{"type":"object","properties":{"mentioned_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"eligible_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"citations":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"positioned_mention_sentences":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["mentioned_responses","eligible_responses","mentions","citations","positioned_mention_sentences"],"additionalProperties":{}},"unavailable_reasons":{"type":"object","propertyNames":{"type":"string","enum":["visibility","share_of_voice","citation_share","average_mention_position"]},"additionalProperties":{"type":"string","enum":["no_eligible_responses","competitor_visibility_facts_unavailable","no_competitive_mentions","competitor_sov_facts_unavailable","no_competitive_citations","competitor_citation_facts_unavailable","no_competitor_mentions","competitor_position_evidence_unavailable"]}}},"required":["competitor_domain","metrics","counts","unavailable_reasons"],"additionalProperties":{}}}},"required":["website_id","analysis_id","as_of","available_at","metrics","counts"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"includes":{"maxItems":2,"type":"array","items":{"type":"string","enum":["providers","competitors"]}},"projection_version":{"type":"string","maxLength":40,"pattern":"^public_metrics_v\\d+$"},"metric_definition_bundle_version":{"type":"string","maxLength":64,"pattern":"^public_metric_definitions_v(?:0|[1-9]\\d*)$"},"metric_precision_version":{"type":"string","maxLength":64,"pattern":"^metric_precision_v(?:0|[1-9]\\d*)$"},"metric_definition_versions":{"type":"object","properties":{"visibility":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"},"share_of_voice":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"},"sentiment":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"},"citation_share":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"},"average_mention_position":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"}},"required":["visibility","share_of_voice","sentiment","citation_share","average_mention_position"],"additionalProperties":{}},"unavailable_reasons":{"type":"object","propertyNames":{"type":"string","enum":["visibility","share_of_voice","sentiment","citation_share","average_mention_position"]},"additionalProperties":{"type":"string","enum":["no_finalized_analysis","no_eligible_responses","visibility_facts_unavailable","no_tracked_mentions","sov_facts_unavailable","no_scored_responses","sentiment_scoring_failed","sentiment_evidence_unavailable","no_competitive_citations","citation_extraction_failed","citation_evidence_unavailable","no_brand_mentions","mention_position_evidence_unavailable"]}},"data_quality":{"type":"object","properties":{"is_partial":{"type":"boolean"}},"required":["is_partial"],"additionalProperties":{}}},"required":["request_id","includes","projection_version","metric_definition_bundle_version","metric_precision_version","metric_definition_versions","unavailable_reasons","data_quality"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}}},"security":[{"bearer":[]}],"summary":"Get the latest finalized analytics snapshot","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/analytics/history":{"get":{"operationId":"PublicApiV2AnalyticsController_history","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}},{"name":"updated_since","required":false,"in":"query","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?Z$"}},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","required":false,"in":"query","schema":{"type":"string","minLength":1,"maxLength":22000}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"analysis_id":{"type":"string","maxLength":128,"pattern":"^ana_[A-Za-z0-9_-]+$"},"as_of":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"available_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"metrics":{"type":"object","properties":{"visibility":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"share_of_voice":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"sentiment":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"citation_share":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"average_mention_position":{"anyOf":[{"type":"number","minimum":1},{"type":"null"}]}},"required":["visibility","share_of_voice","sentiment","citation_share","average_mention_position"],"additionalProperties":{}},"counts":{"type":"object","properties":{"visibility_mentioned_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"visibility_eligible_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"visibility_eligible_providers":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_brand_mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_competitor_mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_pool_mentions":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sov_eligible_providers":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sentiment_scored_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sentiment_eligible_responses":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"brand_citations":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"competitor_citations":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"citation_pool":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"positioned_mention_sentences":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["visibility_mentioned_responses","visibility_eligible_responses","visibility_eligible_providers","sov_brand_mentions","sov_competitor_mentions","sov_pool_mentions","sov_eligible_providers","sentiment_scored_responses","sentiment_eligible_responses","brand_citations","competitor_citations","citation_pool","positioned_mention_sentences"],"additionalProperties":{}},"meta":{"type":"object","properties":{"projection_version":{"type":"string","maxLength":40,"pattern":"^public_metrics_v\\d+$"},"metric_definition_bundle_version":{"type":"string","maxLength":64,"pattern":"^public_metric_definitions_v(?:0|[1-9]\\d*)$"},"metric_precision_version":{"type":"string","maxLength":64,"pattern":"^metric_precision_v(?:0|[1-9]\\d*)$"},"metric_definition_versions":{"type":"object","properties":{"visibility":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"},"share_of_voice":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"},"sentiment":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"},"citation_share":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"},"average_mention_position":{"type":"string","maxLength":96,"pattern":"^[a-z][a-z0-9_]*_v(?:0|[1-9]\\d*)$"}},"required":["visibility","share_of_voice","sentiment","citation_share","average_mention_position"],"additionalProperties":{}},"unavailable_reasons":{"type":"object","propertyNames":{"type":"string","enum":["visibility","share_of_voice","sentiment","citation_share","average_mention_position"]},"additionalProperties":{"type":"string","enum":["no_finalized_analysis","no_eligible_responses","visibility_facts_unavailable","no_tracked_mentions","sov_facts_unavailable","no_scored_responses","sentiment_scoring_failed","sentiment_evidence_unavailable","no_competitive_citations","citation_extraction_failed","citation_evidence_unavailable","no_brand_mentions","mention_position_evidence_unavailable"]}},"data_quality":{"type":"object","properties":{"is_partial":{"type":"boolean"}},"required":["is_partial"],"additionalProperties":{}}},"required":["projection_version","metric_definition_bundle_version","metric_precision_version","metric_definition_versions","unavailable_reasons","data_quality"],"additionalProperties":{}}},"required":["website_id","analysis_id","as_of","available_at","metrics","counts","meta"],"additionalProperties":{}}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"has_more":{"type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"scan_upper_bound":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["request_id","has_more","next_cursor"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}}},"security":[{"bearer":[]}],"summary":"List immutable analytics history","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/mentions":{"get":{"operationId":"PublicApiV2AnalyticsController_mentions","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}},{"name":"updated_since","required":false,"in":"query","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?Z$"}},{"name":"provider","required":false,"in":"query","schema":{"enum":["chatgpt","gemini","perplexity","google_ai_overview"],"type":"string"}},{"name":"analysis_id","required":false,"in":"query","schema":{"type":"string","maxLength":128,"pattern":"^ana_[A-Za-z0-9_-]+$"}},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","required":false,"in":"query","schema":{"type":"string","minLength":1,"maxLength":22000}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^men_[A-Za-z0-9_-]+$"},"analysis_id":{"type":"string","maxLength":128,"pattern":"^ana_[A-Za-z0-9_-]+$"},"observed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"available_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"provider":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9]+(?:[-_][a-z0-9]+)*$"},"sentence_text":{"type":"string"},"sentence_text_truncated":{"type":"boolean"},"position_in_response":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"sentiment":{"anyOf":[{"type":"number","minimum":0,"maximum":100},{"type":"null"}]},"mention_spans":{"type":"array","items":{"type":"object","properties":{"start":{"type":"integer","minimum":0,"maximum":9007199254740991},"end":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["start","end"],"additionalProperties":{}}}},"required":["id","analysis_id","observed_at","available_at","provider","sentence_text","sentence_text_truncated","position_in_response","sentiment","mention_spans"],"additionalProperties":{}}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"has_more":{"type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"scan_upper_bound":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["request_id","has_more","next_cursor"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}}},"security":[{"bearer":[]}],"summary":"List brand mention evidence","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/citations":{"get":{"operationId":"PublicApiV2AnalyticsController_citations","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}},{"name":"updated_since","required":false,"in":"query","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?Z$"}},{"name":"entity_type","required":false,"in":"query","schema":{"enum":["brand","competitor","other"],"type":"string"}},{"name":"provider","required":false,"in":"query","schema":{"enum":["chatgpt","gemini","perplexity","google_ai_overview"],"type":"string"}},{"name":"analysis_id","required":false,"in":"query","schema":{"type":"string","maxLength":128,"pattern":"^ana_[A-Za-z0-9_-]+$"}},{"name":"limit","required":false,"in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","required":false,"in":"query","schema":{"type":"string","minLength":1,"maxLength":22000}}],"responses":{"200":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^cit_[A-Za-z0-9_-]+$"},"analysis_id":{"type":"string","maxLength":128,"pattern":"^ana_[A-Za-z0-9_-]+$"},"observed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"available_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"provider":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[a-z0-9]+(?:[-_][a-z0-9]+)*$"},"url":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"domain":{"anyOf":[{"type":"string","minLength":1,"maxLength":253},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"position":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"url_unavailable_reason":{"type":"string","enum":["invalid_url","unsafe_url"]},"entity_type":{"type":"string","enum":["brand","competitor","other"]},"competitor_domain":{"type":"string","minLength":1,"maxLength":253}},"required":["id","analysis_id","observed_at","available_at","provider","url","domain","title","position","entity_type"],"additionalProperties":{}}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"has_more":{"type":"boolean"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"scan_upper_bound":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["request_id","has_more","next_cursor"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"400":{"description":"Invalid request or cursor.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"401":{"description":"Authentication is required.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"403":{"description":"The API key lacks read scope.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"404":{"description":"The resource was not found.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"429":{"description":"Rate limit exceeded.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"500":{"description":"Unexpected server failure.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"503":{"description":"A required service is temporarily unavailable.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}}},"security":[{"bearer":[]}],"summary":"List citation evidence","tags":["Public API V2"]}},"/public/v2/websites/{website_id}/prompts:import":{"post":{"operationId":"PublicApiV2PromptImportController_submit","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":255}}],"responses":{"200":{"description":"Terminal replay receipt.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}},"Location":{"description":"Relative URL of the prompt import receipt.","schema":{"type":"string","pattern":"^/public/v2/websites/web_[A-Za-z0-9_-]+/prompt-imports/pim_[A-Za-z0-9_-]+$"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"pending"},"validate_only":{"type":"boolean"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only"]},{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"processing"},"validate_only":{"type":"boolean"},"phase":{"type":"string","enum":["validating","classifying","committing"]},"started_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","phase","started_at"]},{"oneOf":[{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"succeeded"},"validate_only":{"type":"boolean","const":false},"summary":{"type":"object","properties":{"submitted":{"type":"integer","minimum":1,"maximum":1000},"skipped_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_request_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_active_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_inactive_duplicates":{"type":"integer","minimum":0,"maximum":1000},"created":{"type":"integer","minimum":0,"maximum":1000},"active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"prompt_limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["submitted","skipped_duplicates","skipped_request_duplicates","skipped_active_duplicates","skipped_inactive_duplicates","created","active_count","prompt_limit"]},"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"oneOf":[{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"created"},"classification":{"type":"object","properties":{"version":{"type":"string","const":"prompt-classifier-v1"},"fields":{"type":"object","properties":{"language":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"tags":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"search_intent":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"category":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"topic":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"seed_keyword":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]}},"required":["language","tags","search_intent","category","topic","seed_keyword"]}},"required":["version","fields"]}},"required":["index","status"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"skipped"},"code":{"type":"string","enum":["skipped_request_duplicate","skipped_active_duplicate","skipped_inactive_duplicate"]}},"required":["index","status","code"]}]}},"completed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","summary","items","completed_at"]},{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"succeeded"},"validate_only":{"type":"boolean","const":true},"summary":{"type":"object","properties":{"submitted":{"type":"integer","minimum":1,"maximum":1000},"skipped_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_request_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_active_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_inactive_duplicates":{"type":"integer","minimum":0,"maximum":1000},"would_create":{"type":"integer","minimum":0,"maximum":1000},"active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"projected_active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"prompt_limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["submitted","skipped_duplicates","skipped_request_duplicates","skipped_active_duplicates","skipped_inactive_duplicates","would_create","active_count","projected_active_count","prompt_limit"]},"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"oneOf":[{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"would_create"},"classification":{"type":"object","properties":{"version":{"type":"string","const":"prompt-classifier-v1"},"fields":{"type":"object","properties":{"language":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"tags":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"search_intent":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"category":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"topic":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"seed_keyword":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]}},"required":["language","tags","search_intent","category","topic","seed_keyword"]}},"required":["version","fields"]}},"required":["index","status"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"skipped"},"code":{"type":"string","enum":["skipped_request_duplicate","skipped_active_duplicate","skipped_inactive_duplicate"]}},"required":["index","status","code"]}]}},"completed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","summary","items","completed_at"]}]},{"oneOf":[{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"failed"},"validate_only":{"type":"boolean","const":false},"summary":{"type":"object","properties":{"submitted":{"type":"integer","minimum":1,"maximum":1000},"skipped_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_request_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_active_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_inactive_duplicates":{"type":"integer","minimum":0,"maximum":1000},"created":{"type":"number","const":0},"active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"prompt_limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"oneOf":[{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"failed"},"code":{"type":"string","const":"classification_failed"},"classification":{"type":"object","properties":{"version":{"type":"string","const":"prompt-classifier-v1"},"fields":{"type":"object","properties":{"language":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"tags":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"search_intent":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"category":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"topic":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"seed_keyword":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]}},"required":["language","tags","search_intent","category","topic","seed_keyword"]}},"required":["version","fields"]}},"required":["index","status","code"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"skipped"},"code":{"type":"string","enum":["skipped_request_duplicate","skipped_active_duplicate","skipped_inactive_duplicate"]}},"required":["index","status","code"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"not_processed"}},"required":["index","status"]}]}},"error":{"oneOf":[{"type":"object","properties":{"code":{"type":"string","const":"invalid_category"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"prompt_limit_exceeded"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"classification_failed"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"classification_unavailable"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"commit_conflict"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"processing_deadline_exceeded"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"internal_processing_error"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]}]},"completed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","items","error","completed_at"]},{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"failed"},"validate_only":{"type":"boolean","const":true},"summary":{"type":"object","properties":{"submitted":{"type":"integer","minimum":1,"maximum":1000},"skipped_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_request_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_active_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_inactive_duplicates":{"type":"integer","minimum":0,"maximum":1000},"would_create":{"type":"integer","minimum":0,"maximum":1000},"active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"projected_active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"prompt_limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"oneOf":[{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"failed"},"code":{"type":"string","const":"classification_failed"},"classification":{"type":"object","properties":{"version":{"type":"string","const":"prompt-classifier-v1"},"fields":{"type":"object","properties":{"language":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"tags":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"search_intent":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"category":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"topic":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"seed_keyword":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]}},"required":["language","tags","search_intent","category","topic","seed_keyword"]}},"required":["version","fields"]}},"required":["index","status","code"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"skipped"},"code":{"type":"string","enum":["skipped_request_duplicate","skipped_active_duplicate","skipped_inactive_duplicate"]}},"required":["index","status","code"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"not_processed"}},"required":["index","status"]}]}},"error":{"oneOf":[{"type":"object","properties":{"code":{"type":"string","const":"invalid_category"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"prompt_limit_exceeded"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"classification_failed"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"classification_unavailable"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"commit_conflict"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"processing_deadline_exceeded"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"internal_processing_error"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]}]},"completed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","items","error","completed_at"]}]}]},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"202":{"description":"Accepted or pending receipt.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}},"Location":{"description":"Relative URL of the prompt import receipt.","schema":{"type":"string","pattern":"^/public/v2/websites/web_[A-Za-z0-9_-]+/prompt-imports/pim_[A-Za-z0-9_-]+$"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"pending"},"validate_only":{"type":"boolean"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only"]},{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"processing"},"validate_only":{"type":"boolean"},"phase":{"type":"string","enum":["validating","classifying","committing"]},"started_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","phase","started_at"]},{"oneOf":[{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"succeeded"},"validate_only":{"type":"boolean","const":false},"summary":{"type":"object","properties":{"submitted":{"type":"integer","minimum":1,"maximum":1000},"skipped_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_request_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_active_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_inactive_duplicates":{"type":"integer","minimum":0,"maximum":1000},"created":{"type":"integer","minimum":0,"maximum":1000},"active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"prompt_limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["submitted","skipped_duplicates","skipped_request_duplicates","skipped_active_duplicates","skipped_inactive_duplicates","created","active_count","prompt_limit"]},"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"oneOf":[{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"created"},"classification":{"type":"object","properties":{"version":{"type":"string","const":"prompt-classifier-v1"},"fields":{"type":"object","properties":{"language":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"tags":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"search_intent":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"category":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"topic":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"seed_keyword":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]}},"required":["language","tags","search_intent","category","topic","seed_keyword"]}},"required":["version","fields"]}},"required":["index","status"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"skipped"},"code":{"type":"string","enum":["skipped_request_duplicate","skipped_active_duplicate","skipped_inactive_duplicate"]}},"required":["index","status","code"]}]}},"completed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","summary","items","completed_at"]},{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"succeeded"},"validate_only":{"type":"boolean","const":true},"summary":{"type":"object","properties":{"submitted":{"type":"integer","minimum":1,"maximum":1000},"skipped_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_request_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_active_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_inactive_duplicates":{"type":"integer","minimum":0,"maximum":1000},"would_create":{"type":"integer","minimum":0,"maximum":1000},"active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"projected_active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"prompt_limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["submitted","skipped_duplicates","skipped_request_duplicates","skipped_active_duplicates","skipped_inactive_duplicates","would_create","active_count","projected_active_count","prompt_limit"]},"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"oneOf":[{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"would_create"},"classification":{"type":"object","properties":{"version":{"type":"string","const":"prompt-classifier-v1"},"fields":{"type":"object","properties":{"language":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"tags":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"search_intent":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"category":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"topic":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"seed_keyword":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]}},"required":["language","tags","search_intent","category","topic","seed_keyword"]}},"required":["version","fields"]}},"required":["index","status"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"skipped"},"code":{"type":"string","enum":["skipped_request_duplicate","skipped_active_duplicate","skipped_inactive_duplicate"]}},"required":["index","status","code"]}]}},"completed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","summary","items","completed_at"]}]},{"oneOf":[{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"failed"},"validate_only":{"type":"boolean","const":false},"summary":{"type":"object","properties":{"submitted":{"type":"integer","minimum":1,"maximum":1000},"skipped_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_request_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_active_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_inactive_duplicates":{"type":"integer","minimum":0,"maximum":1000},"created":{"type":"number","const":0},"active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"prompt_limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"oneOf":[{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"failed"},"code":{"type":"string","const":"classification_failed"},"classification":{"type":"object","properties":{"version":{"type":"string","const":"prompt-classifier-v1"},"fields":{"type":"object","properties":{"language":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"tags":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"search_intent":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"category":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"topic":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"seed_keyword":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]}},"required":["language","tags","search_intent","category","topic","seed_keyword"]}},"required":["version","fields"]}},"required":["index","status","code"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"skipped"},"code":{"type":"string","enum":["skipped_request_duplicate","skipped_active_duplicate","skipped_inactive_duplicate"]}},"required":["index","status","code"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"not_processed"}},"required":["index","status"]}]}},"error":{"oneOf":[{"type":"object","properties":{"code":{"type":"string","const":"invalid_category"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"prompt_limit_exceeded"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"classification_failed"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"classification_unavailable"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"commit_conflict"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"processing_deadline_exceeded"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"internal_processing_error"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]}]},"completed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","items","error","completed_at"]},{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"failed"},"validate_only":{"type":"boolean","const":true},"summary":{"type":"object","properties":{"submitted":{"type":"integer","minimum":1,"maximum":1000},"skipped_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_request_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_active_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_inactive_duplicates":{"type":"integer","minimum":0,"maximum":1000},"would_create":{"type":"integer","minimum":0,"maximum":1000},"active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"projected_active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"prompt_limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"oneOf":[{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"failed"},"code":{"type":"string","const":"classification_failed"},"classification":{"type":"object","properties":{"version":{"type":"string","const":"prompt-classifier-v1"},"fields":{"type":"object","properties":{"language":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"tags":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"search_intent":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"category":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"topic":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"seed_keyword":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]}},"required":["language","tags","search_intent","category","topic","seed_keyword"]}},"required":["version","fields"]}},"required":["index","status","code"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"skipped"},"code":{"type":"string","enum":["skipped_request_duplicate","skipped_active_duplicate","skipped_inactive_duplicate"]}},"required":["index","status","code"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"not_processed"}},"required":["index","status"]}]}},"error":{"oneOf":[{"type":"object","properties":{"code":{"type":"string","const":"invalid_category"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"prompt_limit_exceeded"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"classification_failed"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"classification_unavailable"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"commit_conflict"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"processing_deadline_exceeded"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"internal_processing_error"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]}]},"completed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","items","error","completed_at"]}]}]},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"400":{"description":"The request is invalid.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"401":{"description":"Authentication is required.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"403":{"description":"The API key lacks prompt write access.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"404":{"description":"The resource was not found.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"409":{"description":"The idempotency key conflicts with an existing request.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"413":{"description":"The request payload is too large.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"415":{"description":"The request media type is not supported.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"429":{"description":"Rate limit exceeded.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}},"Retry-After":{"description":"Minimum delay in seconds before retrying.","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"500":{"description":"Unexpected server failure.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"503":{"description":"A required service is temporarily unavailable.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}}},"security":[{"bearer":[]}],"summary":"Submit an append-only prompt import","tags":["Public API V2"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"type":"object","properties":{"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"prompt_text":{"type":"string"},"tags":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"language":{"type":"string","pattern":"^[a-z]{2}$"},"search_intent":{"type":"string","enum":["informational","commercial","transactional"]},"category":{"anyOf":[{"type":"string","minLength":1,"maxLength":100},{"type":"null"}]},"topic":{"anyOf":[{"type":"string","minLength":1,"maxLength":120},{"type":"null"}]},"seed_keyword":{"anyOf":[{"type":"string","minLength":1,"maxLength":255},{"type":"null"}]}},"required":["prompt_text"],"additionalProperties":false}},"defaults":{"default":{},"type":"object","properties":{"tags":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":80}},"language":{"type":"string","pattern":"^[a-z]{2}$"},"search_intent":{"type":"string","enum":["informational","commercial","transactional"]}},"additionalProperties":false},"classification":{"default":{"mode":"auto"},"type":"object","properties":{"mode":{"default":"auto","type":"string","enum":["auto","provided_only"]}},"required":["mode"],"additionalProperties":false},"validate_only":{"default":false,"type":"boolean"}},"required":["items","defaults","classification","validate_only"],"additionalProperties":false}}}}}},"/public/v2/websites/{website_id}/prompt-imports/{import_id}":{"get":{"operationId":"PublicApiV2PromptImportController_get","parameters":[{"name":"website_id","required":true,"in":"path","description":"Opaque website identifier.","schema":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"}},{"name":"import_id","required":true,"in":"path","description":"Opaque prompt import identifier.","schema":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"}}],"responses":{"200":{"description":"Current prompt import receipt.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}},"Retry-After":{"description":"Polling delay in seconds. Present only while status is pending or processing.","schema":{"type":"string","pattern":"^[1-9][0-9]*$","example":"2"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"pending"},"validate_only":{"type":"boolean"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only"]},{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"processing"},"validate_only":{"type":"boolean"},"phase":{"type":"string","enum":["validating","classifying","committing"]},"started_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","phase","started_at"]},{"oneOf":[{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"succeeded"},"validate_only":{"type":"boolean","const":false},"summary":{"type":"object","properties":{"submitted":{"type":"integer","minimum":1,"maximum":1000},"skipped_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_request_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_active_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_inactive_duplicates":{"type":"integer","minimum":0,"maximum":1000},"created":{"type":"integer","minimum":0,"maximum":1000},"active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"prompt_limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["submitted","skipped_duplicates","skipped_request_duplicates","skipped_active_duplicates","skipped_inactive_duplicates","created","active_count","prompt_limit"]},"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"oneOf":[{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"created"},"classification":{"type":"object","properties":{"version":{"type":"string","const":"prompt-classifier-v1"},"fields":{"type":"object","properties":{"language":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"tags":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"search_intent":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"category":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"topic":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"seed_keyword":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]}},"required":["language","tags","search_intent","category","topic","seed_keyword"]}},"required":["version","fields"]}},"required":["index","status"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"skipped"},"code":{"type":"string","enum":["skipped_request_duplicate","skipped_active_duplicate","skipped_inactive_duplicate"]}},"required":["index","status","code"]}]}},"completed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","summary","items","completed_at"]},{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"succeeded"},"validate_only":{"type":"boolean","const":true},"summary":{"type":"object","properties":{"submitted":{"type":"integer","minimum":1,"maximum":1000},"skipped_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_request_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_active_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_inactive_duplicates":{"type":"integer","minimum":0,"maximum":1000},"would_create":{"type":"integer","minimum":0,"maximum":1000},"active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"projected_active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"prompt_limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["submitted","skipped_duplicates","skipped_request_duplicates","skipped_active_duplicates","skipped_inactive_duplicates","would_create","active_count","projected_active_count","prompt_limit"]},"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"oneOf":[{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"would_create"},"classification":{"type":"object","properties":{"version":{"type":"string","const":"prompt-classifier-v1"},"fields":{"type":"object","properties":{"language":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"tags":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"search_intent":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"category":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"topic":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"seed_keyword":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]}},"required":["language","tags","search_intent","category","topic","seed_keyword"]}},"required":["version","fields"]}},"required":["index","status"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"skipped"},"code":{"type":"string","enum":["skipped_request_duplicate","skipped_active_duplicate","skipped_inactive_duplicate"]}},"required":["index","status","code"]}]}},"completed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","summary","items","completed_at"]}]},{"oneOf":[{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"failed"},"validate_only":{"type":"boolean","const":false},"summary":{"type":"object","properties":{"submitted":{"type":"integer","minimum":1,"maximum":1000},"skipped_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_request_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_active_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_inactive_duplicates":{"type":"integer","minimum":0,"maximum":1000},"created":{"type":"number","const":0},"active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"prompt_limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"oneOf":[{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"failed"},"code":{"type":"string","const":"classification_failed"},"classification":{"type":"object","properties":{"version":{"type":"string","const":"prompt-classifier-v1"},"fields":{"type":"object","properties":{"language":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"tags":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"search_intent":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"category":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"topic":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"seed_keyword":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]}},"required":["language","tags","search_intent","category","topic","seed_keyword"]}},"required":["version","fields"]}},"required":["index","status","code"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"skipped"},"code":{"type":"string","enum":["skipped_request_duplicate","skipped_active_duplicate","skipped_inactive_duplicate"]}},"required":["index","status","code"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"not_processed"}},"required":["index","status"]}]}},"error":{"oneOf":[{"type":"object","properties":{"code":{"type":"string","const":"invalid_category"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"prompt_limit_exceeded"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"classification_failed"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"classification_unavailable"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"commit_conflict"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"processing_deadline_exceeded"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"internal_processing_error"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]}]},"completed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","items","error","completed_at"]},{"type":"object","properties":{"id":{"type":"string","maxLength":128,"pattern":"^pim_[A-Za-z0-9_-]+$"},"object":{"type":"string","const":"prompt_import"},"website_id":{"type":"string","maxLength":128,"pattern":"^web_[A-Za-z0-9_-]+$"},"created_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"expires_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"status":{"type":"string","const":"failed"},"validate_only":{"type":"boolean","const":true},"summary":{"type":"object","properties":{"submitted":{"type":"integer","minimum":1,"maximum":1000},"skipped_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_request_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_active_duplicates":{"type":"integer","minimum":0,"maximum":1000},"skipped_inactive_duplicates":{"type":"integer","minimum":0,"maximum":1000},"would_create":{"type":"integer","minimum":0,"maximum":1000},"active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"projected_active_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"prompt_limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"items":{"minItems":1,"maxItems":1000,"type":"array","items":{"oneOf":[{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"failed"},"code":{"type":"string","const":"classification_failed"},"classification":{"type":"object","properties":{"version":{"type":"string","const":"prompt-classifier-v1"},"fields":{"type":"object","properties":{"language":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"tags":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"search_intent":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"category":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"topic":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]},"seed_keyword":{"type":"object","properties":{"source":{"type":"string","enum":["provided","defaulted","derived","not_applicable","low_confidence"]},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["source"]}},"required":["language","tags","search_intent","category","topic","seed_keyword"]}},"required":["version","fields"]}},"required":["index","status","code"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"skipped"},"code":{"type":"string","enum":["skipped_request_duplicate","skipped_active_duplicate","skipped_inactive_duplicate"]}},"required":["index","status","code"]},{"type":"object","properties":{"index":{"type":"integer","minimum":0,"maximum":999},"client_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"},"status":{"type":"string","const":"not_processed"}},"required":["index","status"]}]}},"error":{"oneOf":[{"type":"object","properties":{"code":{"type":"string","const":"invalid_category"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"prompt_limit_exceeded"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"classification_failed"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":false},"retry_strategy":{"type":"string","const":"none"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"classification_unavailable"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"commit_conflict"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"processing_deadline_exceeded"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]},{"type":"object","properties":{"code":{"type":"string","const":"internal_processing_error"},"message":{"type":"string","minLength":1,"maxLength":1024},"retryable":{"type":"boolean","const":true},"retry_strategy":{"type":"string","const":"new_idempotency_key"}},"required":["code","message","retryable","retry_strategy"]}]},"completed_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["id","object","website_id","created_at","expires_at","status","validate_only","items","error","completed_at"]}]}]},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["data","meta"],"additionalProperties":{}}}}},"400":{"description":"The request is invalid.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"401":{"description":"Authentication is required.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"403":{"description":"The API key lacks prompt write access.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"404":{"description":"The resource was not found.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"429":{"description":"Rate limit exceeded.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}},"Retry-After":{"description":"Minimum delay in seconds before retrying.","schema":{"type":"string","pattern":"^[1-9][0-9]*$"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"500":{"description":"Unexpected server failure.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}},"503":{"description":"A required service is temporarily unavailable.","headers":{"Cache-Control":{"description":"Prevents storage of this private API response.","schema":{"type":"string","enum":["private, no-store"]}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_request","invalid_cursor","unauthorized","forbidden","not_found","idempotency_conflict","payload_too_large","unsupported_media_type","rate_limited","temporarily_unavailable","internal_error"]},"message":{"type":"string","minLength":1,"maxLength":1024},"details":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"field":{"type":"string","minLength":1,"maxLength":128},"issue":{"type":"string","minLength":1,"maxLength":256}},"required":["field","issue"],"additionalProperties":{}}}},"required":["code","message"],"additionalProperties":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string","pattern":"^[A-Za-z0-9._-]{1,128}$"}},"required":["request_id"],"additionalProperties":{}}},"required":["error","meta"],"additionalProperties":{}}}}}},"security":[{"bearer":[]}],"summary":"Get a prompt import receipt","tags":["Public API V2"]}},"/public/v2/openapi.json":{"get":{"operationId":"getPublicApiV2OpenApiDocument","summary":"Download the Public API V2 OpenAPI document","description":"Returns the independently versioned OpenAPI 3.1 JSON document.","security":[],"responses":{"200":{"description":"The Public API V2 OpenAPI document.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}}},"info":{"title":"Videntic Public API V2","description":"The independently versioned Videntic Public API V2 contract.","version":"2.0.0","contact":{}},"tags":[],"servers":[{"url":"https://api.videntic.com"}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"API Key","type":"http"}},"schemas":{}}}