{"openapi":"3.1.0","info":{"title":"AiClicks API","version":"0.1.0"},"paths":{"/add-competitor":{"post":{"tags":["Competitors"],"summary":"Add Competitor","description":"Add a new competitor to a domain.","operationId":"add_competitor_add_competitor_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddCompetitor"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/delete-competitor":{"post":{"tags":["Competitors"],"summary":"Delete Competitor","description":"Delete a competitor.","operationId":"delete_competitor_delete_competitor_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteCompetitor"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Competitor Delete Competitor Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-competitor":{"post":{"tags":["Competitors"],"summary":"Update Competitor","description":"Update a competitor.","operationId":"update_competitor_update_competitor_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCompetitor"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/list-competitors":{"post":{"tags":["Competitors"],"summary":"List Competitors","description":"List competitors for a domain.","operationId":"list_competitors_list_competitors_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListCompetitors"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-competitors":{"post":{"tags":["Competitors"],"summary":"Get Competitors","description":"Get competitors with metrics.","operationId":"get_competitors_get_competitors_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCompetitors"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/suggest-competitors":{"post":{"tags":["Competitors"],"summary":"Suggest Competitors","description":"Suggest competitors for a domain.","operationId":"suggest_competitors_suggest_competitors_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuggestCompetitorsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Suggest Competitors Suggest Competitors Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-competitor-performance":{"post":{"tags":["Competitors"],"summary":"Get Competitor Performance","description":"Get competitor performance metrics.","operationId":"get_competitor_performance_get_competitor_performance_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCompetitorPerformance"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CompetitorPerformance"},"title":"Response Get Competitor Performance Get Competitor Performance Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-dedicated-competitors-performance":{"post":{"tags":["Competitors"],"summary":"Get Dedicated Competitors Performance","description":"Get dedicated competitors performance metrics.","operationId":"get_dedicated_competitors_performance_get_dedicated_competitors_performance_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetDedicatedCompetitorsPerformance"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DedicatedCompetitorPerformance"},"title":"Response Get Dedicated Competitors Performance Get Dedicated Competitors Performance Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-dedicated-competitors-performance/citations":{"post":{"tags":["Competitors"],"summary":"Get Dedicated Competitors Citations","description":"Get per-entity daily citation counts for the dashboard chart.","operationId":"get_dedicated_competitors_citations_get_dedicated_competitors_performance_citations_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetDedicatedCompetitorsPerformance"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DedicatedCompetitorCitations"},"title":"Response Get Dedicated Competitors Citations Get Dedicated Competitors Performance Citations Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-discovery-competitors":{"post":{"tags":["Competitors"],"summary":"Get Discovery Competitors","operationId":"get_discovery_competitors_get_discovery_competitors_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetDiscoveryCompetitors"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/add-query":{"post":{"tags":["Queries"],"summary":"Add Query","description":"Add a new query to a domain.","operationId":"add_query_add_query_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/archive-query":{"post":{"tags":["Queries"],"summary":"Archive Query","description":"Archive a query.","operationId":"archive_query_archive_query_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArchiveQuery"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/archive-topiced-query":{"post":{"tags":["Queries"],"summary":"Archive Topiced Query","description":"Archive a query with its topic relationship.","operationId":"archive_topiced_query_archive_topiced_query_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArchiveTopicedQuery"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/bulk-archive-queries":{"post":{"tags":["Queries"],"summary":"Bulk Archive Queries","description":"Bulk archive queries.","operationId":"bulk_archive_queries_bulk_archive_queries_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkArchiveQueriesWithTopicInfo"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/bulk-archive-topiced-queries":{"post":{"tags":["Queries"],"summary":"Bulk Archive Topiced Queries","description":"Bulk archive queries with their topic relationships.","operationId":"bulk_archive_topiced_queries_bulk_archive_topiced_queries_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkArchiveTopicedQueries"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/bulk-add-queries":{"post":{"tags":["Queries"],"summary":"Bulk Add Queries","description":"Bulk add queries to a domain.","operationId":"bulk_add_queries_bulk_add_queries_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkAddQueriesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkAddQueriesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/check-duplicate-queries":{"post":{"tags":["Queries"],"summary":"Check Duplicate Queries","operationId":"check_duplicate_queries_check_duplicate_queries_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckDuplicateQueriesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckDuplicateQueriesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/analyze-queries":{"post":{"tags":["Queries"],"summary":"Analyze Queries","description":"Trigger analysis of queries for a domain.","operationId":"analyze_queries_analyze_queries_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Analyze Queries Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-active-prompts-count":{"post":{"tags":["Queries"],"summary":"Get Active Prompts Count","description":"Get the count of active (analyzable) prompts for a domain.","operationId":"get_active_prompts_count_get_active_prompts_count_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetActivePromptsCountRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Active Prompts Count Get Active Prompts Count Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-all-domains-active-prompts-count":{"post":{"tags":["Queries"],"summary":"Get All Domains Active Prompts Count","description":"Get active prompts count for all domains in a team.","operationId":"get_all_domains_active_prompts_count_get_all_domains_active_prompts_count_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAllDomainsActivePromptsCountRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get All Domains Active Prompts Count Get All Domains Active Prompts Count Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-fanout-queries":{"post":{"tags":["Queries"],"summary":"Get Fanout Queries","description":"Get aggregated fanout/grounding queries across all prompts.","operationId":"get_fanout_queries_get_fanout_queries_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetFanoutQueriesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Fanout Queries Get Fanout Queries Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-queries":{"post":{"tags":["Queries"],"summary":"Get Queries","description":"Get queries for a domain with optional pagination and aggregation.","operationId":"get_queries_get_queries_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetQueries"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-queries-by-ids":{"post":{"tags":["Queries"],"summary":"Get Queries By Ids","description":"Resolve a set of query (prompt) UUIDs to their text, scoped to one domain.\n\nUsed by the Get Mentioned tab to render prompt tooltips client-side from the\nprompt_ids stored on recommendation_items, without loading the full query list.","operationId":"get_queries_by_ids_get_queries_by_ids_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetQueriesByIdsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Queries By Ids Get Queries By Ids Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-query-by-id":{"post":{"tags":["Queries"],"summary":"Get Query By Id","description":"Get query data by ID with historical responses and pagination.","operationId":"get_query_by_id_get_query_by_id_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetQueryById"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Query By Id Get Query By Id Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/generate-suggested-prompts":{"post":{"tags":["Queries"],"summary":"Generate Suggested Prompts","description":"Generate suggested prompts for a domain.","operationId":"generate_suggested_prompts_generate_suggested_prompts_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuggestedPromptsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Suggested Prompts Generate Suggested Prompts Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-suggested-prompts":{"post":{"tags":["Queries"],"summary":"Get Suggested Prompts","description":"Get all suggested prompts for a domain.","operationId":"get_suggested_prompts_get_suggested_prompts_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetSuggestedPromptsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Suggested Prompts Get Suggested Prompts Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/delete-suggested-prompt":{"post":{"tags":["Queries"],"summary":"Delete Suggested Prompt","description":"Delete a suggested prompt.","operationId":"delete_suggested_prompt_delete_suggested_prompt_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteSuggestedPromptRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Suggested Prompt Delete Suggested Prompt Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-citations":{"post":{"tags":["Citations"],"summary":"Get Citations","description":"Retrieve all unique citations for a domain with timestamps and frequency counts.","operationId":"get_citations_get_citations_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCitations"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/Citation"}},{"$ref":"#/components/schemas/CitationsPaginatedResponse"}],"title":"Response Get Citations Get Citations Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-citations-by-domain":{"post":{"tags":["Citations"],"summary":"Get Citations By Domain","description":"Retrieve citations aggregated by domain with statistics.","operationId":"get_citations_by_domain_get_citations_by_domain_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCitationsByDomain"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/DomainCitation"}},{"$ref":"#/components/schemas/DomainCitationsPaginatedResponse"}],"title":"Response Get Citations By Domain Get Citations By Domain Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-citation-statistics":{"post":{"tags":["Citations"],"summary":"Get Citation Statistics","description":"Retrieve aggregated citation statistics by AI model for the leading model card.","operationId":"get_citation_statistics_get_citation_statistics_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetCitationStatistics"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitationStatisticsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-citations-url-view":{"post":{"tags":["Citations"],"summary":"Get Citations Url View","operationId":"get_citations_url_view_get_citations_url_view_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCitationsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CitationsUrlItem"},"title":"Response Get Citations Url View Get Citations Url View Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-citations-domain-view":{"post":{"tags":["Citations"],"summary":"Get Citations Domain View","operationId":"get_citations_domain_view_get_citations_domain_view_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCitationsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CitationsDomainItem"},"title":"Response Get Citations Domain View Get Citations Domain View Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-citations-prompt-view":{"post":{"tags":["Citations"],"summary":"Get Citations Prompt View","operationId":"get_citations_prompt_view_get_citations_prompt_view_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCitationsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CitationsPromptItem"},"title":"Response Get Citations Prompt View Get Citations Prompt View Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/export-enhanced-citations":{"post":{"tags":["Citations"],"summary":"Export Enhanced Citations","description":"Stream enhanced citations CSV to prevent timeouts on large datasets.","operationId":"export_enhanced_citations_export_enhanced_citations_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnhancedCitationsExport"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/get-citations-url-view-2":{"post":{"tags":["Citations"],"summary":"Get Citations Url View V2","operationId":"get_citations_url_view_v2_v2_get_citations_url_view_2_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCitationsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/get-citations-domain-view":{"post":{"tags":["Citations"],"summary":"Get Citations Domain View V2","operationId":"get_citations_domain_view_v2_v2_get_citations_domain_view_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCitationsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/get-citations-prompt-view":{"post":{"tags":["Citations"],"summary":"Get Citations Prompt View V2","operationId":"get_citations_prompt_view_v2_v2_get_citations_prompt_view_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCitationsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v3/get-citations-url-view":{"post":{"tags":["Citations"],"summary":"Get Citations Url View V3","description":"Get URL-level citation view from snapshots (V3)","operationId":"get_citations_url_view_v3_v3_get_citations_url_view_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCitationsRequestV3"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v3/get-citations-url-timeseries":{"post":{"tags":["Citations"],"summary":"Get Citations Url Timeseries V3","description":"Get URL-level citation timeseries — lightweight, separate from table data.","operationId":"get_citations_url_timeseries_v3_v3_get_citations_url_timeseries_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCitationsRequestV3"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v3/get-citations-domain-view":{"post":{"tags":["Citations"],"summary":"Get Citations Domain View V3","description":"Get domain-level citation view from snapshots (V3)","operationId":"get_citations_domain_view_v3_v3_get_citations_domain_view_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCitationsRequestV3"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v3/get-citations-prompt-view":{"post":{"tags":["Citations"],"summary":"Get Citations Prompt View V3","description":"Get prompt/query-level citation view from snapshots (V3)","operationId":"get_citations_prompt_view_v3_v3_get_citations_prompt_view_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseCitationsRequestV3"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v3/update-citation-notes":{"post":{"tags":["Citations"],"summary":"Update Citation Notes","operationId":"update_citation_notes_v3_update_citation_notes_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchCitationNote"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/citation-page-type-classifier":{"get":{"tags":["Citations"],"summary":"Get Citation Page Type Classifier","description":"Get page type classifier JavaScript.","operationId":"get_citation_page_type_classifier_citation_page_type_classifier_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/citation-page-type-patterns":{"get":{"tags":["Citations"],"summary":"Get Citation Page Type Patterns","description":"Get all citation page type patterns.","operationId":"get_citation_page_type_patterns_citation_page_type_patterns_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Citation Page Type Patterns Citation Page Type Patterns Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Citations"],"summary":"Create Citation Page Type Pattern","description":"Create a citation page type pattern.","operationId":"create_citation_page_type_pattern_citation_page_type_patterns_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePatternRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Citation Page Type Pattern Citation Page Type Patterns Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Citations"],"summary":"Update Citation Page Type Pattern","description":"Update a citation page type pattern.","operationId":"update_citation_page_type_pattern_citation_page_type_patterns_put","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePatternRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Citation Page Type Pattern Citation Page Type Patterns Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["Citations"],"summary":"Delete Citation Page Type Pattern","description":"Delete a citation page type pattern.","operationId":"delete_citation_page_type_pattern_citation_page_type_patterns_delete","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletePatternRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Citation Page Type Pattern Citation Page Type Patterns Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/create-domain":{"post":{"tags":["Domains"],"summary":"Create Domain","description":"Create a new domain with validation, query generation, and resource management.\n\nReturns immediately after domain and queries are created.\nTopics and team resource updates run in background.","operationId":"create_domain_create_domain_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/delete-domain":{"post":{"tags":["Domains"],"summary":"Delete Domain","description":"Delete a domain and all associated data.\n\nReturns dict containing domain_id, queries_deleted, remaining_prompts, domain_name,\nand remaining_domains for enterprise users.","operationId":"delete_domain_delete_domain_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainDelete"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Domain Delete Domain Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-domain":{"post":{"tags":["Domains"],"summary":"Update Domain","description":"Update a domain.","operationId":"update_domain_update_domain_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDomain"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"},"title":"Response Update Domain Update Domain Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-enabled-models":{"post":{"tags":["Domains"],"summary":"Update Domain Enabled Models","operationId":"update_domain_enabled_models_update_enabled_models_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateEnabledModelsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Domain Enabled Models Update Enabled Models Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/toggle-domain-sharing":{"post":{"tags":["Domains"],"summary":"Toggle Domain Sharing","description":"Toggle public sharing for a domain.","operationId":"toggle_domain_sharing_toggle_domain_sharing_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToggleDomainSharingRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Toggle Domain Sharing Toggle Domain Sharing Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-domain-metrics":{"post":{"tags":["Domains"],"summary":"Get Domain Metrics","description":"Get comprehensive domain metrics via unified metrics service.","operationId":"get_domain_metrics_get_domain_metrics_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetDomainMetrics"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-team-domains":{"post":{"tags":["Domains"],"summary":"Get Team Domains","description":"Get all domains for a specific team where the user is a member.","operationId":"get_team_domains_get_team_domains_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTeamDomainsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamDomainsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-top-domains":{"post":{"tags":["Domains"],"summary":"Get Top Domains","description":"Get the top domains for competitor analysis.","operationId":"get_top_domains_get_top_domains_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTopDomainsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Top Domains Get Top Domains Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/upload-logo":{"post":{"tags":["Domains"],"summary":"Upload Logo","description":"Upload a custom logo for a domain.","operationId":"upload_logo_upload_logo_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_logo_upload_logo_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Upload Logo Upload Logo Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/remove-logo":{"post":{"tags":["Domains"],"summary":"Remove Logo","description":"Remove the custom logo for a domain.","operationId":"remove_logo_remove_logo_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_remove_logo_remove_logo_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Remove Logo Remove Logo Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/pause-domain":{"post":{"tags":["Domains"],"summary":"Pause Domain","description":"Pause or unpause a domain. Refunds prompt credits when pausing.","operationId":"pause_domain_pause_domain_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PauseDomainRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Pause Domain Pause Domain Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/convert-pitch-domain":{"post":{"tags":["Domains"],"summary":"Convert Pitch Domain","description":"Convert a pitch brand into a normal brand, charging a domain slot and its prompts.","operationId":"convert_pitch_domain_convert_pitch_domain_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConvertPitchDomainRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Convert Pitch Domain Convert Pitch Domain Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-user-domains":{"get":{"tags":["Domains"],"summary":"Get User Domains","operationId":"get_user_domains_get_user_domains_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserDomainsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/create-team":{"post":{"tags":["Teams"],"summary":"Create Team","operationId":"create_team_create_team_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/complete-onboarding-wizard":{"post":{"tags":["Teams"],"summary":"Complete Onboarding Wizard","description":"Mark the team's onboarding wizard as done and store the questionnaire answers.","operationId":"complete_onboarding_wizard_complete_onboarding_wizard_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompleteOnboardingWizard"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/track-dashboard-visit":{"post":{"tags":["Teams"],"summary":"Track Dashboard Visit","operationId":"track_dashboard_visit_track_dashboard_visit_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/send-team-invite":{"post":{"tags":["Teams"],"summary":"Send Team Invite","operationId":"send_team_invite_send_team_invite_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendTeamInvite"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-team-invites":{"post":{"tags":["Teams"],"summary":"Get Team Invites","operationId":"get_team_invites_get_team_invites_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTeamInvitesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Get Team Invites Get Team Invites Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/cancel-team-invite":{"post":{"tags":["Teams"],"summary":"Cancel Team Invite","operationId":"cancel_team_invite_cancel_team_invite_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelTeamInvite"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-team-members":{"post":{"tags":["Teams"],"summary":"Get Team Members","operationId":"get_team_members_get_team_members_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTeamMembers"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Team Members Get Team Members Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/remove-from-team":{"post":{"tags":["Teams"],"summary":"Remove From Team","operationId":"remove_from_team_remove_from_team_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemoveFromTeam"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Remove From Team Remove From Team Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-available-teams":{"get":{"tags":["Teams"],"summary":"Get Available Teams","operationId":"get_available_teams_get_available_teams_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Available Teams Get Available Teams Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-member-role":{"post":{"tags":["Teams"],"summary":"Update Member Role","operationId":"update_member_role_update_member_role_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMemberRole"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Member Role Update Member Role Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-member-domain-access":{"post":{"tags":["Teams"],"summary":"Update Member Domain Access","operationId":"update_member_domain_access_update_member_domain_access_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMemberDomainAccess"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Member Domain Access Update Member Domain Access Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/team/{team_id}":{"post":{"tags":["Teams"],"summary":"Update Team Config","operationId":"update_team_config_team__team_id__post","parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTeamConfig"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Team Config Team  Team Id  Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/upload-team-logo":{"post":{"tags":["Teams"],"summary":"Upload Team Logo","operationId":"upload_team_logo_upload_team_logo_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_team_logo_upload_team_logo_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Upload Team Logo Upload Team Logo Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/remove-team-logo":{"post":{"tags":["Teams"],"summary":"Remove Team Logo","operationId":"remove_team_logo_remove_team_logo_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_remove_team_logo_remove_team_logo_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Remove Team Logo Remove Team Logo Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/generate-blog":{"post":{"tags":["Articles"],"summary":"Generate Blog","description":"Start an async blog-generation job. Credits are checked up front so the\ncaller gets an immediate error; the pipeline then runs in the background and\nthe frontend polls /generate-blog-status.","operationId":"generate_blog_generate_blog_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateBlogRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Blog Generate Blog Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/analyze":{"post":{"tags":["Articles"],"summary":"Analyze","description":"Start the wizard's Deep-analysis (research-only) job.","operationId":"analyze_analyze_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyzeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Analyze Analyze Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/generate-outline":{"post":{"tags":["Articles"],"summary":"Generate Outline","description":"Start phase-1 (outline review). No credit charge — credits are spent on\nthe full generation. Poll with /generate-blog-status; the completed job\ncarries {outline, faq, sources, serp}. Pass the same job_id back to\n/generate-blog as outline_job_id to reuse its research.","operationId":"generate_outline_generate_outline_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateBlogRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Outline Generate Outline Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/generate-blog-status":{"post":{"tags":["Articles"],"summary":"Generate Blog Status","description":"Poll a blog-generation job. Returns {status, step, steps, article?, error?}.","operationId":"generate_blog_status_generate_blog_status_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlogStatusRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Blog Status Generate Blog Status Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/generate-blog-cancel":{"post":{"tags":["Articles"],"summary":"Generate Blog Cancel","operationId":"generate_blog_cancel_generate_blog_cancel_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlogStatusRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Blog Cancel Generate Blog Cancel Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/dismiss-blog":{"post":{"tags":["Articles"],"summary":"Dismiss Blog","operationId":"dismiss_blog_dismiss_blog_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlogStatusRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Dismiss Blog Dismiss Blog Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/validate-sitemap":{"post":{"tags":["Articles"],"summary":"Validate Sitemap","operationId":"validate_sitemap_validate_sitemap_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateSitemapRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Validate Sitemap Validate Sitemap Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ai-readiness-check":{"post":{"tags":["Articles"],"summary":"Ai Readiness Check","operationId":"ai_readiness_check_ai_readiness_check_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiReadinessCheckRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Ai Readiness Check Ai Readiness Check Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sitemap-urls":{"post":{"tags":["Articles"],"summary":"Sitemap Urls","operationId":"sitemap_urls_sitemap_urls_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SitemapUrlsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Sitemap Urls Sitemap Urls Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/publish":{"post":{"tags":["Articles"],"summary":"Publish","operationId":"publish_publish_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Publish Publish Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/cms-connection/get":{"post":{"tags":["Articles"],"summary":"Get Cms Connection","operationId":"get_cms_connection_cms_connection_get_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Cms Connection Cms Connection Get Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/cms-connection/save":{"post":{"tags":["Articles"],"summary":"Save Cms Connection","operationId":"save_cms_connection_cms_connection_save_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveCmsConnectionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Save Cms Connection Cms Connection Save Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/cms-connection/delete":{"post":{"tags":["Articles"],"summary":"Delete Cms Connection","operationId":"delete_cms_connection_cms_connection_delete_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteCmsConnectionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Cms Connection Cms Connection Delete Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/regenerate-section":{"post":{"tags":["Articles"],"summary":"Regenerate Section","description":"Rewrite a selected passage per a user instruction (Surfer-style). Direct\nLLM call — no SERP pipeline, no job.","operationId":"regenerate_section_regenerate_section_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegenerateSectionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Regenerate Section Regenerate Section Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-blogs":{"post":{"tags":["Articles"],"summary":"Get Blogs","operationId":"get_blogs_get_blogs_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetBlogsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/generate-research":{"post":{"tags":["Articles"],"summary":"Generate Research","operationId":"generate_research_generate_research_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateResearchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Research Generate Research Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-content":{"post":{"tags":["Articles"],"summary":"Update Content","operationId":"update_content_update_content_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateContentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Content Update Content Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/delete-content":{"post":{"tags":["Articles"],"summary":"Delete Content","operationId":"delete_content_delete_content_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteContentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Content Delete Content Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/content-folders/list":{"post":{"tags":["Articles"],"summary":"List Content Folders","operationId":"list_content_folders_content_folders_list_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FolderListRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Content Folders Content Folders List Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/content-folders/create":{"post":{"tags":["Articles"],"summary":"Create Content Folder","operationId":"create_content_folder_content_folders_create_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFolderRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Content Folder Content Folders Create Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/content-folders/rename":{"post":{"tags":["Articles"],"summary":"Rename Content Folder","operationId":"rename_content_folder_content_folders_rename_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RenameFolderRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Rename Content Folder Content Folders Rename Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/content-folders/brand-knowledge":{"post":{"tags":["Articles"],"summary":"Set Content Folder Brand Knowledge","operationId":"set_content_folder_brand_knowledge_content_folders_brand_knowledge_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetFolderBrandKnowledgeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Set Content Folder Brand Knowledge Content Folders Brand Knowledge Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/content-folders/delete":{"post":{"tags":["Articles"],"summary":"Delete Content Folder","operationId":"delete_content_folder_content_folders_delete_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteFolderRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Content Folder Content Folders Delete Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/content-folders/assign":{"post":{"tags":["Articles"],"summary":"Assign Content Folder","operationId":"assign_content_folder_content_folders_assign_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignFolderRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Assign Content Folder Content Folders Assign Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/image-style":{"post":{"tags":["Articles"],"summary":"Get Image Style","operationId":"get_image_style_image_style_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Image Style Image Style Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/image-style/save":{"post":{"tags":["Articles"],"summary":"Save Domain Image Style","operationId":"save_domain_image_style_image_style_save_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveImageStyleRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Save Domain Image Style Image Style Save Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/fetch-keywords":{"post":{"tags":["Keywords"],"summary":"Fetch Keywords","description":"Fetch keywords for a domain.","operationId":"fetch_keywords_fetch_keywords_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FetchKeywords"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Fetch Keywords Fetch Keywords Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-keywords":{"post":{"tags":["Keywords"],"summary":"Get Keywords","description":"Get and analyze keywords for a domain.","operationId":"get_keywords_get_keywords_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetKeywords"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Keywords Get Keywords Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ga4/fetch-data":{"post":{"tags":["GA4"],"summary":"Fetch And Sync Ga4 Data","operationId":"fetch_and_sync_ga4_data_api_ga4_fetch_data_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FetchGA4DataRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/attribution/stats":{"post":{"tags":["GA4"],"summary":"Get Attribution Stats","operationId":"get_attribution_stats_api_attribution_stats_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAttributionStatsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ga4/oauth/initiate":{"post":{"tags":["GA4"],"summary":"Initiate Ga4 Connection","operationId":"initiate_ga4_connection_api_ga4_oauth_initiate_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InitiateGA4ConnectionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ga4/oauth/callback":{"post":{"tags":["GA4"],"summary":"Handle Ga4 Callback","operationId":"handle_ga4_callback_api_ga4_oauth_callback_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GA4ConnectionCallback"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ga4/oauth/select-property":{"post":{"tags":["GA4"],"summary":"Select Ga4 Property","operationId":"select_ga4_property_api_ga4_oauth_select_property_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelectGA4PropertyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ga4/connection/status/{domain_id}":{"get":{"tags":["GA4"],"summary":"Get Ga4 Connection Status","operationId":"get_ga4_connection_status_api_ga4_connection_status__domain_id__get","parameters":[{"name":"domain_id","in":"path","required":true,"schema":{"type":"string","title":"Domain Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ga4/disconnect":{"post":{"tags":["GA4"],"summary":"Disconnect Ga4","operationId":"disconnect_ga4_api_ga4_disconnect_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisconnectGA4Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/connections/list":{"post":{"tags":["Connections"],"summary":"List Domain Connections","operationId":"list_domain_connections_connections_list_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainScopedRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/connections/{provider}/start":{"post":{"tags":["Connections"],"summary":"Start","operationId":"start_connections__provider__start_post","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartConnectionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/connections/{provider}/complete":{"post":{"tags":["Connections"],"summary":"Complete","operationId":"complete_connections__provider__complete_post","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompleteConnectionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/connections/{provider}/select":{"post":{"tags":["Connections"],"summary":"Select","operationId":"select_connections__provider__select_post","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelectResourceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/connections/{provider}/disconnect":{"post":{"tags":["Connections"],"summary":"Remove","operationId":"remove_connections__provider__disconnect_post","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainScopedRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-analysis-history":{"post":{"tags":["Analytics"],"summary":"Get Analysis History","description":"Get the analysis history for a domain.","operationId":"get_analysis_history_get_analysis_history_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAnalysisHistory"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Analysis History Get Analysis History Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-analysis-status":{"post":{"tags":["Analytics"],"summary":"Get Analysis Status","description":"Get the analysis status for a domain.","operationId":"get_analysis_status_get_analysis_status_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAnalysisStatus"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Analysis Status Get Analysis Status Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-trends":{"post":{"tags":["Analytics"],"summary":"Get Trends","description":"Get the trends for a given domain.","operationId":"get_trends_get_trends_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTrends"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-mentions-timeseries":{"post":{"tags":["Analytics"],"summary":"Get Mentions Timeseries","description":"Get mentions timeseries grouped by date and model.\n\nMixed filter semantics:\n- topic_ids only: include prompts mapped to those topics\n- query_ids only: include those explicit prompts\n- topic_ids + query_ids: union of both prompt sets","operationId":"get_mentions_timeseries_get_mentions_timeseries_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetMentionsTimeseries"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MentionsTimeseriesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-industry-stats":{"post":{"tags":["Analytics"],"summary":"Get Industry Stats","description":"Get industry statistics using pre-calculated materialized view.","operationId":"get_industry_stats_get_industry_stats_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetIndustryStats"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/export-detailed-analysis":{"post":{"tags":["Analytics"],"summary":"Export Detailed Analysis","description":"Export detailed analysis data with one row per response.","operationId":"export_detailed_analysis_export_detailed_analysis_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportDetailedAnalysis"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-prompt-response-performance":{"post":{"tags":["Analytics"],"summary":"Get Prompt Response Performance","description":"Get prompt response performance for a given prompt.","operationId":"get_prompt_response_performance_get_prompt_response_performance_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetPromptResponsePerformance"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/notify-analysis-complete":{"post":{"tags":["Analytics"],"summary":"Notify Analysis Complete","description":"Send a one-time email when analysis completes for a domain.","operationId":"notify_analysis_complete_notify_analysis_complete_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-domains-visibility":{"post":{"tags":["Analytics"],"summary":"Get Domains Visibility","operationId":"get_domains_visibility_get_domains_visibility_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetDomainsVisibility"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetDomainsVisibilityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/auth/confirm":{"get":{"tags":["Auth"],"summary":"Magic Link Confirm","operationId":"magic_link_confirm_auth_confirm_get","parameters":[{"name":"email","in":"query","required":false,"schema":{"type":"string","title":"Email"}},{"name":"token_hash","in":"query","required":false,"schema":{"type":"string","title":"Token Hash"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","title":"Type"}},{"name":"next","in":"query","required":false,"schema":{"type":"string","default":"/onboarding","title":"Next"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/auth/impersonate":{"get":{"tags":["Auth"],"summary":"Impersonate User","operationId":"impersonate_user_auth_impersonate_get","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","description":"Email of the user to impersonate","title":"Email"},"description":"Email of the user to impersonate"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/onboarding":{"post":{"tags":["Auth"],"summary":"Onboarding","operationId":"onboarding_onboarding_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OnboardingRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/auth/email-exists":{"post":{"tags":["Auth"],"summary":"Email Exists","operationId":"email_exists_public_auth_email_exists_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailExistsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailExistsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/auth/invite/verify":{"post":{"tags":["Auth"],"summary":"Invite Verify","description":"Public: resolve a team-invite code to the email + team name so the set-password page can\nconfirm it. Returns valid=False for an unknown or expired code (no detail leaked).","operationId":"invite_verify_public_auth_invite_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteVerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/auth/invite/accept":{"post":{"tags":["Auth"],"summary":"Invite Accept","description":"Public: set the invited stub account's password using the single-use code, then expire it.","operationId":"invite_accept_public_auth_invite_accept_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteAcceptRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteAcceptResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/onboarding-citations":{"post":{"tags":["Auth"],"summary":"Get Onboarding Citations","operationId":"get_onboarding_citations_onboarding_citations_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OnboardingCitationsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stripe/webhook":{"post":{"tags":["Stripe"],"summary":"Stripe Webhook","operationId":"stripe_webhook_stripe_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Response Stripe Webhook Stripe Webhook Post"}}}}}}},"/stripe/create-portal-session":{"post":{"tags":["Stripe"],"summary":"Create Portal Session","operationId":"create_portal_session_stripe_create_portal_session_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePortalSession"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Portal Session Stripe Create Portal Session Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stripe/create-checkout-session":{"post":{"tags":["Stripe"],"summary":"Create Checkout Session","operationId":"create_checkout_session_stripe_create_checkout_session_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCheckoutSession"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Checkout Session Stripe Create Checkout Session Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stripe/current-addons":{"post":{"tags":["Stripe"],"summary":"Current Addons","operationId":"current_addons_stripe_current_addons_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddonCatalog"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Current Addons Stripe Current Addons Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stripe/preview-plan-change":{"post":{"tags":["Stripe"],"summary":"Preview Plan Change","operationId":"preview_plan_change_stripe_preview_plan_change_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanChange"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Preview Plan Change Stripe Preview Plan Change Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stripe/change-plan":{"post":{"tags":["Stripe"],"summary":"Change Plan","operationId":"change_plan_stripe_change_plan_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanChange"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Change Plan Stripe Change Plan Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stripe/purchase-addon":{"post":{"tags":["Stripe"],"summary":"Purchase Addon","operationId":"purchase_addon_stripe_purchase_addon_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurchaseAddon"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Purchase Addon Stripe Purchase Addon Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stripe/addon-catalog":{"post":{"tags":["Stripe"],"summary":"Addon Catalog","operationId":"addon_catalog_stripe_addon_catalog_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddonCatalog"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Addon Catalog Stripe Addon Catalog Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stripe/model-headroom":{"post":{"tags":["Stripe"],"summary":"Model Headroom","operationId":"model_headroom_stripe_model_headroom_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelHeadroom"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Model Headroom Stripe Model Headroom Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stripe/preview-addon":{"post":{"tags":["Stripe"],"summary":"Preview Addon","operationId":"preview_addon_stripe_preview_addon_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewAddon"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Preview Addon Stripe Preview Addon Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stripe/cancel-subscription":{"post":{"tags":["Stripe"],"summary":"Cancel Subscription","operationId":"cancel_subscription_stripe_cancel_subscription_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelSubscription"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Cancel Subscription Stripe Cancel Subscription Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stripe/pause-subscription":{"post":{"tags":["Stripe"],"summary":"Pause Subscription","operationId":"pause_subscription_stripe_pause_subscription_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PauseSubscription"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Pause Subscription Stripe Pause Subscription Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stripe/apply-retention-offer":{"post":{"tags":["Stripe"],"summary":"Apply Retention Offer","operationId":"apply_retention_offer_stripe_apply_retention_offer_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplyRetentionOffer"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Apply Retention Offer Stripe Apply Retention Offer Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stripe/reactivate-subscription":{"post":{"tags":["Stripe"],"summary":"Reactivate Subscription","operationId":"reactivate_subscription_stripe_reactivate_subscription_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PauseSubscription"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Reactivate Subscription Stripe Reactivate Subscription Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stripe/resume-subscription":{"post":{"tags":["Stripe"],"summary":"Resume Subscription","operationId":"resume_subscription_stripe_resume_subscription_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PauseSubscription"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Resume Subscription Stripe Resume Subscription Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/stripe/prices":{"get":{"tags":["Stripe"],"summary":"Get Prices","operationId":"get_prices_stripe_prices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Prices Stripe Prices Get"}}}}}}},"/get-recommendation-checklist":{"post":{"tags":["Recommendations"],"summary":"Get Recommendation Checklist","description":"Get recommendation checklist for a domain.","operationId":"get_recommendation_checklist_get_recommendation_checklist_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetRecommendationChecklistRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Recommendation Checklist Get Recommendation Checklist Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/patch-recommendation":{"post":{"tags":["Recommendations"],"summary":"Patch Recommendation","description":"Patch a specific recommendation property for a domain.","operationId":"patch_recommendation_patch_recommendation_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatchRecommendationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Patch Recommendation Patch Recommendation Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-content-recommendations":{"post":{"tags":["Recommendations"],"summary":"Get Content Recommendations","description":"Get content recommendation items for a domain.","operationId":"get_content_recommendations_get_content_recommendations_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetContentRecommendationsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Content Recommendations Get Content Recommendations Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/generate-content-recommendations":{"post":{"tags":["Recommendations"],"summary":"Generate Content Recommendations","description":"Trigger async generation of content recommendations.","operationId":"generate_content_recommendations_generate_content_recommendations_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateContentRecommendationsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Content Recommendations Generate Content Recommendations Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/generate-mentioned-recommendations":{"post":{"tags":["Recommendations"],"summary":"Generate Mentioned Recommendations","description":"Ensure an on-demand mentioned-recommendations run for a domain (idempotent).\n\nThe ``mentioned_gen:{domain_id}`` redis key is the only guard: a live status is\nreturned as-is (no duplicate run); an absent/expired key triggers a fresh run.\nSafe to call from multiple tabs/users — the SET NX claim resolves races.","operationId":"generate_mentioned_recommendations_generate_mentioned_recommendations_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateMentionedRecommendationsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Mentioned Recommendations Generate Mentioned Recommendations Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-mentioned-generation-status":{"post":{"tags":["Recommendations"],"summary":"Get Mentioned Generation Status","description":"Read the on-demand generation status for a domain (the frontend's polling target).","operationId":"get_mentioned_generation_status_get_mentioned_generation_status_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetMentionedGenerationStatusRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Mentioned Generation Status Get Mentioned Generation Status Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/generate-engage-recommendations":{"post":{"tags":["Recommendations"],"summary":"Generate Engage Recommendations","operationId":"generate_engage_recommendations_generate_engage_recommendations_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateEngageRecommendationsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Engage Recommendations Generate Engage Recommendations Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-engage-generation-status":{"post":{"tags":["Recommendations"],"summary":"Get Engage Generation Status","operationId":"get_engage_generation_status_get_engage_generation_status_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetEngageGenerationStatusRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Engage Generation Status Get Engage Generation Status Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-actions-availability":{"post":{"tags":["Recommendations"],"summary":"Get Actions Availability","operationId":"get_actions_availability_get_actions_availability_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetActionsAvailabilityRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Actions Availability Get Actions Availability Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-recommendation-item-status":{"post":{"tags":["Recommendations"],"summary":"Update Recommendation Item Status","description":"Update status of a recommendation item.","operationId":"update_recommendation_item_status_update_recommendation_item_status_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRecommendationItemStatusRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Recommendation Item Status Update Recommendation Item Status Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/bulk-update-recommendation-item-status":{"post":{"tags":["Recommendations"],"summary":"Bulk Update Recommendation Item Status","description":"Update status for multiple recommendation items in one call.","operationId":"bulk_update_recommendation_item_status_bulk_update_recommendation_item_status_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUpdateRecommendationItemStatusRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Bulk Update Recommendation Item Status Bulk Update Recommendation Item Status Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-recommendation-action-status":{"post":{"tags":["Recommendations"],"summary":"Update Recommendation Action Status","description":"Update status of an engage/mentioned action item.","operationId":"update_recommendation_action_status_update_recommendation_action_status_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRecommendationActionStatusRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Recommendation Action Status Update Recommendation Action Status Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-recommendation-action-statuses":{"post":{"tags":["Recommendations"],"summary":"Get Recommendation Action Statuses","description":"Get all statuses for engage/mentioned items for a domain.","operationId":"get_recommendation_action_statuses_get_recommendation_action_statuses_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetRecommendationActionStatusesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Recommendation Action Statuses Get Recommendation Action Statuses Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-recommended-mentions/opportunity":{"post":{"tags":["Recommendations"],"summary":"Get Recommended Mentions Opportunity","description":"Stats cards (opportunities/closed/pending/top_domain) over a 30d window.","operationId":"get_recommended_mentions_opportunity_get_recommended_mentions_opportunity_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecommendedMentionsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Recommended Mentions Opportunity Get Recommended Mentions Opportunity Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-recommended-mentions":{"post":{"tags":["Recommendations"],"summary":"Get Recommended Mentions","description":"List mentioned items for the domain, paginated, with optional server-side\nfilters (status / search / source-domain / topic_ids / prompt_ids) and a synthetic\n``outreached`` flag. Returns ``{items, pagination}``.","operationId":"get_recommended_mentions_get_recommended_mentions_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecommendedMentionsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Recommended Mentions Get Recommended Mentions Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-recommended-mention-domains":{"post":{"tags":["Recommendations"],"summary":"Get Recommended Mention Domains","description":"Domain view: mention URLs aggregated by source_domain, paginated by domain,\nwith the same optional filters (status / search / topic_ids / prompt_ids).\nReturns ``{items, pagination}`` where each item is a per-domain aggregate. The\n``domain`` request field is ignored here (it only scopes the URL view).","operationId":"get_recommended_mention_domains_get_recommended_mention_domains_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecommendedMentionsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Recommended Mention Domains Get Recommended Mention Domains Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-recommended-mention-facets":{"post":{"tags":["Recommendations"],"summary":"Get Recommended Mention Facets","description":"Filter options (topics + prompts) for the GM page, independent of the current\npage so the dropdowns stay complete under pagination. Returns\n``{topics: [{id, name}], prompts: [{id, text}]}``.","operationId":"get_recommended_mention_facets_get_recommended_mention_facets_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecommendedMentionsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Recommended Mention Facets Get Recommended Mention Facets Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-recommended-mention-status":{"post":{"tags":["Recommendations"],"summary":"Update Recommended Mention Status","description":"Update the status of a mentioned item by its uuid (404 if missing).","operationId":"update_recommended_mention_status_update_recommended_mention_status_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRecommendationItemStatusRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Recommended Mention Status Update Recommended Mention Status Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-recommended-mention-note":{"post":{"tags":["Recommendations"],"summary":"Update Recommended Mention Note","description":"Update the note of a mentioned item by its uuid (404 if missing).","operationId":"update_recommended_mention_note_update_recommended_mention_note_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRecommendedMentionNoteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Recommended Mention Note Update Recommended Mention Note Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-recommended-engagements":{"post":{"tags":["Engagements"],"summary":"Get Recommended Engagements","description":"List persisted ``type='engage'`` items for the domain, paginated, with optional\nserver-side filters (status / search / platform), each joined to its Reddit snapshot\n(platform, enrichment status, archived/locked). Returns ``{items, pagination,\ngeneration_quota}`` — the quota drives the remaining-generations meter on the Generate button.","operationId":"get_recommended_engagements_get_recommended_engagements_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecommendedEngagementsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Recommended Engagements Get Recommended Engagements Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-recommended-engagement-status":{"post":{"tags":["Engagements"],"summary":"Update Recommended Engagement Status","operationId":"update_recommended_engagement_status_update_recommended_engagement_status_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateEngagementStatusRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Recommended Engagement Status Update Recommended Engagement Status Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/trigger-engage-enrichment":{"post":{"tags":["Engagements"],"summary":"Trigger Engage Enrichment","operationId":"trigger_engage_enrichment_trigger_engage_enrichment_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriggerEngageEnrichmentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Trigger Engage Enrichment Trigger Engage Enrichment Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-engage-enrichment-progress":{"post":{"tags":["Engagements"],"summary":"Get Engage Enrichment Progress","operationId":"get_engage_enrichment_progress_get_engage_enrichment_progress_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EngageEnrichmentProgressRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Engage Enrichment Progress Get Engage Enrichment Progress Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-recommended-engagement-facets":{"post":{"tags":["Engagements"],"summary":"Get Recommended Engagement Facets","description":"Distinct topics + prompts referenced by the domain's engage rows, for the Engage\ntoolbar's topic/prompt filter dropdowns. Returns ``{topics:[{id,name}], prompts:[{id,text}]}``,\nindependent of the current page (mirrors the mentioned tab's facets).","operationId":"get_recommended_engagement_facets_get_recommended_engagement_facets_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EngagementFacetsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Recommended Engagement Facets Get Recommended Engagement Facets Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-link-snapshot":{"post":{"tags":["Engagements"],"summary":"Get Link Snapshot","description":"Return the single (overwritten) Reddit snapshot for one engage link:\n``{platform, method, enrichment_status, snapshot, updated_at}``. 404 if the item\nisn't in the domain; 200 with ``snapshot:null`` / ``enrichment_status:'pending'``\nwhen not yet enriched.","operationId":"get_link_snapshot_get_link_snapshot_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkSnapshotRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Link Snapshot Get Link Snapshot Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/generate-engagement-comment":{"post":{"tags":["Engagements"],"summary":"Generate Engagement Comment","description":"Synchronously generate an AI comment for an engage link and persist it. Returns\nthe comment (no job id / polling). Fails fast (409) when the link has no completed\nsnapshot — the backend does NOT scrape on demand.\n\nEnforces the domain's tiered per-calendar-month generation cap: at the cap it returns\n``{'error': 'rate_limited', used, limit, next_available}`` and generates nothing (no\nsocial_generations row). On success it echoes the updated ``generation_quota`` so the\nbutton count ticks down immediately.","operationId":"generate_engagement_comment_generate_engagement_comment_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateEngagementCommentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Engagement Comment Generate Engagement Comment Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-engagement-generations":{"post":{"tags":["Engagements"],"summary":"Get Engagement Generations","description":"Paginated generation history for the domain (optionally scoped to one link),\nnewest first. Returns ``{items, pagination}``.","operationId":"get_engagement_generations_get_engagement_generations_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EngagementGenerationsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Engagement Generations Get Engagement Generations Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/list-engagement-templates":{"post":{"tags":["Engagements"],"summary":"List Engagement Templates","description":"List the domain's comment templates (optionally filtered by usage). Returns ``{templates}``.","operationId":"list_engagement_templates_list_engagement_templates_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEngagementTemplatesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Engagement Templates List Engagement Templates Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/create-engagement-template":{"post":{"tags":["Engagements"],"summary":"Create Engagement Template","description":"Create a domain comment template. Returns ``{template}``.","operationId":"create_engagement_template_create_engagement_template_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEngagementTemplateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Engagement Template Create Engagement Template Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/delete-engagement-template":{"post":{"tags":["Engagements"],"summary":"Delete Engagement Template","description":"Delete one of the domain's comment templates. 404 if it isn't the domain's. Returns ``{deleted}``.","operationId":"delete_engagement_template_delete_engagement_template_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteEngagementTemplateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Engagement Template Delete Engagement Template Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-engagement-template":{"post":{"tags":["Engagements"],"summary":"Update Engagement Template","operationId":"update_engagement_template_update_engagement_template_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateEngagementTemplateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Engagement Template Update Engagement Template Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/create-topic":{"post":{"tags":["Topics"],"summary":"Create Topic","operationId":"create_topic_create_topic_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTopic"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Topic Create Topic Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-topics":{"post":{"tags":["Topics"],"summary":"Get Topics","operationId":"get_topics_get_topics_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTopics"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Topics Get Topics Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-topic":{"post":{"tags":["Topics"],"summary":"Update Topic","operationId":"update_topic_update_topic_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTopic"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Topic Update Topic Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/delete-topic":{"post":{"tags":["Topics"],"summary":"Delete Topic","operationId":"delete_topic_delete_topic_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteTopic"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Topic Delete Topic Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-prompt-topic":{"post":{"tags":["Topics"],"summary":"Update Prompt Topic","operationId":"update_prompt_topic_update_prompt_topic_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePromptTopic"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Prompt Topic Update Prompt Topic Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-topics-list":{"post":{"tags":["Topics"],"summary":"Get Topics List","operationId":"get_topics_list_get_topics_list_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTopicsList"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicsListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/bulk-delete-topics":{"post":{"tags":["Topics"],"summary":"Bulk Delete Topics","operationId":"bulk_delete_topics_bulk_delete_topics_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkDeleteTopics"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-topic-queries":{"post":{"tags":["Topics"],"summary":"Get Topic Queries","operationId":"get_topic_queries_get_topic_queries_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTopicQueries"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicQueriesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/export-simple-data":{"post":{"tags":["Topics"],"summary":"Export Simple Data","description":"Export all topics and/or prompts with metrics (unpaginated, for simple export).","operationId":"export_simple_data_export_simple_data_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportSimpleData"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-tag-colors":{"post":{"tags":["Tags"],"summary":"Get Tag Colors","operationId":"get_tag_colors_get_tag_colors_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagColorsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-tags":{"post":{"tags":["Tags"],"summary":"Get Tags","operationId":"get_tags_get_tags_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTags"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagsListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/create-tag":{"post":{"tags":["Tags"],"summary":"Create Tag","operationId":"create_tag_create_tag_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTag"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Tag Create Tag Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-tag":{"post":{"tags":["Tags"],"summary":"Update Tag","operationId":"update_tag_update_tag_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTag"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Tag Update Tag Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/delete-tag":{"post":{"tags":["Tags"],"summary":"Delete Tag","operationId":"delete_tag_delete_tag_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteTag"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Tag Delete Tag Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-prompt-tags":{"post":{"tags":["Tags"],"summary":"Update Prompt Tags","operationId":"update_prompt_tags_update_prompt_tags_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePromptTags"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Prompt Tags Update Prompt Tags Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-topic-prompt-tags":{"post":{"tags":["Tags"],"summary":"Update Topic Prompt Tags","operationId":"update_topic_prompt_tags_update_topic_prompt_tags_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTopicPromptTags"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicPromptTagsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-topic-prompt-tag-selection":{"post":{"tags":["Tags"],"summary":"Update Topic Prompt Tag Selection","operationId":"update_topic_prompt_tag_selection_update_topic_prompt_tag_selection_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTopicPromptTagSelection"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicPromptTagSelectionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-prompts-tags":{"post":{"tags":["Tags"],"summary":"Update Prompts Tags","operationId":"update_prompts_tags_update_prompts_tags_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePromptsTags"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptsTagsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-prompts-tag-summary":{"post":{"tags":["Tags"],"summary":"Get Prompts Tag Summary","operationId":"get_prompts_tag_summary_get_prompts_tag_summary_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetPromptsTagSummary"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptsTagSummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-topic-prompts":{"post":{"tags":["Tags"],"summary":"Get Topic Prompts","operationId":"get_topic_prompts_get_topic_prompts_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTopicPrompts"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicPromptsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-topic-tag-summary":{"post":{"tags":["Tags"],"summary":"Get Topic Tag Summary","operationId":"get_topic_tag_summary_get_topic_tag_summary_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTopicTagSummary"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TopicTagSummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/resolve-tag-query-ids":{"post":{"tags":["Tags"],"summary":"Resolve Tag Query Ids","operationId":"resolve_tag_query_ids_resolve_tag_query_ids_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveTagQueryIds"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Resolve Tag Query Ids Resolve Tag Query Ids Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-picker-preferences":{"get":{"tags":["Preferences"],"summary":"Get Picker Preferences","operationId":"get_picker_preferences_get_picker_preferences_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PickerPreferencesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/update-picker-preferences":{"post":{"tags":["Preferences"],"summary":"Update Picker Preferences","operationId":"update_picker_preferences_update_picker_preferences_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePickerPreferences"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PickerPreferencesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/notifications":{"get":{"tags":["Notifications"],"summary":"List Notifications","operationId":"list_notifications_notifications_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotificationsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/notifications/read":{"post":{"tags":["Notifications"],"summary":"Mark Notifications Read","operationId":"mark_notifications_read_notifications_read_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarkReadRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Mark Notifications Read Notifications Read Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/get-dashboard":{"post":{"tags":["Public"],"summary":"Get Public Dashboard","description":"Get public dashboard data for a shareable domain.\nNo authentication required - only works for domains with is_shareable=true.","operationId":"get_public_dashboard_public_get_dashboard_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetPublicDashboardRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Public Dashboard Public Get Dashboard Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/domain-info":{"post":{"tags":["Public"],"summary":"Get Public Domain Info","description":"Get domain info and analysis status for a shareable domain.","operationId":"get_public_domain_info_public_domain_info_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDomainInfoRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Public Domain Info Public Domain Info Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/competitors-data":{"post":{"tags":["Public"],"summary":"Get Public Competitors Data Endpoint","description":"Get competitors chart data for a shareable domain.","operationId":"get_public_competitors_data_endpoint_public_competitors_data_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompetitorsDataRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Public Competitors Data Endpoint Public Competitors Data Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/competitors-citations-data":{"post":{"tags":["Public"],"summary":"Get Public Competitors Citations Data Endpoint","description":"Get per-entity daily citation counts for a shareable domain.","operationId":"get_public_competitors_citations_data_endpoint_public_competitors_citations_data_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompetitorsDataRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Public Competitors Citations Data Endpoint Public Competitors Citations Data Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/industry-stats":{"post":{"tags":["Public"],"summary":"Get Public Industry Stats Endpoint","description":"Get industry stats for a shareable domain.","operationId":"get_public_industry_stats_endpoint_public_industry_stats_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicIndustryStatsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Public Industry Stats Endpoint Public Industry Stats Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/discovery-competitors":{"post":{"tags":["Public"],"summary":"Get Public Discovery Competitors Endpoint","description":"Get discovery competitors for a shareable domain.","operationId":"get_public_discovery_competitors_endpoint_public_discovery_competitors_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDiscoveryCompetitorsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Public Discovery Competitors Endpoint Public Discovery Competitors Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/topics":{"post":{"tags":["Public"],"summary":"Get Public Topics Endpoint","description":"Get topics with aggregates for a shareable domain.","operationId":"get_public_topics_endpoint_public_topics_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTopicsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Public Topics Endpoint Public Topics Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/prompts":{"post":{"tags":["Public"],"summary":"Get Public Prompts Endpoint","description":"Get prompts with metrics for a shareable domain.","operationId":"get_public_prompts_endpoint_public_prompts_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicPromptsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Public Prompts Endpoint Public Prompts Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/citations":{"post":{"tags":["Public"],"summary":"Get Public Citations Endpoint","description":"Get citations data for a shareable domain.","operationId":"get_public_citations_endpoint_public_citations_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCitationsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Public Citations Endpoint Public Citations Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/metrics":{"post":{"tags":["Public"],"summary":"Get Public Metrics Endpoint","description":"Get metrics for a shareable domain.","operationId":"get_public_metrics_endpoint_public_metrics_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicMetricsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Public Metrics Endpoint Public Metrics Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/attribution":{"post":{"tags":["Public"],"summary":"Get Public Attribution Endpoint","description":"Get attribution data for a shareable domain.","operationId":"get_public_attribution_endpoint_public_attribution_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicAttributionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Public Attribution Endpoint Public Attribution Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/mentions-timeseries":{"post":{"tags":["Public"],"summary":"Get Public Mentions Timeseries Endpoint","description":"Get mentions timeseries for a shareable domain.","operationId":"get_public_mentions_timeseries_endpoint_public_mentions_timeseries_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicMentionsTimeseriesRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Public Mentions Timeseries Endpoint Public Mentions Timeseries Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/topic-prompts":{"post":{"tags":["Public"],"summary":"Get Public Topic Prompts Endpoint","description":"Get prompts for a specific topic with pagination and aggregates for a shareable domain.","operationId":"get_public_topic_prompts_endpoint_public_topic_prompts_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicTopicPromptsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Public Topic Prompts Endpoint Public Topic Prompts Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/domain/reach":{"post":{"tags":["Data Explorer"],"summary":"Domain Reach","operationId":"domain_reach_data_explorer_domain_reach_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExplorerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/domain/overview":{"post":{"tags":["Data Explorer"],"summary":"Domain Overview","operationId":"domain_overview_data_explorer_domain_overview_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExplorerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/domain/visibility":{"post":{"tags":["Data Explorer"],"summary":"Domain Visibility","operationId":"domain_visibility_data_explorer_domain_visibility_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExplorerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/domain/presence":{"post":{"tags":["Data Explorer"],"summary":"Domain Presence","operationId":"domain_presence_data_explorer_domain_presence_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExplorerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/domain/share-of-voice":{"post":{"tags":["Data Explorer"],"summary":"Domain Share Of Voice","operationId":"domain_share_of_voice_data_explorer_domain_share_of_voice_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExplorerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/domain/brand-rank":{"post":{"tags":["Data Explorer"],"summary":"Domain Brand Rank","operationId":"domain_brand_rank_data_explorer_domain_brand_rank_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExplorerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/domain/presence-by-engine":{"post":{"tags":["Data Explorer"],"summary":"Domain Presence By Engine","operationId":"domain_presence_by_engine_data_explorer_domain_presence_by_engine_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExplorerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/domain/visibility-trend":{"post":{"tags":["Data Explorer"],"summary":"Domain Visibility Trend","operationId":"domain_visibility_trend_data_explorer_domain_visibility_trend_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExplorerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/domain/presence-trend":{"post":{"tags":["Data Explorer"],"summary":"Domain Presence Trend","operationId":"domain_presence_trend_data_explorer_domain_presence_trend_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExplorerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/domain/mentioned-brands":{"post":{"tags":["Data Explorer"],"summary":"Domain Mentioned Brands","operationId":"domain_mentioned_brands_data_explorer_domain_mentioned_brands_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExplorerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/domain/share-of-voice-trend":{"post":{"tags":["Data Explorer"],"summary":"Domain Share Of Voice Trend","operationId":"domain_share_of_voice_trend_data_explorer_domain_share_of_voice_trend_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExplorerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/domain/cited-sources":{"post":{"tags":["Data Explorer"],"summary":"Domain Cited Sources","operationId":"domain_cited_sources_data_explorer_domain_cited_sources_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExplorerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/domain/cited-pages":{"post":{"tags":["Data Explorer"],"summary":"Domain Cited Pages","operationId":"domain_cited_pages_data_explorer_domain_cited_pages_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExplorerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/domain/citing-prompts":{"post":{"tags":["Data Explorer"],"summary":"Domain Citing Prompts","operationId":"domain_citing_prompts_data_explorer_domain_citing_prompts_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExplorerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/domain/topics":{"post":{"tags":["Data Explorer"],"summary":"Domain Topics","operationId":"domain_topics_data_explorer_domain_topics_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExplorerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/domain/prompt-gap":{"post":{"tags":["Data Explorer"],"summary":"Domain Prompt Gap","operationId":"domain_prompt_gap_data_explorer_domain_prompt_gap_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExplorerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/domain/influence-map":{"post":{"tags":["Data Explorer"],"summary":"Domain Influence Map","operationId":"domain_influence_map_data_explorer_domain_influence_map_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExplorerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/domain/discovered-mentions":{"post":{"tags":["Data Explorer"],"summary":"Domain Discovered Mentions","operationId":"domain_discovered_mentions_data_explorer_domain_discovered_mentions_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataExplorerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/window":{"get":{"tags":["Data Explorer"],"summary":"Data Window","operationId":"data_window_data_explorer_window_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/data-explorer/hub":{"get":{"tags":["Data Explorer"],"summary":"Data Hub","operationId":"data_hub_data_explorer_hub_get","parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"}},{"name":"model","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Model"}},{"name":"sector","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sector"}},{"name":"industry","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sentiment-themes/overview":{"post":{"tags":["Sentiment Themes"],"summary":"Get Sentiment Overview","operationId":"get_sentiment_overview_sentiment_themes_overview_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SentimentThemesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sentiment-themes/trendline":{"post":{"tags":["Sentiment Themes"],"summary":"Get Sentiment Trendline","operationId":"get_sentiment_trendline_sentiment_themes_trendline_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SentimentThemesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sentiment-themes/themes":{"post":{"tags":["Sentiment Themes"],"summary":"Get Sentiment Themes","operationId":"get_sentiment_themes_sentiment_themes_themes_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SentimentThemesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sentiment-themes/theme-responses":{"post":{"tags":["Sentiment Themes"],"summary":"Get Sentiment Theme Responses","operationId":"get_sentiment_theme_responses_sentiment_themes_theme_responses_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SentimentThemeResponsesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sentiment-themes/theme-sources":{"post":{"tags":["Sentiment Themes"],"summary":"Get Sentiment Theme Sources","operationId":"get_sentiment_theme_sources_sentiment_themes_theme_sources_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SentimentThemeSourcesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sentiment-themes/update-models":{"post":{"tags":["Sentiment Themes"],"summary":"Update Sentiment Models","operationId":"update_sentiment_models_sentiment_themes_update_models_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateSentimentModelsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sentiment-themes/rename":{"post":{"tags":["Sentiment Themes"],"summary":"Rename Sentiment Theme","operationId":"rename_sentiment_theme_sentiment_themes_rename_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RenameThemeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/sentiment-themes/archive":{"post":{"tags":["Sentiment Themes"],"summary":"Archive Sentiment Theme","operationId":"archive_sentiment_theme_sentiment_themes_archive_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteThemeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/search-users":{"post":{"tags":["admin"],"summary":"Admin Search Users","operationId":"admin_search_users_admin_search_users_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchUsersRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/lookup-email":{"post":{"tags":["admin"],"summary":"Admin Lookup Email","operationId":"admin_lookup_email_admin_lookup_email_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LookupEmailRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/join-team":{"post":{"tags":["admin"],"summary":"Admin Join Team","operationId":"admin_join_team_admin_join_team_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JoinTeamRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/update-plan":{"post":{"tags":["admin"],"summary":"Admin Update Plan","operationId":"admin_update_plan_admin_update_plan_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePlanRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/search-teams":{"post":{"tags":["admin"],"summary":"Admin Search Teams","operationId":"admin_search_teams_admin_search_teams_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchTeamsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/search-domains":{"post":{"tags":["admin"],"summary":"Admin Search Domains","operationId":"admin_search_domains_admin_search_domains_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchDomainsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/trigger-analysis":{"post":{"tags":["admin"],"summary":"Admin Trigger Analysis","operationId":"admin_trigger_analysis_admin_trigger_analysis_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriggerAnalysisRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/get-analyses":{"post":{"tags":["admin"],"summary":"Admin Get Analyses","operationId":"admin_get_analyses_admin_get_analyses_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAnalysesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/onboarding-runs":{"post":{"tags":["admin"],"summary":"Admin Onboarding Runs","operationId":"admin_onboarding_runs_admin_onboarding_runs_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OnboardingRunsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/move-domain":{"post":{"tags":["admin"],"summary":"Admin Move Domain","operationId":"admin_move_domain_admin_move_domain_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoveDomainRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/get-team-members":{"post":{"tags":["admin"],"summary":"Admin Get Team Members","operationId":"admin_get_team_members_admin_get_team_members_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTeamMembersRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/set-developer-access":{"post":{"tags":["admin"],"summary":"Admin Set Developer Access","operationId":"admin_set_developer_access_admin_set_developer_access_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetDeveloperAccessRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/set-legacy-pricing":{"post":{"tags":["admin"],"summary":"Admin Set Legacy Pricing","operationId":"admin_set_legacy_pricing_admin_set_legacy_pricing_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetLegacyPricingRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/set-assistant-daily-messages":{"post":{"tags":["admin"],"summary":"Admin Set Assistant Daily Messages","operationId":"admin_set_assistant_daily_messages_admin_set_assistant_daily_messages_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetAssistantMessagesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/update-member-role":{"post":{"tags":["admin"],"summary":"Admin Update Member Role Route","operationId":"admin_update_member_role_route_admin_update_member_role_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMemberRoleRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/remove-team-member":{"post":{"tags":["admin"],"summary":"Admin Remove Team Member Route","operationId":"admin_remove_team_member_route_admin_remove_team_member_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemoveTeamMemberRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/add-team-member":{"post":{"tags":["admin"],"summary":"Admin Add Team Member Route","operationId":"admin_add_team_member_route_admin_add_team_member_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddTeamMemberRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/create-enterprise-user":{"post":{"tags":["admin"],"summary":"Admin Create Enterprise User Route","operationId":"admin_create_enterprise_user_route_admin_create_enterprise_user_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEnterpriseUserRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/leave-team":{"post":{"tags":["admin"],"summary":"Admin Leave Team","operationId":"admin_leave_team_admin_leave_team_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeaveTeamRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/get-team-prompt-stats":{"post":{"tags":["admin"],"summary":"Admin Get Team Prompt Stats","operationId":"admin_get_team_prompt_stats_admin_get_team_prompt_stats_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetTeamPromptStatsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/get-my-teams":{"post":{"tags":["admin"],"summary":"Admin Get My Teams","operationId":"admin_get_my_teams_admin_get_my_teams_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/update-team-created-at":{"post":{"tags":["admin"],"summary":"Admin Update Team Created At","operationId":"admin_update_team_created_at_admin_update_team_created_at_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTeamCreatedAtRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/rename-team":{"post":{"tags":["admin"],"summary":"Admin Rename Team","operationId":"admin_rename_team_admin_rename_team_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RenameTeamRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/preview-team-deletion":{"post":{"tags":["admin"],"summary":"Admin Preview Team Deletion","operationId":"admin_preview_team_deletion_admin_preview_team_deletion_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteTeamRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/delete-team":{"post":{"tags":["admin"],"summary":"Admin Delete Team","operationId":"admin_delete_team_admin_delete_team_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteTeamRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/preview-user-deletion":{"post":{"tags":["admin"],"summary":"Admin Preview User Deletion","operationId":"admin_preview_user_deletion_admin_preview_user_deletion_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteUserRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/delete-user":{"post":{"tags":["admin"],"summary":"Admin Delete User","operationId":"admin_delete_user_admin_delete_user_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteUserRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/get-domain-info":{"post":{"tags":["admin"],"summary":"Admin Get Domain Info","operationId":"admin_get_domain_info_admin_get_domain_info_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetDomainInfoRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/update-domain-settings":{"post":{"tags":["admin"],"summary":"Admin Update Domain Settings","operationId":"admin_update_domain_settings_admin_update_domain_settings_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDomainSettingsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/add-domain-member":{"post":{"tags":["admin"],"summary":"Admin Add Domain Member","operationId":"admin_add_domain_member_admin_add_domain_member_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddDomainMemberRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/remove-domain-member":{"post":{"tags":["admin"],"summary":"Admin Remove Domain Member","operationId":"admin_remove_domain_member_admin_remove_domain_member_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemoveDomainMemberRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/set-user-role":{"post":{"tags":["admin"],"summary":"Admin Set User Role","operationId":"admin_set_user_role_admin_set_user_role_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetUserRoleRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-set-service-provider":{"post":{"tags":["admin"],"summary":"Admin Outreach Set Service Provider","description":"Grant/revoke outreach_service_provider. Allowed for super_admin OR outreach_admin\n(verify_outreach_admin); the service refuses to touch higher tiers.","operationId":"admin_outreach_set_service_provider_admin_outreach_set_service_provider_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOutreachSetServiceProviderRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/onboarding-engine/run":{"post":{"tags":["onboarding_engine"],"summary":"Run Onboarding Engine Route","description":"Kick off the onboarding engine for a domain's analyzable queries.","operationId":"run_onboarding_engine_route_onboarding_engine_run_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/discovery/generate-services":{"post":{"tags":["Discovery"],"summary":"Generate Services","operationId":"generate_services_discovery_generate_services_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateServicesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Services Discovery Generate Services Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/discovery/generate-clusters":{"post":{"tags":["Discovery"],"summary":"Generate Clusters","operationId":"generate_clusters_discovery_generate_clusters_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateClustersRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Clusters Discovery Generate Clusters Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/discovery/generate-cluster-prompts":{"post":{"tags":["Discovery"],"summary":"Generate Cluster Prompts","operationId":"generate_cluster_prompts_discovery_generate_cluster_prompts_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateClusterPromptsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Cluster Prompts Discovery Generate Cluster Prompts Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/discovery/save-services":{"post":{"tags":["Discovery"],"summary":"Save Services","operationId":"save_services_discovery_save_services_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveServicesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Save Services Discovery Save Services Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/discovery/get-services":{"post":{"tags":["Discovery"],"summary":"Get Services","operationId":"get_services_discovery_get_services_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetServicesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Services Discovery Get Services Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/discovery/save-results":{"post":{"tags":["Discovery"],"summary":"Save Results","operationId":"save_results_discovery_save_results_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveDiscoveryResultsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Save Results Discovery Save Results Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/discovery/save-clusters":{"post":{"tags":["Discovery"],"summary":"Save Clusters","operationId":"save_clusters_discovery_save_clusters_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveClustersRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Save Clusters Discovery Save Clusters Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/discovery/get-clusters":{"post":{"tags":["Discovery"],"summary":"Get Clusters","operationId":"get_clusters_discovery_get_clusters_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetClustersRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Clusters Discovery Get Clusters Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/discovery/rename-cluster":{"post":{"tags":["Discovery"],"summary":"Rename Cluster","operationId":"rename_cluster_discovery_rename_cluster_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RenameClusterRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Rename Cluster Discovery Rename Cluster Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/discovery/save-discovery-prompts":{"post":{"tags":["Discovery"],"summary":"Save Discovery Prompts","operationId":"save_discovery_prompts_discovery_save_discovery_prompts_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveDiscoveryPromptsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Save Discovery Prompts Discovery Save Discovery Prompts Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/discovery/get-discovery-prompts":{"post":{"tags":["Discovery"],"summary":"Get Discovery Prompts","operationId":"get_discovery_prompts_discovery_get_discovery_prompts_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetDiscoveryPromptsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Discovery Prompts Discovery Get Discovery Prompts Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/discovery/activate-discovery-prompts":{"post":{"tags":["Discovery"],"summary":"Activate Discovery Prompts","operationId":"activate_discovery_prompts_discovery_activate_discovery_prompts_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActivateDiscoveryPromptsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Activate Discovery Prompts Discovery Activate Discovery Prompts Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/discovery/list-queries-topics":{"post":{"tags":["Discovery"],"summary":"List Queries Topics","operationId":"list_queries_topics_discovery_list_queries_topics_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListQueriesTopicsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TopicWithQueries"},"title":"Response List Queries Topics Discovery List Queries Topics Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/discovery/generate-article-topics":{"post":{"tags":["Discovery"],"summary":"Generate Article Topics","operationId":"generate_article_topics_discovery_generate_article_topics_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateArticleTopicsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Article Topics Discovery Generate Article Topics Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/discovery/generate-cluster-prompts":{"post":{"tags":["Discovery"],"summary":"Generate Cluster Prompts V2","operationId":"generate_cluster_prompts_v2_v2_discovery_generate_cluster_prompts_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateClusterPromptsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Cluster Prompts V2 V2 Discovery Generate Cluster Prompts Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/discovery/score-prompts":{"post":{"tags":["Discovery-Analysis"],"summary":"Score Prompts","operationId":"score_prompts_v2_discovery_score_prompts_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScorePromptsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Score Prompts V2 Discovery Score Prompts Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/public/visibility/url-lookup":{"post":{"tags":["Visibility"],"summary":"Url Lookup","description":"Public endpoint: look up a URL's AI citation visibility metrics.","operationId":"url_lookup_public_visibility_url_lookup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UrlLookupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UrlLookupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/geo/states":{"get":{"tags":["Geo"],"summary":"List States","operationId":"list_states_geo_states_get","parameters":[{"name":"country","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"title":"Country"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StateOut"},"title":"Response List States Geo States Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/geo/cities":{"get":{"tags":["Geo"],"summary":"Search Cities","operationId":"search_cities_geo_cities_get","parameters":[{"name":"country","in":"query","required":true,"schema":{"type":"array","items":{"type":"string"},"minItems":1,"title":"Country"}},{"name":"state","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"},"default":[],"title":"State"}},{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":80,"default":"","title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":25,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CityOut"},"title":"Response Search Cities Geo Cities Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ads/kpis":{"post":{"tags":["Ads"],"summary":"Ads Kpis","operationId":"ads_kpis_ads_kpis_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsKpisRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ads/leaderboard":{"post":{"tags":["Ads"],"summary":"Ads Leaderboard","operationId":"ads_leaderboard_ads_leaderboard_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsLeaderboardRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ads/timeline":{"post":{"tags":["Ads"],"summary":"Ads Timeline","operationId":"ads_timeline_ads_timeline_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsTimelineRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ads/prompts":{"post":{"tags":["Ads"],"summary":"Ads Prompts","operationId":"ads_prompts_ads_prompts_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsPromptsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/ads/cards":{"post":{"tags":["Ads"],"summary":"Ads Cards","operationId":"ads_cards_ads_cards_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsCardsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api-keys":{"post":{"tags":["API Keys"],"summary":"Create Api Key","operationId":"create_api_key_api_keys_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiKeyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Api Key Api Keys Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api-keys/list":{"post":{"tags":["API Keys"],"summary":"List Api Keys","operationId":"list_api_keys_api_keys_list_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListApiKeysRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Api Keys Api Keys List Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api-keys/{api_key_id}":{"delete":{"tags":["API Keys"],"summary":"Revoke Api Key","operationId":"revoke_api_key_api_keys__api_key_id__delete","parameters":[{"name":"api_key_id","in":"path","required":true,"schema":{"type":"string","title":"Api Key Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Revoke Api Key Api Keys  Api Key Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assistant/stream":{"post":{"tags":["Assistant"],"summary":"Stream Assistant Answer","operationId":"stream_assistant_answer_assistant_stream_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assistant/quota":{"post":{"tags":["Assistant"],"summary":"Get Assistant Quota","operationId":"get_assistant_quota_assistant_quota_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuotaRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assistant/conversations/list":{"post":{"tags":["Assistant"],"summary":"List Assistant Conversations","operationId":"list_assistant_conversations_assistant_conversations_list_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationListRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assistant/conversations/get":{"post":{"tags":["Assistant"],"summary":"Get Assistant Conversation","operationId":"get_assistant_conversation_assistant_conversations_get_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationGetRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/assistant/conversations/{conversation_id}":{"delete":{"tags":["Assistant"],"summary":"Archive Assistant Conversation","operationId":"archive_assistant_conversation_assistant_conversations__conversation_id__delete","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/validate":{"get":{"tags":["Public API v1"],"summary":"V1 Validate","operationId":"v1_validate_api_v1_validate_get","parameters":[{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Validate Api V1 Validate Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/domains":{"get":{"tags":["Public API v1"],"summary":"V1 List Domains","operationId":"v1_list_domains_api_v1_domains_get","parameters":[{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 List Domains Api V1 Domains Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Public API v1"],"summary":"V1 Create Domain","description":"Create a brand/domain (with prompts) so analysis can start immediately.\n\nRequires either a `prompts` list or `generate_prompts=true` — a domain with nothing to\nanalyze would sit in the \"analyzing\" state forever.","operationId":"v1_create_domain_api_v1_domains_post","parameters":[{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Create Domain Api V1 Domains Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/prompts":{"get":{"tags":["Public API v1"],"summary":"V1 Prompts","operationId":"v1_prompts_api_v1_prompts_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Size"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Case-insensitive substring match on the prompt text.","title":"Q"},"description":"Case-insensitive substring match on the prompt text."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"topic_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"description":"Only prompts in any of these topics (UUIDs from GET /api/v1/topics). Repeat the param per id. Combined with tag_ids, a prompt matching either is kept.","title":"Topic Ids"},"description":"Only prompts in any of these topics (UUIDs from GET /api/v1/topics). Repeat the param per id. Combined with tag_ids, a prompt matching either is kept."},{"name":"tag_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"description":"Only prompts carrying any of these tags (UUIDs from GET /api/v1/tags). Repeat the param per id.","title":"Tag Ids"},"description":"Only prompts carrying any of these tags (UUIDs from GET /api/v1/tags). Repeat the param per id."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Prompts Api V1 Prompts Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Public API v1"],"summary":"V1 Add Prompt","description":"Add a prompt (with optional topics and tags) to the domain.","operationId":"v1_add_prompt_api_v1_prompts_post","parameters":[{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Add Prompt Api V1 Prompts Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/fanout-queries":{"get":{"tags":["Public API v1"],"summary":"V1 Fanout Queries","description":"Fan-out queries per prompt. Send `page` to paginate by prompt (`size` per page, default 100); without it every prompt is returned. `prompt_id` narrows to one prompt; `include_urls` adds the URLs cited by the response that ran each fan-out query.","operationId":"v1_fanout_queries_api_v1_fanout_queries_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"model","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Model"}},{"name":"prompt_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Prompt Id"}},{"name":"include_urls","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Urls"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Page"}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Size"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Fanout Queries Api V1 Fanout Queries Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/visibility-time-series":{"get":{"tags":["Public API v1"],"summary":"V1 Visibility Time Series","operationId":"v1_visibility_time_series_api_v1_visibility_time_series_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"model","in":"query","required":false,"schema":{"type":"string","description":"Restrict to one AI channel by generic name (ChatGPT, Perplexity, Gemini, AI Overviews, AI Mode, Claude, Microsoft Copilot, Grok, ...) or 'all'.","default":"all","title":"Model"},"description":"Restrict to one AI channel by generic name (ChatGPT, Perplexity, Gemini, AI Overviews, AI Mode, Claude, Microsoft Copilot, Grok, ...) or 'all'."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"topic_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"description":"Only prompts in any of these topics (UUIDs from GET /api/v1/topics). Repeat the param per id. Combined with tag_ids, a prompt matching either is kept.","title":"Topic Ids"},"description":"Only prompts in any of these topics (UUIDs from GET /api/v1/topics). Repeat the param per id. Combined with tag_ids, a prompt matching either is kept."},{"name":"tag_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"description":"Only prompts carrying any of these tags (UUIDs from GET /api/v1/tags). Repeat the param per id.","title":"Tag Ids"},"description":"Only prompts carrying any of these tags (UUIDs from GET /api/v1/tags). Repeat the param per id."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Visibility Time Series Api V1 Visibility Time Series Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/mentions-time-series":{"get":{"tags":["Public API v1"],"summary":"V1 Mentions Time Series","operationId":"v1_mentions_time_series_api_v1_mentions_time_series_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"model","in":"query","required":false,"schema":{"type":"string","description":"Restrict to one AI channel by generic name (ChatGPT, Perplexity, Gemini, AI Overviews, AI Mode, Claude, Microsoft Copilot, Grok, ...) or 'all'.","default":"all","title":"Model"},"description":"Restrict to one AI channel by generic name (ChatGPT, Perplexity, Gemini, AI Overviews, AI Mode, Claude, Microsoft Copilot, Grok, ...) or 'all'."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"topic_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"description":"Only prompts in any of these topics (UUIDs from GET /api/v1/topics). Repeat the param per id. Combined with tag_ids, a prompt matching either is kept.","title":"Topic Ids"},"description":"Only prompts in any of these topics (UUIDs from GET /api/v1/topics). Repeat the param per id. Combined with tag_ids, a prompt matching either is kept."},{"name":"tag_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"description":"Only prompts carrying any of these tags (UUIDs from GET /api/v1/tags). Repeat the param per id.","title":"Tag Ids"},"description":"Only prompts carrying any of these tags (UUIDs from GET /api/v1/tags). Repeat the param per id."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Mentions Time Series Api V1 Mentions Time Series Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/citability-time-series":{"get":{"tags":["Public API v1"],"summary":"V1 Citability Time Series","operationId":"v1_citability_time_series_api_v1_citability_time_series_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"model","in":"query","required":false,"schema":{"type":"string","description":"Restrict to one AI channel by generic name (ChatGPT, Perplexity, Gemini, AI Overviews, AI Mode, Claude, Microsoft Copilot, Grok, ...) or 'all'.","default":"all","title":"Model"},"description":"Restrict to one AI channel by generic name (ChatGPT, Perplexity, Gemini, AI Overviews, AI Mode, Claude, Microsoft Copilot, Grok, ...) or 'all'."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"topic_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"description":"Only prompts in any of these topics (UUIDs from GET /api/v1/topics). Repeat the param per id. Combined with tag_ids, a prompt matching either is kept.","title":"Topic Ids"},"description":"Only prompts in any of these topics (UUIDs from GET /api/v1/topics). Repeat the param per id. Combined with tag_ids, a prompt matching either is kept."},{"name":"tag_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"description":"Only prompts carrying any of these tags (UUIDs from GET /api/v1/tags). Repeat the param per id.","title":"Tag Ids"},"description":"Only prompts carrying any of these tags (UUIDs from GET /api/v1/tags). Repeat the param per id."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Citability Time Series Api V1 Citability Time Series Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/citations-time-series":{"get":{"tags":["Public API v1"],"summary":"V1 Citations Time Series","operationId":"v1_citations_time_series_api_v1_citations_time_series_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"model","in":"query","required":false,"schema":{"type":"string","description":"Restrict to one AI channel by generic name (ChatGPT, Perplexity, Gemini, AI Overviews, AI Mode, Claude, Microsoft Copilot, Grok, ...) or 'all'.","default":"all","title":"Model"},"description":"Restrict to one AI channel by generic name (ChatGPT, Perplexity, Gemini, AI Overviews, AI Mode, Claude, Microsoft Copilot, Grok, ...) or 'all'."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"topic_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"description":"Only prompts in any of these topics (UUIDs from GET /api/v1/topics). Repeat the param per id. Combined with tag_ids, a prompt matching either is kept.","title":"Topic Ids"},"description":"Only prompts in any of these topics (UUIDs from GET /api/v1/topics). Repeat the param per id. Combined with tag_ids, a prompt matching either is kept."},{"name":"tag_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"description":"Only prompts carrying any of these tags (UUIDs from GET /api/v1/tags). Repeat the param per id.","title":"Tag Ids"},"description":"Only prompts carrying any of these tags (UUIDs from GET /api/v1/tags). Repeat the param per id."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Citations Time Series Api V1 Citations Time Series Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/citations":{"get":{"tags":["Public API v1"],"summary":"V1 Citations","description":"Cited URLs sorted by frequency desc. Send `page` to paginate (`size` per page, default 200, max 1000) and page through until `page == total_pages`; without it every URL is returned, which can be very large for long windows. Narrow with `min_frequency`, `cited_domain` (exact host) or `page_type`. `group_by=domain|page_type` returns aggregated rows instead of URLs.","operationId":"v1_citations_api_v1_citations_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Page"}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":200,"title":"Size"}},{"name":"min_frequency","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Min Frequency"}},{"name":"cited_domain","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cited Domain"}},{"name":"page_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Type"}},{"name":"group_by","in":"query","required":false,"schema":{"anyOf":[{"enum":["domain","page_type"],"type":"string"},{"type":"null"}],"title":"Group By"}},{"name":"is_brand_owned","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"true keeps only the brand's own pages, false only third-party pages.","title":"Is Brand Owned"},"description":"true keeps only the brand's own pages, false only third-party pages."},{"name":"model","in":"query","required":false,"schema":{"type":"string","description":"Restrict to one AI channel by generic name (ChatGPT, Perplexity, Gemini, AI Overviews, AI Mode, Claude, Microsoft Copilot, Grok, ...) or 'all'.","default":"all","title":"Model"},"description":"Restrict to one AI channel by generic name (ChatGPT, Perplexity, Gemini, AI Overviews, AI Mode, Claude, Microsoft Copilot, Grok, ...) or 'all'."},{"name":"mentioned","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"true: only cited pages that mention the brand; false: only pages that do not.","title":"Mentioned"},"description":"true: only cited pages that mention the brand; false: only pages that do not."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"topic_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"description":"Only prompts in any of these topics (UUIDs from GET /api/v1/topics). Repeat the param per id. Combined with tag_ids, a prompt matching either is kept.","title":"Topic Ids"},"description":"Only prompts in any of these topics (UUIDs from GET /api/v1/topics). Repeat the param per id. Combined with tag_ids, a prompt matching either is kept."},{"name":"tag_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"description":"Only prompts carrying any of these tags (UUIDs from GET /api/v1/tags). Repeat the param per id.","title":"Tag Ids"},"description":"Only prompts carrying any of these tags (UUIDs from GET /api/v1/tags). Repeat the param per id."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Citations Api V1 Citations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/citation-domains":{"get":{"tags":["Public API v1"],"summary":"V1 Citation Domains","description":"Cited domains sorted by citations desc, paginated: citations, prompts, share of all citations, and owner (own / competitor / third_party). `start_date`+`end_date` (YYYY-MM-DD, both required) override `days`; `topic_ids`/`tag_ids` narrow to those prompts.","operationId":"v1_citation_domains_api_v1_citation_domains_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Size"}},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}],"title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}],"title":"End Date"}},{"name":"topic_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Topic Ids"}},{"name":"tag_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Tag Ids"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Citation Domains Api V1 Citation Domains Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/brand-rankings":{"get":{"tags":["Public API v1"],"summary":"V1 Brand Rankings","operationId":"v1_brand_rankings_api_v1_brand_rankings_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"model","in":"query","required":false,"schema":{"type":"string","description":"Restrict to one AI channel by generic name (ChatGPT, Perplexity, Gemini, AI Overviews, AI Mode, Claude, Microsoft Copilot, Grok, ...) or 'all'.","default":"all","title":"Model"},"description":"Restrict to one AI channel by generic name (ChatGPT, Perplexity, Gemini, AI Overviews, AI Mode, Claude, Microsoft Copilot, Grok, ...) or 'all'."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"topic_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"description":"Only prompts in any of these topics (UUIDs from GET /api/v1/topics). Repeat the param per id. Combined with tag_ids, a prompt matching either is kept.","title":"Topic Ids"},"description":"Only prompts in any of these topics (UUIDs from GET /api/v1/topics). Repeat the param per id. Combined with tag_ids, a prompt matching either is kept."},{"name":"tag_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"description":"Only prompts carrying any of these tags (UUIDs from GET /api/v1/tags). Repeat the param per id.","title":"Tag Ids"},"description":"Only prompts carrying any of these tags (UUIDs from GET /api/v1/tags). Repeat the param per id."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Brand Rankings Api V1 Brand Rankings Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/competitor-time-series":{"get":{"tags":["Public API v1"],"summary":"V1 Competitor Time Series","description":"Daily visibility / share-of-voice / position per tracked competitor (plus the brand) — the trend version of brand-rankings.","operationId":"v1_competitor_time_series_api_v1_competitor_time_series_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"model","in":"query","required":false,"schema":{"type":"string","description":"Restrict to one AI channel by generic name (ChatGPT, Perplexity, Gemini, AI Overviews, AI Mode, Claude, Microsoft Copilot, Grok, ...) or 'all'.","default":"all","title":"Model"},"description":"Restrict to one AI channel by generic name (ChatGPT, Perplexity, Gemini, AI Overviews, AI Mode, Claude, Microsoft Copilot, Grok, ...) or 'all'."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"topic_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"description":"Only prompts in any of these topics (UUIDs from GET /api/v1/topics). Repeat the param per id. Combined with tag_ids, a prompt matching either is kept.","title":"Topic Ids"},"description":"Only prompts in any of these topics (UUIDs from GET /api/v1/topics). Repeat the param per id. Combined with tag_ids, a prompt matching either is kept."},{"name":"tag_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"description":"Only prompts carrying any of these tags (UUIDs from GET /api/v1/tags). Repeat the param per id.","title":"Tag Ids"},"description":"Only prompts carrying any of these tags (UUIDs from GET /api/v1/tags). Repeat the param per id."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Competitor Time Series Api V1 Competitor Time Series Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/competitor-discovery":{"get":{"tags":["Public API v1"],"summary":"V1 Competitor Discovery","description":"Competitors detected in AI answers to the domain's prompts that aren't tracked yet — ranked by how many prompts mention them.","operationId":"v1_competitor_discovery_api_v1_competitor_discovery_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Competitor Discovery Api V1 Competitor Discovery Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/prompt-statistics-time-series":{"get":{"tags":["Public API v1"],"summary":"V1 Prompt Statistics Time Series","operationId":"v1_prompt_statistics_time_series_api_v1_prompt_statistics_time_series_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size when `size` is not given.","default":25,"title":"Limit"},"description":"Page size when `size` is not given."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"size","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":500,"minimum":1},{"type":"null"}],"description":"Page size (max 500); overrides limit.","title":"Size"},"description":"Page size (max 500); overrides limit."},{"name":"sort","in":"query","required":false,"schema":{"enum":["mentions","visibility","position","responses"],"type":"string","description":"Window total each prompt is ranked by.","default":"mentions","title":"Sort"},"description":"Window total each prompt is ranked by."},{"name":"order","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"desc","title":"Order"}},{"name":"model","in":"query","required":false,"schema":{"type":"string","description":"Restrict to one AI channel by generic name (ChatGPT, Perplexity, Gemini, AI Overviews, AI Mode, Claude, Microsoft Copilot, Grok, ...) or 'all'.","default":"all","title":"Model"},"description":"Restrict to one AI channel by generic name (ChatGPT, Perplexity, Gemini, AI Overviews, AI Mode, Claude, Microsoft Copilot, Grok, ...) or 'all'."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"topic_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"description":"Only prompts in any of these topics (UUIDs from GET /api/v1/topics). Repeat the param per id. Combined with tag_ids, a prompt matching either is kept.","title":"Topic Ids"},"description":"Only prompts in any of these topics (UUIDs from GET /api/v1/topics). Repeat the param per id. Combined with tag_ids, a prompt matching either is kept."},{"name":"tag_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"description":"Only prompts carrying any of these tags (UUIDs from GET /api/v1/tags). Repeat the param per id.","title":"Tag Ids"},"description":"Only prompts carrying any of these tags (UUIDs from GET /api/v1/tags). Repeat the param per id."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Prompt Statistics Time Series Api V1 Prompt Statistics Time Series Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/model-leaderboard":{"get":{"tags":["Public API v1"],"summary":"V1 Model Leaderboard","operationId":"v1_model_leaderboard_api_v1_model_leaderboard_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Model Leaderboard Api V1 Model Leaderboard Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sentiment/overview":{"get":{"tags":["Public API v1"],"summary":"V1 Sentiment Overview","operationId":"v1_sentiment_overview_api_v1_sentiment_overview_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"model","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Model"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Sentiment Overview Api V1 Sentiment Overview Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sentiment/time-series":{"get":{"tags":["Public API v1"],"summary":"V1 Sentiment Time Series","operationId":"v1_sentiment_time_series_api_v1_sentiment_time_series_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"model","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Model"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Sentiment Time Series Api V1 Sentiment Time Series Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sentiment/themes":{"get":{"tags":["Public API v1"],"summary":"V1 Sentiment Themes","description":"Sentiment themes for the domain. With `granularity` (day|week) every theme is grouped into the period it was raised in; each theme carries `answers_count` (answers behind it) separately from `occurrences`.","operationId":"v1_sentiment_themes_api_v1_sentiment_themes_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"model","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Model"}},{"name":"granularity","in":"query","required":false,"schema":{"anyOf":[{"enum":["day","week"],"type":"string"},{"type":"null"}],"title":"Granularity"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Sentiment Themes Api V1 Sentiment Themes Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sentiment/theme-sources":{"get":{"tags":["Public API v1"],"summary":"V1 Sentiment Theme Sources","operationId":"v1_sentiment_theme_sources_api_v1_sentiment_theme_sources_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"model","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Model"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Sentiment Theme Sources Api V1 Sentiment Theme Sources Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ga4/summary":{"get":{"tags":["Public API v1"],"summary":"V1 Ga4 Summary","description":"Totals of AI-referred traffic (sessions, users, pageviews) plus the previous period for deltas.","operationId":"v1_ga4_summary_api_v1_ga4_summary_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"llm_source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Source"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Ga4 Summary Api V1 Ga4 Summary Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ga4/by-llm":{"get":{"tags":["Public API v1"],"summary":"V1 Ga4 By Llm","description":"AI-referred sessions/users/pageviews broken out per LLM source, plus the previous period.","operationId":"v1_ga4_by_llm_api_v1_ga4_by_llm_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"llm_source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Source"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Ga4 By Llm Api V1 Ga4 By Llm Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ga4/timeline":{"get":{"tags":["Public API v1"],"summary":"V1 Ga4 Timeline","description":"Daily AI-referred sessions over the window, each day split by LLM source.","operationId":"v1_ga4_timeline_api_v1_ga4_timeline_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"llm_source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Source"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Ga4 Timeline Api V1 Ga4 Timeline Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ga4/top-pages":{"get":{"tags":["Public API v1"],"summary":"V1 Ga4 Top Pages","description":"Pages ranked by AI-referred sessions (page_path + sessions, desc).","operationId":"v1_ga4_top_pages_api_v1_ga4_top_pages_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"llm_source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Source"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Ga4 Top Pages Api V1 Ga4 Top Pages Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ga4/top-locations":{"get":{"tags":["Public API v1"],"summary":"V1 Ga4 Top Locations","description":"AI-referred traffic by country/location (location + sessions, desc).","operationId":"v1_ga4_top_locations_api_v1_ga4_top_locations_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"llm_source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Source"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Ga4 Top Locations Api V1 Ga4 Top Locations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ga4/top-browsers":{"get":{"tags":["Public API v1"],"summary":"V1 Ga4 Top Browsers","description":"AI-referred traffic by browser (browser + sessions, top 10 desc).","operationId":"v1_ga4_top_browsers_api_v1_ga4_top_browsers_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"llm_source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Source"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Ga4 Top Browsers Api V1 Ga4 Top Browsers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ga4/devices":{"get":{"tags":["Public API v1"],"summary":"V1 Ga4 Devices","description":"AI-referred traffic by device category (mobile/desktop/tablet).","operationId":"v1_ga4_devices_api_v1_ga4_devices_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"llm_source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Source"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Ga4 Devices Api V1 Ga4 Devices Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ga4/key-events":{"get":{"tags":["Public API v1"],"summary":"V1 Ga4 Key Events","description":"GA4 key events / conversions attributed to AI-referred traffic — total, per-LLM, top events — plus the previous period's total.","operationId":"v1_ga4_key_events_api_v1_ga4_key_events_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"llm_source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Source"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Ga4 Key Events Api V1 Ga4 Key Events Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ga4/key-events-timeline":{"get":{"tags":["Public API v1"],"summary":"V1 Ga4 Key Events Timeline","operationId":"v1_ga4_key_events_timeline_api_v1_ga4_key_events_timeline_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"llm_source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Source"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Ga4 Key Events Timeline Api V1 Ga4 Key Events Timeline Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/competitors":{"get":{"tags":["Public API v1"],"summary":"V1 List Competitors","description":"Competitors tracked for the domain sorted by name, optionally filtered by dedicated/active. Send `page` to paginate (`size` per page, default 100); without it the full list is returned.","operationId":"v1_list_competitors_api_v1_competitors_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"is_dedicated","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Dedicated"}},{"name":"active","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Page"}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Size"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response V1 List Competitors Api V1 Competitors Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Public API v1"],"summary":"V1 Add Competitor","description":"Track a new competitor for the domain.","operationId":"v1_add_competitor_api_v1_competitors_post","parameters":[{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddCompetitor"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Add Competitor Api V1 Competitors Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ads/kpis":{"get":{"tags":["Public API v1"],"summary":"V1 Ads Kpis","description":"Headline ChatGPT-ads metrics for the domain: prompts with ads, brand appearances, unique advertisers, cards seen — with deltas vs the previous window.","operationId":"v1_ads_kpis_api_v1_ads_kpis_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Ads Kpis Api V1 Ads Kpis Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ads/leaderboard":{"get":{"tags":["Public API v1"],"summary":"V1 Ads Leaderboard","description":"Brands advertising on ChatGPT for the domain's prompts, ranked by prompt coverage.","operationId":"v1_ads_leaderboard_api_v1_ads_leaderboard_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Ads Leaderboard Api V1 Ads Leaderboard Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ads/timeline":{"get":{"tags":["Public API v1"],"summary":"V1 Ads Timeline","description":"Daily ChatGPT-ads activity for the domain over the window — the ads trend.","operationId":"v1_ads_timeline_api_v1_ads_timeline_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Ads Timeline Api V1 Ads Timeline Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ads/prompts":{"get":{"tags":["Public API v1"],"summary":"V1 Ads Prompts","description":"Tracked prompts that triggered ChatGPT ads, paginated.","operationId":"v1_ads_prompts_api_v1_ads_prompts_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Per Page"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Ads Prompts Api V1 Ads Prompts Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/ads/cards":{"get":{"tags":["Public API v1"],"summary":"V1 Ads Cards","description":"Individual ChatGPT ad cards (creatives/advertisers) seen for the domain's prompts, paginated.","operationId":"v1_ads_cards_api_v1_ads_cards_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Per Page"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days.","title":"Start Date"},"description":"Start of a fixed window, YYYY-MM-DD. Pass together with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days.","title":"End Date"},"description":"End of a fixed window (inclusive), YYYY-MM-DD. Pass together with start_date; overrides days."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Ads Cards Api V1 Ads Cards Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tags":{"get":{"tags":["Public API v1"],"summary":"V1 List Tags","description":"Tags defined for the domain — resolve names to ids before add_prompt.","operationId":"v1_list_tags_api_v1_tags_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 List Tags Api V1 Tags Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Public API v1"],"summary":"V1 Create Tag","description":"Create a tag in the domain. Requires the admin, co-admin or editor role on the team.","operationId":"v1_create_tag_api_v1_tags_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1CreateTag"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Create Tag Api V1 Tags Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/topics":{"get":{"tags":["Public API v1"],"summary":"V1 List Topics","description":"Topics defined for the domain — resolve names to ids before add_prompt.","operationId":"v1_list_topics_api_v1_topics_get","parameters":[{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 List Topics Api V1 Topics Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["Public API v1"],"summary":"V1 Create Topic","description":"Create a topic in the domain. Fails with 409 when a topic with that name exists.","operationId":"v1_create_topic_api_v1_topics_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1CreateTopic"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Create Topic Api V1 Topics Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/prompt-brands":{"get":{"tags":["Public API v1","Public API v1"],"summary":"V1 Prompt Brands","description":"Every tracked brand (the domain's own brand first, then each tracked competitor) for one prompt: mentions, visibility, share of voice and average position over the window.","operationId":"v1_prompt_brands_api_v1_prompt_brands_get","parameters":[{"name":"domain_id","in":"query","required":true,"schema":{"type":"string","title":"Domain Id"}},{"name":"prompt_id","in":"query","required":true,"schema":{"type":"string","title":"Prompt Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"First day of an explicit window, YYYY-MM-DD. Pass with end_date; overrides days.","title":"Start Date"},"description":"First day of an explicit window, YYYY-MM-DD. Pass with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Last day of an explicit window, YYYY-MM-DD. Pass with start_date.","title":"End Date"},"description":"Last day of an explicit window, YYYY-MM-DD. Pass with start_date."},{"name":"model","in":"query","required":false,"schema":{"type":"string","description":"One AI channel by generic name (ChatGPT, Gemini, ...) or 'all'.","default":"all","title":"Model"},"description":"One AI channel by generic name (ChatGPT, Gemini, ...) or 'all'."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Prompt Brands Api V1 Prompt Brands Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/competitor-citations":{"get":{"tags":["Public API v1","Public API v1"],"summary":"V1 Competitor Citations","description":"Citations per tracked domain (own brand and each tracked competitor): how many cited URLs point at it and its share of all citations in the window. topic_ids/tag_ids restrict to those prompts.","operationId":"v1_competitor_citations_api_v1_competitor_citations_get","parameters":[{"name":"domain_id","in":"query","required":true,"schema":{"type":"string","title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"First day of an explicit window, YYYY-MM-DD. Pass with end_date; overrides days.","title":"Start Date"},"description":"First day of an explicit window, YYYY-MM-DD. Pass with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Last day of an explicit window, YYYY-MM-DD. Pass with start_date.","title":"End Date"},"description":"Last day of an explicit window, YYYY-MM-DD. Pass with start_date."},{"name":"model","in":"query","required":false,"schema":{"type":"string","description":"One AI channel by generic name (ChatGPT, Gemini, ...) or 'all'.","default":"all","title":"Model"},"description":"One AI channel by generic name (ChatGPT, Gemini, ...) or 'all'."},{"name":"topic_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Topic Ids"}},{"name":"tag_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Tag Ids"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Competitor Citations Api V1 Competitor Citations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/citation-share":{"get":{"tags":["Public API v1","Public API v1"],"summary":"V1 Citation Share","description":"Citation share per brand within each topic (or tag): for every unit, the own brand and each tracked competitor with its citations and share of that unit's citations.","operationId":"v1_citation_share_api_v1_citation_share_get","parameters":[{"name":"domain_id","in":"query","required":true,"schema":{"type":"string","title":"Domain Id"}},{"name":"group_by","in":"query","required":false,"schema":{"enum":["topic","tag"],"type":"string","default":"topic","title":"Group By"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"First day of an explicit window, YYYY-MM-DD. Pass with end_date; overrides days.","title":"Start Date"},"description":"First day of an explicit window, YYYY-MM-DD. Pass with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Last day of an explicit window, YYYY-MM-DD. Pass with start_date.","title":"End Date"},"description":"Last day of an explicit window, YYYY-MM-DD. Pass with start_date."},{"name":"model","in":"query","required":false,"schema":{"type":"string","description":"One AI channel by generic name (ChatGPT, Gemini, ...) or 'all'.","default":"all","title":"Model"},"description":"One AI channel by generic name (ChatGPT, Gemini, ...) or 'all'."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Citation Share Api V1 Citation Share Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/prompt-metrics":{"get":{"tags":["Public API v1","Public API v1"],"summary":"V1 Prompt Metrics","description":"Every tracked prompt with its window metrics: visibility, mentions, citations, average position, answers collected (`responses`), topics and tags. Filter by topics, tags and model; sortable; paginated.","operationId":"v1_prompt_metrics_api_v1_prompt_metrics_get","parameters":[{"name":"domain_id","in":"query","required":true,"schema":{"type":"string","title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"First day of an explicit window, YYYY-MM-DD. Pass with end_date; overrides days.","title":"Start Date"},"description":"First day of an explicit window, YYYY-MM-DD. Pass with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Last day of an explicit window, YYYY-MM-DD. Pass with start_date.","title":"End Date"},"description":"Last day of an explicit window, YYYY-MM-DD. Pass with start_date."},{"name":"model","in":"query","required":false,"schema":{"type":"string","description":"One AI channel by generic name (ChatGPT, Gemini, ...) or 'all'.","default":"all","title":"Model"},"description":"One AI channel by generic name (ChatGPT, Gemini, ...) or 'all'."},{"name":"topic_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Topic Ids"}},{"name":"tag_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Tag Ids"}},{"name":"sort_by","in":"query","required":false,"schema":{"enum":["visibility","mentions","citations","avg_position","responses","estimated_search_volume"],"type":"string","default":"visibility","title":"Sort By"}},{"name":"sort_dir","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"desc","title":"Sort Dir"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Size"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Prompt Metrics Api V1 Prompt Metrics Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/topic-metrics":{"get":{"tags":["Public API v1","Public API v1"],"summary":"V1 Topic Metrics","description":"Scorecard per topic: prompts, answers, visibility, mentions, average position, citations (all and brand), sentiment and search volume.","operationId":"v1_topic_metrics_api_v1_topic_metrics_get","parameters":[{"name":"domain_id","in":"query","required":true,"schema":{"type":"string","title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"First day of an explicit window, YYYY-MM-DD. Pass with end_date; overrides days.","title":"Start Date"},"description":"First day of an explicit window, YYYY-MM-DD. Pass with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Last day of an explicit window, YYYY-MM-DD. Pass with start_date.","title":"End Date"},"description":"Last day of an explicit window, YYYY-MM-DD. Pass with start_date."},{"name":"model","in":"query","required":false,"schema":{"type":"string","description":"One AI channel by generic name (ChatGPT, Gemini, ...) or 'all'.","default":"all","title":"Model"},"description":"One AI channel by generic name (ChatGPT, Gemini, ...) or 'all'."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Topic Metrics Api V1 Topic Metrics Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/tag-metrics":{"get":{"tags":["Public API v1","Public API v1"],"summary":"V1 Tag Metrics","description":"Scorecard per tag, same fields as topic-metrics: prompts, answers, visibility, mentions, average position, citations, sentiment and search volume.","operationId":"v1_tag_metrics_api_v1_tag_metrics_get","parameters":[{"name":"domain_id","in":"query","required":true,"schema":{"type":"string","title":"Domain Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"First day of an explicit window, YYYY-MM-DD. Pass with end_date; overrides days.","title":"Start Date"},"description":"First day of an explicit window, YYYY-MM-DD. Pass with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Last day of an explicit window, YYYY-MM-DD. Pass with start_date.","title":"End Date"},"description":"Last day of an explicit window, YYYY-MM-DD. Pass with start_date."},{"name":"model","in":"query","required":false,"schema":{"type":"string","description":"One AI channel by generic name (ChatGPT, Gemini, ...) or 'all'.","default":"all","title":"Model"},"description":"One AI channel by generic name (ChatGPT, Gemini, ...) or 'all'."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Tag Metrics Api V1 Tag Metrics Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/sentiment/answers":{"get":{"tags":["Public API v1","Public API v1"],"summary":"V1 Sentiment Answers","description":"The AI answers behind one sentiment theme, paginated: channel, prompt, date, the quoted answer text and the source URLs it cites.","operationId":"v1_sentiment_answers_api_v1_sentiment_answers_get","parameters":[{"name":"domain_id","in":"query","required":true,"schema":{"type":"string","title":"Domain Id"}},{"name":"theme_id","in":"query","required":true,"schema":{"type":"string","title":"Theme Id"}},{"name":"model","in":"query","required":false,"schema":{"type":"string","description":"One AI channel by generic name (ChatGPT, Gemini, ...) or 'all'.","default":"all","title":"Model"},"description":"One AI channel by generic name (ChatGPT, Gemini, ...) or 'all'."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Size"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Sentiment Answers Api V1 Sentiment Answers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/engage-recommendations":{"get":{"tags":["Public API v1","Public API v1"],"summary":"V1 Engage Recommendations","description":"Threads and posts (Reddit, X, LinkedIn, ...) worth engaging in, the ones AI answers lean on for the domain's prompts. Filter by platform, status, topics, prompts and minimum engagement; paginated. Each row carries `is_brand_named`: true/false when the page was cited in the domain's AI answers and checked for the brand, null when there is no citation analysis for it.","operationId":"v1_engage_recommendations_api_v1_engage_recommendations_get","parameters":[{"name":"domain_id","in":"query","required":true,"schema":{"type":"string","title":"Domain Id"}},{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"topic_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Topic Ids"}},{"name":"prompt_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Prompt Ids"}},{"name":"min_engagement","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Min Engagement"}},{"name":"min_comments","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"title":"Min Comments"}},{"name":"sort_by","in":"query","required":false,"schema":{"enum":["frequency","engagement","comments"],"type":"string","default":"frequency","title":"Sort By"}},{"name":"sort_dir","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","default":"desc","title":"Sort Dir"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Size"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Engage Recommendations Api V1 Engage Recommendations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/answers":{"get":{"tags":["Public API v1","Public API v1"],"summary":"V1 Answers","description":"One row per collected AI answer to a prompt, newest first: date, model, answer text, whether and where the own brand was named, the tracked competitors named with their positions, and the cited URLs. Paginated.","operationId":"v1_answers_api_v1_answers_get","parameters":[{"name":"domain_id","in":"query","required":true,"schema":{"type":"string","title":"Domain Id"}},{"name":"prompt_id","in":"query","required":true,"schema":{"type":"string","title":"Prompt Id"}},{"name":"model","in":"query","required":false,"schema":{"type":"string","description":"One AI channel by generic name (ChatGPT, Gemini, ...) or 'all'.","default":"all","title":"Model"},"description":"One AI channel by generic name (ChatGPT, Gemini, ...) or 'all'."},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets.","default":30,"title":"Days"},"description":"Trailing look-back window in days, counted back from today. Honoured exactly: days=95 returns the last 95 days. Values are not snapped to buckets."},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"First day of an explicit window, YYYY-MM-DD. Pass with end_date; overrides days.","title":"Start Date"},"description":"First day of an explicit window, YYYY-MM-DD. Pass with end_date; overrides days."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Last day of an explicit window, YYYY-MM-DD. Pass with start_date.","title":"End Date"},"description":"Last day of an explicit window, YYYY-MM-DD. Pass with start_date."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Size"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints.","default":false,"title":"Fresh"},"description":"Skip the cached result (cached up to 1 hour) and recompute it now. The recomputed result replaces the cached one. Ignored by write endpoints."},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Answers Api V1 Answers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/competitors/update":{"post":{"tags":["Public API v1"],"summary":"V1 Update Competitor","description":"Update a tracked competitor: rename it, replace its name variations, or change its\nactive / dedicated state. Turning a competitor into an active dedicated one checks the\nbrand's dedicated-competitor limit.","operationId":"v1_update_competitor_api_v1_competitors_update_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1UpdateCompetitor"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Update Competitor Api V1 Competitors Update Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/competitors/delete":{"post":{"tags":["Public API v1"],"summary":"V1 Delete Competitor","description":"Permanently delete a competitor and its recorded mentions from the domain.","operationId":"v1_delete_competitor_api_v1_competitors_delete_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DeleteCompetitor"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Delete Competitor Api V1 Competitors Delete Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/prompts/bulk":{"post":{"tags":["Public API v1"],"summary":"V1 Add Prompts","description":"Add up to 100 prompts at once, each with optional topic and tag names.\n\nUnknown topic names are created; unknown tag names are skipped (prompts with no known tag\nget the domain's default tags). Prompts that duplicate an active prompt, or each other, are\nskipped and listed under `duplicates`; each added prompt consumes one prompt credit.","operationId":"v1_add_prompts_api_v1_prompts_bulk_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1AddPrompts"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Add Prompts Api V1 Prompts Bulk Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/prompts/archive":{"post":{"tags":["Public API v1"],"summary":"V1 Archive Prompts","description":"Archive active prompts so they stop being analyzed. Each archived prompt refunds one\nprompt credit; history is kept.","operationId":"v1_archive_prompts_api_v1_prompts_archive_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1ArchivePrompts"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Archive Prompts Api V1 Prompts Archive Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/prompts/tags":{"post":{"tags":["Public API v1"],"summary":"V1 Set Prompt Tags","description":"Add and/or remove tags on active prompts. Tag ids that do not belong to the domain are\nignored; the applied ids are returned.","operationId":"v1_set_prompt_tags_api_v1_prompts_tags_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SetPromptTags"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Set Prompt Tags Api V1 Prompts Tags Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/prompts/topics":{"post":{"tags":["Public API v1"],"summary":"V1 Set Prompt Topics","description":"Replace an active prompt's topics with `topic_ids` (an empty list clears them).","operationId":"v1_set_prompt_topics_api_v1_prompts_topics_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1SetPromptTopics"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Set Prompt Topics Api V1 Prompts Topics Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/prompts/update":{"post":{"tags":["Public API v1"],"summary":"V1 Update Prompt","description":"Edit an active prompt's text, optionally replacing its topics and adding/removing tags.\n\nThe prompt keeps its id, so answers collected before the edit stay attached to it but were\nasked with the old wording. Rejects text that duplicates another active prompt (409).","operationId":"v1_update_prompt_api_v1_prompts_update_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1UpdatePrompt"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Update Prompt Api V1 Prompts Update Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/domains/delete":{"post":{"tags":["Public API v1"],"summary":"V1 Delete Domain","description":"Permanently delete a domain (brand) and all of its prompts, competitors and analysis\nhistory. Irreversible. `confirmation_name` must equal the domain's name exactly. Only the\nteam manager or a co-admin can delete; the domain's prompt credits are refunded to the team.","operationId":"v1_delete_domain_api_v1_domains_delete_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DeleteDomain"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Delete Domain Api V1 Domains Delete Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/team-usage":{"get":{"tags":["Public API v1"],"summary":"V1 Team Usage","description":"The team's plan, limits and what is used: prompt credits, domains, models and included\nfeatures. Pass `domain_id` to add that brand's prompt count and competitor slots.","operationId":"v1_team_usage_api_v1_team_usage_get","parameters":[{"name":"team_id","in":"query","required":true,"schema":{"type":"string","title":"Team Id"}},{"name":"domain_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Team Usage Api V1 Team Usage Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/domain-status":{"get":{"tags":["Public API v1"],"summary":"V1 Domain Status","description":"Analysis progress for a domain: whether an analysis is running or complete, response counts, and `is_discovery_ready` (competitor discovery has data to pick from).","operationId":"v1_domain_status_api_v1_domain_status_get","parameters":[{"name":"domain_id","in":"query","required":true,"schema":{"type":"string","title":"Domain Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Domain Status Api V1 Domain Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/teams":{"post":{"tags":["Public API v1"],"summary":"V1 Create Team","description":"Create a new team managed by the caller. Requires a master key or an all-teams connection.","operationId":"v1_create_team_api_v1_teams_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeamCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Create Team Api V1 Teams Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/team-invites":{"post":{"tags":["Public API v1"],"summary":"V1 Send Team Invite","description":"Invite a user to a team by email, optionally limited to `allowed_domains`. Team manager or co-admin only.","operationId":"v1_send_team_invite_api_v1_team_invites_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendTeamInvite"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Send Team Invite Api V1 Team Invites Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/competitors/bulk":{"post":{"tags":["Public API v1"],"summary":"V1 Add Competitors Bulk","description":"Track up to 50 competitors in one call, from an explicit list or the top N discovery candidates; existing rows are promoted instead of duplicated.","operationId":"v1_add_competitors_bulk_api_v1_competitors_bulk_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkAddCompetitors"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Add Competitors Bulk Api V1 Competitors Bulk Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/team-plan":{"post":{"tags":["Public API v1 admin"],"summary":"V1 Admin Set Team Plan","description":"Set a team's subscription tier, expiry and credits. Platform super-admins with an all-teams key only.","operationId":"v1_admin_set_team_plan_api_v1_admin_team_plan_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePlanRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Admin Set Team Plan Api V1 Admin Team Plan Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/delete-team":{"post":{"tags":["Public API v1 admin"],"summary":"V1 Admin Delete Team","description":"Permanently delete a team; `confirmation_name` must equal the team's exact name. Platform super-admins with an all-teams key only.","operationId":"v1_admin_delete_team_api_v1_admin_delete_team_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteTeamRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response V1 Admin Delete Team Api V1 Admin Delete Team Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-outreach-campaigns":{"post":{"tags":["Outreach"],"summary":"Get Outreach Campaigns","description":"The domain's campaign(s) — the tab uses this to show 'Start a campaign' vs the campaign.","operationId":"get_outreach_campaigns_get_outreach_campaigns_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetOutreachCampaignsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-outreach-campaign":{"post":{"tags":["Outreach"],"summary":"Get Outreach Campaign","description":"Campaign-info header + ledger, shaped for the UI. Links are fetched separately\n(paginated) via /get-outreach-campaign-links so this payload stays bounded.","operationId":"get_outreach_campaign_get_outreach_campaign_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetOutreachCampaignRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-outreach-campaign-links":{"post":{"tags":["Outreach"],"summary":"Get Outreach Campaign Links","description":"One page of the campaign's links (shaped rows + pagination envelope), with an\noptional outreach_status filter and ILIKE search.","operationId":"get_outreach_campaign_links_get_outreach_campaign_links_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetOutreachCampaignLinksRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/get-outreach-transactions":{"post":{"tags":["Outreach"],"summary":"Get Outreach Transactions","description":"The campaign's ledger (customer-owned).","operationId":"get_outreach_transactions_get_outreach_transactions_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetOutreachTransactionsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-campaign-list":{"post":{"tags":["Outreach"],"summary":"Admin Outreach Campaign List","description":"Paginated global campaign list across all domains (admin console), newest first,\noptional status / domain_id filters. Returns items + pagination envelope.","operationId":"admin_outreach_campaign_list_admin_outreach_campaign_list_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOutreachCampaignListRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-campaign-get":{"post":{"tags":["Outreach"],"summary":"Admin Outreach Campaign Get","operationId":"admin_outreach_campaign_get_admin_outreach_campaign_get_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminCampaignIdRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-item-list":{"post":{"tags":["Outreach"],"summary":"Admin Outreach Item List","description":"Paginated raw item rows for one campaign (admin links table), with optional\nstatus filter + ILIKE search. Returns the standard items + pagination envelope.","operationId":"admin_outreach_item_list_admin_outreach_item_list_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOutreachItemListRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-transaction-list":{"post":{"tags":["Outreach"],"summary":"Admin Outreach Transaction List","operationId":"admin_outreach_transaction_list_admin_outreach_transaction_list_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminCampaignIdRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/create-outreach-campaign":{"post":{"tags":["Outreach"],"summary":"Create Outreach Campaign","description":"Customer 'Start a campaign': create a planned campaign (auto-named, balance 0)\nand auto-pull the domain's pending mentioned links into it.","operationId":"create_outreach_campaign_create_outreach_campaign_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOutreachCampaignRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/resolve-outreach-item":{"post":{"tags":["Outreach"],"summary":"Resolve Outreach Item","description":"Customer approve/decline of an action_needed link.","operationId":"resolve_outreach_item_resolve_outreach_item_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveOutreachItemRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-campaign-create":{"post":{"tags":["Outreach"],"summary":"Admin Outreach Campaign Create","operationId":"admin_outreach_campaign_create_admin_outreach_campaign_create_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOutreachCampaignCreateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-campaign-update":{"post":{"tags":["Outreach"],"summary":"Admin Outreach Campaign Update","operationId":"admin_outreach_campaign_update_admin_outreach_campaign_update_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOutreachCampaignUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-item-add":{"post":{"tags":["Outreach"],"summary":"Admin Outreach Item Add","operationId":"admin_outreach_item_add_admin_outreach_item_add_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOutreachItemAddRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-item-set-estimate":{"post":{"tags":["Outreach"],"summary":"Admin Outreach Item Set Estimate","operationId":"admin_outreach_item_set_estimate_admin_outreach_item_set_estimate_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOutreachItemSetEstimateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-item-update-status":{"post":{"tags":["Outreach"],"summary":"Admin Outreach Item Update Status","operationId":"admin_outreach_item_update_status_admin_outreach_item_update_status_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOutreachItemUpdateStatusRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-item-bulk-update-status":{"post":{"tags":["Outreach"],"summary":"Admin Outreach Item Bulk Update Status","description":"Atomically move many links to one target status (multi-select). Rejects the\nwhole batch (400) if any selected item can't legally make the move.","operationId":"admin_outreach_item_bulk_update_status_admin_outreach_item_bulk_update_status_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOutreachItemBulkUpdateStatusRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-item-bulk-update-status-by-filter":{"post":{"tags":["Outreach"],"summary":"Admin Outreach Item Bulk Update Status By Filter","description":"Admin \"select all\": move every link of a campaign currently in ``from_status``\nto ``outreach_status`` in one conditional UPDATE (honoring search + exclusions),\nwithout shipping the id list. Returns the count of rows actually changed.","operationId":"admin_outreach_item_bulk_update_status_by_filter_admin_outreach_item_bulk_update_status_by_filter_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOutreachItemBulkUpdateStatusByFilterRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-update-add":{"post":{"tags":["Outreach"],"summary":"Admin Outreach Update Add","operationId":"admin_outreach_update_add_admin_outreach_update_add_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOutreachUpdateAddRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-update-edit":{"post":{"tags":["Outreach"],"summary":"Admin Outreach Update Edit","operationId":"admin_outreach_update_edit_admin_outreach_update_edit_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOutreachUpdateEditRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-update-delete":{"post":{"tags":["Outreach"],"summary":"Admin Outreach Update Delete","operationId":"admin_outreach_update_delete_admin_outreach_update_delete_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOutreachUpdateDeleteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-item-complete":{"post":{"tags":["Outreach"],"summary":"Admin Outreach Item Complete","description":"Finish a link at its final cost — atomic: item completed + settled spend +\nbalance refresh, overdraft-guarded.","operationId":"admin_outreach_item_complete_admin_outreach_item_complete_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOutreachItemCompleteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-topup":{"post":{"tags":["Outreach"],"summary":"Admin Outreach Topup","operationId":"admin_outreach_topup_admin_outreach_topup_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOutreachTopupRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-transaction-reverse":{"post":{"tags":["Outreach"],"summary":"Admin Outreach Transaction Reverse","operationId":"admin_outreach_transaction_reverse_admin_outreach_transaction_reverse_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOutreachReverseRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/outreach/payment-webhook":{"post":{"tags":["Outreach"],"summary":"Outreach Payment Webhook","description":"Public Stripe webhook (NO AuthDep). Verify signature, reconcile, ack fast.\n\nReconciliation reads each object's CURRENT status from Stripe, so duplicate /\nout-of-order deliveries converge; the DB write is idempotent. Returns 2xx only\nafter the (cheap) side effect — a non-2xx makes Stripe retry.","operationId":"outreach_payment_webhook_outreach_payment_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/outreach/topup-intent":{"post":{"tags":["Outreach"],"summary":"Outreach Topup Intent","description":"Customer 'Add funds' via raw PaymentIntent (for an Elements-style UI).\nThe settled ledger row is written by the webhook once the payment succeeds.","operationId":"outreach_topup_intent_outreach_topup_intent_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachTopupIntentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/outreach/create-topup-checkout-session":{"post":{"tags":["Outreach"],"summary":"Outreach Create Topup Checkout Session","description":"Customer 'Launch & Authorize' / 'Add funds' via Stripe Checkout (hosted page).\nReuses the team's Stripe customer so saved cards appear preselected. The\nunderlying PaymentIntent carries metadata.campaign_id, so the existing\npayment-webhook reconcile writes the settled ledger row unchanged.","operationId":"outreach_create_topup_checkout_session_outreach_create_topup_checkout_session_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachTopupCheckoutRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/outreach-refund":{"post":{"tags":["Outreach"],"summary":"Admin Outreach Refund","description":"Record an admin refund (no Stripe): one atomic, idempotent settled ``refund``\nledger row keyed by the admin-supplied external reference, refreshing the balance.","operationId":"admin_outreach_refund_admin_outreach_refund_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminOutreachRefundRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/.well-known/oauth-authorization-server":{"get":{"tags":["OAuth"],"summary":"Authorization Server Metadata","operationId":"authorization_server_metadata__well_known_oauth_authorization_server_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/oauth/register":{"post":{"tags":["OAuth"],"summary":"Register Client","operationId":"register_client_oauth_register_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/oauth/authorize":{"get":{"tags":["OAuth"],"summary":"Authorize","operationId":"authorize_oauth_authorize_get","parameters":[{"name":"client_id","in":"query","required":true,"schema":{"type":"string","title":"Client Id"}},{"name":"redirect_uri","in":"query","required":true,"schema":{"type":"string","title":"Redirect Uri"}},{"name":"response_type","in":"query","required":false,"schema":{"type":"string","default":"code","title":"Response Type"}},{"name":"code_challenge","in":"query","required":true,"schema":{"type":"string","title":"Code Challenge"}},{"name":"code_challenge_method","in":"query","required":false,"schema":{"type":"string","default":"S256","title":"Code Challenge Method"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","title":"State"}},{"name":"scope","in":"query","required":false,"schema":{"type":"string","default":"mcp","title":"Scope"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/oauth/deny":{"post":{"tags":["OAuth"],"summary":"Deny","operationId":"deny_oauth_deny_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/oauth/approve":{"post":{"tags":["OAuth"],"summary":"Approve","operationId":"approve_oauth_approve_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/oauth/token":{"post":{"tags":["OAuth"],"summary":"Token","operationId":"token_oauth_token_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_token_oauth_token_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/":{"get":{"summary":"Read Root","operationId":"read_root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/cron/status":{"get":{"summary":"Get Cron Status","description":"Get the status of all scheduled cron jobs.","operationId":"get_cron_status_cron_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"ActivateDiscoveryPromptsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"prompts":{"items":{"$ref":"#/components/schemas/DiscoveryPromptItem"},"type":"array","title":"Prompts"},"skip_credit_check":{"type":"boolean","title":"Skip Credit Check","default":false}},"type":"object","required":["domain_id","prompts"],"title":"ActivateDiscoveryPromptsRequest"},"AddCompetitor":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"competitor_domain":{"type":"string","title":"Competitor Domain"},"competitor_name":{"type":"string","title":"Competitor Name"},"is_dedicated":{"type":"boolean","title":"Is Dedicated","default":false},"active":{"type":"boolean","title":"Active","default":true},"competitor_variations":{"items":{"type":"string"},"type":"array","title":"Competitor Variations","default":[]}},"type":"object","required":["domain_id","competitor_domain","competitor_name"],"title":"AddCompetitor"},"AddDomainMemberRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"email":{"type":"string","title":"Email"},"role":{"type":"string","title":"Role","default":"editor"}},"type":"object","required":["domain_id","email"],"title":"AddDomainMemberRequest"},"AddTeamMemberRequest":{"properties":{"team_id":{"type":"string","title":"Team Id"},"email":{"type":"string","title":"Email"},"role":{"type":"string","title":"Role","default":"editor"}},"type":"object","required":["team_id","email"],"title":"AddTeamMemberRequest"},"AddonCatalog":{"properties":{"team_id":{"type":"string","title":"Team Id"}},"type":"object","required":["team_id"],"title":"AddonCatalog"},"AdminCampaignIdRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"}},"type":"object","required":["campaign_id"],"title":"AdminCampaignIdRequest"},"AdminOutreachCampaignCreateRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"planned_budget_cents":{"type":"integer","title":"Planned Budget Cents","default":0},"planned_cap_link_budget_cents":{"type":"integer","title":"Planned Cap Link Budget Cents","default":0}},"type":"object","required":["domain_id"],"title":"AdminOutreachCampaignCreateRequest"},"AdminOutreachCampaignListRequest":{"properties":{"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"domain_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"},"page":{"type":"integer","title":"Page","default":1},"per_page":{"type":"integer","title":"Per Page","default":50}},"type":"object","title":"AdminOutreachCampaignListRequest"},"AdminOutreachCampaignUpdateRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"campaign_status":{"type":"string","title":"Campaign Status"}},"type":"object","required":["campaign_id","campaign_status"],"title":"AdminOutreachCampaignUpdateRequest"},"AdminOutreachItemAddRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"recommendation_item_ids":{"items":{"type":"string"},"type":"array","title":"Recommendation Item Ids"}},"type":"object","required":["campaign_id","recommendation_item_ids"],"title":"AdminOutreachItemAddRequest"},"AdminOutreachItemBulkUpdateStatusByFilterRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"from_status":{"type":"string","title":"From Status"},"outreach_status":{"type":"string","title":"Outreach Status"},"search":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"},"excluded_ids":{"items":{"type":"string"},"type":"array","title":"Excluded Ids","default":[]}},"type":"object","required":["campaign_id","from_status","outreach_status"],"title":"AdminOutreachItemBulkUpdateStatusByFilterRequest","description":"Admin \"select all\" move: every link of one campaign currently in\n``from_status`` is moved to ``outreach_status``, honoring the same optional\nsearch filter as the links list and an optional exclusion list (rows the admin\nunchecked). No item_ids are shipped — the backend resolves the set by filter."},"AdminOutreachItemBulkUpdateStatusRequest":{"properties":{"item_ids":{"items":{"type":"string"},"type":"array","title":"Item Ids"},"outreach_status":{"type":"string","title":"Outreach Status"}},"type":"object","required":["item_ids","outreach_status"],"title":"AdminOutreachItemBulkUpdateStatusRequest"},"AdminOutreachItemCompleteRequest":{"properties":{"item_id":{"type":"string","title":"Item Id"},"final_link_cost_cents":{"type":"integer","exclusiveMinimum":0.0,"title":"Final Link Cost Cents"}},"type":"object","required":["item_id","final_link_cost_cents"],"title":"AdminOutreachItemCompleteRequest"},"AdminOutreachItemListRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"page":{"type":"integer","title":"Page","default":1},"per_page":{"type":"integer","title":"Per Page","default":50},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"search":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},"type":"object","required":["campaign_id"],"title":"AdminOutreachItemListRequest","description":"Admin paginated item (link) list for one campaign, with optional status filter\nand ILIKE search. Same repository as the customer links table."},"AdminOutreachItemSetEstimateRequest":{"properties":{"item_id":{"type":"string","title":"Item Id"},"estimated_link_cost_cents":{"type":"integer","title":"Estimated Link Cost Cents"}},"type":"object","required":["item_id","estimated_link_cost_cents"],"title":"AdminOutreachItemSetEstimateRequest"},"AdminOutreachItemUpdateStatusRequest":{"properties":{"item_id":{"type":"string","title":"Item Id"},"outreach_status":{"type":"string","title":"Outreach Status"}},"type":"object","required":["item_id","outreach_status"],"title":"AdminOutreachItemUpdateStatusRequest"},"AdminOutreachRefundRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"amount_cents":{"type":"integer","title":"Amount Cents"},"external_refund_id":{"type":"string","title":"External Refund Id"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["campaign_id","amount_cents","external_refund_id"],"title":"AdminOutreachRefundRequest"},"AdminOutreachReverseRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"txn_type":{"type":"string","enum":["reversal","refund","adjustment"],"title":"Txn Type"},"amount_cents":{"type":"integer","title":"Amount Cents"},"status":{"type":"string","title":"Status","default":"settled"},"item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Id"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency Key"}},"type":"object","required":["campaign_id","txn_type","amount_cents"],"title":"AdminOutreachReverseRequest"},"AdminOutreachSetServiceProviderRequest":{"properties":{"user_id":{"type":"string","title":"User Id"},"grant":{"type":"boolean","title":"Grant"}},"type":"object","required":["user_id","grant"],"title":"AdminOutreachSetServiceProviderRequest"},"AdminOutreachTopupRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"amount_cents":{"type":"integer","exclusiveMinimum":0.0,"title":"Amount Cents"},"status":{"type":"string","title":"Status","default":"settled"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency Key"}},"type":"object","required":["campaign_id","amount_cents"],"title":"AdminOutreachTopupRequest"},"AdminOutreachUpdateAddRequest":{"properties":{"target":{"type":"string","enum":["campaign","item"],"title":"Target"},"row_id":{"type":"string","title":"Row Id"},"text":{"type":"string","title":"Text"},"kind":{"type":"string","title":"Kind","default":"note"}},"type":"object","required":["target","row_id","text"],"title":"AdminOutreachUpdateAddRequest"},"AdminOutreachUpdateDeleteRequest":{"properties":{"target":{"type":"string","enum":["campaign","item"],"title":"Target"},"row_id":{"type":"string","title":"Row Id"},"update_id":{"type":"string","title":"Update Id"}},"type":"object","required":["target","row_id","update_id"],"title":"AdminOutreachUpdateDeleteRequest"},"AdminOutreachUpdateEditRequest":{"properties":{"target":{"type":"string","enum":["campaign","item"],"title":"Target"},"row_id":{"type":"string","title":"Row Id"},"update_id":{"type":"string","title":"Update Id"},"text":{"type":"string","title":"Text"}},"type":"object","required":["target","row_id","update_id","text"],"title":"AdminOutreachUpdateEditRequest"},"AdsCardsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"date_range_days":{"type":"integer","title":"Date Range Days","default":30},"topic_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":500},{"type":"null"}],"title":"Topic Ids"},"brand_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":500},{"type":"null"}],"title":"Brand Ids"},"query_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":500},{"type":"null"}],"title":"Query Ids"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"page":{"type":"integer","title":"Page","default":1},"per_page":{"type":"integer","title":"Per Page","default":50}},"type":"object","required":["domain_id"],"title":"AdsCardsRequest"},"AdsKpisRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"date_range_days":{"type":"integer","title":"Date Range Days","default":30},"topic_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":500},{"type":"null"}],"title":"Topic Ids"},"brand_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":500},{"type":"null"}],"title":"Brand Ids"},"query_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":500},{"type":"null"}],"title":"Query Ids"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},"type":"object","required":["domain_id"],"title":"AdsKpisRequest"},"AdsLeaderboardRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"date_range_days":{"type":"integer","title":"Date Range Days","default":30},"topic_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":500},{"type":"null"}],"title":"Topic Ids"},"brand_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":500},{"type":"null"}],"title":"Brand Ids"},"query_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":500},{"type":"null"}],"title":"Query Ids"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},"type":"object","required":["domain_id"],"title":"AdsLeaderboardRequest"},"AdsPromptsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"date_range_days":{"type":"integer","title":"Date Range Days","default":30},"topic_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":500},{"type":"null"}],"title":"Topic Ids"},"brand_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":500},{"type":"null"}],"title":"Brand Ids"},"query_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":500},{"type":"null"}],"title":"Query Ids"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"page":{"type":"integer","title":"Page","default":1},"per_page":{"type":"integer","title":"Per Page","default":50}},"type":"object","required":["domain_id"],"title":"AdsPromptsRequest"},"AdsTimelineRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"date_range_days":{"type":"integer","title":"Date Range Days","default":30},"topic_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":500},{"type":"null"}],"title":"Topic Ids"},"brand_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":500},{"type":"null"}],"title":"Brand Ids"},"query_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":500},{"type":"null"}],"title":"Query Ids"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},"type":"object","required":["domain_id"],"title":"AdsTimelineRequest"},"AiReadinessCheckRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"AiReadinessCheckRequest"},"AnalyzeRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"keyword":{"type":"string","title":"Keyword"},"topic":{"type":"string","title":"Topic"},"keywords":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Keywords"}},"type":"object","required":["domain_id","keyword","topic"],"title":"AnalyzeRequest"},"ApplyRetentionOffer":{"properties":{"team_id":{"type":"string","title":"Team Id"}},"type":"object","required":["team_id"],"title":"ApplyRetentionOffer"},"ArchiveQuery":{"properties":{"query_id":{"type":"string","title":"Query Id"}},"type":"object","required":["query_id"],"title":"ArchiveQuery"},"ArchiveTopicedQuery":{"properties":{"query_id":{"type":"string","title":"Query Id"},"topic_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic Id"}},"type":"object","required":["query_id"],"title":"ArchiveTopicedQuery"},"AssignFolderRequest":{"properties":{"research_result_id":{"type":"string","title":"Research Result Id"},"folder_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Folder Id"}},"type":"object","required":["research_result_id"],"title":"AssignFolderRequest"},"AssistantContext":{"properties":{"domain_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"},"page":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Page"},"days":{"anyOf":[{"type":"integer","maximum":365.0,"minimum":1.0},{"type":"null"}],"title":"Days"},"model":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Model"},"start_date":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},{"type":"null"}],"title":"End Date"},"prompt_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":500},{"type":"null"}],"title":"Prompt Ids"},"is_plan_mode":{"type":"boolean","title":"Is Plan Mode","default":false},"skill":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Skill"},"is_skill_opener":{"type":"boolean","title":"Is Skill Opener","default":false}},"type":"object","title":"AssistantContext"},"BaseCitationsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"days":{"type":"integer","title":"Days","default":7}},"type":"object","required":["domain_id"],"title":"BaseCitationsRequest"},"BaseCitationsRequestV3":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"days":{"type":"integer","title":"Days","default":7},"rollup_hosts":{"type":"boolean","title":"Rollup Hosts","default":false},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"query_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Query Ids"},"urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Urls"},"include_timeseries_topics":{"type":"boolean","title":"Include Timeseries Topics","default":false},"include_timeseries_prompts":{"type":"boolean","title":"Include Timeseries Prompts","default":false},"include_partial":{"type":"boolean","title":"Include Partial","default":false}},"type":"object","required":["domain_id"],"title":"BaseCitationsRequestV3","description":"Request model for all V3 citation endpoints.\n\nFilter semantics:\n- If start_date AND end_date are provided, use the inclusive custom window.\n- Otherwise, use rolling `days` ending today.\n- query_ids: optional list of query (prompt) ids to filter citations by.\n  Frontend resolves selected prompts + selected topics → union of query ids\n  before sending. Empty / None disables the filter."},"BlogStatusRequest":{"properties":{"job_id":{"type":"string","title":"Job Id"}},"type":"object","required":["job_id"],"title":"BlogStatusRequest"},"Body_remove_logo_remove_logo_post":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"Body_remove_logo_remove_logo_post"},"Body_remove_team_logo_remove_team_logo_post":{"properties":{"team_id":{"type":"string","title":"Team Id"}},"type":"object","required":["team_id"],"title":"Body_remove_team_logo_remove_team_logo_post"},"Body_token_oauth_token_post":{"properties":{"grant_type":{"type":"string","title":"Grant Type"},"code":{"type":"string","title":"Code"},"redirect_uri":{"type":"string","title":"Redirect Uri"},"code_verifier":{"type":"string","title":"Code Verifier"},"client_id":{"type":"string","title":"Client Id"}},"type":"object","required":["grant_type","code","redirect_uri","code_verifier"],"title":"Body_token_oauth_token_post"},"Body_upload_logo_upload_logo_post":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"logo":{"type":"string","contentMediaType":"application/octet-stream","title":"Logo"}},"type":"object","required":["domain_id","logo"],"title":"Body_upload_logo_upload_logo_post"},"Body_upload_team_logo_upload_team_logo_post":{"properties":{"team_id":{"type":"string","title":"Team Id"},"logo":{"type":"string","contentMediaType":"application/octet-stream","title":"Logo"}},"type":"object","required":["team_id","logo"],"title":"Body_upload_team_logo_upload_team_logo_post"},"BulkAddCompetitors":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"competitors":{"items":{"$ref":"#/components/schemas/BulkCompetitorEntry"},"type":"array","maxItems":50,"title":"Competitors"},"from_discovery":{"anyOf":[{"type":"integer","maximum":50.0,"minimum":1.0},{"type":"null"}],"title":"From Discovery"}},"type":"object","required":["domain_id"],"title":"BulkAddCompetitors"},"BulkAddQueriesRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"queries":{"items":{"$ref":"#/components/schemas/BulkQueryItem"},"type":"array","title":"Queries"},"new_tags":{"items":{"$ref":"#/components/schemas/NewTagSpec"},"type":"array","title":"New Tags","default":[]}},"type":"object","required":["domain_id","queries"],"title":"BulkAddQueriesRequest"},"BulkAddQueriesResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"queries":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Queries"},"errors":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Errors","default":[]}},"type":"object","required":["queries"],"title":"BulkAddQueriesResponse"},"BulkArchiveQueriesWithTopicInfo":{"properties":{"query_ids":{"items":{"type":"string"},"type":"array","maxItems":5000,"title":"Query Ids","default":[]},"delete_type":{"type":"string","title":"Delete Type","default":"archive"},"topic_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic Id"},"domain_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"},"scope_topic_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":5000},{"type":"null"}],"title":"Scope Topic Ids"},"prompt_filter":{"anyOf":[{"$ref":"#/components/schemas/PromptFilter"},{"type":"null"}]}},"type":"object","title":"BulkArchiveQueriesWithTopicInfo"},"BulkArchiveTopicedQueries":{"properties":{"query_topic_pairs":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Query Topic Pairs"},"archive_topics":{"type":"boolean","title":"Archive Topics","default":false}},"type":"object","required":["query_topic_pairs"],"title":"BulkArchiveTopicedQueries"},"BulkCompetitorEntry":{"properties":{"competitor_domain":{"type":"string","title":"Competitor Domain"},"competitor_name":{"type":"string","title":"Competitor Name"},"competitor_variations":{"items":{"type":"string"},"type":"array","title":"Competitor Variations","default":[]}},"type":"object","required":["competitor_domain","competitor_name"],"title":"BulkCompetitorEntry"},"BulkDeleteTopics":{"properties":{"topic_ids":{"items":{"type":"string"},"type":"array","maxItems":5000,"title":"Topic Ids"},"delete_prompts":{"type":"string","title":"Delete Prompts"}},"type":"object","required":["topic_ids","delete_prompts"],"title":"BulkDeleteTopics"},"BulkQueryItem":{"properties":{"text":{"type":"string","title":"Text"},"topics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Topics","default":[]},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags","default":[]}},"type":"object","required":["text"],"title":"BulkQueryItem"},"BulkUpdateRecommendationItemStatusRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"updates":{"items":{"$ref":"#/components/schemas/ItemStatusUpdate"},"type":"array","title":"Updates"}},"type":"object","required":["domain_id","updates"],"title":"BulkUpdateRecommendationItemStatusRequest"},"CancelSubscription":{"properties":{"team_id":{"type":"string","title":"Team Id"},"reason":{"type":"string","title":"Reason"},"likelihood_to_return":{"type":"integer","title":"Likelihood To Return"},"details":{"type":"string","title":"Details","default":""}},"type":"object","required":["team_id","reason","likelihood_to_return"],"title":"CancelSubscription"},"CancelTeamInvite":{"properties":{"team_id":{"type":"string","title":"Team Id"},"invite_id":{"type":"string","title":"Invite Id"}},"type":"object","required":["team_id","invite_id"],"title":"CancelTeamInvite"},"ChatRequest":{"properties":{"messages":{"items":{"$ref":"#/components/schemas/UiMessage"},"type":"array","maxItems":50,"title":"Messages"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id"},"is_retry":{"type":"boolean","title":"Is Retry","default":false},"retry_message_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Retry Message Id"},"context":{"$ref":"#/components/schemas/AssistantContext"}},"type":"object","title":"ChatRequest"},"CheckDuplicateItem":{"properties":{"text":{"type":"string","title":"Text"},"topic_names":{"items":{"type":"string"},"type":"array","title":"Topic Names","default":[]},"topic_ids":{"items":{"type":"string"},"type":"array","title":"Topic Ids","default":[]},"tag_names":{"items":{"type":"string"},"type":"array","title":"Tag Names","default":[]}},"type":"object","required":["text"],"title":"CheckDuplicateItem"},"CheckDuplicateQueriesRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"items":{"items":{"$ref":"#/components/schemas/CheckDuplicateItem"},"type":"array","title":"Items"}},"type":"object","required":["domain_id","items"],"title":"CheckDuplicateQueriesRequest"},"CheckDuplicateQueriesResponse":{"properties":{"duplicates":{"items":{"$ref":"#/components/schemas/CheckDuplicateItem"},"type":"array","title":"Duplicates"},"existing_topic_matches":{"items":{"$ref":"#/components/schemas/TopicNameMatch"},"type":"array","title":"Existing Topic Matches","default":[]},"unknown_tags":{"items":{"type":"string"},"type":"array","title":"Unknown Tags","default":[]}},"type":"object","required":["duplicates"],"title":"CheckDuplicateQueriesResponse"},"Citation":{"properties":{"url":{"type":"string","title":"Url"},"model":{"type":"string","title":"Model"},"first_seen":{"type":"string","title":"First Seen"},"citation_count":{"type":"integer","title":"Citation Count"},"query_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query Text"},"query_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query Id"}},"type":"object","required":["url","model","first_seen","citation_count"],"title":"Citation"},"CitationStatisticsResponse":{"properties":{"model_stats":{"items":{"$ref":"#/components/schemas/ModelStatistics"},"type":"array","title":"Model Stats"},"total_citations":{"type":"integer","title":"Total Citations"},"total_domains":{"type":"integer","title":"Total Domains"},"total_all_domains":{"type":"integer","title":"Total All Domains"},"leading_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Leading Model"}},"type":"object","required":["model_stats","total_citations","total_domains","total_all_domains"],"title":"CitationStatisticsResponse"},"CitationsDomainItem":{"properties":{"domain":{"type":"string","title":"Domain"},"frequency":{"type":"integer","title":"Frequency"},"prompt_count":{"type":"integer","title":"Prompt Count"},"models":{"items":{"type":"string"},"type":"array","title":"Models"},"urls":{"items":{"$ref":"#/components/schemas/CitationsDomainUrlItem"},"type":"array","title":"Urls"},"used_percent":{"type":"number","title":"Used Percent"},"is_brand_owned":{"type":"boolean","title":"Is Brand Owned","default":false},"merged_hosts":{"items":{"type":"string"},"type":"array","title":"Merged Hosts","default":[]}},"type":"object","required":["domain","frequency","prompt_count","models","urls","used_percent"],"title":"CitationsDomainItem"},"CitationsDomainUrlItem":{"properties":{"url":{"type":"string","title":"Url"},"host":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Host"},"frequency":{"type":"integer","title":"Frequency"},"prompt_count":{"type":"integer","title":"Prompt Count"},"models":{"items":{"type":"string"},"type":"array","title":"Models","default":[]}},"type":"object","required":["url","frequency","prompt_count"],"title":"CitationsDomainUrlItem"},"CitationsPaginatedResponse":{"properties":{"citations":{"items":{"$ref":"#/components/schemas/Citation"},"type":"array","title":"Citations"},"pagination":{"additionalProperties":true,"type":"object","title":"Pagination"}},"type":"object","required":["citations","pagination"],"title":"CitationsPaginatedResponse"},"CitationsPromptItem":{"properties":{"query_id":{"type":"string","title":"Query Id"},"prompt_text":{"type":"string","title":"Prompt Text"},"model_count":{"type":"integer","title":"Model Count"},"models":{"items":{"type":"string"},"type":"array","title":"Models"},"mentions":{"type":"integer","title":"Mentions"},"citations":{"items":{"type":"string"},"type":"array","title":"Citations"},"sentiment":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sentiment"},"position":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Position"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["query_id","prompt_text","model_count","models","mentions","citations","sentiment","position","created_at"],"title":"CitationsPromptItem"},"CitationsUrlItem":{"properties":{"url":{"type":"string","title":"Url"},"domain":{"type":"string","title":"Domain"},"frequency":{"type":"integer","title":"Frequency"},"prompt_count":{"type":"integer","title":"Prompt Count"},"prompt_ids":{"items":{"type":"string"},"type":"array","title":"Prompt Ids"},"prompt_texts":{"items":{"type":"string"},"type":"array","title":"Prompt Texts"},"topic_ids":{"items":{"type":"string"},"type":"array","title":"Topic Ids"},"topic_names":{"items":{"type":"string"},"type":"array","title":"Topic Names"},"models":{"items":{"type":"string"},"type":"array","title":"Models"},"first_seen":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Seen"},"last_seen":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Seen"},"average_position":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Position"},"mention_count":{"type":"integer","title":"Mention Count"}},"type":"object","required":["url","domain","frequency","prompt_count","prompt_ids","prompt_texts","topic_ids","topic_names","models","first_seen","last_seen","average_position","mention_count"],"title":"CitationsUrlItem"},"CityOut":{"properties":{"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id"},"name":{"type":"string","title":"Name"},"state_code":{"type":"string","title":"State Code"},"country":{"type":"string","title":"Country"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude"}},"type":"object","required":["name","state_code","country"],"title":"CityOut"},"ClusterData":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"prompts":{"items":{"$ref":"#/components/schemas/ClusterPrompt"},"type":"array","title":"Prompts"}},"type":"object","required":["name","description","prompts"],"title":"ClusterData"},"ClusterItem":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"}},"type":"object","required":["name","description"],"title":"ClusterItem"},"ClusterPrompt":{"properties":{"text":{"type":"string","title":"Text"},"tracked":{"type":"boolean","title":"Tracked","default":false}},"type":"object","required":["text"],"title":"ClusterPrompt"},"CompetitorPerformance":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"mentions":{"type":"integer","title":"Mentions"},"position":{"type":"number","title":"Position"},"sentiment":{"type":"number","title":"Sentiment"},"visibility":{"type":"number","title":"Visibility"},"sov":{"type":"number","title":"Sov"},"prompts_mentioned":{"type":"integer","title":"Prompts Mentioned"},"total_prompts":{"type":"integer","title":"Total Prompts"},"total_prompt_executions":{"type":"integer","title":"Total Prompt Executions"},"positions_sum":{"type":"integer","title":"Positions Sum","default":0},"isUser":{"type":"boolean","title":"Isuser","default":false}},"type":"object","required":["id","name","website","mentions","position","sentiment","visibility","sov","prompts_mentioned","total_prompts","total_prompt_executions"],"title":"CompetitorPerformance"},"CompleteConnectionRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"code":{"type":"string","maxLength":512,"title":"Code"},"state":{"type":"string","maxLength":512,"title":"State"}},"type":"object","required":["domain_id","code","state"],"title":"CompleteConnectionRequest"},"CompleteOnboardingWizard":{"properties":{"team_id":{"type":"string","title":"Team Id"},"answers":{"additionalProperties":true,"type":"object","title":"Answers","default":{}}},"type":"object","required":["team_id"],"title":"CompleteOnboardingWizard"},"ConversationGetRequest":{"properties":{"conversation_id":{"type":"string","title":"Conversation Id"}},"type":"object","required":["conversation_id"],"title":"ConversationGetRequest"},"ConversationListRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"limit":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":30}},"type":"object","required":["domain_id"],"title":"ConversationListRequest"},"ConvertPitchDomainRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"ConvertPitchDomainRequest","description":"Request model for converting a pitch brand into a normal brand."},"CreateApiKeyRequest":{"properties":{"team_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id"},"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"}},"type":"object","required":["name"],"title":"CreateApiKeyRequest"},"CreateCheckoutSession":{"properties":{"team_id":{"type":"string","title":"Team Id"},"plan":{"type":"string","title":"Plan"},"currency":{"type":"string","title":"Currency"},"email":{"type":"string","title":"Email"},"referral_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referral Id"},"success_url":{"type":"string","title":"Success Url"},"cancel_url":{"type":"string","title":"Cancel Url"},"ga_client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ga Client Id"},"ga_session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ga Session Id"},"gclid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gclid"},"gbraid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gbraid"},"wbraid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wbraid"},"fbc":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fbc"},"fbp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fbp"},"first_touchpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Touchpoint"},"consent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Consent"}},"type":"object","required":["team_id","plan","currency","email","success_url","cancel_url"],"title":"CreateCheckoutSession"},"CreateEngagementTemplateRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"usage":{"type":"string","title":"Usage"},"name":{"type":"string","title":"Name"},"content":{"type":"string","title":"Content"},"generation_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generation Type"},"subtype":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subtype"},"is_active":{"type":"boolean","title":"Is Active","default":true}},"additionalProperties":false,"type":"object","required":["domain_id","usage","name","content"],"title":"CreateEngagementTemplateRequest"},"CreateEnterpriseUserRequest":{"properties":{"team_id":{"type":"string","title":"Team Id"},"email":{"type":"string","title":"Email"},"role":{"type":"string","title":"Role","default":"editor"}},"type":"object","required":["team_id","email"],"title":"CreateEnterpriseUserRequest"},"CreateFolderRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"name":{"type":"string","title":"Name"}},"type":"object","required":["domain_id","name"],"title":"CreateFolderRequest"},"CreateOutreachCampaignRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"planned_budget_cents":{"type":"integer","title":"Planned Budget Cents","default":0},"planned_cap_link_budget_cents":{"type":"integer","title":"Planned Cap Link Budget Cents","default":0},"min_domain_rating":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Domain Rating"},"min_organic_traffic":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Organic Traffic"},"brand_reference_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand Reference Url"}},"type":"object","required":["domain_id"],"title":"CreateOutreachCampaignRequest"},"CreatePatternRequest":{"properties":{"host":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Host"},"url_part":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Part"},"page_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Type"}},"type":"object","title":"CreatePatternRequest","description":"Request model for creating a pattern"},"CreatePortalSession":{"properties":{"team_id":{"type":"string","title":"Team Id"},"return_url":{"type":"string","title":"Return Url"},"flow_intent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Flow Intent"}},"type":"object","required":["team_id","return_url"],"title":"CreatePortalSession"},"CreateTag":{"properties":{"name":{"type":"string","title":"Name"},"color_id":{"type":"string","minLength":1,"title":"Color Id"},"domain_id":{"type":"string","title":"Domain Id"},"query_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Query Ids","default":[]}},"type":"object","required":["name","color_id","domain_id"],"title":"CreateTag"},"CreateTopic":{"properties":{"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"query_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Query Ids","default":[]},"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["name","domain_id"],"title":"CreateTopic"},"DataExplorerRequest":{"properties":{"domain":{"type":"string","maxLength":2048,"minLength":1,"title":"Domain"},"start_date":{"type":"string","format":"date","title":"Start Date"},"end_date":{"type":"string","format":"date","title":"End Date"},"model":{"type":"string","title":"Model","default":"all"}},"additionalProperties":false,"type":"object","required":["domain","start_date","end_date"],"title":"DataExplorerRequest"},"DateRange":{"properties":{"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"}},"type":"object","required":["start_date","end_date"],"title":"DateRange"},"DedicatedCompetitorCitations":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"website":{"type":"string","title":"Website"},"data_points":{"items":{"$ref":"#/components/schemas/DedicatedCompetitorCitationsDataPoint"},"type":"array","title":"Data Points"},"total_brand_citations":{"type":"integer","title":"Total Brand Citations"},"total_citations":{"type":"integer","title":"Total Citations"},"is_user_brand":{"type":"boolean","title":"Is User Brand","default":false}},"type":"object","required":["id","name","website","data_points","total_brand_citations","total_citations"],"title":"DedicatedCompetitorCitations"},"DedicatedCompetitorCitationsDataPoint":{"properties":{"date":{"type":"string","title":"Date"},"brand_citations":{"type":"integer","title":"Brand Citations"},"citations_count":{"type":"integer","title":"Citations Count"}},"type":"object","required":["date","brand_citations","citations_count"],"title":"DedicatedCompetitorCitationsDataPoint"},"DedicatedCompetitorDataPoint":{"properties":{"date":{"type":"string","title":"Date"},"mentions":{"type":"integer","title":"Mentions"},"position":{"type":"number","title":"Position"},"sentiment_score":{"type":"number","title":"Sentiment Score"},"visibility_score":{"type":"number","title":"Visibility Score"},"sov_score":{"type":"number","title":"Sov Score"},"answers_count":{"type":"integer","title":"Answers Count","default":0}},"type":"object","required":["date","mentions","position","sentiment_score","visibility_score","sov_score"],"title":"DedicatedCompetitorDataPoint"},"DedicatedCompetitorPerformance":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"website":{"type":"string","title":"Website"},"data_points":{"items":{"$ref":"#/components/schemas/DedicatedCompetitorDataPoint"},"type":"array","title":"Data Points"},"avg_mentions":{"type":"number","title":"Avg Mentions"},"avg_position":{"type":"number","title":"Avg Position"},"avg_sentiment":{"type":"number","title":"Avg Sentiment"},"avg_visibility":{"type":"number","title":"Avg Visibility"},"avg_sov":{"type":"number","title":"Avg Sov"},"total_queries":{"type":"integer","title":"Total Queries"},"is_user_brand":{"type":"boolean","title":"Is User Brand","default":false}},"type":"object","required":["id","name","website","data_points","avg_mentions","avg_position","avg_sentiment","avg_visibility","avg_sov","total_queries"],"title":"DedicatedCompetitorPerformance"},"DeleteCmsConnectionRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},"type":"object","required":["domain_id"],"title":"DeleteCmsConnectionRequest"},"DeleteCompetitor":{"properties":{"competitor_id":{"type":"string","title":"Competitor Id"}},"type":"object","required":["competitor_id"],"title":"DeleteCompetitor"},"DeleteContentRequest":{"properties":{"research_result_id":{"type":"string","title":"Research Result Id"}},"type":"object","required":["research_result_id"],"title":"DeleteContentRequest"},"DeleteEngagementTemplateRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"template_id":{"type":"string","title":"Template Id"}},"additionalProperties":false,"type":"object","required":["domain_id","template_id"],"title":"DeleteEngagementTemplateRequest"},"DeleteFolderRequest":{"properties":{"folder_id":{"type":"string","title":"Folder Id"}},"type":"object","required":["folder_id"],"title":"DeleteFolderRequest"},"DeletePatternRequest":{"properties":{"id":{"type":"string","title":"Id"}},"type":"object","required":["id"],"title":"DeletePatternRequest","description":"Request model for deleting a pattern"},"DeleteSuggestedPromptRequest":{"properties":{"prompt_id":{"type":"string","title":"Prompt Id"}},"type":"object","required":["prompt_id"],"title":"DeleteSuggestedPromptRequest"},"DeleteTag":{"properties":{"tag_id":{"type":"string","title":"Tag Id"},"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["tag_id","domain_id"],"title":"DeleteTag"},"DeleteTeamRequest":{"properties":{"team_id":{"type":"string","title":"Team Id"},"confirmation_name":{"type":"string","title":"Confirmation Name"}},"type":"object","required":["team_id","confirmation_name"],"title":"DeleteTeamRequest"},"DeleteThemeRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"theme_id":{"type":"string","title":"Theme Id"}},"type":"object","required":["domain_id","theme_id"],"title":"DeleteThemeRequest"},"DeleteTopic":{"properties":{"topic_id":{"type":"string","title":"Topic Id"},"delete_prompts":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Delete Prompts","default":false}},"type":"object","required":["topic_id"],"title":"DeleteTopic"},"DeleteUserRequest":{"properties":{"email":{"type":"string","title":"Email"},"confirmation_email":{"type":"string","title":"Confirmation Email"}},"type":"object","required":["email","confirmation_email"],"title":"DeleteUserRequest"},"DisconnectGA4Request":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"DisconnectGA4Request"},"DiscoveryPromptItem":{"properties":{"text":{"type":"string","title":"Text"},"topic":{"type":"string","title":"Topic"},"topic_description":{"type":"string","title":"Topic Description"},"estimated_volume":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Volume","default":0}},"type":"object","required":["text","topic","topic_description"],"title":"DiscoveryPromptItem"},"DomainCitation":{"properties":{"domain":{"type":"string","title":"Domain"},"mentions":{"type":"integer","title":"Mentions"},"prompts":{"type":"integer","title":"Prompts"},"pages":{"type":"integer","title":"Pages"},"used_percent":{"type":"number","title":"Used Percent"},"avg_citations":{"type":"number","title":"Avg Citations"},"first_seen":{"type":"string","title":"First Seen"},"last_seen":{"type":"string","title":"Last Seen"},"models":{"items":{"type":"string"},"type":"array","title":"Models"}},"type":"object","required":["domain","mentions","prompts","pages","used_percent","avg_citations","first_seen","last_seen","models"],"title":"DomainCitation"},"DomainCitationsPaginatedResponse":{"properties":{"citations":{"items":{"$ref":"#/components/schemas/DomainCitation"},"type":"array","title":"Citations"},"pagination":{"additionalProperties":true,"type":"object","title":"Pagination"}},"type":"object","required":["citations","pagination"],"title":"DomainCitationsPaginatedResponse"},"DomainCreate":{"properties":{"team_id":{"type":"string","title":"Team Id"},"name":{"type":"string","title":"Name"},"website":{"type":"string","title":"Website"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"states":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"States"},"cities":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Cities"},"generate_prompts":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Generate Prompts","default":false},"prompts":{"anyOf":[{"items":{"$ref":"#/components/schemas/DomainPromptItem"},"type":"array"},{"type":"null"}],"title":"Prompts"},"new_tags":{"items":{"$ref":"#/components/schemas/NewTagSpec"},"type":"array","title":"New Tags","default":[]},"is_pitch":{"type":"boolean","title":"Is Pitch","default":false},"defer_analysis":{"type":"boolean","title":"Defer Analysis","default":false}},"type":"object","required":["team_id","name","website"],"title":"DomainCreate"},"DomainDelete":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"DomainDelete"},"DomainPromptItem":{"properties":{"text":{"type":"string","title":"Text"},"topics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Topics","default":[]},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags","default":[]}},"type":"object","required":["text"],"title":"DomainPromptItem"},"DomainRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"DomainRequest"},"DomainScopedRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"DomainScopedRequest"},"DomainVisibilityEntry":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"visibility_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Visibility Score"},"previous_visibility_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Previous Visibility Score"},"visibility_points_change":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Visibility Points Change"},"current_responses":{"type":"integer","title":"Current Responses","default":0},"previous_responses":{"type":"integer","title":"Previous Responses","default":0}},"type":"object","required":["domain_id"],"title":"DomainVisibilityEntry"},"DomainVisibilityPeriod":{"properties":{"current_start":{"type":"string","title":"Current Start"},"current_end":{"type":"string","title":"Current End"},"previous_start":{"type":"string","title":"Previous Start"},"previous_end":{"type":"string","title":"Previous End"}},"type":"object","required":["current_start","current_end","previous_start","previous_end"],"title":"DomainVisibilityPeriod"},"EmailExistsRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"}},"type":"object","required":["email"],"title":"EmailExistsRequest"},"EmailExistsResponse":{"properties":{"exists":{"type":"boolean","title":"Exists"}},"type":"object","required":["exists"],"title":"EmailExistsResponse"},"EngageEnrichmentProgressRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"since":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Since"},"since_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Since Id"}},"additionalProperties":false,"type":"object","required":["domain_id"],"title":"EngageEnrichmentProgressRequest"},"EngagementFacetsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"additionalProperties":false,"type":"object","required":["domain_id"],"title":"EngagementFacetsRequest"},"EngagementGenerationsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"recommendation_item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recommendation Item Id"},"page":{"type":"integer","title":"Page","default":1},"per_page":{"type":"integer","title":"Per Page","default":100}},"additionalProperties":false,"type":"object","required":["domain_id"],"title":"EngagementGenerationsRequest"},"EnhancedCitationsExport":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"export_all":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Export All","default":false}},"type":"object","required":["domain_id"],"title":"EnhancedCitationsExport"},"ExportDetailedAnalysis":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"date_range":{"anyOf":[{"$ref":"#/components/schemas/DateRange"},{"type":"null"}]},"export_all":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Export All","default":false}},"type":"object","required":["domain_id"],"title":"ExportDetailedAnalysis"},"ExportSimpleData":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"timeframe":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timeframe","default":"7d"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","default":"all"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"per_prompt":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Per Prompt","default":true},"per_topic":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Per Topic","default":false}},"type":"object","required":["domain_id"],"title":"ExportSimpleData"},"FetchGA4DataRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date","default":"30daysAgo"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date","default":"today"}},"type":"object","required":["domain_id"],"title":"FetchGA4DataRequest"},"FetchKeywords":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"FetchKeywords"},"FolderBrandOverrides":{"properties":{"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"},"target_market":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Market"},"marketing_objectives":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Marketing Objectives"},"tone_of_voice":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tone Of Voice"},"point_of_view":{"anyOf":[{"type":"string","enum":["first_person","third_party",""]},{"type":"null"}],"title":"Point Of View"}},"type":"object","title":"FolderBrandOverrides"},"FolderListRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"FolderListRequest"},"GA4ConnectionCallback":{"properties":{"code":{"type":"string","title":"Code"},"state":{"type":"string","title":"State"},"domain_id":{"type":"string","title":"Domain Id"},"team_id":{"type":"string","title":"Team Id"}},"type":"object","required":["code","state","domain_id","team_id"],"title":"GA4ConnectionCallback"},"GenerateArticleTopicsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GenerateArticleTopicsRequest"},"GenerateBlogRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"keyword":{"type":"string","title":"Keyword"},"topic":{"type":"string","title":"Topic"},"context":{"type":"string","title":"Context"},"outline":{"additionalProperties":true,"type":"object","title":"Outline"},"research":{"type":"string","title":"Research"},"takeaways":{"type":"string","title":"Takeaways"},"content_type":{"type":"string","title":"Content Type"},"llm_optimized":{"type":"boolean","title":"Llm Optimized","default":true},"prompt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt Text","default":""},"keywords":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Keywords"},"related_links":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Related Links"},"outline_job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Outline Job Id"},"approved_outline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approved Outline"},"approved_faq":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approved Faq"},"analyze_job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Analyze Job Id"},"angle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Angle"},"research_result_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Research Result Id"},"author_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Name"},"author_position":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Position"},"reviewer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewer Name"},"reviewer_position":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reviewer Position"},"folder_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Folder Id"},"image_style":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Style"},"idea_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idea Id"},"point_of_view":{"anyOf":[{"type":"string","enum":["first_person","third_party",""]},{"type":"null"}],"title":"Point Of View"}},"type":"object","required":["domain_id","keyword","topic","context","research","takeaways","content_type"],"title":"GenerateBlogRequest"},"GenerateClusterPromptsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"cluster_name":{"type":"string","title":"Cluster Name"},"cluster_description":{"type":"string","title":"Cluster Description"},"existing_prompts":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Existing Prompts","default":[]}},"type":"object","required":["domain_id","cluster_name","cluster_description"],"title":"GenerateClusterPromptsRequest"},"GenerateClustersRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"services":{"items":{"type":"string"},"type":"array","title":"Services"}},"type":"object","required":["domain_id","services"],"title":"GenerateClustersRequest"},"GenerateContentRecommendationsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"subscription_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscription Tier","default":"starter"}},"type":"object","required":["domain_id"],"title":"GenerateContentRecommendationsRequest"},"GenerateEngageRecommendationsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GenerateEngageRecommendationsRequest"},"GenerateEngagementCommentRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"recommendation_item_id":{"type":"string","title":"Recommendation Item Id"},"generation_type":{"type":"string","enum":["comment_short","comment_generic","comment_unbranded","comment_custom"],"title":"Generation Type"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Query"},"template_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template Id"}},"additionalProperties":false,"type":"object","required":["domain_id","recommendation_item_id","generation_type"],"title":"GenerateEngagementCommentRequest"},"GenerateMentionedRecommendationsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GenerateMentionedRecommendationsRequest"},"GenerateResearchRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"keyword":{"type":"string","title":"Keyword"},"topic":{"type":"string","title":"Topic"},"context":{"type":"string","title":"Context"},"content_type":{"type":"string","title":"Content Type"},"keywords":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Keywords"}},"type":"object","required":["domain_id","keyword","topic","context","content_type"],"title":"GenerateResearchRequest"},"GenerateServicesRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GenerateServicesRequest"},"GetActionsAvailabilityRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GetActionsAvailabilityRequest"},"GetActivePromptsCountRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GetActivePromptsCountRequest"},"GetAllDomainsActivePromptsCountRequest":{"properties":{"team_id":{"type":"string","title":"Team Id"}},"type":"object","required":["team_id"],"title":"GetAllDomainsActivePromptsCountRequest"},"GetAnalysesRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GetAnalysesRequest"},"GetAnalysisHistory":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"page":{"type":"integer","title":"Page","default":1},"limit":{"type":"integer","title":"Limit","default":2}},"type":"object","required":["domain_id"],"title":"GetAnalysisHistory"},"GetAnalysisStatus":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GetAnalysisStatus"},"GetAttributionStatsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"llm_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Llm Source"}},"type":"object","required":["domain_id"],"title":"GetAttributionStatsRequest"},"GetBlogsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"page":{"type":"integer","title":"Page","default":1},"page_size":{"type":"integer","title":"Page Size","default":15},"search":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},"type":"object","required":["domain_id"],"title":"GetBlogsRequest"},"GetCitationStatistics":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GetCitationStatistics"},"GetCitations":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page"},"per_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Per Page"}},"type":"object","required":["domain_id"],"title":"GetCitations"},"GetCitationsByDomain":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page","default":1},"per_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Per Page","default":10000}},"type":"object","required":["domain_id"],"title":"GetCitationsByDomain"},"GetClustersRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GetClustersRequest"},"GetCompetitorPerformance":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"timeframe":{"type":"string","title":"Timeframe","default":"7d"},"model":{"type":"string","title":"Model","default":"all"}},"type":"object","required":["domain_id"],"title":"GetCompetitorPerformance"},"GetCompetitors":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"analysis_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Analysis Id"},"model":{"type":"string","title":"Model","default":"all"},"is_dedicated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Dedicated"}},"type":"object","required":["domain_id"],"title":"GetCompetitors"},"GetContentRecommendationsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"batch_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Batch Id"}},"type":"object","required":["domain_id"],"title":"GetContentRecommendationsRequest"},"GetDedicatedCompetitorsPerformance":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"},"model":{"type":"string","title":"Model","default":"all"},"query_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Query Ids"},"include_partial":{"type":"boolean","title":"Include Partial","default":false}},"type":"object","required":["domain_id"],"title":"GetDedicatedCompetitorsPerformance"},"GetDiscoveryCompetitors":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GetDiscoveryCompetitors"},"GetDiscoveryPromptsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GetDiscoveryPromptsRequest"},"GetDomainInfoRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GetDomainInfoRequest"},"GetDomainMetrics":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"timeframe":{"type":"string","title":"Timeframe","default":"7d"},"model":{"type":"string","title":"Model","default":"all"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"include_partial":{"type":"boolean","title":"Include Partial","default":false}},"type":"object","required":["domain_id"],"title":"GetDomainMetrics"},"GetDomainsVisibility":{"properties":{"domain_ids":{"items":{"type":"string"},"type":"array","maxItems":3000,"minItems":1,"title":"Domain Ids"}},"type":"object","required":["domain_ids"],"title":"GetDomainsVisibility"},"GetDomainsVisibilityResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/DomainVisibilityEntry"},"type":"array","title":"Data"},"period":{"$ref":"#/components/schemas/DomainVisibilityPeriod"}},"type":"object","required":["data","period"],"title":"GetDomainsVisibilityResponse"},"GetEngageGenerationStatusRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GetEngageGenerationStatusRequest"},"GetFanoutQueriesRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"timeframe":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timeframe"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"query_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Query Ids"}},"type":"object","required":["domain_id"],"title":"GetFanoutQueriesRequest"},"GetIndustryStats":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"model":{"type":"string","title":"Model","default":"all"},"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"},"query_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Query Ids"}},"type":"object","required":["domain_id"],"title":"GetIndustryStats"},"GetKeywords":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"keyword":{"type":"string","title":"Keyword"}},"type":"object","required":["domain_id","keyword"],"title":"GetKeywords"},"GetMentionedGenerationStatusRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GetMentionedGenerationStatusRequest"},"GetMentionsTimeseries":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"days":{"type":"integer","title":"Days","default":7},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"},"topic_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Topic Ids"},"query_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Query Ids"}},"type":"object","required":["domain_id"],"title":"GetMentionsTimeseries"},"GetOutreachCampaignLinksRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"page":{"type":"integer","title":"Page","default":1},"per_page":{"type":"integer","title":"Per Page","default":50},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"search":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"},"order":{"type":"string","title":"Order","default":"stable"},"after_updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"After Updated At"},"after_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"After Status"},"after_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"After Id"}},"type":"object","required":["campaign_id"],"title":"GetOutreachCampaignLinksRequest","description":"Customer paginated links table: one campaign, with optional status filter and\nsearch (ILIKE over source_url / title). per_page is clamped server-side.\n\n``order`` selects paging: ``stable`` (default, numbered offset) or ``activity``\n(keyset by updated_at DESC, status_rank, id). For activity the cursor is the last\nloaded row: ``after_updated_at`` / ``after_status`` / ``after_id``."},"GetOutreachCampaignRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"}},"type":"object","required":["campaign_id"],"title":"GetOutreachCampaignRequest"},"GetOutreachCampaignsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GetOutreachCampaignsRequest"},"GetOutreachTransactionsRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"}},"type":"object","required":["campaign_id"],"title":"GetOutreachTransactionsRequest"},"GetPromptResponsePerformance":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"query_id":{"type":"string","title":"Query Id"}},"type":"object","required":["domain_id","query_id"],"title":"GetPromptResponsePerformance"},"GetPromptsTagSummary":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"query_ids":{"items":{"type":"string"},"type":"array","title":"Query Ids","default":[]},"topic_ids":{"items":{"type":"string"},"type":"array","title":"Topic Ids","default":[]},"all_analyzable":{"type":"boolean","title":"All Analyzable","default":false},"include_untopiced":{"type":"boolean","title":"Include Untopiced","default":false},"prompt_filter":{"anyOf":[{"$ref":"#/components/schemas/PromptFilter"},{"type":"null"}]}},"type":"object","required":["domain_id"],"title":"GetPromptsTagSummary"},"GetPublicDashboardRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"timeframe":{"type":"string","title":"Timeframe","default":"7d"},"model":{"type":"string","title":"Model","default":"all"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},"type":"object","required":["domain_id"],"title":"GetPublicDashboardRequest","description":"Request model for public dashboard."},"GetQueries":{"properties":{"tag_ids":{"items":{"type":"string"},"type":"array","maxItems":5000,"title":"Tag Ids","default":[]},"tag_match":{"$ref":"#/components/schemas/TagMatch","default":"or"},"domain_id":{"type":"string","title":"Domain Id"},"analysis_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Analysis Id"},"timeframe":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timeframe"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page","default":1},"per_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Per Page","default":50},"search":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"},"sort_by":{"anyOf":[{"type":"string","enum":["volume","position","answers_count","mentions","visibility","citations","citability"]},{"type":"null"}],"title":"Sort By"},"sort_direction":{"type":"string","enum":["asc","desc"],"title":"Sort Direction","default":"desc"},"excluded_query_ids":{"items":{"type":"string"},"type":"array","maxItems":5000,"title":"Excluded Query Ids","default":[]},"excluded_topic_ids":{"items":{"type":"string"},"type":"array","maxItems":5000,"title":"Excluded Topic Ids","default":[]}},"type":"object","required":["domain_id"],"title":"GetQueries"},"GetQueriesByIdsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"query_ids":{"items":{"type":"string"},"type":"array","title":"Query Ids","default":[]}},"type":"object","required":["domain_id"],"title":"GetQueriesByIdsRequest"},"GetQueryById":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"query_id":{"type":"string","title":"Query Id"},"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page","default":1},"per_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Per Page","default":50},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"include_partial":{"type":"boolean","title":"Include Partial","default":false}},"type":"object","required":["domain_id","query_id"],"title":"GetQueryById"},"GetRecommendationActionStatusesRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"item_type":{"type":"string","enum":["engage","mentioned"],"title":"Item Type"}},"type":"object","required":["domain_id","item_type"],"title":"GetRecommendationActionStatusesRequest"},"GetRecommendationChecklistRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GetRecommendationChecklistRequest"},"GetServicesRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GetServicesRequest"},"GetSuggestedPromptsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GetSuggestedPromptsRequest"},"GetTags":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"topic_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Topic Ids"}},"type":"object","required":["domain_id"],"title":"GetTags"},"GetTeamDomainsRequest":{"properties":{"team_id":{"type":"string","title":"Team Id"}},"type":"object","required":["team_id"],"title":"GetTeamDomainsRequest","description":"Request model for getting team domains."},"GetTeamInvitesRequest":{"properties":{"team_id":{"type":"string","title":"Team Id"}},"type":"object","required":["team_id"],"title":"GetTeamInvitesRequest"},"GetTeamMembers":{"properties":{"team_id":{"type":"string","title":"Team Id"}},"type":"object","required":["team_id"],"title":"GetTeamMembers"},"GetTeamMembersRequest":{"properties":{"team_id":{"type":"string","title":"Team Id"}},"type":"object","required":["team_id"],"title":"GetTeamMembersRequest"},"GetTeamPromptStatsRequest":{"properties":{"team_id":{"type":"string","title":"Team Id"}},"type":"object","required":["team_id"],"title":"GetTeamPromptStatsRequest"},"GetTopDomainsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GetTopDomainsRequest"},"GetTopicPrompts":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"topic_id":{"type":"string","title":"Topic Id"}},"type":"object","required":["domain_id","topic_id"],"title":"GetTopicPrompts"},"GetTopicQueries":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"topic_id":{"type":"string","title":"Topic Id"},"timeframe":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timeframe"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page","default":1},"per_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Per Page","default":50},"skip_cache":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Skip Cache","default":false},"include_partial":{"type":"boolean","title":"Include Partial","default":false},"sort_by":{"anyOf":[{"type":"string","enum":["volume","position","answers_count","mentions","visibility","citations","citability"]},{"type":"null"}],"title":"Sort By"},"sort_direction":{"type":"string","enum":["asc","desc"],"title":"Sort Direction","default":"desc"}},"type":"object","required":["domain_id","topic_id"],"title":"GetTopicQueries"},"GetTopicTagSummary":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"topic_id":{"type":"string","title":"Topic Id"}},"type":"object","required":["domain_id","topic_id"],"title":"GetTopicTagSummary"},"GetTopics":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"GetTopics"},"GetTopicsList":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"timeframe":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timeframe","default":"7d"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","default":"all"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Page","default":1},"per_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Per Page","default":10},"include_partial":{"type":"boolean","title":"Include Partial","default":false}},"type":"object","required":["domain_id"],"title":"GetTopicsList"},"GetTrends":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"include_partial":{"type":"boolean","title":"Include Partial","default":false}},"type":"object","required":["domain_id"],"title":"GetTrends"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"InitiateGA4ConnectionRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"team_id":{"type":"string","title":"Team Id"},"redirect_uri":{"type":"string","title":"Redirect Uri"},"login_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Login Hint"}},"type":"object","required":["domain_id","team_id","redirect_uri"],"title":"InitiateGA4ConnectionRequest"},"InviteAcceptRequest":{"properties":{"code":{"type":"string","title":"Code"},"password":{"type":"string","title":"Password"}},"type":"object","required":["code","password"],"title":"InviteAcceptRequest"},"InviteAcceptResponse":{"properties":{"ok":{"type":"boolean","title":"Ok"}},"type":"object","required":["ok"],"title":"InviteAcceptResponse"},"InviteVerifyRequest":{"properties":{"code":{"type":"string","title":"Code"}},"type":"object","required":["code"],"title":"InviteVerifyRequest"},"InviteVerifyResponse":{"properties":{"valid":{"type":"boolean","title":"Valid"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"team_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Name"}},"type":"object","required":["valid"],"title":"InviteVerifyResponse"},"ItemStatusUpdate":{"properties":{"item_id":{"type":"string","title":"Item Id"},"status":{"type":"string","enum":["pending","done","dismissed"],"title":"Status"}},"type":"object","required":["item_id","status"],"title":"ItemStatusUpdate"},"JoinTeamRequest":{"properties":{"team_id":{"type":"string","title":"Team Id"}},"type":"object","required":["team_id"],"title":"JoinTeamRequest"},"LeaveTeamRequest":{"properties":{"team_id":{"type":"string","title":"Team Id"}},"type":"object","required":["team_id"],"title":"LeaveTeamRequest"},"LinkSnapshotRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"recommendation_item_id":{"type":"string","title":"Recommendation Item Id"}},"additionalProperties":false,"type":"object","required":["domain_id","recommendation_item_id"],"title":"LinkSnapshotRequest"},"ListApiKeysRequest":{"properties":{"team_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id"}},"type":"object","title":"ListApiKeysRequest"},"ListCompetitors":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"is_dedicated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Dedicated"},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active"}},"type":"object","required":["domain_id"],"title":"ListCompetitors"},"ListEngagementTemplatesRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"usage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Usage"}},"additionalProperties":false,"type":"object","required":["domain_id"],"title":"ListEngagementTemplatesRequest"},"ListQueriesTopicsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"ListQueriesTopicsRequest"},"LookupEmailRequest":{"properties":{"email":{"type":"string","title":"Email"}},"type":"object","required":["email"],"title":"LookupEmailRequest"},"MarkReadRequest":{"properties":{"ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Ids"}},"type":"object","required":["ids"],"title":"MarkReadRequest"},"MentionsTimeseriesResponse":{"properties":{"timeseries":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Timeseries"}},"type":"object","required":["timeseries"],"title":"MentionsTimeseriesResponse"},"ModelHeadroom":{"properties":{"team_id":{"type":"string","title":"Team Id"},"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["team_id","domain_id"],"title":"ModelHeadroom"},"ModelStatistics":{"properties":{"model":{"type":"string","title":"Model"},"citations":{"type":"integer","title":"Citations"},"share":{"type":"number","title":"Share"},"top_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Top Domain"},"top_domain_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Top Domain Type"},"newest":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Newest"},"domains":{"additionalProperties":{"type":"integer"},"type":"object","title":"Domains","default":{}}},"type":"object","required":["model","citations","share"],"title":"ModelStatistics"},"MoveDomainRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"target_team_id":{"type":"string","title":"Target Team Id"}},"type":"object","required":["domain_id","target_team_id"],"title":"MoveDomainRequest"},"NewTagSpec":{"properties":{"name":{"type":"string","title":"Name"},"color_id":{"type":"string","minLength":1,"title":"Color Id"}},"type":"object","required":["name","color_id"],"title":"NewTagSpec"},"Notification":{"properties":{"id":{"type":"string","title":"Id"},"domain_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"},"type":{"type":"string","title":"Type"},"title":{"type":"string","title":"Title"},"body":{"type":"string","title":"Body"},"link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link"},"read_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Read At"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","type","title","body","created_at"],"title":"Notification"},"NotificationsResponse":{"properties":{"notifications":{"items":{"$ref":"#/components/schemas/Notification"},"type":"array","title":"Notifications"}},"type":"object","required":["notifications"],"title":"NotificationsResponse"},"OnboardingCitationsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"OnboardingCitationsRequest"},"OnboardingRequest":{"properties":{"name":{"type":"string","title":"Name"},"website":{"type":"string","title":"Website"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"states":{"items":{"type":"string"},"type":"array","title":"States","default":[]},"cities":{"items":{"type":"string"},"type":"array","title":"Cities","default":[]}},"type":"object","required":["name","website"],"title":"OnboardingRequest"},"OnboardingRunsRequest":{"properties":{"limit":{"type":"integer","title":"Limit","default":50}},"type":"object","title":"OnboardingRunsRequest"},"OutreachTopupCheckoutRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"amount_cents":{"type":"integer","exclusiveMinimum":0.0,"title":"Amount Cents"},"success_url":{"type":"string","title":"Success Url"},"cancel_url":{"type":"string","title":"Cancel Url"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency Key"}},"type":"object","required":["campaign_id","amount_cents","success_url","cancel_url"],"title":"OutreachTopupCheckoutRequest"},"OutreachTopupIntentRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"amount_cents":{"type":"integer","exclusiveMinimum":0.0,"title":"Amount Cents"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency Key"}},"type":"object","required":["campaign_id","amount_cents"],"title":"OutreachTopupIntentRequest"},"PatchCitationNote":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"citation_id":{"type":"integer","title":"Citation Id"},"notes":{"type":"string","title":"Notes"}},"type":"object","required":["domain_id","citation_id","notes"],"title":"PatchCitationNote"},"PatchMetadata":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"priority":{"type":"string","title":"Priority"},"contentType":{"type":"string","title":"Contenttype"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"queryNumber":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Querynumber"},"completed":{"type":"boolean","title":"Completed"}},"type":"object","required":["id","title","description","priority","contentType","tags","completed"],"title":"PatchMetadata"},"PatchRecommendationRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"prop":{"type":"string","enum":["reddit_mention","website_llm","wikipedia_listed","wikipedia_article","content_recommendation"],"title":"Prop"},"unique_value":{"type":"string","title":"Unique Value"},"metadata":{"$ref":"#/components/schemas/PatchMetadata"}},"type":"object","required":["domain_id","prop","unique_value","metadata"],"title":"PatchRecommendationRequest"},"PauseDomainRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"disabled":{"type":"boolean","title":"Disabled"}},"type":"object","required":["domain_id","disabled"],"title":"PauseDomainRequest","description":"Request model for pausing/unpausing a domain."},"PauseSubscription":{"properties":{"team_id":{"type":"string","title":"Team Id"}},"type":"object","required":["team_id"],"title":"PauseSubscription"},"PickerPreferences":{"properties":{"team_order":{"items":{"type":"string"},"type":"array","maxItems":100,"title":"Team Order"},"brand_order":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Brand Order"},"pinned":{"items":{"type":"string"},"type":"array","maxItems":200,"title":"Pinned"}},"type":"object","title":"PickerPreferences"},"PickerPreferencesResponse":{"properties":{"preferences":{"$ref":"#/components/schemas/PickerPreferences"}},"type":"object","required":["preferences"],"title":"PickerPreferencesResponse"},"PlanChange":{"properties":{"team_id":{"type":"string","title":"Team Id"},"plan":{"type":"string","title":"Plan"}},"type":"object","required":["team_id","plan"],"title":"PlanChange"},"PreviewAddon":{"properties":{"team_id":{"type":"string","title":"Team Id"},"addon_type":{"type":"string","title":"Addon Type"},"size":{"type":"integer","maximum":1000.0,"exclusiveMinimum":0.0,"title":"Size"},"billing":{"type":"string","title":"Billing","default":"monthly"},"domain_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"}},"type":"object","required":["team_id","addon_type","size"],"title":"PreviewAddon"},"PromptFilter":{"properties":{"tag_ids":{"items":{"type":"string"},"type":"array","maxItems":5000,"title":"Tag Ids","default":[]},"tag_match":{"$ref":"#/components/schemas/TagMatch","default":"or"},"search":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"},"excluded_query_ids":{"items":{"type":"string"},"type":"array","maxItems":5000,"title":"Excluded Query Ids","default":[]},"excluded_topic_ids":{"items":{"type":"string"},"type":"array","maxItems":5000,"title":"Excluded Topic Ids","default":[]}},"type":"object","title":"PromptFilter"},"PromptsTagSummaryResponse":{"properties":{"tag_summary":{"$ref":"#/components/schemas/TopicTagSummary"},"prompt_count":{"type":"integer","title":"Prompt Count"}},"type":"object","required":["tag_summary","prompt_count"],"title":"PromptsTagSummaryResponse"},"PromptsTagsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"applied_add_tag_ids":{"items":{"type":"string"},"type":"array","title":"Applied Add Tag Ids"},"applied_remove_tag_ids":{"items":{"type":"string"},"type":"array","title":"Applied Remove Tag Ids"},"affected_query_count":{"type":"integer","title":"Affected Query Count"},"tag_summary":{"anyOf":[{"$ref":"#/components/schemas/TopicTagSummary"},{"type":"null"}]}},"type":"object","required":["success","applied_add_tag_ids","applied_remove_tag_ids","affected_query_count"],"title":"PromptsTagsResponse"},"PublicAttributionRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"PublicAttributionRequest","description":"Request model for attribution endpoint."},"PublicCitationsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"days":{"type":"integer","title":"Days","default":7}},"type":"object","required":["domain_id"],"title":"PublicCitationsRequest","description":"Request model for citations endpoint."},"PublicCompetitorsDataRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"timeframe":{"type":"string","title":"Timeframe","default":"7d"},"model":{"type":"string","title":"Model","default":"all"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"topic_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Topic Ids"},"prompt_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Prompt Ids"}},"type":"object","required":["domain_id"],"title":"PublicCompetitorsDataRequest","description":"Request model for competitors data endpoint."},"PublicDiscoveryCompetitorsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"PublicDiscoveryCompetitorsRequest","description":"Request model for discovery competitors endpoint."},"PublicDomainInfoRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"PublicDomainInfoRequest","description":"Request model for domain info endpoint."},"PublicIndustryStatsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"timeframe":{"type":"string","title":"Timeframe","default":"7d"},"model":{"type":"string","title":"Model","default":"all"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"topic_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Topic Ids"},"prompt_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Prompt Ids"}},"type":"object","required":["domain_id"],"title":"PublicIndustryStatsRequest","description":"Request model for industry stats endpoint."},"PublicMentionsTimeseriesRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"days":{"type":"integer","title":"Days","default":7},"start_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"End Date"},"topic_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Topic Ids"},"query_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Query Ids"}},"type":"object","required":["domain_id"],"title":"PublicMentionsTimeseriesRequest","description":"Request model for mentions timeseries endpoint."},"PublicMetricsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"timeframe":{"type":"string","title":"Timeframe","default":"7d"},"model":{"type":"string","title":"Model","default":"all"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},"type":"object","required":["domain_id"],"title":"PublicMetricsRequest","description":"Request model for metrics endpoint."},"PublicPromptsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"page":{"type":"integer","title":"Page","default":1},"per_page":{"type":"integer","title":"Per Page","default":20},"timeframe":{"type":"string","title":"Timeframe","default":"7d"},"model":{"type":"string","title":"Model","default":"all"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},"type":"object","required":["domain_id"],"title":"PublicPromptsRequest","description":"Request model for prompts endpoint."},"PublicTopicPromptsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"topic_id":{"type":"string","title":"Topic Id"},"page":{"type":"integer","title":"Page","default":1},"per_page":{"type":"integer","title":"Per Page","default":20},"timeframe":{"type":"string","title":"Timeframe","default":"7d"},"model":{"type":"string","title":"Model","default":"all"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},"type":"object","required":["domain_id","topic_id"],"title":"PublicTopicPromptsRequest","description":"Request model for topic prompts endpoint."},"PublicTopicsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"timeframe":{"type":"string","title":"Timeframe","default":"7d"},"model":{"type":"string","title":"Model","default":"all"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},"type":"object","required":["domain_id"],"title":"PublicTopicsRequest","description":"Request model for topics endpoint."},"PublishRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"title":{"type":"string","title":"Title"},"html":{"type":"string","title":"Html"},"article_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Article Id"},"cms_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cms Type"},"cms":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Cms"},"status":{"type":"string","title":"Status","default":"draft"}},"type":"object","required":["domain_id","title","html"],"title":"PublishRequest"},"PurchaseAddon":{"properties":{"team_id":{"type":"string","title":"Team Id"},"addon_type":{"type":"string","title":"Addon Type"},"size":{"type":"integer","maximum":1000.0,"exclusiveMinimum":0.0,"title":"Size"},"billing":{"type":"string","title":"Billing","default":"monthly"},"domain_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain Id"},"success_url":{"type":"string","title":"Success Url"},"cancel_url":{"type":"string","title":"Cancel Url"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency Key"}},"type":"object","required":["team_id","addon_type","size","success_url","cancel_url"],"title":"PurchaseAddon"},"QueryRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"text":{"type":"string","title":"Text"},"topic_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Topic Ids","default":[]},"tag_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tag Ids"}},"type":"object","required":["domain_id","text"],"title":"QueryRequest"},"QuotaRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"QuotaRequest"},"RecommendedEngagementsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"page":{"type":"integer","title":"Page","default":1},"per_page":{"type":"integer","title":"Per Page","default":100},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"search":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"topic_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Topic Ids"},"prompt_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Prompt Ids"},"min_engagement":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Engagement"},"min_comments":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Comments"},"sort_by":{"type":"string","enum":["frequency","engagement","comments"],"title":"Sort By","default":"frequency"},"sort_dir":{"type":"string","enum":["asc","desc"],"title":"Sort Dir","default":"desc"}},"additionalProperties":false,"type":"object","required":["domain_id"],"title":"RecommendedEngagementsRequest"},"RecommendedMentionsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"page":{"type":"integer","title":"Page","default":1},"per_page":{"type":"integer","title":"Per Page","default":100},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"search":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"topic_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Topic Ids"},"prompt_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Prompt Ids"}},"additionalProperties":false,"type":"object","required":["domain_id"],"title":"RecommendedMentionsRequest"},"RegenerateSectionRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"selected_text":{"type":"string","title":"Selected Text"},"instruction":{"type":"string","title":"Instruction"},"article":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Article"},"context_chips":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Context Chips"},"article_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Article Id"}},"type":"object","required":["domain_id","selected_text","instruction"],"title":"RegenerateSectionRequest"},"RemoveDomainMemberRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"user_id":{"type":"string","title":"User Id"}},"type":"object","required":["domain_id","user_id"],"title":"RemoveDomainMemberRequest"},"RemoveFromTeam":{"properties":{"team_id":{"type":"string","title":"Team Id"},"email":{"type":"string","title":"Email"}},"type":"object","required":["team_id","email"],"title":"RemoveFromTeam"},"RemoveTeamMemberRequest":{"properties":{"team_id":{"type":"string","title":"Team Id"},"user_id":{"type":"string","title":"User Id"}},"type":"object","required":["team_id","user_id"],"title":"RemoveTeamMemberRequest"},"RenameClusterRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"old_name":{"type":"string","title":"Old Name"},"new_name":{"type":"string","title":"New Name"}},"type":"object","required":["domain_id","old_name","new_name"],"title":"RenameClusterRequest"},"RenameFolderRequest":{"properties":{"folder_id":{"type":"string","title":"Folder Id"},"name":{"type":"string","title":"Name"}},"type":"object","required":["folder_id","name"],"title":"RenameFolderRequest"},"RenameTeamRequest":{"properties":{"team_id":{"type":"string","title":"Team Id"},"name":{"type":"string","title":"Name"}},"type":"object","required":["team_id","name"],"title":"RenameTeamRequest"},"RenameThemeRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"theme_id":{"type":"string","title":"Theme Id"},"name":{"type":"string","title":"Name"}},"type":"object","required":["domain_id","theme_id","name"],"title":"RenameThemeRequest"},"ResolveOutreachItemRequest":{"properties":{"item_id":{"type":"string","title":"Item Id"},"decision":{"type":"string","enum":["approve","decline"],"title":"Decision"}},"type":"object","required":["item_id","decision"],"title":"ResolveOutreachItemRequest"},"ResolveTagQueryIds":{"properties":{"tag_ids":{"items":{"type":"string"},"type":"array","maxItems":5000,"title":"Tag Ids","default":[]},"tag_match":{"$ref":"#/components/schemas/TagMatch","default":"or"},"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"ResolveTagQueryIds"},"SaveClustersRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"clusters":{"items":{"$ref":"#/components/schemas/ClusterItem"},"type":"array","title":"Clusters"}},"type":"object","required":["domain_id","clusters"],"title":"SaveClustersRequest"},"SaveCmsConnectionRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"type":{"type":"string","title":"Type"},"config":{"additionalProperties":true,"type":"object","title":"Config"}},"type":"object","required":["domain_id","type","config"],"title":"SaveCmsConnectionRequest"},"SaveDiscoveryPromptsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"prompts":{"items":{"$ref":"#/components/schemas/DiscoveryPromptItem"},"type":"array","title":"Prompts"}},"type":"object","required":["domain_id","prompts"],"title":"SaveDiscoveryPromptsRequest"},"SaveDiscoveryResultsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"clusters":{"items":{"$ref":"#/components/schemas/ClusterData"},"type":"array","title":"Clusters"}},"type":"object","required":["domain_id","clusters"],"title":"SaveDiscoveryResultsRequest"},"SaveImageStyleRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"style":{"type":"string","title":"Style"},"colors":{"items":{"type":"string"},"type":"array","title":"Colors","default":[]}},"type":"object","required":["domain_id","style"],"title":"SaveImageStyleRequest"},"SaveServicesRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"services":{"items":{"$ref":"#/components/schemas/ServiceItem"},"type":"array","title":"Services"}},"type":"object","required":["domain_id","services"],"title":"SaveServicesRequest"},"ScorePromptItem":{"properties":{"text":{"type":"string","title":"Text"},"estimated_volume":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Volume"}},"type":"object","required":["text"],"title":"ScorePromptItem"},"ScorePromptsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"cluster_name":{"type":"string","title":"Cluster Name"},"cluster_description":{"type":"string","title":"Cluster Description"},"prompts":{"items":{"$ref":"#/components/schemas/ScorePromptItem"},"type":"array","title":"Prompts"}},"type":"object","required":["domain_id","cluster_name","cluster_description","prompts"],"title":"ScorePromptsRequest"},"SearchDomainsRequest":{"properties":{"search":{"type":"string","title":"Search"}},"type":"object","required":["search"],"title":"SearchDomainsRequest"},"SearchTeamsRequest":{"properties":{"search":{"type":"string","title":"Search"},"search_type":{"type":"string","title":"Search Type","default":"name"}},"type":"object","required":["search"],"title":"SearchTeamsRequest"},"SearchUsersRequest":{"properties":{"search":{"type":"string","title":"Search"}},"type":"object","required":["search"],"title":"SearchUsersRequest"},"SelectGA4PropertyRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"team_id":{"type":"string","title":"Team Id"},"property_id":{"type":"string","title":"Property Id"},"property_name":{"type":"string","title":"Property Name"},"refresh_token":{"type":"string","title":"Refresh Token"},"force":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Force","default":false}},"type":"object","required":["domain_id","team_id","property_id","property_name","refresh_token"],"title":"SelectGA4PropertyRequest"},"SelectResourceRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"handle":{"type":"string","maxLength":64,"title":"Handle"},"resource_id":{"type":"string","maxLength":512,"title":"Resource Id"},"resource_label":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Resource Label"}},"type":"object","required":["domain_id","handle","resource_id"],"title":"SelectResourceRequest"},"SendTeamInvite":{"properties":{"team_id":{"type":"string","title":"Team Id"},"email":{"type":"string","format":"email","title":"Email"},"role":{"type":"string","title":"Role","default":"editor"},"allowed_domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Domains"}},"type":"object","required":["team_id","email"],"title":"SendTeamInvite"},"SentimentThemeResponsesRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"theme_id":{"type":"string","title":"Theme Id"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"}},"type":"object","required":["domain_id","theme_id"],"title":"SentimentThemeResponsesRequest"},"SentimentThemeSourcesRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"days":{"type":"integer","title":"Days","default":7},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"theme_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Theme Id"}},"type":"object","required":["domain_id"],"title":"SentimentThemeSourcesRequest"},"SentimentThemesRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"days":{"type":"integer","title":"Days","default":7},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"}},"type":"object","required":["domain_id"],"title":"SentimentThemesRequest"},"ServiceItem":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"}},"type":"object","required":["name","description"],"title":"ServiceItem"},"SetAssistantMessagesRequest":{"properties":{"team_id":{"type":"string","title":"Team Id"},"messages":{"anyOf":[{"type":"integer","maximum":32767.0,"minimum":-1.0},{"type":"null"}],"title":"Messages"}},"type":"object","required":["team_id"],"title":"SetAssistantMessagesRequest"},"SetDeveloperAccessRequest":{"properties":{"team_id":{"type":"string","title":"Team Id"},"enabled":{"type":"boolean","title":"Enabled"}},"type":"object","required":["team_id","enabled"],"title":"SetDeveloperAccessRequest"},"SetFolderBrandKnowledgeRequest":{"properties":{"folder_id":{"type":"string","title":"Folder Id"},"brand_overrides":{"anyOf":[{"$ref":"#/components/schemas/FolderBrandOverrides"},{"type":"null"}]}},"type":"object","required":["folder_id"],"title":"SetFolderBrandKnowledgeRequest"},"SetLegacyPricingRequest":{"properties":{"team_id":{"type":"string","title":"Team Id"},"legacy":{"type":"boolean","title":"Legacy"}},"type":"object","required":["team_id","legacy"],"title":"SetLegacyPricingRequest"},"SetUserRoleRequest":{"properties":{"user_id":{"type":"string","title":"User Id"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"}},"type":"object","required":["user_id"],"title":"SetUserRoleRequest"},"SitemapUrlsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"sitemap":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sitemap"},"limit":{"type":"integer","title":"Limit","default":20}},"type":"object","required":["domain_id"],"title":"SitemapUrlsRequest"},"StartConnectionRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"login_hint":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Login Hint"}},"type":"object","required":["domain_id"],"title":"StartConnectionRequest"},"StateOut":{"properties":{"code":{"type":"string","title":"Code"},"name":{"type":"string","title":"Name"},"country":{"type":"string","title":"Country"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},"type":"object","required":["code","name","country"],"title":"StateOut"},"SuggestCompetitorsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"SuggestCompetitorsRequest"},"SuggestedPromptsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"SuggestedPromptsRequest"},"TagColor":{"properties":{"id":{"type":"string","title":"Id"},"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"hex_bg":{"type":"string","title":"Hex Bg"},"hex_text":{"type":"string","title":"Hex Text"},"sort_order":{"type":"integer","title":"Sort Order"}},"type":"object","required":["id","key","label","hex_bg","hex_text","sort_order"],"title":"TagColor"},"TagColorsResponse":{"properties":{"colors":{"items":{"$ref":"#/components/schemas/TagColor"},"type":"array","title":"Colors"}},"type":"object","required":["colors"],"title":"TagColorsResponse"},"TagMatch":{"type":"string","enum":["or","and","untagged"],"title":"TagMatch"},"TagUsageColor":{"properties":{"key":{"type":"string","title":"Key"},"hex_bg":{"type":"string","title":"Hex Bg"},"hex_text":{"type":"string","title":"Hex Text"}},"type":"object","required":["key","hex_bg","hex_text"],"title":"TagUsageColor"},"TagWithUsage":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"color":{"$ref":"#/components/schemas/TagColor"},"count":{"type":"integer","title":"Count"},"auto_assigned":{"type":"boolean","title":"Auto Assigned"}},"type":"object","required":["id","name","color","count","auto_assigned"],"title":"TagWithUsage"},"TagsListResponse":{"properties":{"tags":{"items":{"$ref":"#/components/schemas/TagWithUsage"},"type":"array","title":"Tags"}},"type":"object","required":["tags"],"title":"TagsListResponse"},"TeamCreate":{"properties":{"name":{"type":"string","title":"Name"}},"type":"object","required":["name"],"title":"TeamCreate"},"TeamDomainsResponse":{"properties":{"data":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Data"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["data","count"],"title":"TeamDomainsResponse"},"ToggleDomainSharingRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"is_shareable":{"type":"boolean","title":"Is Shareable"}},"type":"object","required":["domain_id","is_shareable"],"title":"ToggleDomainSharingRequest","description":"Request model for toggling domain sharing."},"TopicNameMatch":{"properties":{"input_name":{"type":"string","title":"Input Name"},"existing_id":{"type":"string","title":"Existing Id"},"existing_name":{"type":"string","title":"Existing Name"}},"type":"object","required":["input_name","existing_id","existing_name"],"title":"TopicNameMatch"},"TopicPrompt":{"properties":{"id":{"type":"string","title":"Id"},"text":{"type":"string","title":"Text"},"tags":{"items":{"$ref":"#/components/schemas/TopicPromptTag"},"type":"array","title":"Tags","default":[]}},"type":"object","required":["id","text"],"title":"TopicPrompt"},"TopicPromptTag":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"color":{"$ref":"#/components/schemas/TagUsageColor"}},"type":"object","required":["id","name","color"],"title":"TopicPromptTag"},"TopicPromptTagSelectionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"topic_id":{"type":"string","title":"Topic Id"},"tag_id":{"type":"string","title":"Tag Id"},"tag_summary":{"anyOf":[{"$ref":"#/components/schemas/TopicTagSummary"},{"type":"null"}]}},"type":"object","required":["success","topic_id","tag_id"],"title":"TopicPromptTagSelectionResponse"},"TopicPromptTagsResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"topic_id":{"type":"string","title":"Topic Id"},"applied_add_tag_ids":{"items":{"type":"string"},"type":"array","title":"Applied Add Tag Ids"},"applied_remove_tag_ids":{"items":{"type":"string"},"type":"array","title":"Applied Remove Tag Ids"},"tag_summary":{"anyOf":[{"$ref":"#/components/schemas/TopicTagSummary"},{"type":"null"}]}},"type":"object","required":["success","topic_id","applied_add_tag_ids","applied_remove_tag_ids"],"title":"TopicPromptTagsResponse"},"TopicPromptsResponse":{"properties":{"topic_id":{"type":"string","title":"Topic Id"},"prompts":{"items":{"$ref":"#/components/schemas/TopicPrompt"},"type":"array","title":"Prompts"}},"type":"object","required":["topic_id","prompts"],"title":"TopicPromptsResponse"},"TopicQueriesResponse":{"properties":{"queries":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Queries"},"pagination":{"additionalProperties":true,"type":"object","title":"Pagination"},"topic_aggregates":{"additionalProperties":true,"type":"object","title":"Topic Aggregates"}},"type":"object","required":["queries","pagination","topic_aggregates"],"title":"TopicQueriesResponse"},"TopicQueryItem":{"properties":{"text":{"type":"string","title":"Text"},"estimated_search_volume":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Estimated Search Volume","default":0}},"type":"object","required":["text"],"title":"TopicQueryItem"},"TopicTagSummary":{"properties":{"tagged_count":{"type":"integer","title":"Tagged Count","default":0},"untagged_count":{"type":"integer","title":"Untagged Count","default":0},"tags":{"items":{"$ref":"#/components/schemas/TopicTagUsage"},"type":"array","title":"Tags","default":[]}},"type":"object","title":"TopicTagSummary"},"TopicTagSummaryResponse":{"properties":{"topic_id":{"type":"string","title":"Topic Id"},"tag_summary":{"$ref":"#/components/schemas/TopicTagSummary"}},"type":"object","required":["topic_id","tag_summary"],"title":"TopicTagSummaryResponse"},"TopicTagUsage":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"color":{"$ref":"#/components/schemas/TagUsageColor"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["id","name","color","count"],"title":"TopicTagUsage"},"TopicWithAggregates":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"query_count":{"type":"integer","title":"Query Count"},"analyzable_query_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Analyzable Query Count"},"avg_volume":{"type":"integer","title":"Avg Volume"},"avg_position":{"type":"number","title":"Avg Position"},"avg_sentiment":{"type":"integer","title":"Avg Sentiment"},"total_frequency":{"type":"integer","title":"Total Frequency"},"total_mentions":{"type":"integer","title":"Total Mentions"},"total_sources":{"type":"integer","title":"Total Sources"},"answers_count":{"type":"integer","title":"Answers Count","default":0},"citation_count":{"type":"integer","title":"Citation Count","default":0},"brand_citation_count":{"type":"integer","title":"Brand Citation Count","default":0},"avg_visibility":{"type":"number","title":"Avg Visibility"},"tag_summary":{"$ref":"#/components/schemas/TopicTagSummary","default":{"tagged_count":0,"untagged_count":0,"tags":[]}}},"type":"object","required":["id","name","query_count","avg_volume","avg_position","avg_sentiment","total_frequency","total_mentions","total_sources","avg_visibility"],"title":"TopicWithAggregates"},"TopicWithQueries":{"properties":{"topic":{"type":"string","title":"Topic"},"queries":{"items":{"$ref":"#/components/schemas/TopicQueryItem"},"type":"array","title":"Queries"}},"type":"object","required":["topic","queries"],"title":"TopicWithQueries"},"TopicsListResponse":{"properties":{"topics":{"items":{"$ref":"#/components/schemas/TopicWithAggregates"},"type":"array","title":"Topics"},"pagination":{"additionalProperties":true,"type":"object","title":"Pagination"}},"type":"object","required":["topics","pagination"],"title":"TopicsListResponse"},"TriggerAnalysisRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"type":"object","required":["domain_id"],"title":"TriggerAnalysisRequest"},"TriggerEngageEnrichmentRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"}},"additionalProperties":false,"type":"object","required":["domain_id"],"title":"TriggerEngageEnrichmentRequest"},"UiMessage":{"properties":{"role":{"type":"string","title":"Role"},"parts":{"items":{"$ref":"#/components/schemas/UiMessagePart"},"type":"array","title":"Parts"}},"type":"object","required":["role"],"title":"UiMessage"},"UiMessagePart":{"properties":{"type":{"type":"string","title":"Type"},"text":{"anyOf":[{"type":"string","maxLength":8000},{"type":"null"}],"title":"Text"},"url":{"anyOf":[{"type":"string","maxLength":7000000},{"type":"null"}],"title":"Url"},"mediaType":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Mediatype"},"filename":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Filename"}},"type":"object","required":["type"],"title":"UiMessagePart"},"UpdateCompetitor":{"properties":{"competitor_id":{"type":"string","title":"Competitor Id"},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active"},"is_dedicated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Dedicated"},"competitor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Competitor Name"},"competitor_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Competitor Domain"},"competitor_variations":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Competitor Variations"}},"type":"object","required":["competitor_id"],"title":"UpdateCompetitor"},"UpdateContentRequest":{"properties":{"article_id":{"type":"string","title":"Article Id"},"content":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Content"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"}},"type":"object","required":["article_id"],"title":"UpdateContentRequest"},"UpdateDomain":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"name":{"type":"string","title":"Name"},"website":{"type":"string","title":"Website"},"language":{"type":"string","title":"Language"},"country":{"type":"string","title":"Country"},"regions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Regions"},"states":{"items":{"type":"string"},"type":"array","title":"States","default":[]},"cities":{"items":{"type":"string"},"type":"array","title":"Cities","default":[]},"description":{"type":"string","title":"Description"},"target_market":{"type":"string","title":"Target Market"},"main_keyword":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Main Keyword"},"main_query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Main Query"},"enabled_models":{"items":{"type":"string"},"type":"array","title":"Enabled Models","default":[]},"marketing_objectives":{"type":"string","title":"Marketing Objectives"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"tone_of_voice":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tone Of Voice"},"point_of_view":{"anyOf":[{"type":"string","enum":["first_person","third_party",""]},{"type":"null"}],"title":"Point Of View"},"sitemap":{"type":"string","title":"Sitemap","default":""},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"variations":{"items":{"type":"string"},"type":"array","title":"Variations","default":[]},"authors":{"anyOf":[{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array"},{"type":"null"}],"title":"Authors"}},"type":"object","required":["domain_id","name","website","language","country","description","target_market","marketing_objectives"],"title":"UpdateDomain","description":"Request model for updating domain details."},"UpdateDomainSettingsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"analysis_frequency_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Analysis Frequency Days"},"enabled_models":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Enabled Models"},"extra_models":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Extra Models"}},"type":"object","required":["domain_id"],"title":"UpdateDomainSettingsRequest"},"UpdateEnabledModelsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"enabled_models":{"items":{"type":"string"},"type":"array","title":"Enabled Models"}},"type":"object","required":["domain_id","enabled_models"],"title":"UpdateEnabledModelsRequest"},"UpdateEngagementStatusRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"item_id":{"type":"string","title":"Item Id"},"status":{"type":"string","enum":["pending","done","dismissed"],"title":"Status"}},"additionalProperties":false,"type":"object","required":["domain_id","item_id","status"],"title":"UpdateEngagementStatusRequest"},"UpdateEngagementTemplateRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"template_id":{"type":"string","title":"Template Id"},"name":{"type":"string","title":"Name"},"content":{"type":"string","title":"Content"}},"additionalProperties":false,"type":"object","required":["domain_id","template_id","name","content"],"title":"UpdateEngagementTemplateRequest"},"UpdateMemberDomainAccess":{"properties":{"team_id":{"type":"string","title":"Team Id"},"member_user_id":{"type":"string","title":"Member User Id"},"allowed_domains":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Domains"}},"type":"object","required":["team_id","member_user_id"],"title":"UpdateMemberDomainAccess"},"UpdateMemberRole":{"properties":{"team_id":{"type":"string","title":"Team Id"},"member_user_id":{"type":"string","title":"Member User Id"},"role":{"type":"string","title":"Role"}},"type":"object","required":["team_id","member_user_id","role"],"title":"UpdateMemberRole"},"UpdateMemberRoleRequest":{"properties":{"team_id":{"type":"string","title":"Team Id"},"user_id":{"type":"string","title":"User Id"},"role":{"type":"string","title":"Role"}},"type":"object","required":["team_id","user_id","role"],"title":"UpdateMemberRoleRequest"},"UpdatePatternRequest":{"properties":{"id":{"type":"string","title":"Id"},"url_part":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url Part"},"page_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Type"},"rank_order":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank Order"}},"type":"object","required":["id"],"title":"UpdatePatternRequest","description":"Request model for updating a pattern"},"UpdatePickerPreferences":{"properties":{"preferences":{"$ref":"#/components/schemas/PickerPreferences"}},"type":"object","required":["preferences"],"title":"UpdatePickerPreferences"},"UpdatePlanRequest":{"properties":{"team_id":{"type":"string","title":"Team Id"},"subscription_tier":{"type":"string","title":"Subscription Tier"},"subscription_until":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscription Until"},"use_plan_defaults":{"type":"boolean","title":"Use Plan Defaults","default":true},"remaining_prompts":{"anyOf":[{"type":"integer","maximum":32767.0,"minimum":0.0},{"type":"null"}],"title":"Remaining Prompts"},"remaining_blogs":{"anyOf":[{"type":"integer","maximum":32767.0,"minimum":0.0},{"type":"null"}],"title":"Remaining Blogs"},"remaining_keywords":{"anyOf":[{"type":"integer","maximum":32767.0,"minimum":0.0},{"type":"null"}],"title":"Remaining Keywords"},"remaining_analyses":{"anyOf":[{"type":"integer","maximum":32767.0,"minimum":0.0},{"type":"null"}],"title":"Remaining Analyses"},"remaining_domains":{"anyOf":[{"type":"integer","maximum":32767.0,"minimum":0.0},{"type":"null"}],"title":"Remaining Domains"},"remaining_pitch_brands":{"anyOf":[{"type":"integer","maximum":32767.0,"minimum":0.0},{"type":"null"}],"title":"Remaining Pitch Brands"},"allowed_models":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Models"}},"type":"object","required":["team_id","subscription_tier"],"title":"UpdatePlanRequest"},"UpdatePromptTags":{"properties":{"query_id":{"type":"string","title":"Query Id"},"domain_id":{"type":"string","title":"Domain Id"},"tag_ids":{"items":{"type":"string"},"type":"array","title":"Tag Ids","default":[]}},"type":"object","required":["query_id","domain_id"],"title":"UpdatePromptTags"},"UpdatePromptTopic":{"properties":{"query_id":{"type":"string","title":"Query Id"},"topic_ids":{"items":{"type":"string"},"type":"array","title":"Topic Ids"}},"type":"object","required":["query_id","topic_ids"],"title":"UpdatePromptTopic"},"UpdatePromptsTags":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"query_ids":{"items":{"type":"string"},"type":"array","title":"Query Ids","default":[]},"topic_ids":{"items":{"type":"string"},"type":"array","title":"Topic Ids","default":[]},"all_analyzable":{"type":"boolean","title":"All Analyzable","default":false},"include_untopiced":{"type":"boolean","title":"Include Untopiced","default":false},"prompt_filter":{"anyOf":[{"$ref":"#/components/schemas/PromptFilter"},{"type":"null"}]},"add_tag_ids":{"items":{"type":"string"},"type":"array","title":"Add Tag Ids","default":[]},"remove_tag_ids":{"items":{"type":"string"},"type":"array","title":"Remove Tag Ids","default":[]}},"type":"object","required":["domain_id"],"title":"UpdatePromptsTags"},"UpdateRecommendationActionStatusRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"item_type":{"type":"string","enum":["engage","mentioned"],"title":"Item Type"},"item_key":{"type":"string","title":"Item Key"},"status":{"type":"string","enum":["pending","done","dismissed"],"title":"Status"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subtitle"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"source_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Domain"},"topics_covered":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Topics Covered"},"prompts_covered":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Prompts Covered"},"frequency":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Frequency"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["domain_id","item_type","item_key","status"],"title":"UpdateRecommendationActionStatusRequest"},"UpdateRecommendationItemStatusRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"item_id":{"type":"string","title":"Item Id"},"status":{"type":"string","enum":["pending","done","dismissed"],"title":"Status"}},"type":"object","required":["domain_id","item_id","status"],"title":"UpdateRecommendationItemStatusRequest"},"UpdateRecommendedMentionNoteRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"item_id":{"type":"string","title":"Item Id"},"note":{"type":"string","title":"Note"}},"type":"object","required":["domain_id","item_id","note"],"title":"UpdateRecommendedMentionNoteRequest"},"UpdateSentimentModelsRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"sentiment_models":{"items":{"type":"string"},"type":"array","title":"Sentiment Models"}},"type":"object","required":["domain_id","sentiment_models"],"title":"UpdateSentimentModelsRequest"},"UpdateTag":{"properties":{"tag_id":{"type":"string","title":"Tag Id"},"domain_id":{"type":"string","title":"Domain Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"color_id":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Color Id"}},"type":"object","required":["tag_id","domain_id"],"title":"UpdateTag"},"UpdateTeamConfig":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"company_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Type"},"company_size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Size"},"how_found_us":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"How Found Us"},"team_creation_unlocked":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Team Creation Unlocked"},"agency_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agency Domain"},"clients_to_track":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Clients To Track"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"phone_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone Number"}},"type":"object","title":"UpdateTeamConfig"},"UpdateTeamCreatedAtRequest":{"properties":{"team_id":{"type":"string","title":"Team Id"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["team_id","created_at"],"title":"UpdateTeamCreatedAtRequest"},"UpdateTopic":{"properties":{"topic_id":{"type":"string","title":"Topic Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"query_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Query Ids"}},"type":"object","required":["topic_id"],"title":"UpdateTopic"},"UpdateTopicPromptTagSelection":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"topic_id":{"type":"string","title":"Topic Id"},"tag_id":{"type":"string","title":"Tag Id"},"add_query_ids":{"items":{"type":"string"},"type":"array","title":"Add Query Ids","default":[]},"remove_query_ids":{"items":{"type":"string"},"type":"array","title":"Remove Query Ids","default":[]}},"type":"object","required":["domain_id","topic_id","tag_id"],"title":"UpdateTopicPromptTagSelection"},"UpdateTopicPromptTags":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"topic_id":{"type":"string","title":"Topic Id"},"add_tag_ids":{"items":{"type":"string"},"type":"array","title":"Add Tag Ids","default":[]},"remove_tag_ids":{"items":{"type":"string"},"type":"array","title":"Remove Tag Ids","default":[]}},"type":"object","required":["domain_id","topic_id"],"title":"UpdateTopicPromptTags"},"UrlLookupRequest":{"properties":{"url":{"type":"string","title":"Url"}},"type":"object","required":["url"],"title":"UrlLookupRequest"},"UrlLookupResponse":{"properties":{"url":{"type":"string","title":"Url"},"found":{"type":"boolean","title":"Found"},"citation_count":{"type":"integer","title":"Citation Count","default":0},"models_breakdown":{"additionalProperties":{"type":"integer"},"type":"object","title":"Models Breakdown","default":{}},"page_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Type"},"page_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Title"},"first_seen":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Seen"},"last_seen":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Seen"},"prompts":{"items":{"type":"string"},"type":"array","title":"Prompts","default":[]},"fanout_queries":{"items":{"type":"string"},"type":"array","title":"Fanout Queries","default":[]},"competitors":{"items":{"type":"string"},"type":"array","title":"Competitors","default":[]},"avg_position":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Position"},"domains_citing_count":{"type":"integer","title":"Domains Citing Count","default":0}},"type":"object","required":["url","found"],"title":"UrlLookupResponse"},"UserDomainsResponse":{"properties":{"data":{"additionalProperties":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"type":"object","title":"Data"},"total_domain_count":{"type":"integer","title":"Total Domain Count"}},"type":"object","required":["data","total_domain_count"],"title":"UserDomainsResponse"},"V1AddPrompts":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"prompts":{"items":{"$ref":"#/components/schemas/BulkQueryItem"},"type":"array","maxItems":100,"minItems":1,"title":"Prompts"}},"type":"object","required":["domain_id","prompts"],"title":"V1AddPrompts"},"V1ArchivePrompts":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"prompt_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":100,"minItems":1,"title":"Prompt Ids"}},"type":"object","required":["domain_id","prompt_ids"],"title":"V1ArchivePrompts"},"V1CreateTag":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"name":{"type":"string","title":"Name"},"color_id":{"type":"string","minLength":1,"title":"Color Id","default":"slate"}},"type":"object","required":["domain_id","name"],"title":"V1CreateTag"},"V1CreateTopic":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","required":["domain_id","name"],"title":"V1CreateTopic"},"V1DeleteCompetitor":{"properties":{"competitor_id":{"type":"string","format":"uuid","title":"Competitor Id"}},"type":"object","required":["competitor_id"],"title":"V1DeleteCompetitor"},"V1DeleteDomain":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"confirmation_name":{"type":"string","title":"Confirmation Name"}},"type":"object","required":["domain_id","confirmation_name"],"title":"V1DeleteDomain"},"V1SetPromptTags":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"prompt_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":100,"minItems":1,"title":"Prompt Ids"},"add_tag_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Add Tag Ids","default":[]},"remove_tag_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Remove Tag Ids","default":[]}},"type":"object","required":["domain_id","prompt_ids"],"title":"V1SetPromptTags"},"V1SetPromptTopics":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"prompt_id":{"type":"string","format":"uuid","title":"Prompt Id"},"topic_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Topic Ids"}},"type":"object","required":["domain_id","prompt_id","topic_ids"],"title":"V1SetPromptTopics"},"V1UpdateCompetitor":{"properties":{"competitor_id":{"type":"string","format":"uuid","title":"Competitor Id"},"competitor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Competitor Name"},"competitor_variations":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Competitor Variations"},"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active"},"is_dedicated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Dedicated"}},"type":"object","required":["competitor_id"],"title":"V1UpdateCompetitor"},"V1UpdatePrompt":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"prompt_id":{"type":"string","format":"uuid","title":"Prompt Id"},"text":{"type":"string","title":"Text"},"topic_ids":{"anyOf":[{"items":{"type":"string","format":"uuid"},"type":"array"},{"type":"null"}],"title":"Topic Ids"},"add_tag_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Add Tag Ids","default":[]},"remove_tag_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Remove Tag Ids","default":[]}},"type":"object","required":["domain_id","prompt_id","text"],"title":"V1UpdatePrompt"},"ValidateSitemapRequest":{"properties":{"domain_id":{"type":"string","title":"Domain Id"},"sitemap":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sitemap"}},"type":"object","required":["domain_id"],"title":"ValidateSitemapRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}