{"openapi":"3.1.0","info":{"title":"CiteLadder API","version":"1"},"servers":[{"url":"https://api.citeladder.com"}],"security":[{"apiKey":[]}],"components":{"schemas":{"ActionDeclaration":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"action_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"output_revision_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"member_opportunity_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"opportunity_snapshot_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"target_site_url_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"target_external_url":{"type":["string","null"]},"declared_implemented_at":{"type":"string"},"expected_checks":{"type":"array","items":{"$ref":"#/components/schemas/ExpectedCheck"}},"state":{"$ref":"#/components/schemas/ImplementationState"},"limitations":{"type":"array","items":{"type":"string"}},"verification_events":{"type":"array","items":{"$ref":"#/components/schemas/VerificationEvent"}},"legs":{"type":"array","items":{"$ref":"#/components/schemas/MeasurementLeg"}},"checks":{"type":"array","items":{"$ref":"#/components/schemas/DeclarationCheck"}},"measured_until":{"type":"string"},"created_at":{"type":"string"}},"required":["id","action_id","output_revision_id","member_opportunity_ids","opportunity_snapshot_id","target_site_url_ids","target_external_url","declared_implemented_at","expected_checks","state","limitations","verification_events","legs","checks","measured_until","created_at"],"additionalProperties":false},"ActionDetail":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"project_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"target_kind":{"type":"string"},"target_label":{"type":"string"},"target_url":{"type":["string","null"]},"target_prompt_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"origin":{"type":"string","enum":["evidence","agent"]},"status":{"$ref":"#/components/schemas/ActionStatus"},"priority_score":{"type":["number","null"]},"families":{"type":"array","items":{"type":"string"}},"approach":{"type":"string"},"skill_id":{"type":"string"},"member_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"evidence_cleared_at":{"type":["string","null"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"member_measurement":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"string","enum":["next_visibility_run","next_search_console_window","next_crawl"]},{"type":"null"}]}},"declarable_since":{"type":"string"},"diagnosis":{"type":"object","properties":{"what_happened":{"type":"array","items":{"type":"object","properties":{"opportunity_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"rule_id":{"type":"string"},"title":{"type":"string"},"family":{"type":"string"},"priority_score":{"type":"number"}},"required":["opportunity_id","rule_id","title","family","priority_score"],"additionalProperties":false}},"families":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","enum":["observed","no_finding","unavailable"]}},"approach":{"type":"string"},"skill_id":{"type":"string"},"donts":{"type":"array","items":{"type":"string"}},"measure_with":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"members":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"project_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"rule_id":{"type":"string"},"opportunity_type":{"$ref":"#/components/schemas/OpportunityType"},"severity":{"$ref":"#/components/schemas/OpportunitySeverity"},"priority_score":{"type":"number"},"title":{"type":"string"},"target_key":{"type":"string"},"target_prompt_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"target_url":{"type":["string","null"]},"target_theme":{"type":["string","null"]},"target_label":{"type":["string","null"]},"action_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"system_rank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"display_rank":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"order_source":{"type":"string","enum":["system","manual"]},"priority_factors":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["string","number"]}},"evidence_summary":{"type":"object","properties":{"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"kinds":{"type":"array","items":{"type":"string"}}},"required":["count","kinds"],"additionalProperties":false},"created_at":{"type":"string"},"updated_at":{"type":"string"},"remediation":{"type":"string"}},"required":["id","project_id","rule_id","opportunity_type","severity","priority_score","title","target_key","target_prompt_id","target_url","target_theme","target_label","action_id","system_rank","display_rank","order_source","priority_factors","evidence_summary","created_at","updated_at","remediation"],"additionalProperties":false}},"declaration":{"anyOf":[{"$ref":"#/components/schemas/ActionDeclaration"},{"type":"null"}]}},"required":["id","project_id","target_kind","target_label","target_url","target_prompt_id","origin","status","priority_score","families","approach","skill_id","member_count","evidence_cleared_at","created_at","updated_at","member_measurement","declarable_since","diagnosis","members","declaration"],"additionalProperties":false},"ActionItem":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"project_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"target_kind":{"type":"string"},"target_label":{"type":"string"},"target_url":{"type":["string","null"]},"target_prompt_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"origin":{"type":"string","enum":["evidence","agent"]},"status":{"$ref":"#/components/schemas/ActionStatus"},"priority_score":{"type":["number","null"]},"families":{"type":"array","items":{"type":"string"}},"approach":{"type":"string"},"skill_id":{"type":"string"},"member_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"evidence_cleared_at":{"type":["string","null"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","project_id","target_kind","target_label","target_url","target_prompt_id","origin","status","priority_score","families","approach","skill_id","member_count","evidence_cleared_at","created_at","updated_at"],"additionalProperties":false},"ActionsPage":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ActionItem"}},"next_cursor":{"type":["string","null"]},"status_counts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}}},"required":["items","next_cursor","status_counts"],"additionalProperties":false},"ActionStatus":{"type":"string","enum":["open","in_progress","implemented","measuring","done","dismissed"]},"AdOwnership":{"type":"string","enum":["owned","competitor","other"]},"AiReferrals":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"window_start":{"type":"string"},"window_end":{"type":"string"},"granularity":{"$ref":"#/components/schemas/SnapshotGranularity"},"referral_volume":{"$ref":"#/components/schemas/MetricSeries"},"referral_share":{"$ref":"#/components/schemas/MetricSeries"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/AiReferralSourceRow"}},"analyzer_version":{"type":"string"},"formula_version":{"type":"string"},"scope":{"default":"property-wide","type":"string","const":"property-wide"},"reporting_timezone":{"default":null,"type":["string","null"]},"currency_code":{"default":null,"type":["string","null"]},"analytics_quality":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"revision":{"type":["number","null"]},"flags":{"type":"array","items":{"type":"string"}},"artifact_ids":{"type":"array","items":{"type":"string"}},"reporting_timezone":{"type":["string","null"]},"currency_code":{"type":["string","null"]},"excluded_hosts":{"type":"number"}},"required":["day","revision","flags","artifact_ids","reporting_timezone","currency_code","excluded_hosts"],"additionalProperties":false}}},"unattributed_landing":{"default":null,"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"source_measures":{"default":[],"type":"array","items":{"type":"object","properties":{"ai_source":{"$ref":"#/components/schemas/AiSource"},"sessions":{"type":["number","null"]},"key_events":{"type":["number","null"]},"engagement_rate":{"type":["number","null"]},"transactions":{"type":["number","null"]},"purchase_revenue":{"type":["number","null"]}},"required":["ai_source","sessions","key_events","engagement_rate","transactions","purchase_revenue"],"additionalProperties":false}},"channel_comparison":{"default":[],"type":"array","items":{"type":"object","properties":{"channel":{"type":"string"},"sessions":{"type":["number","null"]},"key_events":{"type":["number","null"]},"engagement_rate":{"type":["number","null"]}},"required":["channel","sessions","key_events","engagement_rate"],"additionalProperties":false}},"landing_pages":{"default":[],"type":"array","items":{"type":"object","properties":{"url_hash":{"type":"string"},"canonical_url":{"type":"string"},"ai_source":{"$ref":"#/components/schemas/AiSource"},"sessions":{"type":["number","null"]},"key_events":{"type":["number","null"]},"analytics_quality":{"type":"array","items":{"type":"string"}}},"required":["url_hash","canonical_url","ai_source","sessions","key_events","analytics_quality"],"additionalProperties":false}}},"required":["project_id","window_start","window_end","granularity","referral_volume","referral_share","sources","analyzer_version","formula_version","scope","reporting_timezone","currency_code","analytics_quality","unattributed_landing","source_measures","channel_comparison","landing_pages"],"additionalProperties":false},"AiReferralSourceRow":{"type":"object","properties":{"ai_source":{"type":"string","enum":["chatgpt","gemini","claude","perplexity","copilot","google_ai_overview"]},"sessions":{"type":"integer","minimum":0,"maximum":9007199254740991},"share":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]}},"required":["ai_source","sessions","share"],"additionalProperties":false},"AiSource":{"type":"string","enum":["chatgpt","gemini","claude","perplexity","copilot","google_ai_overview","other"]},"AiTrafficOverview":{"type":"object","properties":{"crawl":{"$ref":"#/components/schemas/CrawlSummary"},"referrals":{"$ref":"#/components/schemas/AiReferrals"},"citations":{"type":"object","properties":{"unit":{"type":"string","const":"tracked_citations"},"count":{"type":["number","null"]},"label":{"type":"string"}},"required":["unit","count","label"],"additionalProperties":false}},"required":["crawl","referrals","citations"],"additionalProperties":false},"AiTrafficPages":{"type":"object","properties":{"window_start":{"type":"string"},"window_end":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"url_hash":{"type":"string"},"canonical_url":{"type":"string"},"display_path":{"type":"string"},"folder":{"type":"string"},"resource_class":{"type":"string"},"crawl":{"$ref":"#/components/schemas/TrafficLeg"},"referrals":{"$ref":"#/components/schemas/TrafficLeg"},"citations":{"$ref":"#/components/schemas/TrafficLeg"},"findings":{"$ref":"#/components/schemas/TrafficLeg"},"key_events":{"type":["number","null"]},"last_crawl":{"type":["string","null"]},"errors_4xx":{"type":["number","null"]},"errors_5xx":{"type":["number","null"]}},"required":["url_hash","canonical_url","display_path","folder","resource_class","crawl","referrals","citations","findings","key_events","last_crawl","errors_4xx","errors_5xx"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]},"observed_crawl_coverage":{"type":"object","properties":{"state":{"type":"string"},"share":{"type":["number","null"]},"known_pages":{"type":"number"},"observed_pages":{"type":["number","null"]},"inventory_date":{"type":["string","null"]},"inventory_complete":{"type":"boolean"},"sample_mode":{"type":"boolean"},"label":{"type":"string","const":"Observed crawl coverage"}},"required":["state","share","known_pages","observed_pages","inventory_date","inventory_complete","sample_mode","label"],"additionalProperties":false}},"required":["window_start","window_end","items","next_cursor","observed_crawl_coverage"],"additionalProperties":false},"AnswerStates":{"type":"object","properties":{"mentioned_and_cited":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"mentioned_only":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cited_only":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"neither":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["mentioned_and_cited","mentioned_only","cited_only","neither"],"additionalProperties":false},"Audit":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspace_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"project_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"parent_audit_id":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"status":{"$ref":"#/components/schemas/AuditStatus"},"benchmark_mode":{"type":"string"},"audit_scope":{"default":"brand","type":"string","enum":["brand","commerce"]},"model_provenance":{"default":[],"type":"array","items":{"$ref":"#/components/schemas/ModelProvenance"}},"repetitions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"random_seed":{"type":"string"},"requested_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"completed_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"failed_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"error_message":{"type":"string"},"engine_snapshots":{"type":"array","items":{"type":"object","properties":{"logical_engine":{"type":"string"},"transport_provider":{"type":"string"},"transport_model":{"type":"string"}},"required":["logical_engine","transport_provider","transport_model"],"additionalProperties":false}},"market":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"country_code":{"type":"string"},"language_code":{"type":"string"}},"required":["id","country_code","language_code"],"additionalProperties":false},"launch_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"not_applicable_engines":{"type":"array","items":{"$ref":"#/components/schemas/LogicalEngine"}},"created_at":{"type":"string"},"updated_at":{"type":"string"},"started_at":{"type":["string","null"]},"completed_at":{"type":["string","null"]}},"required":["id","workspace_id","project_id","parent_audit_id","status","benchmark_mode","audit_scope","model_provenance","repetitions","random_seed","requested_count","completed_count","failed_count","error_message","engine_snapshots","market","launch_id","not_applicable_engines","created_at","updated_at","started_at","completed_at"],"additionalProperties":false},"AuditEstimate":{"type":"object","properties":{"retrieval_enabled":{"type":"boolean"},"prompt_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"engine_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"repetition_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"market_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"execution_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maximum_attempt_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maximum_wall_clock_seconds":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"cost_status":{"type":"string","enum":["complete","partial","unknown"]},"estimated_total_cost_microusd":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"engines":{"type":"array","items":{"type":"object","properties":{"logical_engine":{"$ref":"#/components/schemas/LogicalEngine"},"transport_provider":{"$ref":"#/components/schemas/TransportProvider"},"transport_model":{"type":"string"},"retrieval_enabled":{"type":["boolean","null"]},"prompt_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"repetition_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"market_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"execution_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maximum_attempt_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"estimated_input_tokens":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"estimated_output_tokens":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"estimated_search_calls":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"estimated_token_cost_microusd":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"estimated_search_cost_microusd":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"estimated_total_cost_microusd":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"cost_status":{"type":"string","enum":["complete","partial","unknown"]},"pricing_version":{"type":"string"}},"required":["logical_engine","transport_provider","transport_model","retrieval_enabled","prompt_count","repetition_count","market_count","execution_count","maximum_attempt_count","estimated_input_tokens","estimated_output_tokens","estimated_search_calls","estimated_token_cost_microusd","estimated_search_cost_microusd","estimated_total_cost_microusd","cost_status","pricing_version"],"additionalProperties":false}}},"required":["retrieval_enabled","prompt_count","engine_count","repetition_count","market_count","execution_count","maximum_attempt_count","maximum_wall_clock_seconds","cost_status","estimated_total_cost_microusd","engines"],"additionalProperties":false},"AuditSchedule":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspace_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"project_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"prompt_set_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"audit_scope":{"type":"string","enum":["brand","commerce"]},"cadence":{"$ref":"#/components/schemas/AuditScheduleCadence"},"interval_minutes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"timezone":{"type":"string"},"engines":{"type":"array","items":{"$ref":"#/components/schemas/LogicalEngine"}},"market_ids":{"type":"array","items":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"repetitions":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"benchmark_mode":{"anyOf":[{"$ref":"#/components/schemas/BenchmarkMode"},{"type":"null"}]},"enabled":{"type":"boolean"},"next_run_at":{"type":["string","null"]},"last_run_at":{"type":["string","null"]},"failure_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"last_error":{"type":"string"},"last_failure_at":{"type":["string","null"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","workspace_id","project_id","prompt_set_id","audit_scope","cadence","interval_minutes","timezone","engines","market_ids","repetitions","benchmark_mode","enabled","next_run_at","last_run_at","failure_count","last_error","last_failure_at","created_at","updated_at"],"additionalProperties":false},"AuditScheduleCadence":{"type":"string","enum":["one_time","every_n_minutes","hourly","daily","weekly"]},"AuditStatus":{"type":"string","enum":["draft","validating","queued","running","analyzing","reporting","completed","partially_completed","failed","cancelled"]},"BenchmarkMode":{"type":"string","enum":["consumer_like","controlled_localized","forced_grounded"]},"BusinessMap":{"type":"object","properties":{"offerings":{"type":"array","items":{"$ref":"#/components/schemas/OfferingMap"}},"available_offerings":{"type":"array","items":{"type":"string"}}},"required":["offerings","available_offerings"],"additionalProperties":false},"BusinessMapEntry":{"type":"object","properties":{"value":{"type":"string"},"origin":{"type":"string","enum":["manual","model"]},"review_state":{"type":"string","enum":["suggested","confirmed"]},"reviewed_by":{"default":null,"type":["string","null"]},"reviewed_at":{"default":null,"type":["string","null"]},"source":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["value","origin","review_state","reviewed_by","reviewed_at","source"],"additionalProperties":false},"BuyerStage":{"type":"string","enum":["","awareness","consideration","decision","implementation"]},"Competitor":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"aliases":{"type":"array","items":{"type":"string"}},"domains":{"type":"array","items":{"type":"string"}},"logo_url":{"type":["string","null"]},"matching":{"$ref":"#/components/schemas/EntityMatching"}},"required":["id","name","aliases","domains"],"additionalProperties":false},"CrawlAnalysisStatus":{"type":"string","enum":["pending","running","stopped","completed","partially_completed","failed","cancelled"]},"CrawlCounters":{"type":"object","properties":{"discovered":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"selected":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"queued":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"running":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"analyzed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"errors":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"blocked":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"failure_breakdown":{"type":"object","properties":{"robots_denied":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"http_4xx":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"http_5xx":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"timeout":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["robots_denied","http_4xx","http_5xx","timeout"],"additionalProperties":false},"activity":{"type":"object","properties":{"state":{"type":"string","enum":["working","waiting","stalled","terminal"]},"reason":{"type":"string","enum":["active_work","host_gate","retry_backoff","expired_lease","terminal"]},"queue_depth":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"next_available_at":{"type":["string","null"]}},"required":["state","reason","queue_depth","next_available_at"],"additionalProperties":false},"by_page_kind":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}}},"required":["discovered","selected","queued","running","analyzed","errors","blocked","failure_breakdown","activity","by_page_kind"],"additionalProperties":false},"CrawlCoverageResponse":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"source_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"reporting_date":{"type":"string"},"reporting_timezone":{"type":"string"},"coverage":{"type":"string","enum":["complete","declared_complete","partial","unknown"]},"reason":{"type":"string"},"batch_count":{"type":"number"},"heartbeat_count":{"type":"number"},"max_gap_minutes":{"type":"number"}},"required":["source_id","reporting_date","reporting_timezone","coverage","reason","batch_count","heartbeat_count","max_gap_minutes"],"additionalProperties":false}},"sources":{"type":"array","items":{"$ref":"#/components/schemas/CrawlSource"}},"next_cursor":{"type":["string","null"]}},"required":["items","sources","next_cursor"],"additionalProperties":false},"CrawlDiscoveryStatus":{"type":"string","enum":["pending","running","stopped","completed","sample_completed","failed","cancelled"]},"CrawlerPurpose":{"type":"string","enum":["ai_training","ai_search","ai_user_fetch","search_engine","other"]},"CrawlOverallStatus":{"type":"string","enum":["draft","validating","queued","running","paused","completed","partially_completed","failed","cancelled"]},"CrawlSource":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string","enum":["webhook","pull","upload"]},"setup":{"type":"string","enum":["cloudflare_worker","cloudflare_logpush","aws_firehose","gcp_pubsub_pull","custom","upload"]},"preset":{"type":"string"},"buffer_interval_seconds":{"type":["number","null"]},"format":{"type":"string"},"collection_point":{"type":"string"},"sampling":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"none"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"sampled"},"rate":{"type":"number","exclusiveMinimum":0,"maximum":1}},"required":["kind","rate"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"filtered"},"description":{"type":"string"}},"required":["kind","description"],"additionalProperties":false}]},"origin":{"type":"string"},"host":{"type":"string"},"status":{"type":"string","enum":["active","revoked"]},"state":{"type":"string","enum":["active","awaiting_verification","stalled","revoked"]},"stall_reason":{"anyOf":[{"$ref":"#/components/schemas/CrawlStallReason"},{"type":"null"}]},"stalled_at":{"type":["string","null"]},"pull":{"anyOf":[{"type":"object","properties":{"subscription":{"type":"string"},"verification_nonce":{"type":"string"},"verified_at":{"type":["string","null"]},"verification_checked_at":{"type":["string","null"]},"verification_failure":{"anyOf":[{"$ref":"#/components/schemas/CrawlVerificationFailure"},{"type":"null"}]},"filter_catalog_version":{"type":"string"},"filter_confirmed_at":{"type":["string","null"]},"filter_current":{"type":"boolean"},"declared_sample_rate":{"type":"number"},"last_pull_at":{"type":["string","null"]},"last_drained_at":{"type":["string","null"]}},"required":["subscription","verification_nonce","verified_at","verification_checked_at","verification_failure","filter_catalog_version","filter_confirmed_at","filter_current","declared_sample_rate","last_pull_at","last_drained_at"],"additionalProperties":false},{"type":"null"}]},"token_prefix":{"type":["string","null"]},"connection":{"type":"string","enum":["not_connected","awaiting_data","connected"]},"last_accepted_batch":{"type":["string","null"]},"last_processed_at":{"type":["string","null"]},"rejected_lines":{"type":"number"},"overlapping_lines":{"type":"number"},"unsupported_uploads":{"type":"number"},"unsupported_batches":{"type":"number"}},"required":["id","kind","setup","preset","buffer_interval_seconds","format","collection_point","sampling","origin","host","status","state","stall_reason","stalled_at","pull","token_prefix","connection","last_accepted_batch","last_processed_at","rejected_lines","overlapping_lines","unsupported_uploads","unsupported_batches"],"additionalProperties":false},"CrawlStallReason":{"type":"string","enum":["no_receipts","not_in_plan","oversize","verification_failed"]},"CrawlSummary":{"type":"object","properties":{"unit":{"type":"string","const":"requests"},"identity_level":{"type":"string","const":"path"},"connection":{"type":"string","enum":["not_connected","awaiting_data","connected"]},"coverage":{"type":"string","enum":["complete","declared_complete","partial","unknown"]},"reporting_timezone":{"type":"string"},"last_processed_at":{"type":["string","null"]},"requests":{"type":["number","null"]},"pages":{"type":["number","null"]},"active_bots":{"type":["number","null"]},"error_share":{"type":["number","null"]},"failed_verification_requests":{"type":["number","null"]},"series":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"purpose":{"anyOf":[{"$ref":"#/components/schemas/CrawlerPurpose"},{"type":"string","const":"unknown"}]},"requests":{"type":"number"}},"required":["date","purpose","requests"],"additionalProperties":false}}},"required":["unit","identity_level","connection","coverage","reporting_timezone","last_processed_at","requests","pages","active_bots","error_share","failed_verification_requests","series"],"additionalProperties":false},"CrawlVerificationFailure":{"type":"string","enum":["label_mismatch","push_subscription","ack_deadline","permission_denied","not_found","unavailable"]},"DeclarationCheck":{"type":"object","properties":{"index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"kind":{"type":"string"},"leg":{"type":"string","enum":["next_visibility_run","next_search_console_window","next_crawl"]},"state":{"type":"string","enum":["waiting","met","unmet","unavailable"]},"reason":{"type":["string","null"]},"observed_at":{"type":["string","null"]},"source_kind":{"type":["string","null"]},"source_id":{"type":["string","null"]},"subject":{"type":["string","null"]},"prompt_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["index","kind","leg","state","reason","observed_at","source_kind","source_id","subject"],"additionalProperties":false},"EntityMatching":{"type":"object","properties":{"mode":{"$ref":"#/components/schemas/EntityMatchingMode"},"context_terms":{"default":[],"type":"array","items":{"type":"string"}},"exclusion_phrases":{"default":[],"type":"array","items":{"type":"string"}},"common_word":{"default":false,"type":"boolean"}},"required":["mode","context_terms","exclusion_phrases","common_word"],"additionalProperties":false},"EntityMatchingMode":{"type":"string","enum":["always","context_required"]},"ExpectedCheck":{"oneOf":[{"$ref":"#/components/schemas/KeywordPresenceExpectedCheck"},{"type":"object","properties":{"kind":{"type":"string","const":"contextual_link"},"recommendation_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"internal_link_run_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"target_site_url_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"target_url":{"type":"string"},"anchor_text":{"type":"string"},"source_analysis_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"source_artifact_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"target_analysis_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"target_artifact_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"extractor_version":{"type":"string"}},"required":["kind","recommendation_id","internal_link_run_id","target_site_url_id","target_url","anchor_text","source_analysis_id","source_artifact_id","target_analysis_id","target_artifact_id","extractor_version"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"site_rule"},"target_site_url_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"rule_id":{"type":"string"},"expected_outcome":{"type":"string","enum":["pass","fail","partial"]}},"required":["kind","rule_id","expected_outcome"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"traffic_metric"},"metric":{"type":"string"},"direction":{"type":"string","enum":["increase","decrease","equal"]},"scope":{"type":"string","enum":["page","query"]},"scope_key":{"type":"string"},"min_delta":{"type":"number"},"baseline_traffic_snapshot_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"baseline_value":{"type":"number"},"baseline_window_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"expected_value":{"type":"number"},"tolerance":{"type":"number"}},"required":["kind","metric","direction"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"visibility_metric"},"metric":{"type":"string"},"direction":{"type":"string","enum":["increase","decrease","equal"]},"min_delta":{"type":"number"},"tolerance":{"type":"number"},"target_prompt_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"baseline_metric_snapshot_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"baseline_value":{"type":"number"}},"required":["kind","metric","direction","min_delta","tolerance","target_prompt_id"],"additionalProperties":false}]},"FindingClass":{"type":"string","enum":["defect","advisory","diagnostic"]},"ImplementationState":{"type":"string","enum":["declared","observed","verified","contradicted"]},"IssueDimension":{"type":"string","enum":["technical","aeo"]},"IssueSeverity":{"type":"string","enum":["critical","high","medium","low","info"]},"IssuesSummary":{"type":"object","properties":{"issue_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"defect_issue_type_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"advisory_issue_type_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"occurrence_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"severity_counts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"dimension_counts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"affected_url_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"monitored_affected_url_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["issue_count","defect_issue_type_count","advisory_issue_type_count","occurrence_count","severity_counts","dimension_counts","affected_url_count","monitored_affected_url_count"],"additionalProperties":false},"KeywordPresenceExpectedCheck":{"type":"object","properties":{"kind":{"type":"string","const":"keyword_presence"},"keyword":{"type":"string"},"query_key":{"type":"string"},"owned_origin":{"type":"string"},"location_code":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"language_code":{"type":"string"}},"required":["kind","keyword","query_key","owned_origin","location_code","language_code"],"additionalProperties":false},"LogicalEngine":{"type":"string","enum":["chatgpt","gemini","claude","google_ai_overview","chatgpt_search","gemini_consumer"]},"MeasurementCounts":{"type":"object","properties":{"state":{"type":"string"},"responses":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"brand_responses":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"owned_citation_responses":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"entity_presences":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"expected":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"failed":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"not_run":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["state","responses","brand_responses","owned_citation_responses","entity_presences","expected","failed","not_run"],"additionalProperties":false},"MeasurementLeg":{"type":"object","properties":{"leg":{"type":"string","enum":["next_visibility_run","next_search_console_window","next_crawl"]},"state":{"type":"string","enum":["waiting","not_scheduled","sync_needed","observed"]},"due_at":{"type":["string","null"]},"last_evidence_at":{"type":["string","null"]},"source_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["leg","state","due_at","last_evidence_at","source_id"],"additionalProperties":false},"MetricSeries":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":["number","null"]}},"required":["date","value"],"additionalProperties":false}},"ModelProvenance":{"type":"object","properties":{"logical_engine":{"type":"string"},"transport_provider":{"type":"string"},"transport_model":{"type":"string"},"retrieval_enabled":{"type":["boolean","null"]}},"required":["logical_engine","transport_provider","transport_model","retrieval_enabled"],"additionalProperties":false},"MonitoredQuota":{"type":"object","properties":{"used":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"limit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["used","limit"],"additionalProperties":false},"ObservedCompetitor":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"audit_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"domain":{"type":"string"},"qualification_reason":{"type":"string"},"prompt_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"engine_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"market_relevant":{"type":"boolean"},"analyzer_version":{"type":"string"},"source_analysis_ids":{"type":"array","items":{"type":"string"}},"source_artifact_ids":{"type":"array","items":{"type":"string"}},"status":{"type":"string"},"created_at":{"type":"string"}},"required":["id","audit_id","name","domain","qualification_reason","prompt_count","engine_count","market_relevant","analyzer_version","source_analysis_ids","source_artifact_ids","status","created_at"],"additionalProperties":false},"OfferingMap":{"type":"object","properties":{"offering":{"type":"string"},"attributes":{"type":"array","items":{"$ref":"#/components/schemas/BusinessMapEntry"}},"situations":{"type":"array","items":{"$ref":"#/components/schemas/BusinessMapEntry"}},"audiences":{"type":"array","items":{"$ref":"#/components/schemas/BusinessMapEntry"}},"exclusions":{"type":"array","items":{"type":"object","properties":{"first":{"type":"string"},"second":{"type":"string"}},"required":["first","second"],"additionalProperties":false}}},"required":["offering","attributes","situations","audiences","exclusions"],"additionalProperties":false},"OpportunitySeverity":{"type":"string","enum":["critical","high","medium","low","info"]},"OpportunityType":{"type":"string","enum":["visibility","commerce","site","traffic","topic"]},"PageAnalysisStatus":{"type":"string","enum":["not_selected","not_measured","pending","running","completed","partially_completed","failed","error","blocked","cancelled"]},"PageKind":{"type":"string","enum":["homepage","article","editorial_index","product","category","pricing","docs","faq","about_contact","service","local","guide","how_to","listicle","comparison","alternative","case_study_review","trust_policy","other"]},"PageKindScoreSummary":{"type":"object","properties":{"analyzed_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"web_fundamentals_score":{"type":["number","null"]},"web_fundamentals_coverage":{"type":["number","null"]},"web_fundamentals_state":{"type":"string","enum":["measured","limited_evidence","not_measured","excluded"]},"aeo_readiness_score":{"type":["number","null"]},"aeo_measurement_coverage":{"type":["number","null"]},"aeo_measurement_state":{"type":"string","enum":["measured","limited_evidence","not_measured","excluded"]},"aeo_measurement_reason":{"type":"string"}},"required":["analyzed_count","web_fundamentals_score","web_fundamentals_coverage","web_fundamentals_state","aeo_readiness_score","aeo_measurement_coverage","aeo_measurement_state","aeo_measurement_reason"],"additionalProperties":false},"PagesPage":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/PageSummary"}},"next_cursor":{"type":["string","null"]},"root_errors":{"type":"array","items":{"$ref":"#/components/schemas/RootError"}}},"required":["items","next_cursor","root_errors"],"additionalProperties":false},"PageStanding":{"type":"string","enum":["yours","competitor","blocked","unreadable","not_read","gap","listed","read"]},"PageSummary":{"type":"object","properties":{"site_url_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"crawl_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"normalized_url":{"type":"string"},"display_url":{"type":"string"},"title":{"type":["string","null"]},"monitored":{"type":"boolean"},"analysis_status":{"$ref":"#/components/schemas/PageAnalysisStatus"},"error_code":{"type":"string"},"issue_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"web_fundamentals_score":{"type":["number","null"]},"web_fundamentals_coverage":{"type":["number","null"]},"web_fundamentals_state":{"type":"string","enum":["measured","limited_evidence","not_measured","excluded"]},"aeo_readiness_score":{"type":["number","null"]},"aeo_measurement_coverage":{"type":["number","null"]},"aeo_measurement_state":{"type":"string","enum":["measured","limited_evidence","not_measured","excluded"]},"aeo_measurement_reason":{"type":"string"},"main_content_indexable":{"type":["boolean","null"]},"last_audited":{"type":["string","null"]},"page_kind":{"anyOf":[{"$ref":"#/components/schemas/PageKind"},{"type":"null"}]},"inbound_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"main_content_inbound_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"depth_from_home":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["site_url_id","crawl_id","normalized_url","display_url","title","monitored","analysis_status","error_code","issue_count","web_fundamentals_score","web_fundamentals_coverage","web_fundamentals_state","aeo_readiness_score","aeo_measurement_coverage","aeo_measurement_state","aeo_measurement_reason","main_content_indexable","last_audited","page_kind","inbound_count","main_content_inbound_count","depth_from_home"],"additionalProperties":false},"PerceptionBreakdown":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"score":{"$ref":"#/components/schemas/PerceptionScore"},"coverage":{"$ref":"#/components/schemas/PerceptionCoverage"}},"required":["key","label","score","coverage"],"additionalProperties":false},"PerceptionCoverage":{"type":"object","properties":{"mentions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"classified":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"pending":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"not_assessable":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"low_confidence":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unavailable":{"type":"array","items":{"type":"object","properties":{"reason":{"type":"string","enum":["model_not_configured","platform_cap","entity_limit","invalid_output","model_error","task_failed","not_assessable"]},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["reason","count"],"additionalProperties":false}}},"required":["mentions","classified","pending","not_assessable","low_confidence","unavailable"],"additionalProperties":false},"PerceptionEntity":{"type":"object","properties":{"name":{"type":"string"},"is_brand":{"type":"boolean"},"score":{"$ref":"#/components/schemas/PerceptionScore"},"coverage":{"$ref":"#/components/schemas/PerceptionCoverage"}},"required":["name","is_brand","score","coverage"],"additionalProperties":false},"PerceptionQuote":{"type":"object","properties":{"text":{"type":"string"},"theme":{"type":"string"},"polarity":{"type":"string","enum":["positive","negative"]},"entity":{"type":"string"},"is_brand":{"type":"boolean"},"logical_engine":{"type":"string"},"prompt":{"type":"string"},"run_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"execution_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"observed_at":{"type":"string"},"extractor_version":{"type":"string"},"template_version":{"type":"string"}},"required":["text","theme","polarity","entity","is_brand","logical_engine","prompt","run_id","execution_id","observed_at","extractor_version","template_version"],"additionalProperties":false},"PerceptionResponse":{"type":"object","properties":{"state":{"type":"string","enum":["value","pending","unavailable","no_mentions"]},"reason":{"anyOf":[{"type":"string","enum":["model_not_configured","platform_cap","entity_limit","invalid_output","model_error","task_failed","not_assessable"]},{"type":"null"}]},"source_audit_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"brand":{"anyOf":[{"$ref":"#/components/schemas/PerceptionEntity"},{"type":"null"}]},"coverage":{"$ref":"#/components/schemas/PerceptionCoverage"},"entities":{"type":"array","items":{"$ref":"#/components/schemas/PerceptionEntity"}},"engines":{"type":"array","items":{"$ref":"#/components/schemas/PerceptionBreakdown"}},"topics":{"type":"array","items":{"$ref":"#/components/schemas/PerceptionBreakdown"}},"prompts":{"type":"array","items":{"$ref":"#/components/schemas/PerceptionBreakdown"}},"themes":{"type":"array","items":{"type":"object","properties":{"theme":{"type":"string"},"positive":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"negative":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"quotes":{"type":"array","items":{"$ref":"#/components/schemas/PerceptionQuote"}}},"required":["theme","positive","negative","quotes"],"additionalProperties":false}},"negative_quotes":{"type":"array","items":{"$ref":"#/components/schemas/PerceptionQuote"}},"drivers":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string"},"answers":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"example_url":{"type":["string","null"]}},"required":["domain","answers","example_url"],"additionalProperties":false}},"recommended":{"type":"object","properties":{"mentioned":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"recommended":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"recommended_against":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rate":{"type":["number","null"]},"limitation":{"type":"string"}},"required":["mentioned","recommended","recommended_against","rate","limitation"],"additionalProperties":false},"trend":{"type":"array","items":{"type":"object","properties":{"audit_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"completed_at":{"type":"string"},"score":{"$ref":"#/components/schemas/PerceptionScore"},"mentions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"extractor_version":{"type":"string"},"template_version":{"type":"string"},"metrics_version":{"type":"string"},"comparable":{"type":"boolean"}},"required":["audit_id","completed_at","score","mentions","extractor_version","template_version","metrics_version","comparable"],"additionalProperties":false}}},"required":["state","reason","source_audit_ids","brand","coverage","entities","engines","topics","prompts","themes","negative_quotes","drivers","recommended","trend"],"additionalProperties":false},"PerceptionScore":{"type":"object","properties":{"positive":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"neutral":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"negative":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"mixed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"classified":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"positive_share":{"type":["number","null"]},"negative_share":{"type":["number","null"]},"net_sentiment":{"type":["number","null"]}},"required":["positive","neutral","negative","mixed","classified","positive_share","negative_share","net_sentiment"],"additionalProperties":false},"PerformanceMetrics":{"type":"object","properties":{"clicks":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"impressions":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"ctr":{"type":["number","null"]},"position":{"type":["number","null"]}},"required":["clicks","impressions","ctr","position"],"additionalProperties":false},"PerformanceWindow":{"type":"object","properties":{"snapshot_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"window_start":{"type":"string"},"window_end":{"type":"string"},"evidence_state":{"type":"string","enum":["not_run","observed_zero","available"]},"totals":{"type":"object","properties":{"clicks":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"impressions":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"ctr":{"type":["number","null"]},"position":{"type":["number","null"]},"sessions":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"key_events":{"type":["number","null"]}},"required":["clicks","impressions","ctr","position","sessions","key_events"],"additionalProperties":false},"series":{"type":"object","properties":{"clicks":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":["number","null"]}},"required":["date","value"],"additionalProperties":false}},"impressions":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":["number","null"]}},"required":["date","value"],"additionalProperties":false}},"ctr":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":["number","null"]}},"required":["date","value"],"additionalProperties":false}},"position":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"value":{"type":["number","null"]}},"required":["date","value"],"additionalProperties":false}}},"required":["clicks","impressions","ctr","position"],"additionalProperties":false}},"required":["snapshot_id","window_start","window_end","evidence_state","totals","series"],"additionalProperties":false},"Project":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspace_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"brand_name":{"type":"string"},"website_url":{"type":"string"},"industry":{"type":"string"},"subindustry":{"type":"string"},"primary_market":{"type":"string"},"country_code":{"type":"string"},"language_code":{"type":"string"},"benchmark_mode":{"$ref":"#/components/schemas/BenchmarkMode"},"default_repetitions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"brand":{"type":"object","properties":{"aliases":{"type":"array","items":{"type":"string"}},"logo_url":{"type":["string","null"]},"matching":{"$ref":"#/components/schemas/EntityMatching"}},"required":["aliases"],"additionalProperties":false},"owned_domains":{"type":"array","items":{"type":"string"}},"unintended_domains":{"type":"array","items":{"type":"string"}},"competitors":{"type":"array","items":{"$ref":"#/components/schemas/Competitor"}},"prompt_sets":{"type":"array","items":{"$ref":"#/components/schemas/PromptSet"}},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","workspace_id","name","brand_name","website_url","industry","subindustry","primary_market","country_code","language_code","benchmark_mode","default_repetitions","brand","owned_domains","unintended_domains","competitors","prompt_sets","created_at","updated_at"],"additionalProperties":false},"Prompt":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"prompt_set_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"topic_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"text":{"type":"string"},"theme":{"type":"string"},"intent":{"$ref":"#/components/schemas/PromptIntent"},"buyer_stage":{"default":"","$ref":"#/components/schemas/BuyerStage"},"prompt_intent":{"default":"","$ref":"#/components/schemas/PromptIntentDetail"},"cohort":{"$ref":"#/components/schemas/PromptCohort"},"branded":{"type":"boolean"},"enabled":{"type":"boolean"},"status":{"$ref":"#/components/schemas/PromptStatus"},"origin":{"type":"string","enum":["manual","imported","generated"]},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","prompt_set_id","text","theme","intent","buyer_stage","prompt_intent","cohort","branded","enabled","status","origin"],"additionalProperties":false},"PromptCandidate":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"run_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"prompt_set_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"topic_id":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"text":{"type":"string"},"intent":{"default":"","type":"string"},"buyer_stage":{"default":"","$ref":"#/components/schemas/BuyerStage"},"prompt_intent":{"default":"","$ref":"#/components/schemas/PromptIntentDetail"},"cohort":{"$ref":"#/components/schemas/PromptCohort"},"created_at":{"type":"string"},"expires_at":{"type":"string"},"quality_status":{"default":"not_judged","type":"string","enum":["judged","off","unavailable","not_judged"]},"quality_flags":{"default":[],"type":"array","items":{"type":"string"}},"grounded":{"default":false,"type":"boolean"}},"required":["id","run_id","prompt_set_id","topic_id","text","intent","buyer_stage","prompt_intent","cohort","created_at","expires_at","quality_status","quality_flags","grounded"],"additionalProperties":false},"PromptCandidateReviewResponse":{"type":"object","properties":{"accepted":{"type":"array","items":{"$ref":"#/components/schemas/Prompt"}},"rejected_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"dropped_duplicates":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unavailable_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["accepted","rejected_count","dropped_duplicates","unavailable_count"],"additionalProperties":false},"PromptCohort":{"type":"string","enum":["core","brand_diagnostic","comparison","commerce"]},"PromptGenerateResponse":{"type":"object","properties":{"candidates":{"type":"array","items":{"$ref":"#/components/schemas/PromptCandidate"}},"topics":{"type":"array","items":{"$ref":"#/components/schemas/Topic"}},"dropped_duplicates":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"requested_count":{"default":0,"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"candidates_generated":{"default":0,"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"quality_gate":{"default":"off","type":"string","enum":["off","shadow","gate","unavailable"]},"quality_rejected":{"default":0,"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"admission_drops":{"default":{},"type":"object","propertyNames":{"type":"string","enum":["unknown_topic","unplanned_slot","intent","stage","duplicate","length","placeholder","observed_copy","off_topic","location_unplanned","branded_core","brand_missing","competitor_missing"]},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}},"shortfall_reason":{"default":null,"anyOf":[{"type":"string","enum":["deadline","model_error"]},{"type":"null"}]}},"required":["candidates","topics","dropped_duplicates","requested_count","candidates_generated","quality_gate","quality_rejected","admission_drops","shortfall_reason"],"additionalProperties":false},"PromptHistory":{"type":"object","properties":{"prompt":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"text":{"type":"string"},"topic_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"status":{"type":"string"}},"required":["id","text","topic_id","status"],"additionalProperties":false},"cohort":{"$ref":"#/components/schemas/PromptCohort"},"market_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"logical_engine":{"type":["string","null"]},"points":{"type":"array","items":{"$ref":"#/components/schemas/PromptHistoryPoint"}},"implementations":{"type":"array","items":{"$ref":"#/components/schemas/PromptHistoryImplementation"}},"latest":{"anyOf":[{"$ref":"#/components/schemas/PromptMetricItem"},{"type":"null"}]}},"required":["prompt","cohort","market_id","logical_engine","points","implementations","latest"],"additionalProperties":false},"PromptHistoryImplementation":{"type":"object","properties":{"implementation_event_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"action_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string"},"status":{"$ref":"#/components/schemas/ActionStatus"},"implemented_at":{"type":"string"}},"required":["implementation_event_id","action_id","title","status","implemented_at"],"additionalProperties":false},"PromptHistoryPoint":{"type":"object","properties":{"audit_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"completed_at":{"type":"string"},"prompt_text":{"type":"string"},"counts":{"$ref":"#/components/schemas/MeasurementCounts"},"mention_rate":{"type":["number","null"]},"owned_citation_rate":{"type":["number","null"]},"answer_states":{"anyOf":[{"$ref":"#/components/schemas/AnswerStates"},{"type":"null"}]},"source_analysis_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"comparison_key":{"type":["string","null"]},"analyzer_version":{"type":"string"},"scoring_rule_version":{"type":"string"},"comparable_with_previous":{"type":["boolean","null"]},"source_snapshot_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["audit_id","completed_at","prompt_text","counts","mention_rate","owned_citation_rate","answer_states","source_analysis_ids","comparison_key","analyzer_version","scoring_rule_version","comparable_with_previous","source_snapshot_id"],"additionalProperties":false},"PromptIntent":{"type":"string","enum":["","discovery","comparison","purchase","service","local"]},"PromptIntentDetail":{"type":"string","enum":["","learn","solve","compare","recommend","validate","buy","implement"]},"PromptMetricItem":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"audit_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"prompt_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"prompt_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"prompt_text":{"type":"string"},"prompt_snapshot_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"cohort":{"type":"string"},"composite_score":{"type":["number","null"]},"source_audit_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"previous_score":{"type":["number","null"]},"immediate_delta":{"type":["number","null"]},"rolling_four":{"type":"array","items":{"type":"number"}},"per_engine_scores":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"number"}},"components":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["number","null"]}},"engine_agreement":{"type":"number"},"repetition_agreement":{"type":"number"},"evidence_coverage":{"type":"number"},"trend_confidence":{"type":"number"},"decline_confirmed":{"type":"boolean"},"analyzer_version":{"type":"string"},"scoring_rule_version":{"type":"string"},"created_at":{"type":"string"},"theme":{"type":"string"},"intent":{"type":"string"},"visibility_rate":{"type":["number","null"]},"owned_citation_rate":{"type":["number","null"]},"avg_position":{"type":["number","null"]},"visibility_delta":{"type":["number","null"]},"comparison_status":{"type":"string"},"comparison":{"anyOf":[{"$ref":"#/components/schemas/VisibilityComparison"},{"type":"null"}]},"counts":{"$ref":"#/components/schemas/MeasurementCounts"},"answer_states":{"anyOf":[{"$ref":"#/components/schemas/AnswerStates"},{"type":"null"}]},"action_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"outcomes":{"type":"array","items":{"type":"object","properties":{"logical_engine":{"type":"string"},"transport_model":{"type":"string"},"counts":{"$ref":"#/components/schemas/MeasurementCounts"},"visibility_rate":{"type":["number","null"]},"owned_citation_rate":{"type":["number","null"]},"answer_states":{"anyOf":[{"$ref":"#/components/schemas/AnswerStates"},{"type":"null"}]},"gap_counts":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}}},"required":["logical_engine","transport_model","counts","visibility_rate","owned_citation_rate","gap_counts"],"additionalProperties":false}}},"required":["id","audit_id","prompt_id","prompt_index","prompt_text","cohort","composite_score","previous_score","immediate_delta","rolling_four","per_engine_scores","components","engine_agreement","repetition_agreement","evidence_coverage","trend_confidence","decline_confirmed","analyzer_version","scoring_rule_version","created_at"],"additionalProperties":false},"PromptSet":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"project_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"description":{"type":"string"},"prompt_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"prompts":{"type":"array","items":{"$ref":"#/components/schemas/Prompt"}},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","project_id","name","prompts","created_at","updated_at"],"additionalProperties":false},"PromptStatus":{"type":"string","enum":["active","archived"]},"RankingRow":{"type":"object","properties":{"name":{"type":"string"},"is_brand":{"type":"boolean"},"logo_url":{"type":["string","null"]},"website_url":{"type":["string","null"]},"mention_rate":{"type":["number","null"]},"citation_rate":{"type":["number","null"]},"share_of_voice":{"type":["number","null"]},"mention_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"visibility_delta":{"type":["number","null"]},"gap_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"matched_visibility_rate":{"type":["number","null"]},"matched_visibility_delta":{"type":["number","null"]},"matched_response_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"avg_position":{"type":["number","null"]}},"required":["name","is_brand","mention_rate","citation_rate","share_of_voice","mention_count","avg_position"],"additionalProperties":false},"ResearchScope":{"type":"string","enum":["exact_host","domain_subdomains"]},"RootError":{"type":"object","properties":{"method":{"type":"string"},"target":{"type":"string"},"outcome":{"type":"string"},"error_code":{"type":"string"},"status_code":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"latency_ms":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["method","target","outcome","error_code","status_code","latency_ms"],"additionalProperties":false},"SearchDataset":{"type":"object","properties":{"research_scope":{"$ref":"#/components/schemas/ResearchScope"},"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"run_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"dataset_kind":{"type":"string"},"target_domain":{"type":"string"},"target_hostname":{"type":"string"},"target_origin":{"type":"string"},"acquisition":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"comparison_origin":{"type":"string"},"location_code":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"language_code":{"type":"string"},"status":{"type":"string"},"coverage":{"type":"string"},"requested_rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"raw_rows_received":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unique_rows_saved":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"provider_total":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"truncated":{"type":"boolean"},"summary":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"collection_started_at":{"type":["string","null"]},"collection_ended_at":{"type":["string","null"]},"published_at":{"type":["string","null"]},"filtered_saved_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["research_scope","id","run_id","dataset_kind","target_domain","target_hostname","target_origin","acquisition","comparison_origin","location_code","language_code","status","coverage","requested_rows","raw_rows_received","unique_rows_saved","provider_total","truncated","summary","collection_started_at","collection_ended_at","published_at"],"additionalProperties":{}},"SearchDatasetPage":{"type":"object","properties":{"dataset":{"$ref":"#/components/schemas/SearchDataset"},"rows":{"type":"array","items":{"$ref":"#/components/schemas/SearchRow"}},"next_cursor":{"type":["string","null"]}},"required":["dataset","rows","next_cursor"],"additionalProperties":false},"SearchRow":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"dataset_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"call_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"row_kind":{"type":"string"},"keyword":{"type":"string"},"domain":{"type":"string"},"url":{"type":"string"},"search_volume":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"difficulty":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"intent":{"type":"string"},"rank_group":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"owned_rank_group":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"etv":{"type":["string","null"]},"backlinks":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"referring_main_domains":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"dataforseo_rank":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"auxiliary":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"action_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["id","dataset_id","call_id","row_kind","keyword","domain","url","search_volume","difficulty","intent","rank_group","owned_rank_group","etv","backlinks","referring_main_domains","dataforseo_rank","auxiliary"],"additionalProperties":{}},"SearchRun":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string"},"action":{"type":"string"},"pricing_version":{"type":"string"},"estimated_cost_usd":{"type":"string"},"provider_reported_cost_usd":{"type":["string","null"]},"planned_calls":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"completed_calls":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"planned_rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"received_rows":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"uncertain_calls":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"error_code":{"type":"string"},"error_detail":{"type":"string"},"expires_at":{"type":"string"},"confirmed_at":{"type":["string","null"]},"cancelled_at":{"type":["string","null"]},"completed_at":{"type":["string","null"]},"frozen_scope":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"call_plan":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"reused_datasets":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"created_at":{"type":"string"}},"required":["id","status","action","pricing_version","estimated_cost_usd","provider_reported_cost_usd","planned_calls","completed_calls","planned_rows","received_rows","uncertain_calls","error_code","error_detail","expires_at","confirmed_at","cancelled_at","completed_at","frozen_scope","call_plan","reused_datasets","created_at"],"additionalProperties":false},"SiteCrawl":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"workspace_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"project_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profile_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"$ref":"#/components/schemas/CrawlOverallStatus"},"discovery_status":{"$ref":"#/components/schemas/CrawlDiscoveryStatus"},"analysis_status":{"$ref":"#/components/schemas/CrawlAnalysisStatus"},"root_url":{"type":"string"},"sample_mode":{"type":"boolean"},"seed":{"type":"string"},"inventory_complete":{"type":"boolean"},"partial_reason":{"type":"string","enum":["","discovery_incomplete","analysis_incomplete","discovery_and_analysis_incomplete"]},"visible_url_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"analyzed_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"failed_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"discovery_requested_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"analysis_requested_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"counters":{"$ref":"#/components/schemas/CrawlCounters"},"discovered_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"total_url_count":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"has_more_site_urls":{"type":["boolean","null"]},"score_summary":{"anyOf":[{"$ref":"#/components/schemas/SiteScoreSummary"},{"type":"null"}]},"failure_summary":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"attempts":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"status_code":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"target_url":{"type":"string"}},"required":["code","message","attempts","status_code","target_url"],"additionalProperties":false},{"type":"null"}]},"site_facts":{"anyOf":[{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},{"type":"null"}]},"extractor_version":{"type":"string"},"analyzer_version":{"type":"string"},"rule_version":{"type":"string"},"scoring_version":{"type":"string"},"error_message":{"type":"string"},"created_at":{"type":"string"},"updated_at":{"type":"string"},"started_at":{"type":["string","null"]},"completed_at":{"type":["string","null"]}},"required":["id","workspace_id","project_id","profile_id","status","discovery_status","analysis_status","root_url","sample_mode","seed","inventory_complete","partial_reason","visible_url_count","analyzed_count","failed_count","discovery_requested_count","analysis_requested_count","counters","total_url_count","score_summary","failure_summary","site_facts","extractor_version","analyzer_version","rule_version","scoring_version","error_message","created_at","updated_at","started_at","completed_at"],"additionalProperties":false},"SiteHealthDashboard":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"crawl":{"anyOf":[{"$ref":"#/components/schemas/SiteCrawl"},{"type":"null"}]},"score_summary":{"anyOf":[{"$ref":"#/components/schemas/SiteScoreSummary"},{"type":"null"}]},"phase":{"type":"string","enum":["empty","discovering","analyzing","dashboard","terminal"]},"snapshot_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"quota":{"$ref":"#/components/schemas/MonitoredQuota"},"root_errors":{"type":"array","items":{"$ref":"#/components/schemas/RootError"}}},"required":["project_id","crawl","score_summary","phase","snapshot_id","quota","root_errors"],"additionalProperties":false},"SiteIssue":{"type":"object","properties":{"group_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"crawl_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"rule_id":{"type":"string"},"page_kinds":{"type":"array","items":{"type":"string"}},"dimension":{"$ref":"#/components/schemas/IssueDimension"},"category":{"type":"string"},"severity":{"$ref":"#/components/schemas/IssueSeverity"},"finding_class":{"$ref":"#/components/schemas/FindingClass"},"title":{"type":"string"},"description":{"type":"string"},"remediation":{"type":"string"},"remediation_route":{"type":"string"},"affected_url_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"analyzer_version":{"type":"string"},"rule_version":{"type":"string"},"created_at":{"type":"string"}},"required":["group_id","crawl_id","rule_id","page_kinds","dimension","category","severity","finding_class","title","description","remediation","remediation_route","affected_url_count","analyzer_version","rule_version","created_at"],"additionalProperties":false},"SiteIssuesPage":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SiteIssue"}},"next_cursor":{"type":["string","null"]},"summary":{"$ref":"#/components/schemas/IssuesSummary"}},"required":["items","next_cursor","summary"],"additionalProperties":false},"SiteScoreSummary":{"type":"object","properties":{"web_fundamentals_score":{"type":["number","null"]},"web_fundamentals_coverage":{"type":["number","null"]},"web_fundamentals_state":{"type":"string","enum":["measured","limited_evidence","not_measured","excluded"]},"aeo_readiness_score":{"type":["number","null"]},"aeo_measurement_coverage":{"type":["number","null"]},"aeo_measurement_state":{"type":"string","enum":["measured","limited_evidence","not_measured","excluded"]},"search_eligibility":{"type":"string","enum":["eligible","blocked","unknown","excluded"]},"classified_page_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"other_page_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"classification_error_page_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"classification_expected_page_count":{"type":"integer","minimum":0,"maximum":9007199254740991},"classification_coverage":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}]},"classification_state":{"type":"string","enum":["complete","partial","not_measured"]},"classification_reason_groups":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}},"classification_formula_version":{"type":"string"},"classification_source_analysis_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"classification_source_artifact_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"classification_source_task_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"scored_page_kind_set":{"type":"array","items":{"$ref":"#/components/schemas/PageKind"}},"scored_page_count_by_kind":{"type":"object","propertyNames":{"$ref":"#/components/schemas/PageKind"},"additionalProperties":{"type":"integer","minimum":0,"maximum":9007199254740991}},"selected_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"analyzed_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"issue_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"scoring_version":{"type":"string"},"by_page_kind":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"$ref":"#/components/schemas/PageKindScoreSummary"}}},"required":["web_fundamentals_score","web_fundamentals_coverage","web_fundamentals_state","aeo_readiness_score","aeo_measurement_coverage","aeo_measurement_state","search_eligibility","classified_page_count","other_page_count","classification_error_page_count","classification_expected_page_count","classification_coverage","classification_state","classification_reason_groups","classification_formula_version","classification_source_analysis_ids","classification_source_artifact_ids","classification_source_task_ids","scored_page_kind_set","scored_page_count_by_kind","selected_count","analyzed_count","issue_count","scoring_version","by_page_kind"],"additionalProperties":false},"SnapshotGranularity":{"type":"string","enum":["day","week","month"]},"Topic":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"project_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"parent_id":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"name":{"type":"string"},"description":{"type":"string"},"origin":{"type":"string","enum":["manual","generated"]},"active_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"created_at":{"type":"string"},"updated_at":{"type":"string"}},"required":["id","project_id","parent_id","name","description","origin","active_count","created_at","updated_at"],"additionalProperties":false},"TrafficLeg":{"type":"object","properties":{"state":{"type":"string","enum":["not_connected","unknown","unavailable","zero","value","non_comparable","flagged"]},"value":{"type":["number","null"]},"coverage":{"type":["string","null"]},"reason":{"type":["string","null"]}},"required":["state","value","coverage","reason"],"additionalProperties":false},"TransportProvider":{"type":"string","enum":["openai","anthropic","google","dataforseo"]},"VerificationEvent":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"observation_kind":{"type":"string","enum":["observed","verified","contradicted"]},"observed_at":{"type":"string"},"crawl_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"audit_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"source_analysis_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"source_rule_evaluation_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"source_metric_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"result":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"verifier_version":{"type":"string"},"limitations":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string"}},"required":["id","observation_kind","observed_at","crawl_id","audit_id","source_analysis_ids","source_rule_evaluation_ids","source_metric_ids","result","verifier_version","limitations","created_at"],"additionalProperties":false},"Visibility":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"audit_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"audit_status":{"$ref":"#/components/schemas/AuditStatus"},"analyzer_version":{"type":"string"},"scoring_rule_version":{"type":"string"},"cohort":{"default":"core","$ref":"#/components/schemas/PromptCohort"},"coverage":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["number","null"]}},"total_completed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"total_failed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"visibility_score":{"type":["number","null"]},"visibility_rate":{"type":["number","null"]},"owned_citation_rate":{"type":["number","null"]},"prompt_performance_score":{"type":["number","null"]},"counts":{"$ref":"#/components/schemas/MeasurementCounts"},"comparison_key":{"type":["string","null"]},"comparison":{"$ref":"#/components/schemas/VisibilityComparison"},"citation_totals":{"type":"object","properties":{"citations":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"owned_citations":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"owned_share":{"type":["number","null"]}},"required":["citations","owned_citations","owned_share"],"additionalProperties":false},"selection_mode":{"type":"string","enum":["latest","run","range"]},"source_audit_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"configuration_groups":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"from_at":{"type":["string","null"]},"to_at":{"type":["string","null"]},"model_provenance":{"default":[],"type":"array","items":{"$ref":"#/components/schemas/ModelProvenance"}},"rankings":{"type":"array","items":{"$ref":"#/components/schemas/RankingRow"}},"per_engine":{"type":"array","items":{"$ref":"#/components/schemas/VisibilityEngine"}},"avg_position":{"type":["number","null"]},"created_at":{"type":"string"}},"required":["project_id","audit_id","audit_status","analyzer_version","scoring_rule_version","cohort","coverage","total_completed","total_failed","visibility_score","model_provenance","rankings","per_engine","avg_position","created_at"],"additionalProperties":false},"VisibilityAdsResponse":{"type":"object","properties":{"state":{"type":"string","enum":["value","not_applicable","unavailable","no_answers"]},"source_audit_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"parser_versions":{"type":"array","items":{"type":"string"}},"metrics_version":{"type":"string"},"presence":{"type":"object","properties":{"answers":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"answers_with_ads":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rate":{"type":["number","null"]}},"required":["answers","answers_with_ads","rate"],"additionalProperties":false},"engines":{"type":"array","items":{"type":"object","properties":{"engine":{"type":"string"},"applicability":{"type":"string","enum":["applicable","unavailable","not_applicable"]},"answers":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"presence":{"anyOf":[{"type":"object","properties":{"answers":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"answers_with_ads":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rate":{"type":["number","null"]}},"required":["answers","answers_with_ads","rate"],"additionalProperties":false},{"type":"null"}]}},"required":["engine","applicability","answers","presence"],"additionalProperties":false}},"brand":{"type":"object","properties":{"appearances":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"share":{"type":["number","null"]},"best_rank":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},"required":["appearances","share","best_rank"],"additionalProperties":false},"advertisers_seen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"advertisers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"domain":{"type":"string"},"ownership":{"$ref":"#/components/schemas/AdOwnership"},"appearances":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"prompts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"share":{"type":"number"},"first_seen_at":{"type":"string"},"last_seen_at":{"type":"string"}},"required":["name","domain","ownership","appearances","prompts","share","first_seen_at","last_seen_at"],"additionalProperties":false}},"creatives":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"advertiser_name":{"type":"string"},"advertiser_domain":{"type":"string"},"ownership":{"$ref":"#/components/schemas/AdOwnership"},"title":{"type":"string"},"snippet":{"type":"string"},"landing_url":{"type":"string"},"appearances":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"prompts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"first_seen_at":{"type":"string"},"last_seen_at":{"type":"string"}},"required":["advertiser_name","advertiser_domain","ownership","title","snippet","landing_url","appearances","prompts","first_seen_at","last_seen_at"],"additionalProperties":false}},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"next_cursor":{"type":["string","null"]}},"required":["items","total","next_cursor"],"additionalProperties":false},"prompts":{"type":"array","items":{"type":"object","properties":{"prompt":{"type":"string"},"topic":{"type":"string"},"presence":{"type":"object","properties":{"answers":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"answers_with_ads":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rate":{"type":["number","null"]}},"required":["answers","answers_with_ads","rate"],"additionalProperties":false},"ads_seen":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"top_advertiser":{"anyOf":[{"type":"object","properties":{"name":{"type":"string"},"domain":{"type":"string"}},"required":["name","domain"],"additionalProperties":false},{"type":"null"}]},"competitor_ad_answers":{"type":"object","properties":{"brand_mentioned":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"brand_not_mentioned":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["brand_mentioned","brand_not_mentioned"],"additionalProperties":false}},"required":["prompt","topic","presence","ads_seen","top_advertiser","competitor_ad_answers"],"additionalProperties":false}},"topics":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"presence":{"type":"object","properties":{"answers":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"answers_with_ads":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rate":{"type":["number","null"]}},"required":["answers","answers_with_ads","rate"],"additionalProperties":false}},"required":["key","label","presence"],"additionalProperties":false}},"runs":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"presence":{"type":"object","properties":{"answers":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"answers_with_ads":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"rate":{"type":["number","null"]}},"required":["answers","answers_with_ads","rate"],"additionalProperties":false}},"required":["key","label","presence"],"additionalProperties":false}}},"required":["state","source_audit_ids","parser_versions","metrics_version","presence","engines","brand","advertisers_seen","advertisers","creatives","prompts","topics","runs"],"additionalProperties":false},"VisibilityComparison":{"type":"object","properties":{"status":{"type":"string"},"baseline_audit_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"baseline_audit_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"baseline_at":{"type":["string","null"]},"baseline_counts":{"anyOf":[{"$ref":"#/components/schemas/MeasurementCounts"},{"type":"null"}]},"current_counts":{"anyOf":[{"$ref":"#/components/schemas/MeasurementCounts"},{"type":"null"}]},"deltas":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["number","null"]}},"rankings":{"type":"array","items":{"$ref":"#/components/schemas/RankingRow"}},"skipped_runs":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"matched_cells":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"current_cells":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"baseline_cells":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"current_values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["number","null"]}},"baseline_values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":["number","null"]}},"current_rankings":{"type":"array","items":{"$ref":"#/components/schemas/RankingRow"}}},"required":["status","baseline_audit_id","baseline_audit_ids","baseline_at","baseline_counts","current_counts","deltas","rankings","skipped_runs","matched_cells","current_cells","baseline_cells","current_values","baseline_values","current_rankings"],"additionalProperties":false},"VisibilityEngine":{"type":"object","properties":{"logical_engine":{"type":"string"},"total_completed":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"brand_mention_rate":{"type":["number","null"]},"owned_citation_rate":{"type":["number","null"]},"search_use_rate":{"type":["number","null"]},"visibility_score":{"type":["number","null"]},"counts":{"$ref":"#/components/schemas/MeasurementCounts"}},"required":["logical_engine","total_completed","brand_mention_rate","owned_citation_rate","search_use_rate","visibility_score"],"additionalProperties":false},"VisibilityFanoutSummary":{"type":"object","properties":{"event_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"distinct_queries":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"matched_queries":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"coverage":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"next_cursor":{"type":["string","null"]},"total_answers":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"answers":{"type":"array","items":{"type":"object","properties":{"audit_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"task_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"prompt_text":{"type":"string"},"logical_engine":{"type":"string"},"brand_mentioned":{"type":"boolean"},"owned_domain_cited":{"type":"boolean"}},"required":["audit_id","task_id","prompt_text","logical_engine","brand_mentioned","owned_domain_cited"],"additionalProperties":false}},"items":{"type":"array","items":{"type":"object","properties":{"query":{"type":"string"},"event_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"prompt_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"engines":{"type":"array","items":{"type":"string"}},"response_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"brand_response_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["query","event_count","prompt_count","engines","response_count","brand_response_count"],"additionalProperties":false}}},"required":["event_count","distinct_queries","matched_queries","coverage","next_cursor","total_answers","answers","items"],"additionalProperties":false},"VisibilityMarketRow":{"type":"object","properties":{"market":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"label":{"type":"string"},"country_code":{"type":"string"},"language_code":{"type":"string"},"is_default":{"type":"boolean"},"created_at":{"type":["string","null"]}},"required":["id","label","country_code","language_code","is_default","created_at"],"additionalProperties":false},"state":{"type":"string","enum":["measured","no_run"]},"audit_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"measured_at":{"type":["string","null"]},"mention_rate":{"type":["number","null"]},"share_of_voice":{"type":["number","null"]},"net_sentiment":{"type":["number","null"]},"comparison_status":{"type":["string","null"]},"mention_rate_delta":{"type":["number","null"]},"share_of_voice_delta":{"type":["number","null"]}},"required":["market","state","audit_id","measured_at","mention_rate","share_of_voice","net_sentiment","comparison_status","mention_rate_delta","share_of_voice_delta"],"additionalProperties":false},"VisibilityMarkets":{"type":"object","properties":{"cohort":{"$ref":"#/components/schemas/PromptCohort"},"markets":{"type":"array","items":{"$ref":"#/components/schemas/VisibilityMarketRow"}}},"required":["cohort","markets"],"additionalProperties":false},"VisibilitySources":{"type":"object","properties":{"previous_cursor":{"type":["string","null"]},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"responses":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"prompts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"total_citations":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"category_totals":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"next_cursor":{"type":["string","null"]},"as_of":{"type":"string"},"comparison_status":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"responses":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"prompts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"annotations":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"urls":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"response_rate":{"type":["number","null"]},"prompt_coverage":{"type":["number","null"]},"retrieval_rate":{"type":["number","null"]},"citation_share":{"type":["number","null"]},"citation_rate":{"type":["number","null"]},"ownership":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}},"taxonomy_versions":{"type":"array","items":{"type":"string"}},"category_unavailable":{"type":"boolean"},"response_delta":{"type":["number","null"]},"url_hash":{"type":["string","null"]},"inspection_state":{"type":["string","null"]},"opportunity_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"standing":{"anyOf":[{"$ref":"#/components/schemas/PageStanding"},{"type":"null"}]},"action_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"title":{"type":["string","null"]},"page_format":{"type":["string","null"]},"page_format_method":{"type":["string","null"]},"last_cited_at":{"type":["string","null"]},"mentions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"brands":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["brand","competitor"]},"name":{"type":"string"},"responses":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"logo_url":{"type":["string","null"]},"website":{"type":["string","null"]}},"required":["kind","name","responses","logo_url","website"],"additionalProperties":false}}},"required":["key","responses","prompts","annotations","urls","response_rate","prompt_coverage","retrieval_rate","citation_share","citation_rate","ownership","categories","taxonomy_versions","category_unavailable","response_delta","url_hash","inspection_state","opportunity_id","standing","action_id","title","page_format","page_format_method","last_cited_at","mentions","brands"],"additionalProperties":false}}},"required":["total","responses","prompts","total_citations","next_cursor","as_of","comparison_status","items"],"additionalProperties":false},"VisibilityTrendList":{"type":"array","items":{"$ref":"#/components/schemas/VisibilityTrendPoint"}},"VisibilityTrendPoint":{"type":"object","properties":{"audit_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"completed_at":{"type":"string"},"logical_engine":{"type":["string","null"]},"visibility_score":{"type":["number","null"]},"visibility_rate":{"type":["number","null"]},"prompt_performance_score":{"type":["number","null"]},"counts":{"$ref":"#/components/schemas/MeasurementCounts"},"comparison_key":{"type":["string","null"]},"run_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"source_audit_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"brand_mention_rate":{"type":["number","null"]},"owned_citation_rate":{"type":["number","null"]},"sov":{"type":"object","properties":{"mention":{"type":["number","null"]}},"required":["mention"],"additionalProperties":false},"rankings":{"type":"array","items":{"$ref":"#/components/schemas/RankingRow"}},"avg_position":{"type":["number","null"]},"transport_model":{"default":null,"type":["string","null"]},"retrieval_enabled":{"default":null,"type":["boolean","null"]},"model_provenance":{"default":[],"type":"array","items":{"$ref":"#/components/schemas/ModelProvenance"}},"source_snapshot_ids":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"analyzer_versions":{"type":"array","items":{"type":"string"}},"scoring_rule_versions":{"type":"array","items":{"type":"string"}},"spans_version_boundary":{"type":"boolean"}},"required":["audit_id","completed_at","logical_engine","visibility_score","brand_mention_rate","owned_citation_rate","sov","rankings","avg_position","transport_model","retrieval_enabled","model_provenance","source_snapshot_ids","analyzer_versions","scoring_rule_versions","spans_version_boundary"],"additionalProperties":false}},"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"An API key created in Settings → API keys, sent as `Authorization: Bearer cl_live_…`."}}},"paths":{"/v1/projects/{project_id}":{"get":{"tags":["projects"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Project"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/markets":{"get":{"tags":["markets"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"label":{"type":"string"},"country_code":{"type":"string"},"language_code":{"type":"string"},"is_default":{"type":"boolean"},"created_at":{"type":["string","null"]}},"required":["id","label","country_code","language_code","is_default","created_at"],"additionalProperties":false}}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/site-crawls/{crawl_id}/pages":{"get":{"tags":["site-crawls"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagesPage"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"crawl_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":200}},{"name":"cursor","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"status","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"monitored","in":"query","required":false,"schema":{"type":["boolean","null"]}},{"name":"page_kind","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"sort","in":"query","required":false,"schema":{"default":"status","type":"string","enum":["status","url","inbound","main_content_inbound","depth"]}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/site-crawls/{crawl_id}/issues":{"get":{"tags":["site-crawls"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteIssuesPage"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"crawl_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":200}},{"name":"cursor","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"query","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"severity","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"category","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"dimension","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"rule","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"site_url_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"page_kind","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"finding_class","in":"query","required":false,"schema":{"default":"defect","type":"string","enum":["defect","advisory"]}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/site-health":{"get":{"tags":["site-health"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SiteHealthDashboard"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"crawl_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/ai-traffic/pages":{"get":{"tags":["ai-traffic"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiTrafficPages"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"range","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date","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])))$"},{"type":"null"}]}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date","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])))$"},{"type":"null"}]}},{"name":"bot_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]}},{"name":"pattern","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]}},{"name":"folder","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}]}},{"name":"resource_class","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":24},{"type":"null"}]}},{"name":"verification","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}]}},{"name":"sort","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}]}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":4096},{"type":"null"}]}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1,"maximum":100},{"type":"null"}]}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/ai-traffic/overview":{"get":{"tags":["ai-traffic"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiTrafficOverview"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"range","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date","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])))$"},{"type":"null"}]}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date","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])))$"},{"type":"null"}]}},{"name":"purpose","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"verification","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}]}},{"name":"bot_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":100,"maximum":599},{"type":"null"}]}},{"name":"folder","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}]}},{"name":"resource_class","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":24},{"type":"null"}]}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":4096},{"type":"null"}]}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1,"maximum":100},{"type":"null"}]}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/ai-traffic/coverage":{"get":{"tags":["ai-traffic"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrawlCoverageResponse"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"range","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date","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])))$"},{"type":"null"}]}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date","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])))$"},{"type":"null"}]}},{"name":"purpose","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"verification","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}]}},{"name":"bot_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":100,"maximum":599},{"type":"null"}]}},{"name":"folder","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}]}},{"name":"resource_class","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":24},{"type":"null"}]}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":4096},{"type":"null"}]}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1,"maximum":100},{"type":"null"}]}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/visibility/ads":{"get":{"tags":["visibility"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VisibilityAdsResponse"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"audit_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"audit_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"type":"null"}]}},{"name":"market","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"engine","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"cohort","in":"query","required":false,"schema":{"default":"core","type":"string","enum":["core","comparison"]}},{"name":"from","in":"query","required":false,"schema":{"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},{"name":"to","in":"query","required":false,"schema":{"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}]}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":50}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/visibility/perception":{"get":{"tags":["visibility"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerceptionResponse"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"audit_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"audit_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"type":"null"}]}},{"name":"market","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"engine","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"cohort","in":"query","required":false,"schema":{"default":"core","type":"string","enum":["core","comparison"]}},{"name":"from","in":"query","required":false,"schema":{"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},{"name":"to","in":"query","required":false,"schema":{"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/visibility":{"get":{"tags":["visibility"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Visibility"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"audit_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"market","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"engine","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"baseline_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"selection_mode","in":"query","required":false,"schema":{"default":"latest","type":"string","enum":["latest","run","range"]}},{"name":"from","in":"query","required":false,"schema":{"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},{"name":"to","in":"query","required":false,"schema":{"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},{"name":"configuration_key","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"cohort","in":"query","required":false,"schema":{"default":"core","type":"string","enum":["core","comparison"]}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/visibility/prompts":{"get":{"tags":["visibility"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PromptMetricItem"}}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"audit_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"audit_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"type":"null"}]}},{"name":"market","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"baseline_audit_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"type":"null"}]}},{"name":"engine","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"baseline_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"cohort","in":"query","required":false,"schema":{"default":"core","type":"string","enum":["core","comparison"]}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/visibility/prompts/{prompt_id}/history":{"get":{"tags":["visibility"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptHistory"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"prompt_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"market","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"engine","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"cohort","in":"query","required":false,"schema":{"anyOf":[{"type":"string","enum":["core","comparison"]},{"type":"null"}]}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/visibility/trends":{"get":{"tags":["visibility"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VisibilityTrendList"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"market","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"engine","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"from","in":"query","required":false,"schema":{"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},{"name":"to","in":"query","required":false,"schema":{"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},{"name":"granularity","in":"query","required":false,"schema":{"default":"run","type":"string"}},{"name":"transport_model","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"retrieval_enabled","in":"query","required":false,"schema":{"type":["boolean","null"]}},{"name":"cohort","in":"query","required":false,"schema":{"default":"core","type":"string","enum":["core","comparison"]}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/visibility/fanout":{"get":{"tags":["visibility"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VisibilityFanoutSummary"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"audit_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"audit_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"type":"null"}]}},{"name":"market","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"engine","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"cohort","in":"query","required":false,"schema":{"default":"core","type":"string","enum":["core","comparison"]}},{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":8192},{"type":"null"}]}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}]}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}]}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/visibility/sources":{"get":{"tags":["visibility"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VisibilitySources"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"audit_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"audit_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"type":"null"}]}},{"name":"market","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"baseline_audit_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"type":"null"}]}},{"name":"engine","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"cohort","in":"query","required":false,"schema":{"default":"core","type":"string","enum":["core","comparison"]}},{"name":"domain","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}]}},{"name":"source_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]}},{"name":"standing","in":"query","required":false,"schema":{"anyOf":[{"type":"string","enum":["gap"]},{"type":"null"}]}},{"name":"dimension","in":"query","required":false,"schema":{"default":"domain","type":"string","enum":["domain","url"]}},{"name":"from","in":"query","required":false,"schema":{"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},{"name":"to","in":"query","required":false,"schema":{"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},{"name":"as_of","in":"query","required":false,"schema":{"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}]}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/visibility/markets":{"get":{"tags":["visibility"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VisibilityMarkets"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"cohort","in":"query","required":false,"schema":{"default":"core","type":"string","enum":["core","comparison"]}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/performance":{"get":{"tags":["performance"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"range":{"type":"string"},"granularity":{"type":"string"},"compare":{"type":"string"},"selected":{"$ref":"#/components/schemas/PerformanceWindow"},"comparison":{"anyOf":[{"$ref":"#/components/schemas/PerformanceWindow"},{"type":"null"}]},"coverage":{"type":"object","properties":{"earliest_date":{"type":["string","null"]},"latest_date":{"type":["string","null"]},"covered_days":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"analytics_quality":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"day":{"type":"string"},"revision":{"type":["number","null"]},"flags":{"type":"array","items":{"type":"string"}}},"required":["day","revision","flags"],"additionalProperties":false}}}},"required":["earliest_date","latest_date","covered_days","analytics_quality"],"additionalProperties":false},"dimension_counts":{"type":"object","properties":{"query":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"page":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"country":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"device":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"search_appearance":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"day":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"bing_query":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"bing_page":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["query","page","country","device","search_appearance","day","bing_query","bing_page"],"additionalProperties":false},"unavailable_dimensions":{"type":"array","items":{"type":"string"}},"formula_version":{"type":"string"},"normalization_version":{"type":"string"}},"required":["project_id","range","granularity","compare","selected","comparison","coverage","dimension_counts","unavailable_dimensions","formula_version","normalization_version"],"additionalProperties":false}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"range","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date","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])))$"},{"type":"null"}]}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date","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])))$"},{"type":"null"}]}},{"name":"compare","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"compare_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date","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])))$"},{"type":"null"}]}},{"name":"compare_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date","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])))$"},{"type":"null"}]}},{"name":"granularity","in":"query","required":false,"schema":{"type":["string","null"]}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/performance/table":{"get":{"tags":["performance"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"dimension":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"dimension_key":{"type":"string"},"display_value":{"type":"string"},"metrics":{"$ref":"#/components/schemas/PerformanceMetrics"},"comparison_metrics":{"anyOf":[{"$ref":"#/components/schemas/PerformanceMetrics"},{"type":"null"}]}},"required":["dimension_key","display_value","metrics","comparison_metrics"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]},"total_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"page_size":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["dimension","items","next_cursor","total_count","page_size"],"additionalProperties":false}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"snapshot_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"dimension","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"sort","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"page_size","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]}},{"name":"compare_snapshot_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/actions":{"get":{"tags":["actions"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionsPage"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":200}},{"name":"cursor","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"status","in":"query","required":false,"schema":{"type":["string","null"]}},{"name":"target_kind","in":"query","required":false,"schema":{"type":["string","null"]}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/actions/{action_id}":{"get":{"tags":["actions"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionDetail"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"action_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"x-citeladder-scope":"read"},"patch":{"tags":["actions"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionItem"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"action_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"}},"required":["status"],"additionalProperties":false}}}},"x-citeladder-scope":"actions:write"}},"/v1/projects/{project_id}/actions/{action_id}/declaration":{"post":{"tags":["actions"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionDeclaration"}}}},"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionDeclaration"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"action_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"recommendation_ids":{"default":[],"maxItems":100,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"output_revision_id":{"default":null,"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"declared_implemented_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":["declared_implemented_at"],"additionalProperties":false}}}},"x-citeladder-scope":"actions:write"}},"/v1/projects/{project_id}/search-intelligence/runs":{"get":{"tags":["search-intelligence"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SearchRun"}}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},{"name":"limit","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":100}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/search-intelligence/datasets/{dataset_id}/rows":{"get":{"tags":["search-intelligence"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchDatasetPage"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"dataset_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}]}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":200}},{"name":"sort","in":"query","required":false,"schema":{"default":"id","type":"string"}},{"name":"direction","in":"query","required":false,"schema":{"default":"asc","type":"string","enum":["asc","desc"]}},{"name":"search","in":"query","required":false,"schema":{"default":"","type":"string","maxLength":200}},{"name":"min_volume","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},{"name":"intent","in":"query","required":false,"schema":{"default":"","type":"string","maxLength":100}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/business-map":{"get":{"tags":["business-map"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessMap"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/competitor-suggestions":{"get":{"tags":["competitor-suggestions"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ObservedCompetitor"}}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/competitor-suggestions/{candidate_id}/accept":{"post":{"tags":["competitor-suggestions"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Competitor"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"candidate_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":255}}],"x-citeladder-scope":"competitors:write"}},"/v1/projects/{project_id}/prompt-sets/{prompt_set_id}/generate":{"post":{"tags":["prompt-sets"],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptGenerateResponse"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"prompt_set_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"count":{"default":10,"type":"integer","minimum":1,"maximum":9007199254740991},"topic_ids":{"default":[],"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"topic_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"agent_revision_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"cohort":{"default":"core","type":"string","enum":["core","comparison","brand_diagnostic"]}}}}}},"x-citeladder-scope":"prompts:write"}},"/v1/projects/{project_id}/prompt-sets/{prompt_set_id}":{"get":{"tags":["prompt-sets"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptSet"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"prompt_set_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/prompt-sets/{prompt_set_id}/import":{"post":{"tags":["prompt-sets"],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptSet"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"prompt_set_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompts":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","maxLength":300},"theme":{"default":"","type":"string","maxLength":255},"intent":{"default":"","type":"string","maxLength":64},"cohort":{"default":"core","$ref":"#/components/schemas/PromptCohort"},"enabled":{"default":true,"type":"boolean"},"topic":{"default":"","type":"string","maxLength":255}},"required":["text"],"additionalProperties":false}}},"required":["prompts"],"additionalProperties":false}}}},"x-citeladder-scope":"prompts:write"}},"/v1/projects/{project_id}/prompt-sets/{prompt_set_id}/candidates":{"get":{"tags":["prompt-sets"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PromptCandidate"}}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"prompt_set_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/prompt-sets/{prompt_set_id}/candidates/review":{"post":{"tags":["prompt-sets"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptCandidateReviewResponse"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"prompt_set_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"accept_ids":{"default":[],"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"reject_ids":{"default":[],"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}}}}}},"x-citeladder-scope":"prompts:write"}},"/v1/projects/{project_id}/prompts/{prompt_id}":{"patch":{"tags":["prompts"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Prompt"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"prompt_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"anyOf":[{"type":"string","minLength":1,"maxLength":300},{"type":"null"}]},"theme":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}]},"intent":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]},"cohort":{"anyOf":[{"$ref":"#/components/schemas/PromptCohort"},{"type":"null"}]},"enabled":{"type":["boolean","null"]},"status":{"anyOf":[{"$ref":"#/components/schemas/PromptStatus"},{"type":"null"}]},"topic_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"additionalProperties":false}}}},"x-citeladder-scope":"prompts:write"},"delete":{"tags":["prompts"],"responses":{"204":{"description":"Successful Response"}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"prompt_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"x-citeladder-scope":"prompts:write"}},"/v1/projects/{project_id}/topics":{"get":{"tags":["topics"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Topic"}}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"x-citeladder-scope":"read"},"post":{"tags":["topics"],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Topic"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"description":{"default":"","type":"string","maxLength":1024},"parent_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["name"]}}}},"x-citeladder-scope":"prompts:write"}},"/v1/projects/{project_id}/topics/{topic_id}":{"patch":{"tags":["topics"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Topic"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"topic_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"anyOf":[{"type":"string","minLength":1,"maxLength":255},{"type":"null"}]},"description":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}]},"parent_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}}}}}},"x-citeladder-scope":"prompts:write"},"delete":{"tags":["topics"],"responses":{"204":{"description":"Successful Response"}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"topic_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"x-citeladder-scope":"prompts:write"}},"/v1/projects/{project_id}/audit-schedules":{"post":{"tags":["audit-schedules"],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditSchedule"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt_set_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"audit_scope":{"default":"brand","type":"string","enum":["brand","commerce"]},"cadence":{"$ref":"#/components/schemas/AuditScheduleCadence"},"interval_minutes":{"default":null,"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},{"type":"null"}]},"timezone":{"type":"string","minLength":1,"maxLength":64},"engines":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/LogicalEngine"}},"market_ids":{"default":[null],"minItems":1,"maxItems":11,"type":"array","items":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"repetitions":{"default":null,"anyOf":[{"type":"integer","minimum":1,"maximum":10},{"type":"null"}]},"benchmark_mode":{"default":null,"anyOf":[{"$ref":"#/components/schemas/BenchmarkMode"},{"type":"null"}]},"enabled":{"default":true,"type":"boolean"},"next_run_at":{"default":null,"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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["prompt_set_id","cadence","engines"]}}}},"x-citeladder-scope":"schedules:write"},"get":{"tags":["audit-schedules"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AuditSchedule"}}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/audit-schedules/{schedule_id}":{"get":{"tags":["audit-schedules"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditSchedule"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"schedule_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"x-citeladder-scope":"read"},"patch":{"tags":["audit-schedules"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditSchedule"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"schedule_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt_set_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"audit_scope":{"type":"string","enum":["brand","commerce"]},"cadence":{"$ref":"#/components/schemas/AuditScheduleCadence"},"interval_minutes":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},{"type":"null"}]},"timezone":{"type":"string","minLength":1,"maxLength":64},"engines":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/LogicalEngine"}},"market_ids":{"minItems":1,"maxItems":11,"type":"array","items":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"repetitions":{"anyOf":[{"type":"integer","minimum":1,"maximum":10},{"type":"null"}]},"benchmark_mode":{"anyOf":[{"$ref":"#/components/schemas/BenchmarkMode"},{"type":"null"}]},"enabled":{"type":"boolean"},"next_run_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|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}}}}}},"x-citeladder-scope":"schedules:write"},"delete":{"tags":["audit-schedules"],"responses":{"204":{"description":"Successful Response"}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"schedule_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"x-citeladder-scope":"schedules:write"}},"/v1/projects/{project_id}/audits/{audit_id}":{"get":{"tags":["audits"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Audit"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"audit_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/audits/{audit_id}/cancel":{"post":{"tags":["audits"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Audit"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"audit_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":255}}],"x-citeladder-scope":"audits:run"}},"/v1/projects":{"get":{"tags":["projects"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Project"}},"next_cursor":{"type":["string","null"]}},"required":["items","next_cursor"],"additionalProperties":false}}}}},"parameters":[{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}]}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/prompt-sets":{"get":{"tags":["prompt-sets"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PromptSet"}}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/prompts":{"get":{"tags":["prompts"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"prompt_set_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"topic_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"text":{"type":"string"},"theme":{"type":"string"},"intent":{"$ref":"#/components/schemas/PromptIntent"},"buyer_stage":{"default":"","$ref":"#/components/schemas/BuyerStage"},"prompt_intent":{"default":"","$ref":"#/components/schemas/PromptIntentDetail"},"cohort":{"$ref":"#/components/schemas/PromptCohort"},"branded":{"type":"boolean"},"enabled":{"type":"boolean"},"status":{"$ref":"#/components/schemas/PromptStatus"},"origin":{"type":"string","enum":["manual","imported","generated"]},"created_at":{"type":"string"},"updated_at":{"type":"string"},"latest_measurement":{"oneOf":[{"type":"object","properties":{"state":{"type":"string","const":"measured"},"audit_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"mention_rate":{"type":["number","null"]},"citation_rate":{"type":["number","null"]}},"required":["state","audit_id","mention_rate","citation_rate"],"additionalProperties":false},{"type":"object","properties":{"state":{"type":"string","const":"not_measured"}},"required":["state"],"additionalProperties":false},{"type":"object","properties":{"state":{"type":"string","const":"unavailable"}},"required":["state"],"additionalProperties":false}]}},"required":["id","prompt_set_id","text","theme","intent","buyer_stage","prompt_intent","cohort","branded","enabled","status","origin","latest_measurement"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]}},"required":["items","next_cursor"],"additionalProperties":false}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}]}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"prompt_set_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"topic_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","enum":["active","archived"]},{"type":"null"}]}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/prompt-sets/{prompt_set_id}/prompts":{"post":{"tags":["prompt-sets"],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"prompts":{"type":"array","items":{"$ref":"#/components/schemas/Prompt"}}},"required":["prompts"],"additionalProperties":false}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"prompt_set_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompts":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":300},"theme":{"default":"","type":"string","maxLength":255},"intent":{"default":"","type":"string","maxLength":64},"cohort":{"default":"core","$ref":"#/components/schemas/PromptCohort"},"enabled":{"default":true,"type":"boolean"},"topic_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"required":["text"],"additionalProperties":false}}},"required":["prompts"],"additionalProperties":false}}}},"x-citeladder-scope":"prompts:write"}},"/v1/projects/{project_id}/prompt-sets/{prompt_set_id}/generation-runs":{"get":{"tags":["prompt-sets"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"prompt_set_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"generator_version":{"type":"string"},"created_at":{"type":"string"}},"required":["id","prompt_set_id","generator_version","created_at"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]}},"required":["items","next_cursor"],"additionalProperties":false}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"prompt_set_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}]}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}}],"x-citeladder-scope":"read"}},"/v1/projects/{project_id}/competitors":{"get":{"tags":["competitors"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Competitor"}}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"x-citeladder-scope":"read"},"post":{"tags":["competitors"],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Competitor"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"aliases":{"default":[],"type":"array","items":{"type":"string","maxLength":1024}},"domains":{"default":[],"type":"array","items":{"type":"string","maxLength":1024}}},"required":["name"],"additionalProperties":false}}}},"x-citeladder-scope":"competitors:write"}},"/v1/projects/{project_id}/competitors/{competitor_id}":{"patch":{"tags":["competitors"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Competitor"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255},"aliases":{"type":"array","items":{"type":"string","maxLength":1024}},"domains":{"type":"array","items":{"type":"string","maxLength":1024}}},"additionalProperties":false}}}},"x-citeladder-scope":"competitors:write"},"delete":{"tags":["competitors"],"responses":{"204":{"description":"Successful Response"}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"x-citeladder-scope":"competitors:write"}},"/v1/projects/{project_id}/audits":{"get":{"tags":["audits"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Audit"}},"next_cursor":{"type":["string","null"]}},"required":["items","next_cursor"],"additionalProperties":false}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}]}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}}],"x-citeladder-scope":"read"},"post":{"tags":["audits"],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Audit"}}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt_set_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"prompt_ids":{"default":[],"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"engines":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/LogicalEngine"}},"repetitions":{"anyOf":[{"type":"integer","minimum":1,"maximum":10},{"type":"null"}]},"benchmark_mode":{"anyOf":[{"$ref":"#/components/schemas/BenchmarkMode"},{"type":"null"}]},"market_ids":{"default":[null],"minItems":1,"maxItems":11,"type":"array","items":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}},"audit_scope":{"default":"brand","type":"string","enum":["brand","commerce"]},"random_seed":{"type":["string","null"]},"max_estimated_credits":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["engines","max_estimated_credits"]}}}},"x-citeladder-scope":"audits:run"}},"/v1/projects/{project_id}/audits/estimate":{"post":{"tags":["audits"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditEstimate"}}}}},"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt_set_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]},"prompt_ids":{"default":[],"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"engines":{"minItems":1,"type":"array","items":{"$ref":"#/components/schemas/LogicalEngine"}},"repetitions":{"anyOf":[{"type":"integer","minimum":1,"maximum":10},{"type":"null"}]},"market_ids":{"default":[null],"minItems":1,"maxItems":11,"type":"array","items":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},{"type":"null"}]}}},"required":["engines"]}}}},"x-citeladder-scope":"read"}}}}