{"openapi":"3.1.0","info":{"title":"GPT Backend API","version":"0.1.0"},"paths":{"/api/auth/status":{"get":{"tags":["auth"],"summary":"Check Registration Status","description":"Check user registration status.\nReturns whether user is authenticated and registered.\n\n``pending_shopify_install`` tells an unfinished registration that this\nbrowser holds a live Shopify install claim, so the register page chooses\nthe Shopify branch from server state rather than client storage.","operationId":"check_registration_status_api_auth_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/auth/registration/touch":{"post":{"tags":["auth"],"summary":"Touch Registration Lead","description":"Capture signed-in Clerk identities before ToS/account details are submitted.\n\nThis does not create a product user record; `/register/init` remains the\nonly self-serve path that creates `users`.","operationId":"touch_registration_lead_api_auth_registration_touch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistrationTouchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistrationTouchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/auth/register/init":{"post":{"tags":["auth"],"summary":"Register Init","description":"Initialize registration by creating the user and organization after ToS acceptance.\n\n- Validates ToS and allowlist\n- If allowlisted: creates User + Organization + default CompanyProfile + credits\n- Sets registration_data.status = 'account_created'\n- Returns { user_id, organization_id, on_waitlist }\n\nIdempotent: if already created (phase account_created), returns existing IDs.\nIf already complete, 409.\n\nA browser holding a live Shopify install claim, or an identity created for\na Shopify install, is refused with a structured 409 before any Stripe\norganization exists; Shopify owns billing for those merchants.","operationId":"register_init_api_auth_register_init_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistrationFormData"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/auth/register/shopify":{"post":{"tags":["auth"],"summary":"Register Shopify User","description":"Create only the Pomo identity for a verified Shopify-origin install.\n\nThe normal registration endpoint deliberately creates a Stripe organization\nand enters Stripe checkout. A Shopify merchant must never cross that\nboundary. This endpoint is gated by the browser-bound Shopify claim, records\nthe same account details and Terms acceptance, and leaves organization and\nprofile creation to the atomic Shopify resolve path.\n\nAn existing identity whose registration is unfinished (typically a Stripe\n``register/init`` that never paid) is moved onto the Shopify path; one whose\nStripe payment has begun is refused with ``stripe_registration_billing_started``.\nA completed registration is left untouched. The response reports the\nresulting ``registration_type`` and ``registration_complete`` so the client\ncontinues to Shopify only on the server's confirmation.","operationId":"register_shopify_user_api_auth_register_shopify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShopifyRegistrationFormData"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistrationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/auth/register/finalize":{"post":{"tags":["auth"],"summary":"Register Finalize","description":"Finalize registration after plan selection/payment.\n\nSets registration_data.status = 'complete' and records selected_plan.\nIdempotent: if already complete, returns success.","operationId":"register_finalize_api_auth_register_finalize_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinalizeRegistrationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/auth/invitation-session":{"get":{"tags":["auth"],"summary":"Get Invitation Session","operationId":"get_invitation_session_api_auth_invitation_session_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InvitationInfoResponse"},{"type":"null"}],"title":"Response Get Invitation Session Api Auth Invitation Session Get"}}}}}},"post":{"tags":["auth"],"summary":"Start Invitation Session","operationId":"start_invitation_session_api_auth_invitation_session_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartInvitationSessionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitationInfoResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["auth"],"summary":"Cancel Invitation Session","operationId":"cancel_invitation_session_api_auth_invitation_session_delete","responses":{"204":{"description":"Successful Response"}}}},"/api/auth/invitation-session/accept":{"post":{"tags":["auth"],"summary":"Accept Invitation Session","operationId":"accept_invitation_session_api_auth_invitation_session_accept_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptInvitationSessionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptInvitationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/auth/invitation":{"get":{"tags":["auth"],"summary":"Get Invitation Info From Query","description":"Query-parameter variant for invitation preview.\nUseful when clients/proxies alter path-style tokens.","operationId":"get_invitation_info_from_query_api_auth_invitation_get","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","minLength":1,"title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitationInfoResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/invitation/{invite_token}":{"get":{"tags":["auth"],"summary":"Get Invitation Info","description":"Preview invitation details before accepting.\nCan be called by authenticated or unauthenticated users.","operationId":"get_invitation_info_api_auth_invitation__invite_token__get","parameters":[{"name":"invite_token","in":"path","required":true,"schema":{"type":"string","title":"Invite Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitationInfoResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/auth/accept-invitation":{"post":{"tags":["auth"],"summary":"Accept Invitation","description":"Accept an organization invitation.\nHandles both new users and existing users joining additional organizations.\n\nFlow:\n- Validates ToS acceptance\n- Validates invite token\n- If user exists:\n    - ACTIVE users: Join organization as MEMBER (no credits)\n    - SUSPENDED/DELETED users: Error\n- If user doesn't exist:\n    - Check allowlist → waitlist if not allowed\n    - Create user + join organization as MEMBER + allocate credits","operationId":"accept_invitation_api_auth_accept_invitation_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptInvitationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptInvitationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/auth/register":{"post":{"tags":["auth"],"summary":"Register User","description":"Register NEW users creating their own organization.\nFor accepting invitations, use /accept-invitation endpoint instead.\n\nFlow:\n- Validates ToS acceptance\n- Checks if user already exists → error if yes\n- Validates email allowlist → waitlist if not allowed\n- Creates user + new organization (as OWNER) + company profile\n- Allocates initial credits to organization","operationId":"register_user_api_auth_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistrationFormData"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistrationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/auth/me":{"get":{"tags":["auth"],"summary":"Get User Profile","description":"Get current user profile (requires registration and verification).","operationId":"get_user_profile_api_auth_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/auth/update-profile":{"post":{"tags":["auth"],"summary":"Update User Profile","description":"Update the current user's profile information.","operationId":"update_user_profile_api_auth_update_profile_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/User"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/auth/logout":{"post":{"tags":["auth"],"summary":"Logout","description":"Clear the user context.\nNote: Clerk handles token invalidation on the client side.","operationId":"logout_api_auth_logout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/auth/health":{"get":{"tags":["auth"],"summary":"Health Check","description":"Check if auth service is healthy.","operationId":"health_check_api_auth_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/legal/tos/latest":{"get":{"tags":["legal"],"summary":"Get Latest Terms Of Service","description":"Return latest ToS content, version, and server-computed hash.\n\nThe response includes an ETag header equal to the hash for caching/integrity.","operationId":"get_latest_terms_of_service_api_legal_tos_latest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/chat/files/{file_id}/share":{"post":{"tags":["chat"],"summary":"Share Chat File","description":"Share a chat-uploaded file to the gallery/documents.\n\nWhen a file is shared, it becomes visible in the company's document library\nand can be accessed by the get_company_documents MCP tool.","operationId":"share_chat_file_api_chat_files__file_id__share_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"File Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareFileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["chat"],"summary":"Unshare File","description":"Remove a file from the Knowledge Base (stop sharing).\n\nThe file is kept but no longer visible in the shared document library.\nOnly the owner can unshare their files.","operationId":"unshare_file_api_chat_files__file_id__share_delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"File Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareFileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/chat/files/{file_id}":{"delete":{"tags":["chat"],"summary":"Delete File","description":"Permanently delete a file.\n\nThis removes the file from GCS storage and the database entirely.\nOnly the file owner can delete the file.","operationId":"delete_file_api_chat_files__file_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"File Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteFileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/chat/shared-files":{"get":{"tags":["chat"],"summary":"Get Shared Files","description":"Get list of files for the current company profile (Knowledge Base).\n\nReturns:\n- All shared files (is_shared=True) - visible to everyone\n- Owner's legacy unbound files - only visible to the owner\n\nConversation-private chat attachments remain accessible only through their\nscoped conversation handles; they never enter this profile-wide library.","operationId":"get_shared_files_api_chat_shared_files_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SharedFilesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/chat/knowledge-base/upload":{"post":{"tags":["chat"],"summary":"Upload To Knowledge Base","description":"Upload files directly to the Knowledge Base.\n\nFiles are stored in company_analysis_files with is_shared=True,\nmaking them immediately available in the Knowledge Base tab.\nSummaries are extracted for discoverability.","operationId":"upload_to_knowledge_base_api_chat_knowledge_base_upload_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_to_knowledge_base_api_chat_knowledge_base_upload_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeBaseUploadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/lead-form-capabilities":{"get":{"tags":["campaigns"],"summary":"Lead Form Capabilities","description":"Return the backend-owned exact-platform lead-form capability registry.","operationId":"lead_form_capabilities_api_campaigns_lead_form_capabilities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object","title":"Response Lead Form Capabilities Api Campaigns Lead Form Capabilities Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/external/sync":{"post":{"tags":["campaigns"],"summary":"Sync External Campaigns","description":"Sync external Google, Meta, TikTok, LinkedIn, or ChatGPT campaigns for the active profile.\n\nCampaign identity and daily metrics are fetched at campaign level without\nfiltering native ad types. Provider-specific hydration may add richer media\n(for example, Google Performance Max asset groups), but an unknown type is\nstill persisted and renderable through the generic document contract. The\ndefault bounded mode never infers remote deletion; callers must explicitly\nrequest an exhaustive inventory before missing documents are retired.\n\nProviders are independent: a refused one is returned with\n``status=\"failed\"`` and its reason beside the ones that completed. The\nrequest itself fails only when no requested provider could be read.","operationId":"sync_external_campaigns_api_campaigns_external_sync_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalCampaignSyncRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalCampaignSyncResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/external/{platform}/{remote_campaign_id}":{"get":{"tags":["campaigns"],"summary":"Get External Campaign Document","description":"Return one imported campaign, strictly scoped to the active profile.","operationId":"get_external_campaign_document_api_campaigns_external__platform___remote_campaign_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"platform","in":"path","required":true,"schema":{"enum":["google","meta","tiktok","linkedin","chatgpt"],"type":"string","title":"Platform"}},{"name":"remote_campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Remote Campaign Id"}},{"name":"document_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Document Id"}},{"name":"account_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get External Campaign Document Api Campaigns External  Platform   Remote Campaign Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["campaigns"],"summary":"Patch External Campaign Document","description":"Mutate allowlisted provider fields and return verified provider readback.","operationId":"patch_external_campaign_document_api_campaigns_external__platform___remote_campaign_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"platform","in":"path","required":true,"schema":{"enum":["google","meta","tiktok"],"type":"string","title":"Platform"}},{"name":"remote_campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Remote Campaign Id"}},{"name":"document_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Document Id"}},{"name":"account_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalCampaignPatchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Patch External Campaign Document Api Campaigns External  Platform   Remote Campaign Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/external-media/{document_id}/{media_key}":{"get":{"tags":["campaigns"],"summary":"Get External Campaign Media","description":"Proxy one provider media asset after profile-scoped validation.","operationId":"get_external_campaign_media_api_campaigns_external_media__document_id___media_key__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Document Id"}},{"name":"media_key","in":"path","required":true,"schema":{"type":"string","title":"Media Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/external/{platform}/{remote_campaign_id}/sync":{"post":{"tags":["campaigns"],"summary":"Sync External Campaign Document","description":"Synchronize one exact provider campaign for safe mutation recovery.","operationId":"sync_external_campaign_document_api_campaigns_external__platform___remote_campaign_id__sync_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"platform","in":"path","required":true,"schema":{"enum":["google","meta","tiktok"],"type":"string","title":"Platform"}},{"name":"remote_campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Remote Campaign Id"}},{"name":"document_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Document Id"}},{"name":"account_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Sync External Campaign Document Api Campaigns External  Platform   Remote Campaign Id  Sync Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/optimization-activity":{"get":{"tags":["campaigns"],"summary":"Get Optimization Activity","description":"AI-team activity (history) for the active company profile.\n\nSourced from the execution layer (``AgentTeamAction``), so stage reflects\nwhat actually happened: ``executed`` only when the action genuinely ran;\n``approved`` actions are reported as approved/queued, not applied. Pass\n``stage`` (``executed``/``approved``/``declined``/``failed``) to filter. A\nmeasured performance outcome is reported only when one really exists.","operationId":"get_optimization_activity_api_campaigns_optimization_activity_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"stage","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stage"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiTeamActivityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/optimization-summary":{"get":{"tags":["campaigns"],"summary":"Get Optimization Summary","description":"Per-campaign AI-team activity rollup for the active profile.\n\nOne row per public campaign id the team has acted on, so the Campaigns\ndashboard can surface \"AI team · N optimizations\" (with a measured outcome\nwhen one exists) directly on the matching card. Fetched once per profile and\nmerged client-side by campaign id; kept independent of the dashboard bundle\nso an activity-query hiccup never blanks the campaign list.","operationId":"get_optimization_summary_api_campaigns_optimization_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignOptimizationSummaryResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/{campaign_public_id}/optimizations/rollback":{"post":{"tags":["campaigns"],"summary":"Rollback Campaign Optimizations","operationId":"rollback_campaign_optimizations_api_campaigns__campaign_public_id__optimizations_rollback_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_public_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Public Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignOptimizationRollbackRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignOptimizationRollbackResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/{campaign_public_id}/optimizations/{action_id}/rollback":{"post":{"tags":["campaigns"],"summary":"Rollback Campaign Optimization","description":"Reverse one provider-executed optimization from its captured prior values.\n\nThis is an authenticated, user-confirmed provider mutation—not a database\nrewind. The source action stays immutable. Dates and automatic activation\nare excluded, newer overlapping changes block the rollback, and the normal\nexternal mutation service enforces provider constraints plus readback.","operationId":"rollback_campaign_optimization_api_campaigns__campaign_public_id__optimizations__action_id__rollback_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_public_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Public Id"}},{"name":"action_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Action Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignOptimizationRollbackResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/{campaign_public_id}/optimization-activity":{"get":{"tags":["campaigns"],"summary":"Get Campaign Optimization Activity","description":"The AI-team activity ledger scoped to a single campaign.\n\n``campaign_public_id`` is the public id the dashboard exposes on each card\n(``ads_<hash>`` / ``social_<hash>`` / ``batch_<hash>_<platform>``). Same\nhonest, execution-sourced contract as the profile-wide ledger, filtered to\nactions that target this campaign.","operationId":"get_campaign_optimization_activity_api_campaigns__campaign_public_id__optimization_activity_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_public_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Public Id"}},{"name":"stage","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stage"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiTeamActivityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/{campaign_public_id}/optimization-activity/{action_id}":{"get":{"tags":["campaigns"],"summary":"Get Campaign Optimization Activity Action","description":"Return the exact applied action behind a history or measurement link.","operationId":"get_campaign_optimization_activity_action_api_campaigns__campaign_public_id__optimization_activity__action_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_public_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Public Id"}},{"name":"action_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Action Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiTeamActivityItem"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/{campaign_public_id}/perf-history":{"get":{"tags":["campaigns"],"summary":"Get Campaign Perf History","description":"Daily headline-metric trend + optimization markers for one campaign, for the\nexpanded-row chart that backs the strip's DoD/WoW tags and \"+N% vs before\". Computed\nlive from the raw platform daily metrics; empty for a campaign with no paid analytics.","operationId":"get_campaign_perf_history_api_campaigns__campaign_public_id__perf_history_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_public_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Public Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignPerfHistoryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/email/edit-image":{"post":{"tags":["campaigns","Email Campaigns"],"summary":"Edit Campaign Image","description":"Edit a campaign supporting image based on user instructions.\nThe edited image will be added as a new image for the same campaign.\nOnly supporting images can be edited (not banner images).\n\nThe user provides a text description of the changes they want, and the\nAI will generate an edited version of the image based on those instructions.","operationId":"edit_campaign_image_api_campaigns_email_edit_image_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_edit_campaign_image_api_campaigns_email_edit_image_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/email/delete-image":{"delete":{"tags":["campaigns","Email Campaigns"],"summary":"Delete Campaign Image","description":"Delete a campaign supporting image.\nOnly the user who created the campaign can delete images associated with it.\n\nQuery parameters:\n- campaign_id: Campaign ID of the image to delete\n- idea_number: Campaign idea number\n- image_url: URL of the image to delete","operationId":"delete_campaign_image_api_campaigns_email_delete_image_delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"query","required":true,"schema":{"type":"string","title":"Campaign Id"}},{"name":"idea_number","in":"query","required":true,"schema":{"type":"integer","title":"Idea Number"}},{"name":"image_url","in":"query","required":true,"schema":{"type":"string","title":"Image Url"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/email/upload-image":{"post":{"tags":["campaigns","Email Campaigns"],"summary":"Upload Email Campaign Image General","description":"Upload a new image for an email campaign and update database records.\nThis endpoint is used for manual image uploads for email campaigns.\nIt replaces the general upload-image endpoint previously in campaigns_general.py.","operationId":"upload_email_campaign_image_general_api_campaigns_email_upload_image_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_email_campaign_image_general_api_campaigns_email_upload_image_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/email/upload-campaign-image":{"post":{"tags":["campaigns","Email Campaigns"],"summary":"Upload Campaign Image","description":"Upload a new campaign image and update database records.\nThis endpoint is used for manual image edits instead of replacing an existing image.\n\nArgs:\n    file: The image file to upload\n    campaign_id: Campaign ID\n    idea_number: Campaign idea number\n    image_type: Type of image (defaults to EMAIL_IMAGE)\n    current_user: The authenticated user\n    db: Database session\n\nReturns:\n    JSON response with the result including new image URL","operationId":"upload_campaign_image_api_campaigns_email_upload_campaign_image_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_campaign_image_api_campaigns_email_upload_campaign_image_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/email/upload-campaign-images":{"post":{"tags":["campaigns","Email Campaigns"],"summary":"Upload Campaign Images","description":"Upload campaign images (up to 15) and update database records.\nThis endpoint allows batch uploading of images for a specific campaign idea.\n\nArgs:\n    files: List of image files to upload (max 15)\n    campaign_id: Campaign ID\n    idea_number: Campaign idea number\n    image_type: Type of image (defaults to EMAIL_IMAGE)\n    current_user: The authenticated user\n    db: Database session\n\nReturns:\n    JSON response with the result including new image URLs","operationId":"upload_campaign_images_api_campaigns_email_upload_campaign_images_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_campaign_images_api_campaigns_email_upload_campaign_images_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/email":{"get":{"tags":["campaigns","Email Campaigns"],"summary":"Fetch All Email Campaigns","description":"Fetch all email campaigns for the current user, including the generated email images.\nSupport pagination with page and limit parameters.","operationId":"fetch_all_email_campaigns_api_campaigns_email_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Fetch All Email Campaigns Api Campaigns Email Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["campaigns","Email Campaigns"],"summary":"Create Email Campaign","description":"Create a new email campaign using the dedicated EmailCampaign model.\nThis endpoint provides a direct REST API method for creating campaigns\ninstead of using the workflow approach.","operationId":"create_email_campaign_api_campaigns_email_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailCampaignCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailCampaignResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/email/{campaign_id}":{"delete":{"tags":["campaigns","Email Campaigns"],"summary":"Delete Email Campaign","description":"Delete an entire email campaign (all ideas) and related resources.\nThis will remove the EmailCampaign models and related resources.","operationId":"delete_email_campaign_api_campaigns_email__campaign_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/email/{campaign_id}/idea/{idea_number}":{"delete":{"tags":["campaigns","Email Campaigns"],"summary":"Delete Email Campaign Idea","description":"Delete a specific idea from an email campaign.\nThis will remove the idea and all associated images from the database.\nHandles both the new EmailCampaign model and the legacy Campaign model.","operationId":"delete_email_campaign_idea_api_campaigns_email__campaign_id__idea__idea_number__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}},{"name":"idea_number","in":"path","required":true,"schema":{"type":"integer","title":"Idea Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/email/count":{"get":{"tags":["campaigns","Email Campaigns"],"summary":"Get Email Campaigns Count","description":"Get the count of email campaigns for the current user.\nThis counts campaigns in the new EmailCampaign model.","operationId":"get_email_campaigns_count_api_campaigns_email_count_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/email/associate-consumer-group":{"post":{"tags":["campaigns","Email Campaigns"],"summary":"Associate Consumer Group With Email Campaign","description":"Associate a consumer group with an email campaign.","operationId":"associate_consumer_group_with_email_campaign_api_campaigns_email_associate_consumer_group_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/email/list-associated-consumer-groups/{campaign_id}/{idea_number}":{"get":{"tags":["campaigns","Email Campaigns"],"summary":"List Associated Consumer Groups","description":"List all consumer groups associated with an email campaign idea.","operationId":"list_associated_consumer_groups_api_campaigns_email_list_associated_consumer_groups__campaign_id___idea_number__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}},{"name":"idea_number","in":"path","required":true,"schema":{"type":"integer","title":"Idea Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/email/remove-consumer-group-association/{association_id}":{"delete":{"tags":["campaigns","Email Campaigns"],"summary":"Remove Consumer Group Association","description":"Remove an association between a consumer group and an email campaign.","operationId":"remove_consumer_group_association_api_campaigns_email_remove_consumer_group_association__association_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"association_id","in":"path","required":true,"schema":{"type":"integer","title":"Association Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/email/{email_campaign_id}/image":{"post":{"tags":["campaigns","Email Campaigns"],"summary":"Add Email Campaign Image","description":"Add a new image to an existing email campaign using the EmailCampaignImage model.\nThe email_campaign_id refers to the ID of the EmailCampaign record.","operationId":"add_email_campaign_image_api_campaigns_email__email_campaign_id__image_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"email_campaign_id","in":"path","required":true,"schema":{"type":"integer","title":"Email Campaign Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailCampaignImageCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/social-post/direct-edit-social-post":{"post":{"tags":["campaigns","Social Post Campaigns"],"summary":"Direct Edit Social Post","description":"Directly edit a social post's content without AI assistance.\nThis endpoint allows direct updates to a social post's name, caption, hashtags and other fields for the current company profile.","operationId":"direct_edit_social_post_api_campaigns_social_post_direct_edit_social_post_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_direct_edit_social_post_api_campaigns_social_post_direct_edit_social_post_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/social-post/delete-social-post":{"delete":{"tags":["campaigns","Social Post Campaigns"],"summary":"Delete Social Post","description":"Delete a social media post.\nOnly the current company profile who created the post can delete it.\nThe post will be removed from the database and chat message metadata.\nAny associated images will also be deleted from the database.\n\nQuery parameters:\n- campaign_id: Campaign ID of the post to delete\n- idea_number: Post idea number","operationId":"delete_social_post_api_campaigns_social_post_delete_social_post_delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"query","required":true,"schema":{"type":"string","title":"Campaign Id"}},{"name":"idea_number","in":"query","required":true,"schema":{"type":"integer","title":"Idea Number"}},{"name":"variation","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Variation"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/social-post/edit-social-post-image":{"post":{"tags":["campaigns","Social Post Campaigns"],"summary":"Edit Social Post Image","description":"Edits a specific social post image using AI, updates GCS and campaign meta_data for the current company profile.\nAlso updates the corresponding chat message metadata.","operationId":"edit_social_post_image_api_campaigns_social_post_edit_social_post_image_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_edit_social_post_image_api_campaigns_social_post_edit_social_post_image_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/social-post/upload-social-post-image":{"post":{"tags":["campaigns","Social Post Campaigns"],"summary":"Upload Social Post Image","description":"Upload an image for a social post campaign and update database records for the current company profile.\nThis is used for initial creation of campaigns or updating existing ones.\n\nParameters:\n- file: The image file to upload\n- campaign_id: ID of the campaign\n- idea_number: Idea number of the campaign\n- current_image_url: URL of the current image (used for lookup when replace is True)\n- replace: If True, replace existing image; if False, append as a new image","operationId":"upload_social_post_image_api_campaigns_social_post_upload_social_post_image_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_social_post_image_api_campaigns_social_post_upload_social_post_image_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/social-post/social-post-campaigns":{"get":{"tags":["campaigns","Social Post Campaigns"],"summary":"Fetch All Social Post Campaigns","description":"Fetch all social post campaigns for the current company profile.\n\nThis endpoint retrieves all the social post campaigns created by the current company profile,\nsupporting pagination and the option to include variations.\n\nQuery parameters:\n- page: The page number (0-indexed) for pagination\n- limit: The number of items per page\n- include_variations: Whether to include variations of the original posts\n\nReturns a list of campaigns with their associated images, metadata, and posting status information,\nalong with pagination information.","operationId":"fetch_all_social_post_campaigns_api_campaigns_social_post_social_post_campaigns_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"}},{"name":"include_variations","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Variations"}},{"name":"campaign_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"If provided, only campaigns matching this campaign_id are returned","title":"Campaign Id"},"description":"If provided, only campaigns matching this campaign_id are returned"},{"name":"platform_scope","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional social platform family filter","title":"Platform Scope"},"description":"Optional social platform family filter"},{"name":"status_filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional normalized social status filter","title":"Status Filter"},"description":"Optional normalized social status filter"},{"name":"source_filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional creation source filter","title":"Source Filter"},"description":"Optional creation source filter"},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional search text","title":"Search"},"description":"Optional search text"},{"name":"dashboard_mode","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Dashboard Mode"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/social-post/social-post-campaign/{campaign_id}":{"delete":{"tags":["campaigns","Social Post Campaigns"],"summary":"Delete Social Post Campaign","description":"Delete an entire social post campaign for the current company profile.\nThis will remove the campaign and all associated images from the database.","operationId":"delete_social_post_campaign_api_campaigns_social_post_social_post_campaign__campaign_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/social-post/social-post-campaign/{campaign_id}/idea/{idea_number}":{"delete":{"tags":["campaigns","Social Post Campaigns"],"summary":"Delete Social Post Campaign Idea","description":"Delete a specific idea from a social post campaign for the current company profile.\nThis will remove the idea and all associated images from the database.\nIf this was the last idea in the campaign, the entire campaign will be removed.","operationId":"delete_social_post_campaign_idea_api_campaigns_social_post_social_post_campaign__campaign_id__idea__idea_number__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}},{"name":"idea_number","in":"path","required":true,"schema":{"type":"integer","title":"Idea Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/social-post/social-post-campaigns-count":{"get":{"tags":["campaigns","Social Post Campaigns"],"summary":"Get Social Post Campaigns Count","description":"Get the count of social post campaigns for the current company profile.\nReturns the total number of social post campaigns owned by the company profile.","operationId":"get_social_post_campaigns_count_api_campaigns_social_post_social_post_campaigns_count_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/social-post/{campaign_id}/{idea_number}/posts":{"get":{"tags":["campaigns","Social Post Campaigns"],"summary":"Get Campaign Posts","description":"Get posts for a specific campaign idea for the current company profile, optionally filtered by platform and variation.","operationId":"get_campaign_posts_api_campaigns_social_post__campaign_id___idea_number__posts_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}},{"name":"idea_number","in":"path","required":true,"schema":{"type":"integer","title":"Idea Number"}},{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"}},{"name":"variation","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Variation"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignPostsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/social-post":{"post":{"tags":["campaigns","Social Post Campaigns"],"summary":"Create Social Post Campaign","description":"Create a new social post campaign using the dedicated SocialPostCampaign model for the current company profile.\nThis endpoint provides a direct REST API method for creating campaigns\ninstead of using the workflow approach.","operationId":"create_social_post_campaign_api_campaigns_social_post_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialPostCampaignCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialPostCampaignResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/social-post/schedule/preflight":{"post":{"tags":["campaigns","Social Post Campaigns"],"summary":"Preflight Social Post Schedule","operationId":"preflight_social_post_schedule_api_campaigns_social_post_schedule_preflight_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialScheduleUpsertRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/social-post/schedule":{"post":{"tags":["campaigns","Social Post Campaigns"],"summary":"Upsert Social Post Schedule","operationId":"upsert_social_post_schedule_api_campaigns_social_post_schedule_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialScheduleUpsertRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/social-post/schedule/{campaign_id}/{idea_number}/{variation}":{"get":{"tags":["campaigns","Social Post Campaigns"],"summary":"Get Social Post Schedule","operationId":"get_social_post_schedule_api_campaigns_social_post_schedule__campaign_id___idea_number___variation__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}},{"name":"idea_number","in":"path","required":true,"schema":{"type":"integer","title":"Idea Number"}},{"name":"variation","in":"path","required":true,"schema":{"type":"integer","title":"Variation"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/social-post/publication-verification/{campaign_id}/{idea_number}/{variation}/resolve":{"post":{"tags":["campaigns","Social Post Campaigns"],"summary":"Resolve Social Publication Verification","description":"Resolve a provider outcome that was deliberately blocked as unknown.","operationId":"resolve_social_publication_verification_api_campaigns_social_post_publication_verification__campaign_id___idea_number___variation__resolve_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}},{"name":"idea_number","in":"path","required":true,"schema":{"type":"integer","title":"Idea Number"}},{"name":"variation","in":"path","required":true,"schema":{"type":"integer","title":"Variation"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialPublicationVerificationResolutionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/social-post/schedule/{schedule_id}":{"delete":{"tags":["campaigns","Social Post Campaigns"],"summary":"Cancel Social Post Schedule","operationId":"cancel_social_post_schedule_api_campaigns_social_post_schedule__schedule_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"schedule_id","in":"path","required":true,"schema":{"type":"string","title":"Schedule Id"}},{"name":"expected_state_token","in":"query","required":true,"schema":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[0-9a-f]{64}$","description":"Opaque release-state token captured when the cancellation was reviewed. It prevents a stale confirmation from cancelling a newer schedule.","title":"Expected State Token"},"description":"Opaque release-state token captured when the cancellation was reviewed. It prevents a stale confirmation from cancelling a newer schedule."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/social-post/calendar-published-activities":{"get":{"tags":["campaigns","Social Post Campaigns"],"summary":"List Social Published Calendar Activities","description":"List confirmed publications, including posts published immediately.","operationId":"list_social_published_calendar_activities_api_campaigns_social_post_calendar_published_activities_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"published_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Published From"}},{"name":"published_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Published To"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/social-post/list-schedules":{"get":{"tags":["campaigns","Social Post Campaigns"],"summary":"List Social Post Schedules","operationId":"list_social_post_schedules_api_campaigns_social_post_list_schedules_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"scheduled_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scheduled From"}},{"name":"scheduled_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scheduled To"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/social-post/schedule/dispatch-due":{"post":{"tags":["campaigns","Social Post Campaigns"],"summary":"Dispatch Due Social Post Schedules For Company","operationId":"dispatch_due_social_post_schedules_for_company_api_campaigns_social_post_schedule_dispatch_due_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/social-post/schedule-campaign/{campaign_id}/{idea_number}":{"post":{"tags":["campaigns","Social Post Campaigns"],"summary":"Schedule Social Post Campaign","operationId":"schedule_social_post_campaign_api_campaigns_social_post_schedule_campaign__campaign_id___idea_number__post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}},{"name":"idea_number","in":"path","required":true,"schema":{"type":"integer","title":"Idea Number"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Schedule Data"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/social-post/campaign-schedule/{campaign_id}/{idea_number}":{"get":{"tags":["campaigns","Social Post Campaigns"],"summary":"Get Social Post Campaign Schedule","operationId":"get_social_post_campaign_schedule_api_campaigns_social_post_campaign_schedule__campaign_id___idea_number__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}},{"name":"idea_number","in":"path","required":true,"schema":{"type":"integer","title":"Idea Number"}},{"name":"variation","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Variation"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/social-post/cancel-schedule/{schedule_id}":{"delete":{"tags":["campaigns","Social Post Campaigns"],"summary":"Cancel Social Post Campaign Schedule","operationId":"cancel_social_post_campaign_schedule_api_campaigns_social_post_cancel_schedule__schedule_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"schedule_id","in":"path","required":true,"schema":{"type":"string","title":"Schedule Id"}},{"name":"expected_state_token","in":"query","required":true,"schema":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[0-9a-f]{64}$","title":"Expected State Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/social-post/posts/{post_id}/media/{media_id}/preview":{"get":{"tags":["campaigns","Social Post Media"],"summary":"Preview Social Media","operationId":"preview_social_media_api_campaigns_social_post_posts__post_id__media__media_id__preview_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"post_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Post Id"}},{"name":"media_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Media Id"}},{"name":"expected_creative_state_token","in":"query","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Expected Creative State Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/social-post/posts/{post_id}/media/{media_id}/playback":{"get":{"tags":["campaigns","Social Post Media"],"summary":"Social Video Playback","operationId":"social_video_playback_api_campaigns_social_post_posts__post_id__media__media_id__playback_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"post_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Post Id"}},{"name":"media_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Media Id"}},{"name":"expected_creative_state_token","in":"query","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Expected Creative State Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/google-display/create":{"post":{"tags":["campaigns","Online Ad Campaigns"],"summary":"Create Google Display Campaign","description":"Create a Google Display ad campaign with optional reference images","operationId":"create_google_display_campaign_api_campaigns_online_ads_google_display_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/schemas__campaigns__ads__google__GoogleDisplayAdRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/google-search/create":{"post":{"tags":["campaigns","Online Ad Campaigns"],"summary":"Create Google Search Campaign","description":"Create a Google Search ad campaign","operationId":"create_google_search_campaign_api_campaigns_online_ads_google_search_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleSearchAdRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/meta-feed/create":{"post":{"tags":["campaigns","Online Ad Campaigns"],"summary":"Create Meta Feed Campaign","description":"Create a Meta Feed ad campaign with optional reference images","operationId":"create_meta_feed_campaign_api_campaigns_online_ads_meta_feed_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaFeedAdRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/meta-stories-reels/create":{"post":{"tags":["campaigns","Online Ad Campaigns"],"summary":"Create Meta Stories Reels Campaign","description":"Create a Meta Stories & Reels ad campaign","operationId":"create_meta_stories_reels_campaign_api_campaigns_online_ads_meta_stories_reels_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaStoriesReelsAdRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/amazon-sponsored-products/create":{"post":{"tags":["campaigns","Online Ad Campaigns"],"summary":"Create Amazon Sponsored Products Campaign","description":"Create an Amazon Sponsored Products ad campaign","operationId":"create_amazon_sponsored_products_campaign_api_campaigns_online_ads_amazon_sponsored_products_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AmazonSponsoredProductsAdRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/amazon-sponsored-brands/create":{"post":{"tags":["campaigns","Online Ad Campaigns"],"summary":"Create Amazon Sponsored Brands Campaign","description":"Create an Amazon Sponsored Brands ad campaign with optional reference images","operationId":"create_amazon_sponsored_brands_campaign_api_campaigns_online_ads_amazon_sponsored_brands_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AmazonSponsoredBrandsAdRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/amazon-sponsored-display/create":{"post":{"tags":["campaigns","Online Ad Campaigns"],"summary":"Create Amazon Sponsored Display Campaign","description":"Create an Amazon Sponsored Display ad campaign with optional reference images","operationId":"create_amazon_sponsored_display_campaign_api_campaigns_online_ads_amazon_sponsored_display_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AmazonSponsoredDisplayAdRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/tiktok/create":{"post":{"tags":["campaigns","Online Ad Campaigns"],"summary":"Create Tiktok Campaign","description":"Create a TikTok Single Image ad campaign","operationId":"create_tiktok_campaign_api_campaigns_online_ads_tiktok_create_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseAdsCampaignRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/lead-forms/draft-copy":{"post":{"tags":["campaigns","Online Ad Campaigns","lead_form_draft_copy"],"summary":"Draft Lead Form Copy","operationId":"draft_lead_form_copy_api_campaigns_online_ads_lead_forms_draft_copy_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadFormDraftCopyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeadFormDraftCopyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/google-search-campaigns":{"get":{"tags":["campaigns","Online Ad Campaigns","google_search_campaigns"],"summary":"Get Google Search Campaigns","operationId":"get_google_search_campaigns_api_campaigns_online_ads_google_search_campaigns_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"}},{"name":"campaign_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id"}},{"name":"ad_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/google-search-campaign/{campaign_id}":{"get":{"tags":["campaigns","Online Ad Campaigns","google_search_campaigns"],"summary":"Get Google Search Campaign","operationId":"get_google_search_campaign_api_campaigns_online_ads_google_search_campaign__campaign_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/google-search/update-campaign":{"put":{"tags":["campaigns","Online Ad Campaigns","google_search_campaigns"],"summary":"Update Google Search Campaign","operationId":"update_google_search_campaign_api_campaigns_online_ads_google_search_update_campaign_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleSearchCampaignUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsCampaignUpdateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/google-search/generate-variation/{ad_id}":{"post":{"tags":["campaigns","Online Ad Campaigns","google_search_campaigns"],"summary":"Generate Google Search Variation","operationId":"generate_google_search_variation_api_campaigns_online_ads_google_search_generate_variation__ad_id__post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ad_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/google-display-campaigns":{"get":{"tags":["campaigns","Online Ad Campaigns","google_display_campaigns"],"summary":"Get Google Display Campaigns","operationId":"get_google_display_campaigns_api_campaigns_online_ads_google_display_campaigns_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"}},{"name":"campaign_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id"}},{"name":"ad_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/google-display-campaign/{campaign_id}":{"get":{"tags":["campaigns","Online Ad Campaigns","google_display_campaigns"],"summary":"Get Google Display Campaign","operationId":"get_google_display_campaign_api_campaigns_online_ads_google_display_campaign__campaign_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/google-display/update-campaign":{"put":{"tags":["campaigns","Online Ad Campaigns","google_display_campaigns"],"summary":"Update Google Display Campaign","operationId":"update_google_display_campaign_api_campaigns_online_ads_google_display_update_campaign_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsCampaignUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsCampaignUpdateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/google-display/generate-variation/{ad_id}":{"post":{"tags":["campaigns","Online Ad Campaigns","google_display_campaigns"],"summary":"Generate Google Display Variation","operationId":"generate_google_display_variation_api_campaigns_online_ads_google_display_generate_variation__ad_id__post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ad_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/google-display/edit-image":{"post":{"tags":["campaigns","Online Ad Campaigns","google_display_campaigns"],"summary":"Edit Google Display Image","operationId":"edit_google_display_image_api_campaigns_online_ads_google_display_edit_image_post","responses":{"410":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/google-display/upload-image":{"post":{"tags":["campaigns","Online Ad Campaigns","google_display_campaigns"],"summary":"Upload Google Display Image","operationId":"upload_google_display_image_api_campaigns_online_ads_google_display_upload_image_post","responses":{"410":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/google-video":{"post":{"tags":["campaigns","Online Ad Campaigns","Google Video Ads"],"summary":"Create Google Video Ad Campaign","operationId":"create_google_video_ad_campaign_api_campaigns_online_ads_google_video_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleVideoAdRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["campaigns","Online Ad Campaigns","Google Video Ads"],"summary":"Get Google Video Campaigns","operationId":"get_google_video_campaigns_api_campaigns_online_ads_google_video_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"}},{"name":"campaign_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id"}},{"name":"ad_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/google-video/all":{"get":{"tags":["campaigns","Online Ad Campaigns","Google Video Ads"],"summary":"Get Google Video Ad Campaigns","operationId":"get_google_video_ad_campaigns_api_campaigns_online_ads_google_video_all_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/google-video/{ad_id}":{"get":{"tags":["campaigns","Online Ad Campaigns","Google Video Ads"],"summary":"Get Google Video Ad Campaign","operationId":"get_google_video_ad_campaign_api_campaigns_online_ads_google_video__ad_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ad_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/google-video/campaign/{campaign_id}":{"delete":{"tags":["campaigns","Online Ad Campaigns","Google Video Ads"],"summary":"Delete Google Video Ad Campaign","operationId":"delete_google_video_ad_campaign_api_campaigns_online_ads_google_video_campaign__campaign_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/google-video/generate-variation/{ad_id}":{"post":{"tags":["campaigns","Online Ad Campaigns","Google Video Ads"],"summary":"Create Google Video Ad Variation","operationId":"create_google_video_ad_variation_api_campaigns_online_ads_google_video_generate_variation__ad_id__post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ad_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/google-video/update-campaign":{"put":{"tags":["campaigns","Online Ad Campaigns","Google Video Ads"],"summary":"Update Google Video Ad Campaign","operationId":"update_google_video_ad_campaign_api_campaigns_online_ads_google_video_update_campaign_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsCampaignUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/meta-stories-reels-campaigns":{"get":{"tags":["campaigns","Online Ad Campaigns","meta_stories_reels_campaigns"],"summary":"Get Meta Stories Reels Campaigns","operationId":"get_meta_stories_reels_campaigns_api_campaigns_online_ads_meta_stories_reels_campaigns_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"}},{"name":"campaign_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id"}},{"name":"ad_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/meta-stories-reels-campaign/{campaign_id}":{"get":{"tags":["campaigns","Online Ad Campaigns","meta_stories_reels_campaigns"],"summary":"Get Meta Stories Reels Campaign","operationId":"get_meta_stories_reels_campaign_api_campaigns_online_ads_meta_stories_reels_campaign__campaign_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/meta-stories-reels/create-campaign":{"post":{"tags":["campaigns","Online Ad Campaigns","meta_stories_reels_campaigns"],"summary":"Create Meta Stories Reels Campaign","operationId":"create_meta_stories_reels_campaign_api_campaigns_online_ads_meta_stories_reels_create_campaign_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_description","in":"query","required":true,"schema":{"type":"string","title":"Product Description"}},{"name":"target_audience","in":"query","required":true,"schema":{"type":"string","title":"Target Audience"}},{"name":"key_selling_points","in":"query","required":false,"schema":{"type":"string","default":"","title":"Key Selling Points"}},{"name":"num_ads","in":"query","required":false,"schema":{"type":"integer","default":3,"title":"Num Ads"}},{"name":"num_images_per_ad","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Num Images Per Ad"}},{"name":"video_length","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Video Length"}},{"name":"bid_strategy","in":"query","required":false,"schema":{"type":"string","default":"automatic","title":"Bid Strategy"}},{"name":"budget_range","in":"query","required":false,"schema":{"type":"string","default":"medium","title":"Budget Range"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"}},{"name":"state_province","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province"}},{"name":"city","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"}},{"name":"locations","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locations"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Campaign Goals"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/meta-stories-reels/update-campaign":{"put":{"tags":["campaigns","Online Ad Campaigns","meta_stories_reels_campaigns"],"summary":"Update Meta Stories Reels Campaign","operationId":"update_meta_stories_reels_campaign_api_campaigns_online_ads_meta_stories_reels_update_campaign_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaStoriesReelsCampaignUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsCampaignUpdateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/meta-stories-reels/launch":{"post":{"tags":["campaigns","Online Ad Campaigns","meta_stories_reels_campaigns"],"summary":"Launch Meta Stories Reels Campaign","operationId":"launch_meta_stories_reels_campaign_api_campaigns_online_ads_meta_stories_reels_launch_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Request"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/meta-feed-campaigns":{"get":{"tags":["campaigns","Online Ad Campaigns","meta_feed_campaigns"],"summary":"Get Meta Feed Campaigns","operationId":"get_meta_feed_campaigns_api_campaigns_online_ads_meta_feed_campaigns_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"}},{"name":"campaign_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id"}},{"name":"ad_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/meta-feed-campaign/{campaign_id}":{"get":{"tags":["campaigns","Online Ad Campaigns","meta_feed_campaigns"],"summary":"Get Meta Feed Campaign","operationId":"get_meta_feed_campaign_api_campaigns_online_ads_meta_feed_campaign__campaign_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/meta-feed/create-campaign":{"post":{"tags":["campaigns","Online Ad Campaigns","meta_feed_campaigns"],"summary":"Create Meta Feed Campaign","operationId":"create_meta_feed_campaign_api_campaigns_online_ads_meta_feed_create_campaign_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_description","in":"query","required":true,"schema":{"type":"string","title":"Product Description"}},{"name":"target_audience","in":"query","required":true,"schema":{"type":"string","title":"Target Audience"}},{"name":"key_selling_points","in":"query","required":false,"schema":{"type":"string","default":"","title":"Key Selling Points"}},{"name":"num_ads","in":"query","required":false,"schema":{"type":"integer","default":3,"title":"Num Ads"}},{"name":"num_images_per_ad","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Num Images Per Ad"}},{"name":"video_length","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Video Length"}},{"name":"bid_strategy","in":"query","required":false,"schema":{"type":"string","default":"automatic","title":"Bid Strategy"}},{"name":"budget_range","in":"query","required":false,"schema":{"type":"string","default":"medium","title":"Budget Range"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"}},{"name":"state_province","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province"}},{"name":"city","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"}},{"name":"locations","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locations"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Campaign Goals"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/meta-feed/update-campaign":{"put":{"tags":["campaigns","Online Ad Campaigns","meta_feed_campaigns"],"summary":"Update Meta Feed Campaign","operationId":"update_meta_feed_campaign_api_campaigns_online_ads_meta_feed_update_campaign_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaFeedCampaignUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsCampaignUpdateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/meta-feed/edit-image":{"post":{"tags":["campaigns","Online Ad Campaigns","meta_feed_campaigns"],"summary":"Edit Meta Feed Image","operationId":"edit_meta_feed_image_api_campaigns_online_ads_meta_feed_edit_image_post","responses":{"410":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/meta-feed/upload-image":{"post":{"tags":["campaigns","Online Ad Campaigns","meta_feed_campaigns"],"summary":"Upload Meta Feed Image","operationId":"upload_meta_feed_image_api_campaigns_online_ads_meta_feed_upload_image_post","responses":{"410":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/meta-feed/launch":{"post":{"tags":["campaigns","Online Ad Campaigns","meta_feed_campaigns"],"summary":"Launch Meta Feed Campaign","operationId":"launch_meta_feed_campaign_api_campaigns_online_ads_meta_feed_launch_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Request"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/linkedin-image-campaigns":{"get":{"tags":["campaigns","Online Ad Campaigns","linkedin_image_campaigns"],"summary":"Get Linkedin Image Campaigns","operationId":"get_linkedin_image_campaigns_api_campaigns_online_ads_linkedin_image_campaigns_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"}},{"name":"campaign_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id"}},{"name":"ad_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/linkedin-image/{campaign_id}":{"get":{"tags":["campaigns","Online Ad Campaigns","linkedin_image_campaigns"],"summary":"Get Linkedin Image Campaign","operationId":"get_linkedin_image_campaign_api_campaigns_online_ads_linkedin_image__campaign_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/linkedin-image-campaign/{campaign_id}":{"get":{"tags":["campaigns","Online Ad Campaigns","linkedin_image_campaigns"],"summary":"Get Linkedin Image Campaign","operationId":"get_linkedin_image_campaign_api_campaigns_online_ads_linkedin_image_campaign__campaign_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/linkedin-image/update-campaign":{"put":{"tags":["campaigns","Online Ad Campaigns","linkedin_image_campaigns"],"summary":"Update Linkedin Image Campaign","operationId":"update_linkedin_image_campaign_api_campaigns_online_ads_linkedin_image_update_campaign_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsCampaignUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsCampaignUpdateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/linkedin-video-campaigns":{"get":{"tags":["campaigns","Online Ad Campaigns","linkedin_video_campaigns"],"summary":"Get Linkedin Video Campaigns","operationId":"get_linkedin_video_campaigns_api_campaigns_online_ads_linkedin_video_campaigns_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"}},{"name":"campaign_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id"}},{"name":"ad_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/linkedin-video/{campaign_id}":{"get":{"tags":["campaigns","Online Ad Campaigns","linkedin_video_campaigns"],"summary":"Get Linkedin Video Campaign","operationId":"get_linkedin_video_campaign_api_campaigns_online_ads_linkedin_video__campaign_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/linkedin-video-campaign/{campaign_id}":{"get":{"tags":["campaigns","Online Ad Campaigns","linkedin_video_campaigns"],"summary":"Get Linkedin Video Campaign","operationId":"get_linkedin_video_campaign_api_campaigns_online_ads_linkedin_video_campaign__campaign_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/linkedin-video/update-campaign":{"put":{"tags":["campaigns","Online Ad Campaigns","linkedin_video_campaigns"],"summary":"Update Linkedin Video Campaign","operationId":"update_linkedin_video_campaign_api_campaigns_online_ads_linkedin_video_update_campaign_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsCampaignUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsCampaignUpdateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/tiktok-video":{"post":{"tags":["campaigns","Online Ad Campaigns","TikTok Video Ads"],"summary":"Create Tiktok Video Ad Campaign","operationId":"create_tiktok_video_ad_campaign_api_campaigns_online_ads_tiktok_video_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TikTokVideoAdRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["campaigns","Online Ad Campaigns","TikTok Video Ads"],"summary":"Get Tiktok Video Campaigns","operationId":"get_tiktok_video_campaigns_api_campaigns_online_ads_tiktok_video_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"}},{"name":"campaign_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id"}},{"name":"ad_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/tiktok-video/all":{"get":{"tags":["campaigns","Online Ad Campaigns","TikTok Video Ads"],"summary":"Get Tiktok Video Ad Campaigns","operationId":"get_tiktok_video_ad_campaigns_api_campaigns_online_ads_tiktok_video_all_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/tiktok-video/call-to-actions":{"get":{"tags":["campaigns","Online Ad Campaigns","TikTok Video Ads"],"summary":"Get Tiktok Video Call To Actions","operationId":"get_tiktok_video_call_to_actions_api_campaigns_online_ads_tiktok_video_call_to_actions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/campaigns/online-ads/tiktok-video/{campaign_id}":{"get":{"tags":["campaigns","Online Ad Campaigns","TikTok Video Ads"],"summary":"Get Tiktok Video Ad Campaign","operationId":"get_tiktok_video_ad_campaign_api_campaigns_online_ads_tiktok_video__campaign_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/tiktok-video/campaign/{campaign_id}":{"delete":{"tags":["campaigns","Online Ad Campaigns","TikTok Video Ads"],"summary":"Delete Tiktok Video Ad Campaign","operationId":"delete_tiktok_video_ad_campaign_api_campaigns_online_ads_tiktok_video_campaign__campaign_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/tiktok-video/update-campaign":{"put":{"tags":["campaigns","Online Ad Campaigns","TikTok Video Ads"],"summary":"Update Tiktok Video Ad Campaign","operationId":"update_tiktok_video_ad_campaign_api_campaigns_online_ads_tiktok_video_update_campaign_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsCampaignUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/chatgpt-chat-card-campaigns":{"get":{"tags":["campaigns","Online Ad Campaigns","chatgpt_chat_card_campaigns"],"summary":"Get Chatgpt Chat Card Campaigns","operationId":"get_chatgpt_chat_card_campaigns_api_campaigns_online_ads_chatgpt_chat_card_campaigns_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"}},{"name":"campaign_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id"}},{"name":"ad_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/chatgpt-chat-card/{campaign_id}":{"get":{"tags":["campaigns","Online Ad Campaigns","chatgpt_chat_card_campaigns"],"summary":"Get Chatgpt Chat Card Campaign","operationId":"get_chatgpt_chat_card_campaign_api_campaigns_online_ads_chatgpt_chat_card__campaign_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/chatgpt-chat-card-campaign/{campaign_id}":{"get":{"tags":["campaigns","Online Ad Campaigns","chatgpt_chat_card_campaigns"],"summary":"Get Chatgpt Chat Card Campaign","operationId":"get_chatgpt_chat_card_campaign_api_campaigns_online_ads_chatgpt_chat_card_campaign__campaign_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/chatgpt-chat-card/update-campaign":{"put":{"tags":["campaigns","Online Ad Campaigns","chatgpt_chat_card_campaigns"],"summary":"Update Chatgpt Chat Card Campaign","operationId":"update_chatgpt_chat_card_campaign_api_campaigns_online_ads_chatgpt_chat_card_update_campaign_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsCampaignUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsCampaignUpdateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/landing-page-suggestions":{"get":{"tags":["campaigns","Online Ad Campaigns"],"summary":"Get Landing Page Suggestions","description":"Known first-party pages a person may pick as this saved ad's destination.\n\nComputed on demand from the profile's links and the campaign's product, so\nevery existing draft gets them. Suggestions only: nothing here is written\nto the ad, and generation still leaves the destination for the person.","operationId":"get_landing_page_suggestions_api_campaigns_online_ads_landing_page_suggestions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"platform_type","in":"query","required":true,"schema":{"type":"string","title":"Platform Type"}},{"name":"ad_id","in":"query","required":true,"schema":{"type":"string","title":"Ad Id"}},{"name":"campaign_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/online-ads/generate-variation":{"post":{"tags":["campaigns","Online Ad Campaigns"],"summary":"Generate Ad Variation","description":"Generate a new variation of an existing ad campaign.\n\nArgs:\n    request: Variation request data\n    company_profile: Authenticated company profile\n    db: Database session\n\nReturns:\n    Structured response with campaign metadata and variation data","operationId":"generate_ad_variation_api_campaigns_online_ads_generate_variation_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateAdVariationRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/all-campaigns/count":{"get":{"tags":["campaigns","Online Ad Campaigns"],"summary":"Get All Online Ads Campaigns Count","description":"Get the total count of all online ad campaigns across all platforms for the current company profile.\nReturns the total number of ad campaigns from Google Search, Google Display, Google Video, and Meta platforms.","operationId":"get_all_online_ads_campaigns_count_api_campaigns_online_ads_all_campaigns_count_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/online-ads/top-level":{"get":{"tags":["campaigns","Online Ad Campaigns"],"summary":"Get Top Level Entities","description":"Return both A/B Groups and ungrouped campaigns for the management page.\n- Groups: all groups for the company (optionally filtered by ads_channel/status)\n- Campaigns: normalized platform ads that are NOT members of any group (optionally filtered by ads_channel)","operationId":"get_top_level_entities_api_campaigns_online_ads_top_level_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ads_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ads Type"}},{"name":"status_filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Filter"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/images/edit-image/job":{"post":{"tags":["campaigns","Campaign Images"],"summary":"Start Campaign Image Edit Job","description":"Start an asynchronous job to generate edited image variations for a campaign asset.","operationId":"start_campaign_image_edit_job_api_campaigns_images_edit_image_job_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditImageJobRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/images/edit-image/request/{request_identity}/cancel":{"post":{"tags":["campaigns","Campaign Images"],"summary":"Cancel Campaign Image Edit Request","operationId":"cancel_campaign_image_edit_request_api_campaigns_images_edit_image_request__request_identity__cancel_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"request_identity","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Request Identity"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/images/select-image":{"post":{"tags":["campaigns","Campaign Images"],"summary":"Select Campaign Image","description":"Select an image variation for a campaign\n\nThis endpoint allows users to choose one of the generated image variations\nand update their campaign with the selected image.","operationId":"select_campaign_image_api_campaigns_images_select_image_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageSelectionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageSelectionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/images/select-video":{"post":{"tags":["campaigns","Campaign Images"],"summary":"Select Campaign Video","description":"Select a replacement video for a normalized ad campaign.\n\nUser uploads are first saved to the gallery, then this endpoint links that\ncompany-owned video URL to the campaign creative.","operationId":"select_campaign_video_api_campaigns_images_select_video_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoSelectionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoSelectionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/images/batch-select-images":{"post":{"tags":["campaigns","Campaign Images"],"summary":"Batch Select Campaign Images","description":"Select images for multiple campaigns in batch\n\nThis is useful when updating multiple ad variations or campaigns\nwith different selected images at once.","operationId":"batch_select_campaign_images_api_campaigns_images_batch_select_images_post","requestBody":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ImageSelectionRequest"},"type":"array","title":"Requests"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ImageSelectionResponse"},"type":"array","title":"Response Batch Select Campaign Images Api Campaigns Images Batch Select Images Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/images/campaign/{campaign_type}/{campaign_id}/image-history":{"get":{"tags":["campaigns","Campaign Images"],"summary":"Get Campaign Image History","description":"Get the image history for a campaign\n\nThis can be extended to track all image changes over time","operationId":"get_campaign_image_history_api_campaigns_images_campaign__campaign_type___campaign_id__image_history_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_type","in":"path","required":true,"schema":{"type":"string","title":"Campaign Type"}},{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/video-editor/validate-text":{"post":{"tags":["campaigns","Campaign Video Editor"],"summary":"Validate Campaign Video Text","operationId":"validate_campaign_video_text_api_campaigns_video_editor_validate_text_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoTextValidationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoTextValidationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/video-editor/source":{"post":{"tags":["campaigns","Campaign Video Editor"],"summary":"Resolve Video Source","operationId":"resolve_video_source_api_campaigns_video_editor_source_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveVideoSourceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryImageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/video-editor/replacement":{"post":{"tags":["campaigns","Campaign Video Editor"],"summary":"Upload Campaign Video Replacement","operationId":"upload_campaign_video_replacement_api_campaigns_video_editor_replacement_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_campaign_video_replacement_api_campaigns_video_editor_replacement_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryImageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/video-editor/manual-render/job":{"post":{"tags":["campaigns","Campaign Video Editor"],"summary":"Start Manual Campaign Video Render","description":"Queue a manual render.\n\nThe manifest and overlay are validated here so bad input fails immediately\nwith a 400 the editor can show inline, rather than becoming a job that fails\nminutes later. The render itself runs in the worker because it can outlast\nboth the load balancer's idle timeout and the browser's request timeout.","operationId":"start_manual_campaign_video_render_api_campaigns_video_editor_manual_render_job_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_start_manual_campaign_video_render_api_campaigns_video_editor_manual_render_job_post"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/video-editor/gemini-edit/job":{"post":{"tags":["campaigns","Campaign Video Editor"],"summary":"Start Gemini Campaign Video Edit","operationId":"start_gemini_campaign_video_edit_api_campaigns_video_editor_gemini_edit_job_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GeminiVideoEditRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/video-editor/captions/job":{"post":{"tags":["campaigns","Campaign Video Editor"],"summary":"Start Campaign Video Caption Job","description":"Automatic captions are English-only; typed captions accept any language.","operationId":"start_campaign_video_caption_job_api_campaigns_video_editor_captions_job_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoCaptionRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/video-editor/request/{request_identity}/cancel":{"post":{"tags":["campaigns","Campaign Video Editor"],"summary":"Cancel Campaign Video Editor Request","operationId":"cancel_campaign_video_editor_request_api_campaigns_video_editor_request__request_identity__cancel_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"request_identity","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Request Identity"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoRequestCancellationRequest"}}}},"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/budget-estimate":{"post":{"tags":["campaigns","Budget Estimate"],"summary":"Budget Estimate","description":"Generate a budget estimate for campaign scope settings.","operationId":"budget_estimate_api_campaigns_budget_estimate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetEstimateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetEstimateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/paid-review/{ad_id}/media/{rendition_id}":{"get":{"tags":["campaigns","Paid Campaign Media"],"summary":"Preview Paid Media","operationId":"preview_paid_media_api_campaigns_paid_review__ad_id__media__rendition_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ad_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ad Id"}},{"name":"rendition_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Rendition Id"}},{"name":"generation","in":"query","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"title":"Generation"}},{"name":"state","in":"query","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"State"}},{"name":"job","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Job"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/paid-review/{ad_id}/gallery/{gallery_id}":{"get":{"tags":["campaigns","Paid Campaign Media"],"summary":"Preview Paid Logo","operationId":"preview_paid_logo_api_campaigns_paid_review__ad_id__gallery__gallery_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ad_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ad Id"}},{"name":"gallery_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Gallery Id"}},{"name":"generation","in":"query","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"title":"Generation"}},{"name":"state","in":"query","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"State"}},{"name":"source","in":"query","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Source"}},{"name":"job","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Job"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/paid-review/{ad_id}/media/{rendition_id}/playback":{"get":{"tags":["campaigns","Paid Campaign Media"],"summary":"Paid Video Playback","operationId":"paid_video_playback_api_campaigns_paid_review__ad_id__media__rendition_id__playback_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ad_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ad Id"}},{"name":"rendition_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Rendition Id"}},{"name":"generation","in":"query","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"title":"Generation"}},{"name":"state","in":"query","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"State"}},{"name":"job","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Job"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/deletion/{campaign_kind}/{campaign_id}":{"delete":{"tags":["campaigns","Campaign Deletion"],"summary":"Delete Campaign Draft","description":"Remove a draft from the workspace (soft delete).\n\n204 on success and on a repeat request for an already-deleted campaign.\n404 when the campaign is not in this company profile. 409 with a stable\n``code`` when the campaign is no longer eligible.","operationId":"delete_campaign_draft_api_campaigns_deletion__campaign_kind___campaign_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_kind","in":"path","required":true,"schema":{"$ref":"#/components/schemas/CampaignKind"}},{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}},{"name":"idea_number","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Idea Number"}},{"name":"variation","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Variation"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/deletion/{campaign_kind}/bulk":{"post":{"tags":["campaigns","Campaign Deletion"],"summary":"Delete Campaign Drafts","description":"Remove up to 200 drafts, one committed delete per target.\n\nAlways 200 once the request validates: each target reports its own\noutcome, so a blocked or missing row never fails the rest.","operationId":"delete_campaign_drafts_api_campaigns_deletion__campaign_kind__bulk_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_kind","in":"path","required":true,"schema":{"$ref":"#/components/schemas/CampaignKind"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignDeletionTargetsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkCampaignDeletionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/deletion/{campaign_kind}/restore":{"post":{"tags":["campaigns","Campaign Deletion"],"summary":"Restore Campaign Drafts","description":"Bring removed drafts back.\n\nNot reachable from the UI. Any content writer on the profile may call it\n(the same gate as removal: it undoes a soft delete in their own\nworkspace), which is how an operator brings a removal back. A\n``user_requested`` tombstone is restorable for as long as it exists.\n\nLike the bulk delete, each target commits on its own and reports its own\noutcome: one that fails unexpectedly is logged and answered ``error``\nwhile the rest are still tried, so an earlier restore is never hidden\nbehind a 500.","operationId":"restore_campaign_drafts_api_campaigns_deletion__campaign_kind__restore_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_kind","in":"path","required":true,"schema":{"$ref":"#/components/schemas/CampaignKind"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignDeletionTargetsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignRestoreResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/deletion/{campaign_kind}/ids":{"get":{"tags":["campaigns","Campaign Deletion"],"summary":"List Deletable Campaign Targets","description":"Every removable target under the dashboard's current filters.\n\nSame read gate and same filter semantics as ``/campaigns/dashboard``,\nso \"Select all N\" is the N the page shows minus the rows it cannot act\non. Newest first, capped at 5000; ``truncated`` says the cap was hit and\n``total`` is then a floor.","operationId":"list_deletable_campaign_targets_api_campaigns_deletion__campaign_kind__ids_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_kind","in":"path","required":true,"schema":{"$ref":"#/components/schemas/CampaignKind"}},{"name":"platform_scope","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform Scope"}},{"name":"status_filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Filter"}},{"name":"source_filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Filter"}},{"name":"search_query","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search Query"}},{"name":"campaign_type_filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Type Filter"}},{"name":"count_only","in":"query","required":false,"schema":{"type":"boolean","description":"Answer with the count alone; the band's number needs no targets.","default":false,"title":"Count Only"},"description":"Answer with the count alone; the band's number needs no targets."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignDeletableTargetsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/dayparting/campaigns/{campaign_id}/configure":{"post":{"tags":["campaigns","Dayparting","dayparting"],"summary":"Configure Campaign Dayparting","operationId":"configure_campaign_dayparting_api_campaigns_dayparting_campaigns__campaign_id__configure_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignDaypartingRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/dayparting/campaigns/{campaign_id}/status":{"get":{"tags":["campaigns","Dayparting","dayparting"],"summary":"Get Dayparting Status","operationId":"get_dayparting_status_api_campaigns_dayparting_campaigns__campaign_id__status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/dayparting/campaigns/{campaign_id}/disable":{"delete":{"tags":["campaigns","Dayparting","dayparting"],"summary":"Disable Dayparting","operationId":"disable_dayparting_api_campaigns_dayparting_campaigns__campaign_id__disable_delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/dayparting/meta/{ad_id}/health":{"get":{"tags":["campaigns","Dayparting","dayparting"],"summary":"Check Meta Rules Health","operationId":"check_meta_rules_health_api_campaigns_dayparting_meta__ad_id__health_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ad_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DaypartingHealthResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/dayparting/meta/{ad_id}/cleanup":{"delete":{"tags":["campaigns","Dayparting","dayparting"],"summary":"Cleanup Meta Rules","operationId":"cleanup_meta_rules_api_campaigns_dayparting_meta__ad_id__cleanup_delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ad_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/dayparting/performance/{campaign_id}":{"get":{"tags":["campaigns","Dayparting","dayparting"],"summary":"Get Dayparting Performance","operationId":"get_dayparting_performance_api_campaigns_dayparting_performance__campaign_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}},{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/geo/reverse-geocode":{"get":{"tags":["campaigns","Campaign Geo"],"summary":"Reverse Geocode Campaign Pin","description":"Resolve a map pin into postal/city/region fields for launch adapters.","operationId":"reverse_geocode_campaign_pin_api_campaigns_geo_reverse_geocode_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"latitude","in":"query","required":true,"schema":{"type":"number","maximum":90,"minimum":-90,"title":"Latitude"}},{"name":"longitude","in":"query","required":true,"schema":{"type":"number","maximum":180,"minimum":-180,"title":"Longitude"}},{"name":"country_code","in":"query","required":false,"schema":{"type":"string","minLength":0,"maxLength":2,"default":"","title":"Country Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignReverseGeocodeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/geo/postal-code":{"get":{"tags":["campaigns","Campaign Geo"],"summary":"Resolve Campaign Postal Code","description":"Resolve a typed postal code for map preview and platform fallback labels.","operationId":"resolve_campaign_postal_code_api_campaigns_geo_postal_code_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"postal_code","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":16,"title":"Postal Code"}},{"name":"country_code","in":"query","required":false,"schema":{"type":"string","minLength":0,"maxLength":2,"default":"","title":"Country Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignReverseGeocodeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/paid-media-playbook":{"get":{"tags":["campaigns","Paid Media Playbook"],"summary":"Get Paid Media Playbook","operationId":"get_paid_media_playbook_api_campaigns_paid_media_playbook_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaidMediaPlaybookResponse"}}}}},"security":[{"HTTPBearer":[]}]},"put":{"tags":["campaigns","Paid Media Playbook"],"summary":"Put Paid Media Playbook","operationId":"put_paid_media_playbook_api_campaigns_paid_media_playbook_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaidMediaPlaybookSaveRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaidMediaPlaybookResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/ad-accounts":{"get":{"tags":["campaigns","Ad Accounts"],"summary":"List Ad Accounts","description":"One card per activated ad account, plus the platforms still to connect.","operationId":"list_ad_accounts_api_campaigns_ad_accounts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdAccountsResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/ad-accounts/{platform}/report":{"get":{"tags":["campaigns","Ad Accounts"],"summary":"Get Ad Account Report","operationId":"get_ad_account_report_api_campaigns_ad_accounts__platform__report_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"platform","in":"path","required":true,"schema":{"type":"string","title":"Platform"}},{"name":"integration_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Integration Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdAccountReportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/ad-accounts/{platform}/report/refresh":{"post":{"tags":["campaigns","Ad Accounts"],"summary":"Refresh Ad Account Report","description":"Rebuild the report on demand. Idempotent per account per day.","operationId":"refresh_ad_account_report_api_campaigns_ad_accounts__platform__report_refresh_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"platform","in":"path","required":true,"schema":{"type":"string","title":"Platform"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/AdAccountReportRefreshRequest"},{"type":"null"}],"title":"Request"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdAccountCard"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/queue":{"get":{"tags":["campaigns"],"summary":"Get Campaign Work Queue","description":"Three-bucket campaign work queue: live, needs-you, everything else.\n\nThe dashboard endpoint answers \"show me every ad\"; this one answers \"what\nshould I launch today\". The draft bucket is capped on purpose — see\n``services.campaign_queue_read_model``.","operationId":"get_campaign_work_queue_api_campaigns_queue_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"draft_limit","in":"query","required":false,"schema":{"type":"integer","default":5,"title":"Draft Limit"}},{"name":"window_days","in":"query","required":false,"schema":{"type":"integer","default":3,"title":"Window Days"}},{"name":"counts_only","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Counts Only"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/dashboard":{"get":{"tags":["campaigns"],"summary":"Get Campaign Dashboard Bundle","operationId":"get_campaign_dashboard_bundle_api_campaigns_dashboard_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":200,"title":"Limit"}},{"name":"mode","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mode"}},{"name":"include_secondary","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Secondary"}},{"name":"platform_scope","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform Scope"}},{"name":"status_filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Filter"}},{"name":"source_filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Filter"}},{"name":"campaign_type_filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Type Filter"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"include_filter_counts","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Filter Counts"}},{"name":"range_start","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Range Start"}},{"name":"range_end","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Range End"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaigns/all/count":{"get":{"tags":["campaigns"],"summary":"Get All Campaigns Count","description":"Get the total count of all campaigns across all types (email, social post, and online ads) for the company profile.\nReturns the total number and breakdown by campaign type.","operationId":"get_all_campaigns_count_api_campaigns_all_count_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaigns/all/active":{"get":{"tags":["campaigns"],"summary":"Get Active Campaigns","description":"Get all active campaigns across all types with details for dashboard display.\nReturns campaigns that are currently running or scheduled.\nIncludes AI test results if available.","operationId":"get_active_campaigns_api_campaigns_all_active_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/consumer-group/create_group":{"post":{"tags":["consumer-group"],"summary":"Create User Group","description":"Create a new consumer group for the current company profile.","operationId":"create_user_group_api_consumer_group_create_group_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/consumer-group/fetch_groups":{"get":{"tags":["consumer-group"],"summary":"Fetch Consumer Groups","description":"Fetch all consumer groups for the current company profile.","operationId":"fetch_consumer_groups_api_consumer_group_fetch_groups_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/consumer-group/delete_group/{group_id}":{"delete":{"tags":["consumer-group"],"summary":"Delete Consumer Group","description":"Delete a consumer group and all its consumers.","operationId":"delete_consumer_group_api_consumer_group_delete_group__group_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Group Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/consumer-group/upload_consumers/{group_id}":{"post":{"tags":["consumer-group"],"summary":"Upload Consumers To Group","description":"Upload consumers from a CSV or Excel file to a consumer group.","operationId":"upload_consumers_to_group_api_consumer_group_upload_consumers__group_id__post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Group Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_consumers_to_group_api_consumer_group_upload_consumers__group_id__post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/consumer-group/remove_consumers/{group_id}":{"post":{"tags":["consumer-group"],"summary":"Remove Consumers From Group","description":"Remove specific consumers from a group.","operationId":"remove_consumers_from_group_api_consumer_group_remove_consumers__group_id__post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Group Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/consumer-group/get_consumers/{group_id}":{"get":{"tags":["consumer-group"],"summary":"Get Consumers","description":"Get consumers in a group with pagination.","operationId":"get_consumers_api_consumer_group_get_consumers__group_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Group Id"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile/":{"get":{"tags":["company-profile"],"summary":"Get Company Profiles","description":"Get company profiles the current user has access to in the ACTIVE organization.\n\nRBAC Logic:\n- Org owners/admins see ALL profiles in the active organization\n- Members see only profiles they have explicit CompanyProfileAccess to\n- Only org admins/owners can query archived or deleted profiles or all profiles (no status filter)\n\nMulti-org Support:\n- Uses X-Organization-Id header to determine which organization's profiles to return\n- Only returns profiles from the active organization\n- Validates user has access to the organization via get_active_organization_id dependency","operationId":"get_company_profiles_api_company_profile__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/CompanyProfileStatus"},{"type":"null"}],"description":"Filter profiles by status (active, archived, deleted). If not specified, returns all profiles. Only org admins can view non-active profiles.","title":"Status"},"description":"Filter profiles by status (active, archived, deleted). If not specified, returns all profiles. Only org admins can view non-active profiles."},{"name":"scope","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/CompanyProfileListScope"},{"type":"null"}],"description":"Optional scoped list query. 'active_org' returns active profiles in the active organization for admins. 'my_accessible' returns active profiles visible to the current user.","title":"Scope"},"description":"Optional scoped list query. 'active_org' returns active profiles in the active organization for admins. 'my_accessible' returns active profiles visible to the current user."},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Bypass the shared response cache","default":false,"title":"Force Refresh"},"description":"Bypass the shared response cache"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CompanyProfileResponse"},"title":"Response Get Company Profiles Api Company Profile  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["company-profile"],"summary":"Create Company Profile","description":"Create a new company profile (project) in the user's organization.\nEach profile represents a separate project the organization is working on.\n\nMulti-org: Creates profile in the active organization resolved from X-Organization-Id\n(with fallback to the user's first active organization).","operationId":"create_company_profile_api_company_profile__post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile/summaries":{"get":{"tags":["company-profile"],"summary":"Get Company Profile Summaries","description":"Return the compact active/archived profile list used by workspace navigation.","operationId":"get_company_profile_summaries_api_company_profile_summaries_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Bypass the shared response cache","default":false,"title":"Force Refresh"},"description":"Bypass the shared response cache"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CompanyProfileSummaryResponse"},"title":"Response Get Company Profile Summaries Api Company Profile Summaries Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile/{profile_id}":{"get":{"tags":["company-profile"],"summary":"Get Company Profile By Id","description":"Get a specific company profile by ID.\nValidates that the profile belongs to the user's organization.","operationId":"get_company_profile_by_id_api_company_profile__profile_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Bypass the shared response cache","default":false,"title":"Force Refresh"},"description":"Bypass the shared response cache"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["company-profile"],"summary":"Update Company Profile","description":"Update an existing company profile.\nRequires contributor or admin access.","operationId":"update_company_profile_api_company_profile__profile_id__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["company-profile"],"summary":"Delete Company Profile","description":"Hard delete a company profile (permanently removes from database).\nRequires ownership-level access (org owner/admin or explicit profile admin).\n\nNote: Consider using PATCH /{profile_id}/status with status='deleted' for soft delete instead.","operationId":"delete_company_profile_api_company_profile__profile_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile/{profile_id}/status":{"patch":{"tags":["company-profile"],"summary":"Update Company Profile Status","description":"Update the status of a company profile (archive, delete, or restore to active).\nRequires ownership-level access (org owner/admin or explicit profile admin).\n\nThis is a soft delete/archive - data is preserved.\n- Setting to ACTIVE restores the profile\n- Restoring a DELETED profile does not restart deleted onboarding workflows\n- Setting to ARCHIVED/DELETED hides the profile from normal views","operationId":"update_company_profile_status_api_company_profile__profile_id__status_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileStatusUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileStatusUpdateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile/{profile_id}/company-messages":{"post":{"tags":["company-profile"],"summary":"Add Company Message","description":"Add a company message to a specific company profile.\nValidates that the profile belongs to the user's organization.","operationId":"add_company_message_api_company_profile__profile_id__company_messages_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyMessageCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile/{profile_id}/company-messages/{message_id}":{"delete":{"tags":["company-profile"],"summary":"Delete Company Message","description":"Delete a company message from a specific company profile.\nValidates that the profile belongs to the user's organization.","operationId":"delete_company_message_api_company_profile__profile_id__company_messages__message_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}},{"name":"message_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Message Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile/{profile_id}/upload-image":{"post":{"tags":["company-profile"],"summary":"Upload Image","description":"Upload an example image to GCS for a specific company profile.\nValidates that the profile belongs to the user's organization.","operationId":"upload_image_api_company_profile__profile_id__upload_image_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_image_api_company_profile__profile_id__upload_image_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile/{profile_id}/company-images/{image_id}":{"delete":{"tags":["company-profile"],"summary":"Delete Company Image","description":"Delete a company image from a specific company profile.\nValidates that the profile belongs to the user's organization.","operationId":"delete_company_image_api_company_profile__profile_id__company_images__image_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}},{"name":"image_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Image Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile/{profile_id}/stylebook":{"get":{"tags":["company-profile"],"summary":"Get Company Stylebook","operationId":"get_company_stylebook_api_company_profile__profile_id__stylebook_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyStylebookResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["company-profile"],"summary":"Update Company Stylebook","operationId":"update_company_stylebook_api_company_profile__profile_id__stylebook_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyStylebookUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyStylebookResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile/{profile_id}/stylebook/generate":{"post":{"tags":["company-profile"],"summary":"Generate Company Stylebook","operationId":"generate_company_stylebook_api_company_profile__profile_id__stylebook_generate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyStylebookGenerateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyStylebookResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile/{profile_id}/is-complete":{"get":{"tags":["company-profile"],"summary":"Check Profile Completion","description":"Check if a specific company profile and marketing profile are complete.\nValidates that the profile belongs to the user's organization.\n\nTwo signals, two meanings:\n* ``is_completed`` — profile-content signal (name/description/brand\n  attributes filled in). Mutated here if the underlying columns are now\n  populated. This is NOT the onboarding-completion signal.\n* ``marketing_profile_completed`` — onboarding signal derived from the\n  shared ``get_marketing_profile_completion`` helper, which reads the\n  BrandGenerationWorkflow projection the same way list/detail responses do.","operationId":"check_profile_completion_api_company_profile__profile_id__is_complete_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile/{profile_id}/competitive-analysis":{"put":{"tags":["company-profile"],"summary":"Update Competitive Analysis","description":"Update competitive analysis for a specific company profile.\nValidates that the profile belongs to the user's organization.","operationId":"update_competitive_analysis_api_company_profile__profile_id__competitive_analysis_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Competitive Analysis"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile/{profile_id}/marketing-strategy":{"put":{"tags":["company-profile"],"summary":"Update Marketing Strategy","description":"Update marketing strategy for a specific company profile.\nValidates that the profile belongs to the user's organization.","operationId":"update_marketing_strategy_api_company_profile__profile_id__marketing_strategy_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Marketing Strategy"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile/{profile_id}/upload-logo":{"post":{"tags":["company-profile"],"summary":"Upload Company Logo","description":"Upload a custom logo for a specific company profile.\nValidates that the profile belongs to the user's organization.","operationId":"upload_company_logo_api_company_profile__profile_id__upload_logo_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_company_logo_api_company_profile__profile_id__upload_logo_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile/{profile_id}/files":{"get":{"tags":["company-profile"],"summary":"Get Company Files","description":"Get all files associated with a company profile.\nValidates that the profile belongs to the user's organization.","operationId":"get_company_files_api_company_profile__profile_id__files_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile/{profile_id}/files/{file_id}/download":{"get":{"tags":["company-profile"],"summary":"Download Company File","description":"Download a specific file associated with a company profile.\nValidates that the profile belongs to the user's organization.","operationId":"download_company_file_api_company_profile__profile_id__files__file_id__download_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"File Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile/{profile_id}/files/{file_id}/info":{"get":{"tags":["company-profile"],"summary":"Get File Info","description":"Get detailed information about a specific file.\nValidates that the profile belongs to the user's organization.","operationId":"get_file_info_api_company_profile__profile_id__files__file_id__info_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}},{"name":"file_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"File Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile-access/{profile_id}/access":{"get":{"tags":["company-profile-access"],"summary":"List Project Access","description":"Get all users who have access to a specific project.\nOnly project admins and org admins/owners can view access list.","operationId":"list_project_access_api_company_profile_access__profile_id__access_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Bypass the shared response cache","default":false,"title":"Force Refresh"},"description":"Bypass the shared response cache"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileAccessListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["company-profile-access"],"summary":"Grant Project Access","description":"Grant a user access to a project.\nOnly project admins and org admins/owners can grant access.","operationId":"grant_project_access_api_company_profile_access__profile_id__access_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileAccessGrantRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileAccessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile-access/{profile_id}/access/{user_id}":{"put":{"tags":["company-profile-access"],"summary":"Update Project Access","description":"Update a user's project access role.\nOnly project admins and org admins/owners can update access.","operationId":"update_project_access_api_company_profile_access__profile_id__access__user_id__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}},{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"User Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileAccessUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileAccessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["company-profile-access"],"summary":"Revoke Project Access","description":"Revoke a user's access to a project.\nOnly project admins and org admins/owners can revoke access.","operationId":"revoke_project_access_api_company_profile_access__profile_id__access__user_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}},{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"User Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profile-access/{profile_id}/access/bulk":{"post":{"tags":["company-profile-access"],"summary":"Bulk Grant Project Access","description":"Grant project access to multiple users at once.\nOnly project admins and org admins/owners can grant bulk access.","operationId":"bulk_grant_project_access_api_company_profile_access__profile_id__access_bulk_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkCompanyProfileAccessRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkCompanyProfileAccessResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization/data-download":{"get":{"tags":["organization"],"summary":"Download Organization Data","description":"Download a restricted export bundle for the authenticated admin/owner.\n\nScope is intentionally limited to the current authenticated user and the\ncurrently selected company profile within the active organization.","operationId":"download_organization_data_api_v1_organization_data_download_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization":{"get":{"tags":["organization"],"summary":"Get Organization","description":"Get current user's organization information including all members.\n\nRequires: Organization owner or admin role in the active organization (from X-Organization-Id header)\n\nReturns sensitive data:\n- Invite token (for inviting new members)\n- Full members list with roles","operationId":"get_organization_api_v1_organization_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Bypass the shared response cache","default":false,"title":"Force Refresh"},"description":"Bypass the shared response cache"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization/billing-metadata":{"get":{"tags":["organization"],"summary":"Get Organization Billing Metadata","description":"Get the minimal organization billing metadata required by recovery surfaces.\n\nUnlike the full organization detail route, this excludes invite tokens,\nmember lists, and other admin-only organization management data.","operationId":"get_organization_billing_metadata_api_v1_organization_billing_metadata_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationBillingMetadataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization/list":{"get":{"tags":["organization"],"summary":"List User Organizations","description":"Get all organizations the current user belongs to.\n\nReturns a lightweight list of organizations with:\n- Organization basic info\n- User's role in each organization\n- Member count (not full member list)\n\nThis is used for organization selection/switching in multi-org UI.","operationId":"list_user_organizations_api_v1_organization_list_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Bypass the shared response cache","default":false,"title":"Force Refresh"},"description":"Bypass the shared response cache"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OrganizationListItemResponse"},"title":"Response List User Organizations Api V1 Organization List Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization/invites":{"get":{"tags":["organization"],"summary":"List Organization Invites","description":"List organization invites. Defaults to pending invites only.","operationId":"list_organization_invites_api_v1_organization_invites_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"status_filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Filter"}},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Bypass the shared response cache","default":false,"title":"Force Refresh"},"description":"Bypass the shared response cache"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationInviteListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["organization"],"summary":"Create Organization Invites","description":"Create email-based organization invites.","operationId":"create_organization_invites_api_v1_organization_invites_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrganizationInvitesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrganizationInvitesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization/invite-domain-settings":{"get":{"tags":["organization"],"summary":"Get Invite Domain Settings Endpoint","operationId":"get_invite_domain_settings_endpoint_api_v1_organization_invite_domain_settings_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Bypass the shared response cache","default":false,"title":"Force Refresh"},"description":"Bypass the shared response cache"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteDomainRestrictionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["organization"],"summary":"Update Invite Domain Settings Endpoint","operationId":"update_invite_domain_settings_endpoint_api_v1_organization_invite_domain_settings_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteDomainRestrictionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InviteDomainRestrictionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization/invites/link":{"post":{"tags":["organization"],"summary":"Create Invite Link","operationId":"create_invite_link_api_v1_organization_invites_link_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationInviteLinkRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationInviteLinkResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["organization"],"summary":"Disable Invite Link","description":"Disable the current open invite link.","operationId":"disable_invite_link_api_v1_organization_invites_link_delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationInviteActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization/invites/{invite_id}/resend":{"post":{"tags":["organization"],"summary":"Resend Invite","operationId":"resend_invite_api_v1_organization_invites__invite_id__resend_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"invite_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Invite Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationInviteActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization/invites/{invite_id}/revoke":{"post":{"tags":["organization"],"summary":"Revoke Invite","operationId":"revoke_invite_api_v1_organization_invites__invite_id__revoke_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"invite_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Invite Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationInviteActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization/generate-invite-token":{"post":{"tags":["organization"],"summary":"Generate Invite Token","operationId":"generate_invite_token_api_v1_organization_generate_invite_token_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateInviteTokenResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization/invite-info":{"get":{"tags":["organization"],"summary":"Get Invite Info","operationId":"get_invite_info_api_v1_organization_invite_info_get","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationInviteInfoResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization/join":{"post":{"tags":["organization"],"summary":"Join Organization","operationId":"join_organization_api_v1_organization_join_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JoinOrganizationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JoinOrganizationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/organization/members":{"get":{"tags":["organization"],"summary":"Get Organization Members","description":"Get list of all members in the active organization (from X-Organization-Id header).","operationId":"get_organization_members_api_v1_organization_members_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Bypass the shared response cache","default":false,"title":"Force Refresh"},"description":"Bypass the shared response cache"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OrganizationMemberResponse"},"title":"Response Get Organization Members Api V1 Organization Members Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization/invite/email":{"post":{"tags":["organization"],"summary":"Send Invite Email","operationId":"send_invite_email_api_v1_organization_invite_email_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendOrganizationInviteEmailRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendOrganizationInviteEmailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization/members/{user_id}/role":{"put":{"tags":["organization"],"summary":"Update Member Role","description":"Update a member's organization role.\nOnly owners can update roles (assign admin or change admin back to member).\nUsers cannot modify their own role.","operationId":"update_member_role_api_v1_organization_members__user_id__role_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"User Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganizationRoleUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization/members/{user_id}":{"delete":{"tags":["organization"],"summary":"Remove Member","description":"Remove a member from the organization.\nOnly owners and admins can remove members.\nCannot remove the organization owner or yourself.","operationId":"remove_member_api_v1_organization_members__user_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"User Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization/members/{user_id}/status":{"put":{"tags":["organization"],"summary":"Update Member Status","description":"Suspend or activate a member.\nOnly owners and admins can change member status.\nCannot suspend owner or yourself.","operationId":"update_member_status_api_v1_organization_members__user_id__status_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"User Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberStatusUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization/transfer-ownership":{"post":{"tags":["organization"],"summary":"Transfer Ownership","description":"Transfer organization ownership to another user.\nOnly the current owner can transfer ownership.","operationId":"transfer_ownership_api_v1_organization_transfer_ownership_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransferOwnershipRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/organization/members/{user_id}/permissions":{"get":{"tags":["organization"],"summary":"Get Member Permissions","description":"Get a summary of a user's permissions within the active organization.\nOnly admins/owners can view other users' permissions.\nUsers can view their own permissions.","operationId":"get_member_permissions_api_v1_organization_members__user_id__permissions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"User Id"}},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Bypass the shared response cache","default":false,"title":"Force Refresh"},"description":"Bypass the shared response cache"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserPermissionSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/preferences":{"get":{"tags":["user-preferences"],"summary":"Get User Preferences","description":"Get current user's preferences.\n\nCreates default preferences if they don't exist.\nRequires authentication.","operationId":"get_user_preferences_api_preferences_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserPreferencesResponse"}}}}},"security":[{"HTTPBearer":[]}]},"put":{"tags":["user-preferences"],"summary":"Update User Preferences","description":"Update user preferences.\n\nMerges the provided preferences with existing preferences.\nDoes not replace the entire preferences object.\nRequires authentication.\n\nExample request:\n{\n  \"preferences\": {\n    \"tutorial_completed\": true,\n    \"daily_digest_theme\": \"dark\"\n  }\n}","operationId":"update_user_preferences_api_preferences_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserPreferencesUpdate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserPreferencesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]},"delete":{"tags":["user-preferences"],"summary":"Reset User Preferences","description":"Reset ordinary user preferences, preserving native consent records.\n\nThis does not delete the preferences record or Markee consent choices.\nRequires authentication.","operationId":"reset_user_preferences_api_preferences_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/preferences/config":{"get":{"tags":["user-preferences"],"summary":"Get User Preferences Config","description":"Get only the preferences configuration object (without metadata).\n\nLightweight endpoint for frontend to quickly fetch user settings.\nRequires authentication.","operationId":"get_user_preferences_config_api_preferences_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserPreferencesPartial"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/preferences/release-announcements/claim":{"post":{"tags":["user-preferences"],"summary":"Claim Release Announcement","description":"Atomically claim a release spotlight and mark its visible digest as\ncovered.\n\nThe user's canonical preference row is locked before inspecting the\nspotlight receipt. Exactly one concurrent request can therefore win on\ndatabases that support ``SELECT ... FOR UPDATE`` (including production\nPostgreSQL). SQLite uses ``BEGIN IMMEDIATE`` before the read to provide the\nsame exact-once behavior; exhausted lock contention fails closed with a\nretryable 503. Each release is persisted under its own top-level key so a\nlater generic preference merge cannot replace an entire receipt map.","operationId":"claim_release_announcement_api_preferences_release_announcements_claim_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReleaseAnnouncementClaimRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReleaseAnnouncementClaimResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/document-jobs":{"get":{"tags":["document-jobs"],"summary":"List Document Jobs","operationId":"list_document_jobs_api_document_jobs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"product_offering_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id"}},{"name":"doc_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Type"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentJobsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/document-jobs/{job_id}":{"get":{"tags":["document-jobs"],"summary":"Get Document Job","operationId":"get_document_job_api_document_jobs__job_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Job Id"}},{"name":"company_profile_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentJobDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/document-jobs/{job_id}/sign":{"get":{"tags":["document-jobs"],"summary":"Sign Document Download","operationId":"sign_document_download_api_document_jobs__job_id__sign_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Job Id"}},{"name":"format","in":"query","required":true,"schema":{"type":"string","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignedUrlResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/document-jobs/{job_id}/preview-html":{"get":{"tags":["document-jobs"],"summary":"Get Document Preview Html","operationId":"get_document_preview_html_api_document_jobs__job_id__preview_html_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Job Id"}},{"name":"company_profile_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HtmlPreviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/inspiration":{"get":{"tags":["inspiration"],"summary":"Get Inspiration","operationId":"get_inspiration_api_inspiration_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"industry","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Industry"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Category"}},{"name":"search_terms","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Search Terms"}},{"name":"previous","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Previous"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InspirationCatalogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/inspiration/collections":{"post":{"tags":["inspiration"],"summary":"Start Collection","operationId":"start_collection_api_inspiration_collections_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InspirationBrowseContext"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InspirationCatalogResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/inspiration/templates/{template_id}":{"get":{"tags":["inspiration"],"summary":"Get Campaign Template","operationId":"get_campaign_template_api_inspiration_templates__template_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"template_id","in":"path","required":true,"schema":{"type":"string","title":"Template Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/activity/events":{"post":{"tags":["user-activity"],"summary":"Record Product Events","operationId":"record_product_events_api_activity_events_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductEventsBatchIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductEventsBatchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/activity/ping":{"post":{"tags":["user-activity"],"summary":"Record Presence Ping","operationId":"record_presence_ping_api_activity_ping_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresencePingIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresencePingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/activity/presence":{"get":{"tags":["user-activity"],"summary":"List Presence","operationId":"list_presence_api_activity_presence_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"}},{"name":"active_window_seconds","in":"query","required":false,"schema":{"type":"integer","maximum":3600,"minimum":15,"default":90,"title":"Active Window Seconds"}},{"name":"interaction_window_seconds","in":"query","required":false,"schema":{"type":"integer","maximum":86400,"minimum":30,"default":300,"title":"Interaction Window Seconds"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresenceListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/activity/users/{user_id}/timeline":{"get":{"tags":["user-activity"],"summary":"Get User Activity Timeline","operationId":"get_user_activity_timeline_api_activity_users__user_id__timeline_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"user_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"User Id"}},{"name":"organization_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"To"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductEventTimelineResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/url-shortener/shorten/":{"post":{"tags":["url-shortener"],"summary":"Create Shortened Url","description":"Creates a new shortened URL.\n\nArgs:\n    url (ShortenedURLCreate): URL creation data with long_url and campaign_id\n    request (Request): FastAPI request object\n    db (Session, optional): Database session. Defaults from dependency.\n    current_user (User, optional): The current authenticated user. Defaults from dependency.\n\nReturns:\n    ShortenedURLSchema: The created shortened URL data\n\nRaises:\n    HTTPException: If there is an error creating the shortened URL","operationId":"create_shortened_url_api_url_shortener_shorten__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShortenedURLCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShortenedURL"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/url-shortener/s/{short_code}":{"get":{"tags":["url-shortener"],"summary":"Redirect To Long Url","description":"Redirects to the original long URL based on the short code.\n\nArgs:\n    short_code (str): The short code to redirect from\n    db (Session, optional): Database session. Defaults from dependency.\n    request (Request, optional): FastAPI request object. Defaults to None.\n\nReturns:\n    RedirectResponse: Redirect to the original URL\n\nRaises:\n    HTTPException: If the short URL is not found","operationId":"redirect_to_long_url_api_url_shortener_s__short_code__get","parameters":[{"name":"short_code","in":"path","required":true,"schema":{"type":"string","title":"Short Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/content-editing/edit-image":{"post":{"tags":["content-editing"],"summary":"Edit Image","description":"Process an image using AI to edit based on the prompt\n\n- Takes an uploaded image\n- Takes a text prompt describing the desired edits\n- Optional flag to use company style\n- Optional product image to insert into the scene\n- Optional logo image to incorporate naturally\n- Returns original image URL and list of edited image URLs","operationId":"edit_image_api_content_editing_edit_image_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_edit_image_api_content_editing_edit_image_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentEditResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/content-editing/generate-image":{"post":{"tags":["content-editing"],"summary":"Generate Image","description":"Generate images based on a text prompt\n\n- Takes a text prompt describing the desired image\n- Optional size parameter in format \"widthxheight\"\n- Optional aspect_ratio parameter (\"1:1\", \"3:4\", \"4:3\", \"9:16\", \"16:9\")\n- Optional number of images to generate\n- Optional reference images to guide the generation\n- Optional use_company_style flag to incorporate company branding\n- Returns URLs to the generated images","operationId":"generate_image_api_content_editing_generate_image_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_generate_image_api_content_editing_generate_image_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImageGenerationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/images/replace":{"post":{"tags":["image-operations","images"],"summary":"Replace Image","description":"Replace an existing image in GCS with new image data.\n\nArgs:\n    request: Request object containing URL and image data\n\nReturns:\n    JSONResponse with result","operationId":"replace_image_api_images_replace_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReplaceImageRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/images/replace-upload":{"post":{"tags":["image-operations","images"],"summary":"Replace Image Upload","description":"Replace an existing image in GCS with a new uploaded file.\n\nArgs:\n    url: GCS URL of the image to replace\n    file: New image file to upload\n    content_type: Optional MIME type override\n\nReturns:\n    JSONResponse with result","operationId":"replace_image_upload_api_images_replace_upload_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_replace_image_upload_api_images_replace_upload_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/instagram/auth":{"get":{"tags":["external-platform"],"summary":"Instagram Auth","description":"Generate an OAuth URL for user authentication.\n\nArgs:\n    login_type: The type of login flow to use. Defaults to \"instagram\".\n               Set to \"facebook\" to use Facebook login instead.\n    db: Database session\n    company_profile: Current company profile (injected via dependency)\n\nReturns:\n    InstagramAuthResponseModel: Response with authentication URL","operationId":"instagram_auth_api_external_platform_instagram_auth_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"login_type","in":"query","required":false,"schema":{"type":"string","default":"instagram","title":"Login Type"}},{"name":"oauth_purpose","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Oauth Purpose"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstagramAuthResponseModel"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/instagram/callback":{"get":{"tags":["external-platform"],"summary":"Instagram Callback","description":"Handle Instagram OAuth callback.\n\nArgs:\n    code: Authorization code from OAuth provider\n    state: State parameter containing user ID and login type\n    error: Error code if authorization failed\n    error_reason: Reason for error if authorization failed\n    error_description: Detailed error description if authorization failed\n    db: Database session\n    \nReturns:\n    RedirectResponse: Redirect to frontend with success or error","operationId":"instagram_callback_api_external_platform_instagram_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"type":"string","title":"Code"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","title":"State"}},{"name":"error","in":"query","required":false,"schema":{"type":"string","title":"Error"}},{"name":"error_reason","in":"query","required":false,"schema":{"type":"string","title":"Error Reason"}},{"name":"error_description","in":"query","required":false,"schema":{"type":"string","title":"Error Description"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/instagram/disconnect":{"post":{"tags":["external-platform"],"summary":"Disconnect Instagram","operationId":"disconnect_instagram_api_external_platform_instagram_disconnect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/instagram/create-post":{"post":{"tags":["external-platform"],"summary":"Create Instagram Post","description":"Create an Instagram post with an image.\n\nThis endpoint creates a standalone Instagram post not associated with a campaign.\nIt handles authentication, validates the token, and posts content to Instagram.\n\nArgs:\n    post_data: Post content and account details\n    db: Database session\n    company_profile: Current company profile (injected via dependency)\n\nReturns:\n    PostResponseModel: Response with post ID","operationId":"create_instagram_post_api_external_platform_instagram_create_post_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePostRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostResponseModel"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/instagram/delete-post":{"post":{"tags":["external-platform"],"summary":"Delete Instagram Post","description":"Delete an Instagram post by ID.\n\nThis endpoint deletes a post from Instagram and updates the corresponding\ndatabase records in the SocialPostCampaign table.\n\nArgs:\n    delete_data: Post ID to delete\n    db: Database session\n    company_profile: Current company profile (injected via dependency)\n\nReturns:\n    DeletePostResponseModel: Response with success status","operationId":"delete_instagram_post_api_external_platform_instagram_delete_post_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletePostRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletePostResponseModel"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/instagram/posts":{"get":{"tags":["external-platform"],"summary":"Get Instagram Posts","description":"Get recent Instagram posts for a specific account.\n\nArgs:\n    instagram_account_id: Instagram business account ID\n    limit: Maximum number of posts to return\n    db: Database session\n    company_profile: Current company profile (injected via dependency)\n\nReturns:\n    dict: Response with list of posts","operationId":"get_instagram_posts_api_external_platform_instagram_posts_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"instagram_account_id","in":"query","required":true,"schema":{"type":"string","title":"Instagram Account Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/instagram/post-metrics":{"post":{"tags":["external-platform"],"summary":"Get Post Metrics","description":"Get metrics for a specific Instagram post.\n\nArgs:\n    metrics_data: Post ID and metrics to retrieve\n    db: Database session\n    company_profile: Current company profile (injected via dependency)\n\nReturns:\n    dict: Response with metrics data","operationId":"get_post_metrics_api_external_platform_instagram_post_metrics_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostMetricsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/instagram/batch-post-metrics":{"post":{"tags":["external-platform"],"summary":"Get Batch Post Metrics","description":"Get metrics for multiple Instagram posts in a single request.\n\nArgs:\n    batch_data: Instagram account ID and list of post IDs\n    db: Database session\n    company_profile: Current company profile (injected via dependency)\n\nReturns:\n    dict: Response with metrics for all posts","operationId":"get_batch_post_metrics_api_external_platform_instagram_batch_post_metrics_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchPostMetricsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/instagram/accounts":{"get":{"tags":["external-platform"],"summary":"Get Instagram Accounts","description":"Get a list of Instagram business accounts that the user has access to.\nThis endpoint handles both Instagram direct authentication and Facebook authentication.\n\nArgs:\n    db: Database session\n    company_profile: Current company profile (injected via dependency)\n\nReturns:\n    dict: Response with list of Instagram accounts and authentication method","operationId":"get_instagram_accounts_api_external_platform_instagram_accounts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/instagram/activation":{"get":{"tags":["external-platform"],"summary":"Get Instagram Activation","operationId":"get_instagram_activation_api_external_platform_instagram_activation_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/instagram/activate":{"post":{"tags":["external-platform"],"summary":"Activate Instagram Identity","operationId":"activate_instagram_identity_api_external_platform_instagram_activate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstagramActivateIdentityRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/instagram/post-campaign":{"post":{"tags":["external-platform"],"summary":"Post Campaign To Instagram","operationId":"post_campaign_to_instagram_api_external_platform_instagram_post_campaign_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstagramPostCampaignRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostResponseModel"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/meta/campaign/{campaign_id}/status":{"get":{"tags":["external-platform"],"summary":"Get Meta Campaign Status","description":"Fetch real-time Meta campaign status (with optional adset/ad) and map to canonical states.","operationId":"get_meta_campaign_status_api_external_platform_meta_campaign__campaign_id__status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}},{"name":"adset_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Adset Id"}},{"name":"ad_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/meta/auth":{"get":{"tags":["external-platform"],"summary":"Meta Auth","description":"Get OAuth authorization URL.\n\n- auth_type = 'facebook' returns Meta (Facebook) Ads auth URL and redirects to /meta/callback\n- auth_type = 'instagram' returns Instagram auth URL and redirects to /instagram/callback (for social posting)","operationId":"meta_auth_api_external_platform_meta_auth_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"auth_type","in":"query","required":false,"schema":{"type":"string","description":"'facebook' for Meta Ads; 'instagram' for Instagram social","default":"facebook","title":"Auth Type"},"description":"'facebook' for Meta Ads; 'instagram' for Instagram social"},{"name":"capability","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional incremental capability upgrade on the same Meta connection.","title":"Capability"},"description":"Optional incremental capability upgrade on the same Meta connection."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaAuthResponseModel"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/meta/callback":{"get":{"tags":["external-platform"],"summary":"Meta Callback","description":"Handle Meta (Facebook) OAuth callback for Ads connection and store tokens.\n\nRedirects to the frontend PlatformConnectSuccessPage with platform=meta.","operationId":"meta_callback_api_external_platform_meta_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"type":"string","title":"Code"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","title":"State"}},{"name":"error","in":"query","required":false,"schema":{"type":"string","title":"Error"}},{"name":"error_description","in":"query","required":false,"schema":{"type":"string","title":"Error Description"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/meta/accounts":{"get":{"tags":["external-platform"],"summary":"Get Meta Accounts","description":"Get Meta Ad accounts and Facebook Pages for the authenticated user.","operationId":"get_meta_accounts_api_external_platform_meta_accounts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaAccountsResponseModel"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/meta/activation":{"get":{"tags":["external-platform"],"summary":"Get Meta Activation","operationId":"get_meta_activation_api_external_platform_meta_activation_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/meta/disconnect":{"post":{"tags":["external-platform"],"summary":"Disconnect Meta Ads","operationId":"disconnect_meta_ads_api_external_platform_meta_disconnect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/meta/accounts/select":{"post":{"tags":["external-platform"],"summary":"Select Meta Ad Account","description":"Activate one Meta ad account for future launches.","operationId":"select_meta_ad_account_api_external_platform_meta_accounts_select_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaSelectAdAccountRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/meta/activate":{"post":{"tags":["external-platform"],"summary":"Activate Meta Ad Account","operationId":"activate_meta_ad_account_api_external_platform_meta_activate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaSelectAdAccountRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/meta/launch-ad-campaign":{"post":{"tags":["external-platform"],"summary":"Launch Meta Ad Campaign","description":"Queue a Meta ad campaign launch and return a job id for status polling.","operationId":"launch_meta_ad_campaign_api_external_platform_meta_launch_ad_campaign_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaLaunchAdCampaignRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/meta/sync-ad-campaign/preview":{"post":{"tags":["external-platform"],"summary":"Preview Meta Sync","description":"Preview sync changes and billing impact for a Meta ad campaign.","operationId":"preview_meta_sync_api_external_platform_meta_sync_ad_campaign_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaSyncPreviewRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/meta/sync-ad-campaign":{"post":{"tags":["external-platform"],"summary":"Sync Meta Ad Campaign","description":"Queue a Meta ad sync and return a job id for status polling.","operationId":"sync_meta_ad_campaign_api_external_platform_meta_sync_ad_campaign_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaSyncAdCampaignRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/meta/sync-job/{job_id}":{"get":{"tags":["external-platform"],"summary":"Get Sync Job Status","operationId":"get_sync_job_status_api_external_platform_meta_sync_job__job_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/meta/launch-job/{job_id}":{"get":{"tags":["external-platform"],"summary":"Get Launch Job Status","operationId":"get_launch_job_status_api_external_platform_meta_launch_job__job_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/meta/campaigns/{campaign_id}/activate":{"post":{"tags":["external-platform"],"summary":"Activate Meta Campaign","description":"Activate a paused Meta campaign","operationId":"activate_meta_campaign_api_external_platform_meta_campaigns__campaign_id__activate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/meta/adsets/{adset_id}/activate":{"post":{"tags":["external-platform"],"summary":"Activate Meta Adset","description":"Activate a paused Meta ad set","operationId":"activate_meta_adset_api_external_platform_meta_adsets__adset_id__activate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"adset_id","in":"path","required":true,"schema":{"type":"string","title":"Adset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/meta/ads/{ad_id}/activate":{"post":{"tags":["external-platform"],"summary":"Activate Meta Ad","description":"Activate a paused Meta ad","operationId":"activate_meta_ad_api_external_platform_meta_ads__ad_id__activate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ad_id","in":"path","required":true,"schema":{"type":"string","title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/meta/adsets/{adset_id}/pause":{"post":{"tags":["external-platform"],"summary":"Pause Meta Adset","description":"Pause an active Meta ad set","operationId":"pause_meta_adset_api_external_platform_meta_adsets__adset_id__pause_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"adset_id","in":"path","required":true,"schema":{"type":"string","title":"Adset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/meta/ads/{ad_id}/pause":{"post":{"tags":["external-platform"],"summary":"Pause Meta Ad","description":"Pause an active Meta ad","operationId":"pause_meta_ad_api_external_platform_meta_ads__ad_id__pause_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ad_id","in":"path","required":true,"schema":{"type":"string","title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/meta/campaigns/{campaign_id}/pause":{"post":{"tags":["external-platform"],"summary":"Pause Meta Campaign","description":"Pause an active Meta campaign","operationId":"pause_meta_campaign_api_external_platform_meta_campaigns__campaign_id__pause_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/meta/campaigns/{campaign_id}/insights":{"get":{"tags":["external-platform"],"summary":"Get Meta Campaign Insights","description":"Get performance insights for a Meta campaign","operationId":"get_meta_campaign_insights_api_external_platform_meta_campaigns__campaign_id__insights_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}},{"name":"date_preset","in":"query","required":false,"schema":{"type":"string","default":"last_7d","title":"Date Preset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/meta/campaign/action":{"post":{"tags":["external-platform"],"summary":"Meta Campaign Action","operationId":"meta_campaign_action_api_external_platform_meta_campaign_action_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaCampaignActionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/meta/campaign/resume":{"post":{"tags":["external-platform"],"summary":"Meta Campaign Resume","operationId":"meta_campaign_resume_api_external_platform_meta_campaign_resume_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaCampaignResumeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google/auth":{"get":{"tags":["external-platform"],"summary":"Google Auth","description":"Get Google OAuth authorization URL for the current company profile.","operationId":"google_auth_api_external_platform_google_auth_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAuthResponseModel"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google/callback":{"get":{"tags":["external-platform"],"summary":"Google Callback","description":"Handle Google OAuth callback and store tokens.\nThen redirect to the frontend application.","operationId":"google_callback_api_external_platform_google_callback_get","parameters":[{"name":"state","in":"query","required":true,"schema":{"type":"string","title":"State"}},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"}},{"name":"error","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/google/accounts":{"get":{"tags":["external-platform"],"summary":"Get Google Accounts","description":"Get Google Ads accounts for the authenticated user.","operationId":"get_google_accounts_api_external_platform_google_accounts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAccountsResponseModel"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google/activation":{"get":{"tags":["external-platform"],"summary":"Get Google Activation","operationId":"get_google_activation_api_external_platform_google_activation_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google/activate":{"post":{"tags":["external-platform"],"summary":"Activate Google Ads Account","operationId":"activate_google_ads_account_api_external_platform_google_activate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleActivateAccountRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google/disconnect":{"post":{"tags":["external-platform"],"summary":"Disconnect Google Ads","operationId":"disconnect_google_ads_api_external_platform_google_disconnect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google/campaigns":{"post":{"tags":["external-platform"],"summary":"Create Google Ad Campaign","description":"Create a new Google Ads campaign.","operationId":"create_google_ad_campaign_api_external_platform_google_campaigns_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAdCampaignRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google/ad-groups":{"post":{"tags":["external-platform"],"summary":"Create Google Ad Group","description":"Create a new Google Ads ad group.","operationId":"create_google_ad_group_api_external_platform_google_ad_groups_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAdGroupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google/display-ads":{"post":{"tags":["external-platform"],"summary":"Create Google Display Ad","description":"Create a new Google Ads display ad.","operationId":"create_google_display_ad_api_external_platform_google_display_ads_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/routes__external_platform__google_action__GoogleDisplayAdRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google/create-ad":{"post":{"tags":["external-platform"],"summary":"Create Ad From Campaign","description":"Reject the legacy social-post-to-paid-ad mutation path.","operationId":"create_ad_from_campaign_api_external_platform_google_create_ad_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleCreateAdFromCampaignRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google/sync-ad-campaign/preview":{"post":{"tags":["external-platform"],"summary":"Preview Google Sync","description":"Preview sync changes and billing impact for a Google ad campaign.","operationId":"preview_google_sync_api_external_platform_google_sync_ad_campaign_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleSyncPreviewRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google/sync-ad-campaign":{"post":{"tags":["external-platform"],"summary":"Sync Ad Campaign","description":"Sync an online ad campaign to Google Ads asynchronously via the agent job system.","operationId":"sync_ad_campaign_api_external_platform_google_sync_ad_campaign_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleSyncAdCampaignRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google/launch-ad-campaign":{"post":{"tags":["external-platform"],"summary":"Launch Ad Campaign","description":"Launch an online ad campaign to Google Ads asynchronously via the agent job system.","operationId":"launch_ad_campaign_api_external_platform_google_launch_ad_campaign_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleLaunchAdCampaignRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google/campaign/action":{"post":{"tags":["external-platform"],"summary":"Google Campaign Action","operationId":"google_campaign_action_api_external_platform_google_campaign_action_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleCampaignActionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google/campaign/resume":{"post":{"tags":["external-platform"],"summary":"Google Campaign Resume","operationId":"google_campaign_resume_api_external_platform_google_campaign_resume_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleCampaignActionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google/campaign/{campaign_id}/status":{"get":{"tags":["external-platform"],"summary":"Get Google Campaign Status","description":"Fetch real-time campaign status from Google Ads API\n\nArgs:\n    campaign_id: Google campaign ID\n    google_account_id: Google Ads account ID\n\nReturns:\n    Campaign status information","operationId":"get_google_campaign_status_api_external_platform_google_campaign__campaign_id__status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}},{"name":"google_account_id","in":"query","required":true,"schema":{"type":"string","title":"Google Account Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/amazon/auth":{"get":{"tags":["external-platform"],"summary":"Amazon Auth","description":"Get Amazon OAuth authorization URL for the current user.","operationId":"amazon_auth_api_external_platform_amazon_auth_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AmazonAuthResponseModel"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/amazon/callback":{"get":{"tags":["external-platform"],"summary":"Amazon Callback","description":"Handle Amazon OAuth callback and store tokens.","operationId":"amazon_callback_api_external_platform_amazon_callback_get","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","title":"Code"}},{"name":"state","in":"query","required":true,"schema":{"type":"string","title":"State"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/amazon/accounts":{"get":{"tags":["external-platform"],"summary":"Get Amazon Accounts","description":"Get available Amazon advertising accounts (profiles) for the current user.\nReturns empty list if user hasn't connected their Amazon account yet.","operationId":"get_amazon_accounts_api_external_platform_amazon_accounts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AmazonAccountsResponseModel"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/amazon/campaigns":{"post":{"tags":["external-platform"],"summary":"Create Amazon Campaign","description":"Create a new Amazon advertising campaign.","operationId":"create_amazon_campaign_api_external_platform_amazon_campaigns_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AmazonCampaignRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/amazon/ad-groups":{"post":{"tags":["external-platform"],"summary":"Create Amazon Ad Group","description":"Create a new Amazon ad group.","operationId":"create_amazon_ad_group_api_external_platform_amazon_ad_groups_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AmazonAdGroupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/amazon/product-ads":{"post":{"tags":["external-platform"],"summary":"Create Amazon Product Ad","description":"Create a new Amazon product ad.","operationId":"create_amazon_product_ad_api_external_platform_amazon_product_ads_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AmazonProductAdRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/amazon/keywords":{"post":{"tags":["external-platform"],"summary":"Add Amazon Keywords","description":"Add keywords to an Amazon ad group.","operationId":"add_amazon_keywords_api_external_platform_amazon_keywords_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AmazonKeywordsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/amazon/campaigns/{profile_id}":{"get":{"tags":["external-platform"],"summary":"Get Amazon Campaigns","description":"Get Amazon campaigns for a specific profile.","operationId":"get_amazon_campaigns_api_external_platform_amazon_campaigns__profile_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","title":"Profile Id"}},{"name":"state_filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Filter"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/amazon/metrics":{"post":{"tags":["external-platform"],"summary":"Get Amazon Campaign Metrics","description":"Get performance metrics for Amazon campaigns.","operationId":"get_amazon_campaign_metrics_api_external_platform_amazon_metrics_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Metrics Request"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/amazon/campaign/action":{"post":{"tags":["external-platform"],"summary":"Amazon Campaign Action","description":"Pause or delete an Amazon ad campaign.\n\nActions:\n- pause: Pauses the campaign (can be resumed later)\n- delete: Archives the campaign (can be relaunched)","operationId":"amazon_campaign_action_api_external_platform_amazon_campaign_action_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AmazonCampaignActionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/amazon/campaign/resume":{"post":{"tags":["external-platform"],"summary":"Amazon Campaign Resume","description":"Resume a paused Amazon ad campaign.","operationId":"amazon_campaign_resume_api_external_platform_amazon_campaign_resume_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AmazonCampaignActionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/tiktok/auth":{"get":{"tags":["external-platform"],"summary":"Tiktok Auth","description":"Get TikTok OAuth authorization URL for the current company profile.","operationId":"tiktok_auth_api_external_platform_tiktok_auth_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TikTokAuthResponseModel"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/tiktok/callback":{"get":{"tags":["external-platform"],"summary":"Tiktok Callback","description":"Handle TikTok OAuth callback and store tokens.\nThen redirect to the frontend application.","operationId":"tiktok_callback_api_external_platform_tiktok_callback_get","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","title":"Code"}},{"name":"state","in":"query","required":true,"schema":{"type":"string","title":"State"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/tiktok/accounts":{"get":{"tags":["external-platform"],"summary":"Get Tiktok Accounts","description":"Get TikTok advertiser accounts for the authenticated company profile.","operationId":"get_tiktok_accounts_api_external_platform_tiktok_accounts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TikTokAccountsResponseModel"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/tiktok/activation":{"get":{"tags":["external-platform"],"summary":"Get Tiktok Activation","operationId":"get_tiktok_activation_api_external_platform_tiktok_activation_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/tiktok/activate":{"post":{"tags":["external-platform"],"summary":"Activate Tiktok Ads Account","operationId":"activate_tiktok_ads_account_api_external_platform_tiktok_activate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TikTokActivateAccountRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/tiktok/disconnect":{"post":{"tags":["external-platform"],"summary":"Disconnect Tiktok Ads","operationId":"disconnect_tiktok_ads_api_external_platform_tiktok_disconnect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/tiktok/launch-video-ad":{"post":{"tags":["external-platform"],"summary":"Launch Tiktok Video Ad","description":"Start a TikTok launch job and return tracking info.","operationId":"launch_tiktok_video_ad_api_external_platform_tiktok_launch_video_ad_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TikTokLaunchVideoAdRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/tiktok/sync-ad-campaign/preview":{"post":{"tags":["external-platform"],"summary":"Preview Tiktok Sync","description":"Preview saved Pomo changes for a normalized TikTok video ad.","operationId":"preview_tiktok_sync_api_external_platform_tiktok_sync_ad_campaign_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TikTokSyncPreviewRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/tiktok/sync-ad-campaign":{"post":{"tags":["external-platform"],"summary":"Sync Tiktok Ad Campaign","description":"Queue a normalized TikTok sync job and return tracking info.","operationId":"sync_tiktok_ad_campaign_api_external_platform_tiktok_sync_ad_campaign_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TikTokSyncAdRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/tiktok/ad/pause":{"post":{"tags":["external-platform"],"summary":"Pause Tiktok Ad","operationId":"pause_tiktok_ad_api_external_platform_tiktok_ad_pause_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TikTokAdPauseRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TikTokAdStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/tiktok/ad/resume":{"post":{"tags":["external-platform"],"summary":"Resume Tiktok Ad","operationId":"resume_tiktok_ad_api_external_platform_tiktok_ad_resume_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TikTokAdResumeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TikTokAdStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/chatgpt/connect":{"post":{"tags":["external-platform"],"summary":"Connect Chatgpt Ads Route","description":"Verify a pasted Advertiser API key, store it encrypted and (auto-)activate.","operationId":"connect_chatgpt_ads_route_api_external_platform_chatgpt_connect_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatGptAdsConnectRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/chatgpt/accounts":{"get":{"tags":["external-platform"],"summary":"Get Chatgpt Ads Accounts","operationId":"get_chatgpt_ads_accounts_api_external_platform_chatgpt_accounts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatGptAdsAccountsResponseModel"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/chatgpt/activation":{"get":{"tags":["external-platform"],"summary":"Get Chatgpt Ads Activation","operationId":"get_chatgpt_ads_activation_api_external_platform_chatgpt_activation_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/chatgpt/activate":{"post":{"tags":["external-platform"],"summary":"Activate Chatgpt Ads Account Route","operationId":"activate_chatgpt_ads_account_route_api_external_platform_chatgpt_activate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatGptAdsActivateAccountRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/chatgpt/status":{"get":{"tags":["external-platform"],"summary":"Get Chatgpt Ads Status","description":"Connection state plus a fresh account read (brand review, account status).","operationId":"get_chatgpt_ads_status_api_external_platform_chatgpt_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/chatgpt/conversions/events":{"get":{"tags":["external-platform"],"summary":"Get Chatgpt Conversion Events","description":"The account's conversion events, live, for the card editor's \"Optimize for\" picker.\n\nReturns ``{pixel, events: [{event_type, name, id}], ready, reason,\nhelp_url, ads_manager_url}``; ``ready`` false means a conversions card\ncannot launch yet and ``reason`` says what to set up where.","operationId":"get_chatgpt_conversion_events_api_external_platform_chatgpt_conversions_events_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/chatgpt/disconnect":{"post":{"tags":["external-platform"],"summary":"Disconnect Chatgpt Ads","operationId":"disconnect_chatgpt_ads_api_external_platform_chatgpt_disconnect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/chatgpt/launch-chat-card-ad":{"post":{"tags":["external-platform"],"summary":"Launch Chatgpt Chat Card Ad","description":"Reserve the service fee and queue the native chat-card launch job.","operationId":"launch_chatgpt_chat_card_ad_api_external_platform_chatgpt_launch_chat_card_ad_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatGptLaunchChatCardRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/chatgpt/campaign/pause":{"post":{"tags":["external-platform"],"summary":"Chatgpt Campaign Pause","operationId":"chatgpt_campaign_pause_api_external_platform_chatgpt_campaign_pause_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatGptCampaignActionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/chatgpt/campaign/resume":{"post":{"tags":["external-platform"],"summary":"Chatgpt Campaign Resume","operationId":"chatgpt_campaign_resume_api_external_platform_chatgpt_campaign_resume_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatGptCampaignActionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/chatgpt/sync-ad-campaign/preview":{"post":{"tags":["external-platform"],"summary":"Preview Chatgpt Sync","description":"What a sync would send: the saved (or pending) edit narrowed to what OpenAI accepts.\n\nThe confirm screen shows the same verdict the job reaches, so a field the\nexecutor cannot send is named here, before the marketer commits.","operationId":"preview_chatgpt_sync_api_external_platform_chatgpt_sync_ad_campaign_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatGptSyncPreviewRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/chatgpt/sync-ad-campaign":{"post":{"tags":["external-platform"],"summary":"Sync Chatgpt Ad Campaign","description":"Queue the reviewed sync job; OpenAI is written to only inside the job.","operationId":"sync_chatgpt_ad_campaign_api_external_platform_chatgpt_sync_ad_campaign_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatGptSyncAdRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/chatgpt/ad/{ad_id}/preview":{"get":{"tags":["external-platform"],"summary":"Chatgpt Ad Preview","description":"Provider-rendered preview HTML for a launched chat card (embedded in a sandboxed iframe).","operationId":"chatgpt_ad_preview_api_external_platform_chatgpt_ad__ad_id__preview_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ad_id","in":"path","required":true,"schema":{"type":"string","title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/tiktok-social/auth":{"get":{"tags":["external-platform"],"summary":"Tiktok Social Auth","operationId":"tiktok_social_auth_api_external_platform_tiktok_social_auth_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/tiktok-social/callback":{"get":{"tags":["external-platform"],"summary":"Tiktok Social Callback","operationId":"tiktok_social_callback_api_external_platform_tiktok_social_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"type":"string","title":"Code"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","title":"State"}},{"name":"error","in":"query","required":false,"schema":{"type":"string","title":"Error"}},{"name":"error_description","in":"query","required":false,"schema":{"type":"string","title":"Error Description"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/tiktok-social/status":{"get":{"tags":["external-platform"],"summary":"Tiktok Social Status","operationId":"tiktok_social_status_api_external_platform_tiktok_social_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/tiktok-social/accounts":{"get":{"tags":["external-platform"],"summary":"Tiktok Social Accounts","operationId":"tiktok_social_accounts_api_external_platform_tiktok_social_accounts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/tiktok-social/creator-info":{"post":{"tags":["external-platform"],"summary":"Tiktok Social Creator Info","operationId":"tiktok_social_creator_info_api_external_platform_tiktok_social_creator_info_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/tiktok-social/publish-settings":{"post":{"tags":["external-platform"],"summary":"Save Tiktok Social Publish Settings","operationId":"save_tiktok_social_publish_settings_api_external_platform_tiktok_social_publish_settings_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TikTokSocialPublishSettingsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/tiktok-social/post-campaign":{"post":{"tags":["external-platform"],"summary":"Post Campaign To Tiktok Social","operationId":"post_campaign_to_tiktok_social_api_external_platform_tiktok_social_post_campaign_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TikTokSocialPostCampaignRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/tiktok-social/publish-status/{publish_id}":{"get":{"tags":["external-platform"],"summary":"Tiktok Social Publish Status","operationId":"tiktok_social_publish_status_api_external_platform_tiktok_social_publish_status__publish_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"publish_id","in":"path","required":true,"schema":{"type":"string","title":"Publish Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/tiktok-social/disconnect":{"post":{"tags":["external-platform"],"summary":"Disconnect Tiktok Social","operationId":"disconnect_tiktok_social_api_external_platform_tiktok_social_disconnect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/youtube-social/auth":{"get":{"tags":["external-platform"],"summary":"Youtube Social Auth","operationId":"youtube_social_auth_api_external_platform_youtube_social_auth_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/youtube-social/callback":{"get":{"tags":["external-platform"],"summary":"Youtube Social Callback","operationId":"youtube_social_callback_api_external_platform_youtube_social_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},{"name":"error","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},{"name":"error_description","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Description"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/youtube-social/status":{"get":{"tags":["external-platform"],"summary":"Youtube Social Status","operationId":"youtube_social_status_api_external_platform_youtube_social_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/youtube-social/accounts":{"get":{"tags":["external-platform"],"summary":"Youtube Social Accounts","operationId":"youtube_social_accounts_api_external_platform_youtube_social_accounts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/youtube-social/disconnect":{"post":{"tags":["external-platform"],"summary":"Disconnect Youtube Social","operationId":"disconnect_youtube_social_api_external_platform_youtube_social_disconnect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/youtube-social/post-campaign":{"post":{"tags":["external-platform"],"summary":"Post Campaign To Youtube Social","description":"Publish one approved, server-owned campaign video to the owned channel.","operationId":"post_campaign_to_youtube_social_api_external_platform_youtube_social_post_campaign_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/YouTubeSocialPostCampaignRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin/auth":{"get":{"tags":["external-platform"],"summary":"Linkedin Auth","operationId":"linkedin_auth_api_external_platform_linkedin_auth_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"integration_type","in":"query","required":false,"schema":{"type":"string","description":"One of: ads, social","default":"ads","title":"Integration Type"},"description":"One of: ads, social"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/linkedin/callback":{"get":{"tags":["external-platform"],"summary":"Linkedin Callback","operationId":"linkedin_callback_api_external_platform_linkedin_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"type":"string","title":"Code"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","title":"State"}},{"name":"error","in":"query","required":false,"schema":{"type":"string","title":"Error"}},{"name":"error_description","in":"query","required":false,"schema":{"type":"string","title":"Error Description"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/linkedin/accounts":{"get":{"tags":["external-platform"],"summary":"Get Linkedin Ad Accounts","description":"Get LinkedIn ad accounts for the connected Ads integration.","operationId":"get_linkedin_ad_accounts_api_external_platform_linkedin_accounts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin/activation":{"get":{"tags":["external-platform"],"summary":"Get Linkedin Ads Activation","description":"Get LinkedIn Ads activation state and accessible ad accounts.","operationId":"get_linkedin_ads_activation_api_external_platform_linkedin_activation_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin/activate":{"post":{"tags":["external-platform"],"summary":"Activate Linkedin Ads Account","description":"Activate one LinkedIn ad account and organization for future launches.","operationId":"activate_linkedin_ads_account_api_external_platform_linkedin_activate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInActivateAccountRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin/campaign/action":{"post":{"tags":["external-platform"],"summary":"Linkedin Campaign Action","operationId":"linkedin_campaign_action_api_external_platform_linkedin_campaign_action_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInCampaignActionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin/campaign/resume":{"post":{"tags":["external-platform"],"summary":"Linkedin Campaign Resume","operationId":"linkedin_campaign_resume_api_external_platform_linkedin_campaign_resume_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInCampaignResumeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin/sync-ad-campaign/preview":{"post":{"tags":["external-platform"],"summary":"Preview Linkedin Sync","operationId":"preview_linkedin_sync_api_external_platform_linkedin_sync_ad_campaign_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInSyncPreviewRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin/sync-ad-campaign":{"post":{"tags":["external-platform"],"summary":"Sync Linkedin Ad Campaign","operationId":"sync_linkedin_ad_campaign_api_external_platform_linkedin_sync_ad_campaign_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInSyncAdCampaignRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin/launch-image-ad":{"post":{"tags":["external-platform"],"summary":"Launch Linkedin Image Ad","operationId":"launch_linkedin_image_ad_api_external_platform_linkedin_launch_image_ad_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInLaunchImageAdRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin/launch-video-ad":{"post":{"tags":["external-platform"],"summary":"Launch Linkedin Video Ad","operationId":"launch_linkedin_video_ad_api_external_platform_linkedin_launch_video_ad_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInLaunchVideoAdRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin/status":{"get":{"tags":["external-platform"],"summary":"Linkedin Ads Status","description":"Get LinkedIn Ads integration status.\n\nNote: the Integrations UI uses `/guided-workflow/check-integrations` for the\nConnected badge (same pattern as Google/Meta). This endpoint is kept for\ndeeper validation and manual testing.","operationId":"linkedin_ads_status_api_external_platform_linkedin_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin/disconnect":{"post":{"tags":["external-platform"],"summary":"Disconnect Linkedin Ads","description":"Disconnect LinkedIn Ads integration.\n\nNot currently exposed in production UI; kept for manual testing.","operationId":"disconnect_linkedin_ads_api_external_platform_linkedin_disconnect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin-social/auth":{"get":{"tags":["external-platform"],"summary":"Linkedin Social Auth","description":"Backward-compatible alias for starting LinkedIn OAuth for social posting.\nPrefer `/linkedin/auth?integration_type=social`.","operationId":"linkedin_social_auth_api_external_platform_linkedin_social_auth_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin-social/status":{"get":{"tags":["external-platform"],"summary":"Linkedin Social Status","description":"Get LinkedIn social integration status.","operationId":"linkedin_social_status_api_external_platform_linkedin_social_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin-social/accounts":{"get":{"tags":["external-platform"],"summary":"Linkedin Social Accounts","description":"Get administered LinkedIn Pages available to this brand connection.","operationId":"linkedin_social_accounts_api_external_platform_linkedin_social_accounts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin-social/activation":{"get":{"tags":["external-platform"],"summary":"Get Linkedin Social Activation","description":"Return connection state and administered Pages available for activation.","operationId":"get_linkedin_social_activation_api_external_platform_linkedin_social_activation_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin-social/activate":{"post":{"tags":["external-platform"],"summary":"Activate Linkedin Social Page","operationId":"activate_linkedin_social_page_api_external_platform_linkedin_social_activate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInSocialActivateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin/post-campaign":{"post":{"tags":["external-platform"],"summary":"Post Campaign To Linkedin","description":"Publish a social post campaign as the brand's activated LinkedIn Page.","operationId":"post_campaign_to_linkedin_api_external_platform_linkedin_post_campaign_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInPostCampaignRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin/delete-campaign-post":{"post":{"tags":["external-platform"],"summary":"Delete Campaign Post From Linkedin","description":"Delete a published LinkedIn campaign post and update local status.","operationId":"delete_campaign_post_from_linkedin_api_external_platform_linkedin_delete_campaign_post_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInCampaignPostRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin/sync-post-status":{"post":{"tags":["external-platform"],"summary":"Sync Linkedin Campaign Post Status","description":"Refresh one LinkedIn post status from remote API.","operationId":"sync_linkedin_campaign_post_status_api_external_platform_linkedin_sync_post_status_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkedInCampaignPostRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/linkedin-social/disconnect":{"post":{"tags":["external-platform"],"summary":"Disconnect Linkedin Social","description":"Disconnect LinkedIn social integration.","operationId":"disconnect_linkedin_social_api_external_platform_linkedin_social_disconnect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/shopify/callback":{"get":{"tags":["external-platform"],"summary":"Shopify Callback","description":"Tombstone the retired authorization-code callback.","operationId":"shopify_callback_api_external_platform_shopify_callback_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/external-platform/shopify/install":{"get":{"tags":["external-platform"],"summary":"Shopify Install","description":"Tombstone the retired authorization-code install entry.","operationId":"shopify_install_api_external_platform_shopify_install_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/external-platform/shopify/install/launch":{"get":{"tags":["external-platform"],"summary":"Shopify Install Launch","description":"Tombstone the retired OAuth launch hop.","operationId":"shopify_install_launch_api_external_platform_shopify_install_launch_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/external-platform/shopify/connect/start":{"post":{"tags":["external-platform"],"summary":"Shopify Connect Start","description":"Reject the retired Pomo-origin activation path.\n\nShopify installation and billing must begin in Shopify Admin. Keeping the\nroute as an authenticated tombstone prevents an older Pomo client from\nsilently falling back to the obsolete OAuth/on-ramp workflow.","operationId":"shopify_connect_start_api_external_platform_shopify_connect_start_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/shopify/install/continue":{"get":{"tags":["external-platform"],"summary":"Shopify Install Continue","description":"Redeem the managed App Home continuation and enter Clerk linking.\n\nThe short-lived URL token contains no provider credential. Redemption is\natomic in Redis and produces the longer-lived httpOnly claim cookie used by\nauthenticated resolve, so copying or replaying the URL cannot create a\nsecond browser claim.","operationId":"shopify_install_continue_api_external_platform_shopify_install_continue_get","parameters":[{"name":"token","in":"query","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/shopify/install/resolve":{"post":{"tags":["external-platform"],"summary":"Shopify Install Resolve","description":"Authenticated Shopify-initiated resolution. Claims the pending install for\nthe user, then applies the §7 organization/profile matrix. Returns the\nresolved action + redirect, or a picker payload (needs_org / needs_profile).","operationId":"shopify_install_resolve_api_external_platform_shopify_install_resolve_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShopifyInstallResolveRequestModel"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Shopify Install Resolve Api External Platform Shopify Install Resolve Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/shopify/privacy/webhooks":{"post":{"tags":["external-platform"],"summary":"Shopify Privacy Webhook","description":"Receive Shopify mandatory privacy compliance webhooks.\n\nThe endpoint is intentionally unauthenticated because Shopify authenticates\nthe delivery with X-Shopify-Hmac-SHA256 over the raw body.","operationId":"shopify_privacy_webhook_api_external_platform_shopify_privacy_webhooks_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Shopify Privacy Webhook Api External Platform Shopify Privacy Webhooks Post"}}}}}}},"/api/external-platform/shopify/webhooks/app-uninstalled":{"post":{"tags":["external-platform"],"summary":"Shopify App Uninstalled Webhook","description":"Handle Shopify's app/uninstalled webhook.\n\nShopify authenticates delivery with X-Shopify-Hmac-SHA256 over the raw\nbody. Verified deliveries are durably recorded and acknowledged before a\nworker retires the installation and clears its now-dead local credential.","operationId":"shopify_app_uninstalled_webhook_api_external_platform_shopify_webhooks_app_uninstalled_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Shopify App Uninstalled Webhook Api External Platform Shopify Webhooks App Uninstalled Post"}}}}}}},"/api/external-platform/shopify/shop":{"get":{"tags":["external-platform"],"summary":"Get Shopify Shop","description":"Get connected Shopify shop information.\n\nReturns connection status and shop details if connected.","operationId":"get_shopify_shop_api_external_platform_shopify_shop_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShopifyShopResponseModel"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/shopify/status":{"get":{"tags":["external-platform"],"summary":"Get Shopify Status","description":"Get Shopify connection status with optional health check.\n\nShopify tokens expire roughly every 60 minutes. Use check_health=true to\nrefresh the stored access token if needed and then verify it with a live API\ncall. Refreshing from mf-core is safe because token refreshes are serialized\nwith the UDM pipeline via the shared per-integration advisory lock, so a\nrefresh here can no longer race the pipeline's rotation.\n\nArgs:\n    check_health: If true, refresh if needed and perform a live API call to\n        verify token validity","operationId":"get_shopify_status_api_external_platform_shopify_status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"check_health","in":"query","required":false,"schema":{"type":"boolean","description":"Perform live health check","default":false,"title":"Check Health"},"description":"Perform live health check"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShopifyStatusResponseModel"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/shopify/disconnect":{"delete":{"tags":["external-platform"],"summary":"Disconnect Shopify","description":"Disconnect Shopify integration.\n\nThis uninstalls the app from Shopify before soft-deleting local credentials.","operationId":"disconnect_shopify_api_external_platform_shopify_disconnect_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceDisconnectResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/shopify/app-home":{"get":{"tags":["external-platform"],"summary":"Shopify App Home","description":"Serve the embedded App Home HTML shell with a shop-scoped framing policy.\n\nNot session-token authed: this serves the shell before App Bridge exists.\nThe ``shop`` param is validated (SSRF-safe) and 400 on anything that is not a\nreal myshopify domain.","operationId":"shopify_app_home_api_external_platform_shopify_app_home_get","parameters":[{"name":"shop","in":"query","required":true,"schema":{"type":"string","title":"Shop"}},{"name":"host","in":"query","required":false,"schema":{"type":"string","default":"","title":"Host"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/shopify/app/status":{"get":{"tags":["external-platform"],"summary":"Shopify App Status","description":"Return the App Home status for the session token's shop.\n\nAlways 200 for a valid token. Unbound shops yield ``bound=false`` with the\nshop domain still populated; every profile-related field is null.","operationId":"shopify_app_status_api_external_platform_shopify_app_status_get","parameters":[{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Re-read Shopify billing authority","default":false,"title":"Force Refresh"},"description":"Re-read Shopify billing authority"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppHomeStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/shopify/app/sync":{"post":{"tags":["external-platform"],"summary":"Shopify App Sync","description":"Start/recover catalog onboarding, or read its existing completion state.\n\n409 when the shop is not bound to any Pomo profile (there is nothing to sync).","operationId":"shopify_app_sync_api_external_platform_shopify_app_sync_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppHomeSyncResponse"}}}}}}},"/api/external-platform/shopify/app/begin-install":{"post":{"tags":["external-platform"],"summary":"Shopify App Begin Install","description":"Exchange the App Bridge ID token and create a Pomo link continuation.\n\nShopify already installed the app and granted the TOML scopes. This action\ntherefore performs token exchange directly and never redirects through the\nlegacy authorization-code grant.","operationId":"shopify_app_begin_install_api_external_platform_shopify_app_begin_install_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppHomeBeginInstallResponse"}}}}}}},"/api/external-platform/shopify/subscription":{"get":{"tags":["external-platform"],"summary":"Get Shopify Subscription Summary","description":"Show the selected store's last verified plan, never change its billing.\n\nExisting dependencies enforce Clerk identity, organization administrator\nmembership, profile access and matching request scope. Subscription access\nis deliberately not required: cancelled merchants must still manage plans.","operationId":"get_shopify_subscription_summary_api_external_platform_shopify_subscription_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Force Refresh"}},{"name":"X-Organization-Id","in":"header","required":true,"schema":{"type":"string","format":"uuid","title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShopifySubscriptionSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/stripe/auth":{"get":{"tags":["external-platform"],"summary":"Stripe Auth","description":"Get Stripe Connect OAuth authorization URL.","operationId":"stripe_auth_api_external_platform_stripe_auth_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"write_access","in":"query","required":false,"schema":{"type":"boolean","description":"Request read_write access instead of read_only","default":false,"title":"Write Access"},"description":"Request read_write access instead of read_only"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceAuthResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/stripe/callback":{"get":{"tags":["external-platform"],"summary":"Stripe Callback","description":"Handle Stripe Connect OAuth callback and store tokens.\n\nCRITICAL: Authorization codes can only be used ONCE.\nThe state verification also prevents replay attacks.\nStores credentials in data_source_integrations table.","operationId":"stripe_callback_api_external_platform_stripe_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"type":"string","title":"Code"}},{"name":"state","in":"query","required":true,"schema":{"type":"string","title":"State"}},{"name":"error","in":"query","required":false,"schema":{"type":"string","title":"Error"}},{"name":"error_description","in":"query","required":false,"schema":{"type":"string","title":"Error Description"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/stripe/account":{"get":{"tags":["external-platform"],"summary":"Get Stripe Account","description":"Get connected Stripe account information.\n\nReturns connection status and account details if connected.","operationId":"get_stripe_account_api_external_platform_stripe_account_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceAccountResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/stripe/status":{"get":{"tags":["external-platform"],"summary":"Get Stripe Status","description":"Get Stripe connection status with optional health check.\n\nStripe tokens don't expire but can be revoked. Use check_health=true\nto verify the token is still valid by making a live API call.\n\nArgs:\n    check_health: If true, perform a live API call to verify token validity","operationId":"get_stripe_status_api_external_platform_stripe_status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"check_health","in":"query","required":false,"schema":{"type":"boolean","description":"Perform live health check","default":false,"title":"Check Health"},"description":"Perform live health check"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StripeStatusResponseModel"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/stripe/transactions":{"get":{"tags":["external-platform"],"summary":"Get Stripe Transactions","description":"Get balance transactions from connected Stripe account.","operationId":"get_stripe_transactions_api_external_platform_stripe_transactions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":100,"title":"Limit"}},{"name":"starting_after","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Starting After"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceTransactionsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/stripe/disconnect":{"delete":{"tags":["external-platform"],"summary":"Disconnect Stripe","description":"Disconnect Stripe account.\n\nThis deauthorizes on Stripe's side before soft-deleting the local integration.","operationId":"disconnect_stripe_api_external_platform_stripe_disconnect_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceDisconnectResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/quickbooks/auth":{"get":{"tags":["external-platform"],"summary":"Quickbooks Auth","description":"Get QuickBooks Online OAuth authorization URL.","operationId":"quickbooks_auth_api_external_platform_quickbooks_auth_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceAuthResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/quickbooks/callback":{"get":{"tags":["external-platform"],"summary":"Quickbooks Callback","description":"Handle QuickBooks Online OAuth callback and store tokens.\n\nIntuit callback includes realmId which must be stored to call the Accounting API.","operationId":"quickbooks_callback_api_external_platform_quickbooks_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"type":"string","title":"Code"}},{"name":"realmId","in":"query","required":false,"schema":{"type":"string","description":"QuickBooks company ID (realmId)","title":"Realmid"},"description":"QuickBooks company ID (realmId)"},{"name":"state","in":"query","required":true,"schema":{"type":"string","title":"State"}},{"name":"error","in":"query","required":false,"schema":{"type":"string","title":"Error"}},{"name":"error_description","in":"query","required":false,"schema":{"type":"string","title":"Error Description"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/quickbooks/account":{"get":{"tags":["external-platform"],"summary":"Get Quickbooks Account","description":"Get connected QuickBooks account information (realm + company name if available).","operationId":"get_quickbooks_account_api_external_platform_quickbooks_account_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceAccountResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/quickbooks/status":{"get":{"tags":["external-platform"],"summary":"Get Quickbooks Status","description":"Get QuickBooks connection status with optional health check.\n\nWhen check_health=true, performs a lightweight CompanyInfo call only if the\ncurrently stored access token is still fresh. Databricks owns token refresh\nfor UDM data-platform flows.","operationId":"get_quickbooks_status_api_external_platform_quickbooks_status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"check_health","in":"query","required":false,"schema":{"type":"boolean","description":"Perform live health check","default":false,"title":"Check Health"},"description":"Perform live health check"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickBooksStatusResponseModel"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/quickbooks/disconnect":{"delete":{"tags":["external-platform"],"summary":"Disconnect Quickbooks","description":"Disconnect QuickBooks account after revoking provider-side tokens.","operationId":"disconnect_quickbooks_api_external_platform_quickbooks_disconnect_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceDisconnectResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/quickbooks/initial-sync-status":{"get":{"tags":["external-platform"],"summary":"Get Initial Sync Status","description":"Get the status of the initial data sync triggered after OAuth connection.\n\nReturns the current sync status and, if still running, polls Databricks\nfor the latest status.","operationId":"get_initial_sync_status_api_external_platform_quickbooks_initial_sync_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InitialSyncStatusResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google-analytics/auth":{"get":{"tags":["external-platform"],"summary":"Google Analytics Auth","description":"Get Google Analytics OAuth authorization URL.","operationId":"google_analytics_auth_api_external_platform_google_analytics_auth_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceAuthResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google-analytics/callback":{"get":{"tags":["external-platform"],"summary":"Google Analytics Callback","description":"Handle Google Analytics OAuth callback and store tokens.","operationId":"google_analytics_callback_api_external_platform_google_analytics_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"type":"string","title":"Code"}},{"name":"state","in":"query","required":true,"schema":{"type":"string","title":"State"}},{"name":"error","in":"query","required":false,"schema":{"type":"string","title":"Error"}},{"name":"error_description","in":"query","required":false,"schema":{"type":"string","title":"Error Description"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/google-analytics/status":{"get":{"tags":["external-platform"],"summary":"Get Google Analytics Status","description":"Get Google Analytics connection status with optional live health check.","operationId":"get_google_analytics_status_api_external_platform_google_analytics_status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"check_health","in":"query","required":false,"schema":{"type":"boolean","description":"Perform live health check","default":false,"title":"Check Health"},"description":"Perform live health check"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAnalyticsStatusResponseModel"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/google-analytics/properties":{"get":{"tags":["external-platform"],"summary":"Get Google Analytics Properties","description":"List accessible GA4 properties for the connected Google account.","operationId":"get_google_analytics_properties_api_external_platform_google_analytics_properties_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Refresh property list from Google","default":false,"title":"Refresh"},"description":"Refresh property list from Google"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAnalyticsPropertiesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/google-analytics/traffic":{"get":{"tags":["external-platform"],"summary":"Get Google Analytics Traffic","description":"Return selected-property GA4 observations persisted in Postgres.","operationId":"get_google_analytics_traffic_api_external_platform_google_analytics_traffic_get","security":[{"HTTPBearer":[]}],"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":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20000,"minimum":1,"default":5000,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GoogleAnalyticsTrafficRow"},"title":"Response Get Google Analytics Traffic Api External Platform Google Analytics Traffic Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/google-analytics/organic-summary":{"get":{"tags":["external-platform"],"summary":"Get Google Analytics Organic Summary","description":"Aggregate organic sessions for the SEO overview without row downloads.","operationId":"get_google_analytics_organic_summary_api_external_platform_google_analytics_organic_summary_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"current_start","in":"query","required":true,"schema":{"type":"string","format":"date","title":"Current Start"}},{"name":"current_end","in":"query","required":true,"schema":{"type":"string","format":"date","title":"Current End"}},{"name":"previous_start","in":"query","required":true,"schema":{"type":"string","format":"date","title":"Previous Start"}},{"name":"previous_end","in":"query","required":true,"schema":{"type":"string","format":"date","title":"Previous End"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/google-analytics/properties/select":{"post":{"tags":["external-platform"],"summary":"Select Google Analytics Property","description":"Select the GA4 property and import its traffic into Postgres.","operationId":"select_google_analytics_property_api_external_platform_google_analytics_properties_select_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAnalyticsPropertySelectRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAnalyticsPropertySelectResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google-analytics/disconnect":{"delete":{"tags":["external-platform"],"summary":"Disconnect Google Analytics","description":"Disconnect Google Analytics after revoking the Google OAuth grant.","operationId":"disconnect_google_analytics_api_external_platform_google_analytics_disconnect_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceDisconnectResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/google-analytics/initial-sync-status":{"get":{"tags":["external-platform"],"summary":"Get Google Analytics Initial Sync Status","description":"Get the status of the selected property's Postgres traffic sync.","operationId":"get_google_analytics_initial_sync_status_api_external_platform_google_analytics_initial_sync_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleAnalyticsInitialSyncStatusResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/gmail/oauth/start":{"post":{"tags":["external-platform"],"summary":"Start Gmail Oauth","operationId":"start_gmail_oauth_api_external_platform_gmail_oauth_start_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmailOAuthStartResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/gmail/status":{"get":{"tags":["external-platform"],"summary":"Get Gmail Status","operationId":"get_gmail_status_api_external_platform_gmail_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmailStatusResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/gmail/account":{"delete":{"tags":["external-platform"],"summary":"Disconnect Gmail","operationId":"disconnect_gmail_api_external_platform_gmail_account_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GmailDisconnectResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/email-conversations/manual-send":{"post":{"tags":["email-conversations"],"summary":"Send Manual Email","operationId":"send_manual_email_api_email_conversations_manual_send_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManualEmailSendRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManualEmailSendResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/email-conversations/new-send":{"post":{"tags":["email-conversations"],"summary":"Send New Email","operationId":"send_new_email_api_email_conversations_new_send_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewEmailSendRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewEmailSendResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/email-conversations/manual-send/status":{"get":{"tags":["email-conversations"],"summary":"Get Manual Email Status","operationId":"get_manual_email_status_api_email_conversations_manual_send_status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"idempotency_key","in":"query","required":true,"schema":{"type":"string","minLength":8,"maxLength":128,"title":"Idempotency Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManualEmailSendStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/email-conversations":{"get":{"tags":["email-conversations"],"summary":"List Local Email Conversations","operationId":"list_local_email_conversations_api_email_conversations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor_recorded_at","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cursor Recorded At"}},{"name":"cursor_conversation_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Cursor Conversation Id"}},{"name":"cursor_message_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Cursor Message Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocalEmailConversationListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/email-conversations/person-history":{"get":{"tags":["email-conversations"],"summary":"Get Local Email Person History","operationId":"get_local_email_person_history_api_email_conversations_person_history_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"person_ref","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":512,"title":"Person Ref"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor_recorded_at","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cursor Recorded At"}},{"name":"cursor_conversation_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Cursor Conversation Id"}},{"name":"cursor_message_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Cursor Message Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocalEmailPersonHistoryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/email-conversations/{conversation_id}":{"get":{"tags":["email-conversations"],"summary":"Get Local Email Conversation","operationId":"get_local_email_conversation_api_email_conversations__conversation_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocalEmailConversationThreadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/square/auth":{"get":{"tags":["external-platform"],"summary":"Square Auth","description":"Get Square OAuth authorization URL.","operationId":"square_auth_api_external_platform_square_auth_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"write_access","in":"query","required":false,"schema":{"type":"boolean","description":"Request write scopes for sandbox seeding or re-auth","default":false,"title":"Write Access"},"description":"Request write scopes for sandbox seeding or re-auth"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceAuthResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/square/callback":{"get":{"tags":["external-platform"],"summary":"Square Callback","description":"Handle Square OAuth callback and store tokens.\n\nStores credentials in data_source_integrations table.","operationId":"square_callback_api_external_platform_square_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"type":"string","title":"Code"}},{"name":"state","in":"query","required":true,"schema":{"type":"string","title":"State"}},{"name":"error","in":"query","required":false,"schema":{"type":"string","title":"Error"}},{"name":"error_description","in":"query","required":false,"schema":{"type":"string","title":"Error Description"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/square/webhooks":{"post":{"tags":["external-platform"],"summary":"Square Webhook","description":"Receive Square lifecycle webhooks.\n\nThe endpoint is unauthenticated because Square authenticates webhook\ndelivery with x-square-hmacsha256-signature over the configured\nnotification URL plus raw request body.","operationId":"square_webhook_api_external_platform_square_webhooks_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Square Webhook Api External Platform Square Webhooks Post"}}}}}}},"/api/external-platform/square/status":{"get":{"tags":["external-platform"],"summary":"Get Square Status","description":"Get Square connection status with optional health check.\n\nArgs:\n    check_health: If true, perform a live API call to verify token validity","operationId":"get_square_status_api_external_platform_square_status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"check_health","in":"query","required":false,"schema":{"type":"boolean","description":"Perform live health check","default":false,"title":"Check Health"},"description":"Perform live health check"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SquareStatusResponseModel"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/square/accounts":{"get":{"tags":["external-platform"],"summary":"Get Square Accounts","description":"Get Square locations/accounts for the authenticated company.\n\nReturns locations as \"accounts\" to maintain consistency with other platforms.","operationId":"get_square_accounts_api_external_platform_square_accounts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceLocationsResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/square/disconnect":{"delete":{"tags":["external-platform"],"summary":"Disconnect Square","description":"Disconnect Square account.\n\nThis revokes the Square OAuth authorization before soft-deleting the local integration.","operationId":"disconnect_square_api_external_platform_square_disconnect_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceDisconnectResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/klaviyo/auth":{"get":{"tags":["external-platform"],"summary":"Klaviyo Auth","description":"Get Klaviyo OAuth authorization URL with PKCE for the current company profile.\n\nReturns:\n    KlaviyoAuthResponse with the OAuth authorization URL","operationId":"klaviyo_auth_api_external_platform_klaviyo_auth_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KlaviyoAuthResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/klaviyo/callback":{"get":{"tags":["external-platform"],"summary":"Klaviyo Callback","description":"Handle Klaviyo OAuth callback with PKCE and store tokens.\n\nStores credentials in data_source_integrations table.","operationId":"klaviyo_callback_api_external_platform_klaviyo_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"type":"string","title":"Code"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","title":"State"}},{"name":"error","in":"query","required":false,"schema":{"type":"string","title":"Error"}},{"name":"error_description","in":"query","required":false,"schema":{"type":"string","title":"Error Description"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/klaviyo/accounts":{"get":{"tags":["external-platform"],"summary":"Get Klaviyo Accounts","description":"Get Klaviyo lists and segments for the authenticated company.\n\nReturns lists and segments as \"accounts\" to maintain consistency with other platforms.","operationId":"get_klaviyo_accounts_api_external_platform_klaviyo_accounts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KlaviyoAccountsResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/klaviyo/status":{"get":{"tags":["external-platform"],"summary":"Get Klaviyo Status","description":"Check Klaviyo integration status for the current company profile.","operationId":"get_klaviyo_status_api_external_platform_klaviyo_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KlaviyoStatusResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/klaviyo/health":{"get":{"tags":["external-platform"],"summary":"Get Klaviyo Health","description":"Get Klaviyo connection health status.\n\nCritical for monitoring 10-minute token expiry.","operationId":"get_klaviyo_health_api_external_platform_klaviyo_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KlaviyoHealthResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/klaviyo/disconnect":{"post":{"tags":["external-platform"],"summary":"Disconnect Klaviyo","description":"Disconnect Klaviyo integration by revoking tokens and marking as inactive.","operationId":"disconnect_klaviyo_api_external_platform_klaviyo_disconnect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/{platform}/initial-sync-status":{"get":{"tags":["external-platform"],"summary":"Get Provider Initial Sync Status","description":"Get initial Databricks sync status for a supported data-source provider.","operationId":"get_provider_initial_sync_status_api_external_platform__platform__initial_sync_status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"platform","in":"path","required":true,"schema":{"type":"string","title":"Platform"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InitialSyncStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/slack/auth":{"get":{"tags":["external-platform"],"summary":"Slack Auth","operationId":"slack_auth_api_external_platform_slack_auth_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceAuthResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/slack/callback":{"get":{"tags":["external-platform"],"summary":"Slack Callback","operationId":"slack_callback_api_external_platform_slack_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"}},{"name":"state","in":"query","required":true,"schema":{"type":"string","title":"State"}},{"name":"error","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},{"name":"error_description","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Description"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/slack/status":{"get":{"tags":["external-platform"],"summary":"Slack Status","operationId":"slack_status_api_external_platform_slack_status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Force Refresh"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/slack/channels":{"get":{"tags":["external-platform"],"summary":"List Slack Channels","operationId":"list_slack_channels_api_external_platform_slack_channels_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackChannelsListResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/slack/settings":{"patch":{"tags":["external-platform"],"summary":"Update Slack Settings","operationId":"update_slack_settings_api_external_platform_slack_settings_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackSettingsUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/slack/proactive-settings":{"get":{"tags":["external-platform"],"summary":"Get Slack Proactive Settings","operationId":"get_slack_proactive_settings_api_external_platform_slack_proactive_settings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackProactiveSettingsResponse"}}}}},"security":[{"HTTPBearer":[]}]},"patch":{"tags":["external-platform"],"summary":"Update Slack Proactive Settings","operationId":"update_slack_proactive_settings_api_external_platform_slack_proactive_settings_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackProactiveSettingsUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackProactiveSettingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/slack/link":{"post":{"tags":["external-platform"],"summary":"Link Slack Identity","operationId":"link_slack_identity_api_external_platform_slack_link_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackLinkRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackLinkResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/slack/disconnect":{"post":{"tags":["external-platform"],"summary":"Slack Disconnect","operationId":"slack_disconnect_api_external_platform_slack_disconnect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceDisconnectResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/slack/channel-bindings":{"get":{"tags":["external-platform"],"summary":"List Slack Channel Bindings","operationId":"list_slack_channel_bindings_api_external_platform_slack_channel_bindings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackChannelBindingsListResponse"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["external-platform"],"summary":"Bind Slack Channel","operationId":"bind_slack_channel_api_external_platform_slack_channel_bindings_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackChannelBindRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackChannelBindResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/slack/channel-audience":{"get":{"tags":["external-platform"],"summary":"Preview Slack Channel Audience","description":"Preview who would gain read access, before anything is bound.","operationId":"preview_slack_channel_audience_api_external_platform_slack_channel_audience_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"slack_channel_id","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":64,"title":"Slack Channel Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackChannelAudienceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/slack/channel-bindings/{slack_channel_id}":{"delete":{"tags":["external-platform"],"summary":"Unbind Slack Channel","operationId":"unbind_slack_channel_api_external_platform_slack_channel_bindings__slack_channel_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"slack_channel_id","in":"path","required":true,"schema":{"type":"string","title":"Slack Channel Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackChannelBindResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/slack/events":{"post":{"tags":["external-platform"],"summary":"Slack Events","operationId":"slack_events_api_external_platform_slack_events_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/external-platform/slack/interactions":{"post":{"tags":["external-platform"],"summary":"Slack Interactions","operationId":"slack_interactions_api_external_platform_slack_interactions_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/external-platform/slack/commands":{"post":{"tags":["external-platform"],"summary":"Slack Commands","operationId":"slack_commands_api_external_platform_slack_commands_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/external-platform/x-social/auth":{"get":{"tags":["social-platform"],"summary":"X Auth","description":"Initiate X (Twitter) OAuth for social posts.","operationId":"x_auth_api_external_platform_x_social_auth_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/x-social/callback":{"get":{"tags":["social-platform"],"summary":"X Callback","description":"Handle X (Twitter) OAuth callback.","operationId":"x_callback_api_external_platform_x_social_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"type":"string","title":"Code"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","title":"State"}},{"name":"error","in":"query","required":false,"schema":{"type":"string","title":"Error"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/x-social/status":{"get":{"tags":["social-platform"],"summary":"Get X Status","description":"Check X connection status.","operationId":"get_x_status_api_external_platform_x_social_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/x-social/disconnect":{"post":{"tags":["social-platform"],"summary":"Disconnect X","description":"Disconnect X integration.","operationId":"disconnect_x_api_external_platform_x_social_disconnect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/facebook-social/auth":{"get":{"tags":["external-platform"],"summary":"Facebook Social Auth","operationId":"facebook_social_auth_api_external_platform_facebook_social_auth_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/facebook-social/callback":{"get":{"tags":["external-platform"],"summary":"Facebook Social Callback","operationId":"facebook_social_callback_api_external_platform_facebook_social_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"type":"string","title":"Code"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","title":"State"}},{"name":"error","in":"query","required":false,"schema":{"type":"string","title":"Error"}},{"name":"error_description","in":"query","required":false,"schema":{"type":"string","title":"Error Description"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/facebook-social/status":{"get":{"tags":["external-platform"],"summary":"Facebook Social Status","operationId":"facebook_social_status_api_external_platform_facebook_social_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/facebook-social/pages":{"get":{"tags":["external-platform"],"summary":"Get Facebook Pages","operationId":"get_facebook_pages_api_external_platform_facebook_social_pages_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/facebook-social/activation":{"get":{"tags":["external-platform"],"summary":"Get Facebook Social Activation","operationId":"get_facebook_social_activation_api_external_platform_facebook_social_activation_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/facebook-social/activate":{"post":{"tags":["external-platform"],"summary":"Activate Facebook Social Page","operationId":"activate_facebook_social_page_api_external_platform_facebook_social_activate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FacebookSocialActivateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/facebook-social/disconnect":{"post":{"tags":["external-platform"],"summary":"Disconnect Facebook Social","operationId":"disconnect_facebook_social_api_external_platform_facebook_social_disconnect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/facebook-social/post-campaign":{"post":{"tags":["external-platform"],"summary":"Post Campaign To Facebook","operationId":"post_campaign_to_facebook_api_external_platform_facebook_social_post_campaign_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FacebookPostCampaignRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostResponseModel"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/facebook-social/delete-post":{"post":{"tags":["external-platform"],"summary":"Delete Facebook Story Post","operationId":"delete_facebook_story_post_api_external_platform_facebook_social_delete_post_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletePostRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletePostResponseModel"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/tiktok-business/callback/":{"get":{"tags":["external-platform"],"summary":"Tiktok Business Callback","operationId":"tiktok_business_callback_api_external_platform_tiktok_business_callback__get","parameters":[{"name":"auth_code","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Auth Code"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},{"name":"error","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/tiktok-business/disconnect":{"post":{"tags":["external-platform"],"summary":"Disconnect Tiktok Business","description":"Revoke the TikTok Business Engagement credential and fence its sources.","operationId":"disconnect_tiktok_business_api_external_platform_tiktok_business_disconnect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/status":{"get":{"tags":["engagement"],"summary":"Engagement Status","operationId":"engagement_status_api_engagement_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EngagementStatusResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/facebook/oauth/start":{"get":{"tags":["engagement"],"summary":"Facebook Engagement Oauth Start","operationId":"facebook_engagement_oauth_start_api_engagement_facebook_oauth_start_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/facebook/dm/oauth/start":{"get":{"tags":["engagement"],"summary":"Facebook Dm Oauth Start","operationId":"facebook_dm_oauth_start_api_engagement_facebook_dm_oauth_start_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/tiktok/oauth/start":{"get":{"tags":["engagement"],"summary":"Tiktok Dm Oauth Start","operationId":"tiktok_dm_oauth_start_api_engagement_tiktok_oauth_start_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/facebook/sources":{"get":{"tags":["engagement"],"summary":"List Sources","operationId":"list_sources_api_engagement_facebook_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SourceResponse"},"type":"array","title":"Response List Sources Api Engagement Facebook Sources Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["engagement"],"summary":"Create Source","operationId":"create_source_api_engagement_facebook_sources_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceCreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/facebook/available-pages":{"get":{"tags":["engagement"],"summary":"Available Pages","operationId":"available_pages_api_engagement_facebook_available_pages_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/facebook/dm/available-pages":{"get":{"tags":["engagement"],"summary":"Available Dm Pages","operationId":"available_dm_pages_api_engagement_facebook_dm_available_pages_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/facebook/dm/sources":{"get":{"tags":["engagement"],"summary":"List Sources","operationId":"list_sources_api_engagement_facebook_dm_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SourceResponse"},"type":"array","title":"Response List Sources Api Engagement Facebook Dm Sources Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["engagement"],"summary":"Create Dm Source","operationId":"create_dm_source_api_engagement_facebook_dm_sources_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DmSourceCreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/instagram/oauth/start":{"get":{"tags":["engagement"],"summary":"Instagram Engagement Oauth Start","operationId":"instagram_engagement_oauth_start_api_engagement_instagram_oauth_start_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"login_type","in":"query","required":false,"schema":{"type":"string","pattern":"^(instagram|facebook)$","default":"instagram","title":"Login Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/instagram/dm/oauth/start":{"get":{"tags":["engagement"],"summary":"Instagram Dm Oauth Start","operationId":"instagram_dm_oauth_start_api_engagement_instagram_dm_oauth_start_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"login_type","in":"query","required":false,"schema":{"type":"string","pattern":"^(instagram|facebook)$","default":"instagram","title":"Login Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/linkedin/oauth/start":{"get":{"tags":["engagement"],"summary":"Linkedin Engagement Oauth Start","operationId":"linkedin_engagement_oauth_start_api_engagement_linkedin_oauth_start_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/linkedin/available-organizations":{"get":{"tags":["engagement"],"summary":"Available Linkedin Organizations","operationId":"available_linkedin_organizations_api_engagement_linkedin_available_organizations_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/linkedin/sources":{"get":{"tags":["engagement"],"summary":"List Sources","operationId":"list_sources_api_engagement_linkedin_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SourceResponse"},"type":"array","title":"Response List Sources Api Engagement Linkedin Sources Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["engagement"],"summary":"Create Linkedin Source","operationId":"create_linkedin_source_api_engagement_linkedin_sources_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceCreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/instagram/dm/available-accounts":{"get":{"tags":["engagement"],"summary":"Available Instagram Dm Accounts","operationId":"available_instagram_dm_accounts_api_engagement_instagram_dm_available_accounts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/instagram/dm/sources":{"get":{"tags":["engagement"],"summary":"List Sources","operationId":"list_sources_api_engagement_instagram_dm_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SourceResponse"},"type":"array","title":"Response List Sources Api Engagement Instagram Dm Sources Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["engagement"],"summary":"Create Instagram Dm Source","operationId":"create_instagram_dm_source_api_engagement_instagram_dm_sources_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstagramDmSourceCreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/tiktok/available-accounts":{"get":{"tags":["engagement"],"summary":"Available Tiktok Accounts","operationId":"available_tiktok_accounts_api_engagement_tiktok_available_accounts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/tiktok/dm/sources":{"get":{"tags":["engagement"],"summary":"List Sources","operationId":"list_sources_api_engagement_tiktok_dm_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SourceResponse"},"type":"array","title":"Response List Sources Api Engagement Tiktok Dm Sources Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["engagement"],"summary":"Create Tiktok Dm Source","operationId":"create_tiktok_dm_source_api_engagement_tiktok_dm_sources_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TikTokDmSourceCreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/tiktok/sources":{"get":{"tags":["engagement"],"summary":"List Sources","operationId":"list_sources_api_engagement_tiktok_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SourceResponse"},"type":"array","title":"Response List Sources Api Engagement Tiktok Sources Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["engagement"],"summary":"Create Tiktok Source","operationId":"create_tiktok_source_api_engagement_tiktok_sources_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceCreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/instagram/available-accounts":{"get":{"tags":["engagement"],"summary":"Available Instagram Accounts","operationId":"available_instagram_accounts_api_engagement_instagram_available_accounts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/instagram/sources":{"get":{"tags":["engagement"],"summary":"List Sources","operationId":"list_sources_api_engagement_instagram_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SourceResponse"},"type":"array","title":"Response List Sources Api Engagement Instagram Sources Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["engagement"],"summary":"Create Instagram Source","operationId":"create_instagram_source_api_engagement_instagram_sources_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstagramSourceCreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/engagement/tiktok/dm/sources/{source_id}":{"delete":{"tags":["engagement"],"summary":"Delete Source","operationId":"delete_source_api_engagement_tiktok_dm_sources__source_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Source Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/instagram/dm/sources/{source_id}":{"delete":{"tags":["engagement"],"summary":"Delete Source","operationId":"delete_source_api_engagement_instagram_dm_sources__source_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Source Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/facebook/dm/sources/{source_id}":{"delete":{"tags":["engagement"],"summary":"Delete Source","operationId":"delete_source_api_engagement_facebook_dm_sources__source_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Source Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/tiktok/sources/{source_id}":{"delete":{"tags":["engagement"],"summary":"Delete Source","operationId":"delete_source_api_engagement_tiktok_sources__source_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Source Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/linkedin/sources/{source_id}":{"delete":{"tags":["engagement"],"summary":"Delete Source","operationId":"delete_source_api_engagement_linkedin_sources__source_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Source Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/instagram/sources/{source_id}":{"delete":{"tags":["engagement"],"summary":"Delete Source","operationId":"delete_source_api_engagement_instagram_sources__source_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Source Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/facebook/sources/{source_id}":{"delete":{"tags":["engagement"],"summary":"Delete Source","operationId":"delete_source_api_engagement_facebook_sources__source_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Source Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/tiktok/dm/sources/{source_id}/sync":{"post":{"tags":["engagement"],"summary":"Force Sync","operationId":"force_sync_api_engagement_tiktok_dm_sources__source_id__sync_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Source Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/instagram/dm/sources/{source_id}/sync":{"post":{"tags":["engagement"],"summary":"Force Sync","operationId":"force_sync_api_engagement_instagram_dm_sources__source_id__sync_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Source Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/facebook/dm/sources/{source_id}/sync":{"post":{"tags":["engagement"],"summary":"Force Sync","operationId":"force_sync_api_engagement_facebook_dm_sources__source_id__sync_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Source Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/tiktok/sources/{source_id}/sync":{"post":{"tags":["engagement"],"summary":"Force Sync","operationId":"force_sync_api_engagement_tiktok_sources__source_id__sync_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Source Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/linkedin/sources/{source_id}/sync":{"post":{"tags":["engagement"],"summary":"Force Sync","operationId":"force_sync_api_engagement_linkedin_sources__source_id__sync_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Source Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/instagram/sources/{source_id}/sync":{"post":{"tags":["engagement"],"summary":"Force Sync","operationId":"force_sync_api_engagement_instagram_sources__source_id__sync_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Source Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/facebook/sources/{source_id}/sync":{"post":{"tags":["engagement"],"summary":"Force Sync","operationId":"force_sync_api_engagement_facebook_sources__source_id__sync_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Source Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/tiktok/dm/conversations":{"get":{"tags":["engagement"],"summary":"List Dm Conversations","operationId":"list_dm_conversations_api_engagement_tiktok_dm_conversations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":1024},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationPageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/instagram/dm/conversations":{"get":{"tags":["engagement"],"summary":"List Dm Conversations","operationId":"list_dm_conversations_api_engagement_instagram_dm_conversations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":1024},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationPageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/facebook/dm/conversations":{"get":{"tags":["engagement"],"summary":"List Dm Conversations","operationId":"list_dm_conversations_api_engagement_facebook_dm_conversations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":1024},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationPageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/tiktok/dm/conversations/{item_id}":{"get":{"tags":["engagement"],"summary":"Get Dm Conversation","operationId":"get_dm_conversation_api_engagement_tiktok_dm_conversations__item_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/instagram/dm/conversations/{item_id}":{"get":{"tags":["engagement"],"summary":"Get Dm Conversation","operationId":"get_dm_conversation_api_engagement_instagram_dm_conversations__item_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/facebook/dm/conversations/{item_id}":{"get":{"tags":["engagement"],"summary":"Get Dm Conversation","operationId":"get_dm_conversation_api_engagement_facebook_dm_conversations__item_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/tiktok/dm/conversations/{item_id}/messages":{"get":{"tags":["engagement"],"summary":"List Dm Messages","operationId":"list_dm_messages_api_engagement_tiktok_dm_conversations__item_id__messages_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":1024},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessagePageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/instagram/dm/conversations/{item_id}/messages":{"get":{"tags":["engagement"],"summary":"List Dm Messages","operationId":"list_dm_messages_api_engagement_instagram_dm_conversations__item_id__messages_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":1024},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessagePageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/facebook/dm/conversations/{item_id}/messages":{"get":{"tags":["engagement"],"summary":"List Dm Messages","operationId":"list_dm_messages_api_engagement_facebook_dm_conversations__item_id__messages_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":1024},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessagePageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/tiktok/dm/conversations/{item_id}/generate":{"post":{"tags":["engagement"],"summary":"Generate Dm Reply","operationId":"generate_dm_reply_api_engagement_tiktok_dm_conversations__item_id__generate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProposalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/instagram/dm/conversations/{item_id}/generate":{"post":{"tags":["engagement"],"summary":"Generate Dm Reply","operationId":"generate_dm_reply_api_engagement_instagram_dm_conversations__item_id__generate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProposalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/facebook/dm/conversations/{item_id}/generate":{"post":{"tags":["engagement"],"summary":"Generate Dm Reply","operationId":"generate_dm_reply_api_engagement_facebook_dm_conversations__item_id__generate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProposalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/tiktok/comments":{"get":{"tags":["engagement"],"summary":"List Comments","operationId":"list_comments_api_engagement_tiktok_comments_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":1024},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentPageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/linkedin/comments":{"get":{"tags":["engagement"],"summary":"List Comments","operationId":"list_comments_api_engagement_linkedin_comments_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":1024},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentPageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/instagram/comments":{"get":{"tags":["engagement"],"summary":"List Comments","operationId":"list_comments_api_engagement_instagram_comments_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":1024},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentPageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/facebook/comments":{"get":{"tags":["engagement"],"summary":"List Comments","operationId":"list_comments_api_engagement_facebook_comments_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":1024},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentPageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/tiktok/comments/{item_id}":{"get":{"tags":["engagement"],"summary":"Get Comment","operationId":"get_comment_api_engagement_tiktok_comments__item_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/linkedin/comments/{item_id}":{"get":{"tags":["engagement"],"summary":"Get Comment","operationId":"get_comment_api_engagement_linkedin_comments__item_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/instagram/comments/{item_id}":{"get":{"tags":["engagement"],"summary":"Get Comment","operationId":"get_comment_api_engagement_instagram_comments__item_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/facebook/comments/{item_id}":{"get":{"tags":["engagement"],"summary":"Get Comment","operationId":"get_comment_api_engagement_facebook_comments__item_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/tiktok/comments/{item_id}/generate":{"post":{"tags":["engagement"],"summary":"Generate Comment","operationId":"generate_comment_api_engagement_tiktok_comments__item_id__generate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProposalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/linkedin/comments/{item_id}/generate":{"post":{"tags":["engagement"],"summary":"Generate Comment","operationId":"generate_comment_api_engagement_linkedin_comments__item_id__generate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProposalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/instagram/comments/{item_id}/generate":{"post":{"tags":["engagement"],"summary":"Generate Comment","operationId":"generate_comment_api_engagement_instagram_comments__item_id__generate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProposalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/facebook/comments/{item_id}/generate":{"post":{"tags":["engagement"],"summary":"Generate Comment","operationId":"generate_comment_api_engagement_facebook_comments__item_id__generate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Item Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProposalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/proposals/{proposal_id}/approve":{"post":{"tags":["engagement"],"summary":"Approve","operationId":"approve_api_engagement_proposals__proposal_id__approve_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"proposal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Proposal Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/proposals/{proposal_id}/edit-and-approve":{"post":{"tags":["engagement"],"summary":"Edit Approve","operationId":"edit_approve_api_engagement_proposals__proposal_id__edit_and_approve_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"proposal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Proposal Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditApprovalRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/proposals/{proposal_id}/reject":{"post":{"tags":["engagement"],"summary":"Reject","operationId":"reject_api_engagement_proposals__proposal_id__reject_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"proposal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Proposal Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProposalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/proposals/{proposal_id}/regenerate":{"post":{"tags":["engagement"],"summary":"Regenerate","operationId":"regenerate_api_engagement_proposals__proposal_id__regenerate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"proposal_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Proposal Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProposalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/deliveries/{delivery_id}":{"get":{"tags":["engagement"],"summary":"Get Delivery","operationId":"get_delivery_api_engagement_deliveries__delivery_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"delivery_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Delivery Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/deliveries/{delivery_id}/retry-definite":{"post":{"tags":["engagement"],"summary":"Retry Delivery","operationId":"retry_delivery_api_engagement_deliveries__delivery_id__retry_definite_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"delivery_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Delivery Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MutationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/deliveries/{delivery_id}/confirm-external-id":{"post":{"tags":["engagement"],"summary":"Confirm Delivery","operationId":"confirm_delivery_api_engagement_deliveries__delivery_id__confirm_external_id_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"delivery_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Delivery Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmExternalIdRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/engagement/deliveries/{delivery_id}/abandon-unknown":{"post":{"tags":["engagement"],"summary":"Abandon Delivery","operationId":"abandon_delivery_api_engagement_deliveries__delivery_id__abandon_unknown_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"delivery_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Delivery Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AbandonUnknownRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliveryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/organic-social/overview":{"get":{"tags":["organic-social"],"summary":"Get Organic Social Overview","operationId":"get_organic_social_overview_api_organic_social_overview_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"window","in":"query","required":false,"schema":{"enum":["7d","28d","90d"],"type":"string","default":"28d","title":"Window"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganicSocialOverviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/organic-social/refresh":{"post":{"tags":["organic-social"],"summary":"Refresh Organic Social Overview","operationId":"refresh_organic_social_overview_api_organic_social_refresh_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganicSocialRefreshRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganicSocialRefreshResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/organic-social/refresh/{batch_key}":{"get":{"tags":["organic-social"],"summary":"Get Organic Social Refresh Status","operationId":"get_organic_social_refresh_status_api_organic_social_refresh__batch_key__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"batch_key","in":"path","required":true,"schema":{"type":"string","title":"Batch Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganicSocialRefreshStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/organic-social/capabilities":{"get":{"tags":["organic-social"],"summary":"Get Organic Social Capabilities","operationId":"get_organic_social_capabilities_api_organic_social_capabilities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrganicSocialCapabilitiesResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/payment/subscription/resume":{"post":{"tags":["payment"],"summary":"Resume Subscription","description":"Resume a subscription that was scheduled to cancel at period end.\nThis clears cancel_at_period_end on Stripe and in our DB.","operationId":"resume_subscription_api_payment_subscription_resume_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","title":"Organization Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Resume Subscription Api Payment Subscription Resume Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/payment/subscription/end-trial":{"post":{"tags":["payment"],"summary":"End Trial And Start Paid Billing","description":"End an eligible free trial immediately so the saved Stripe payment method\ncan start paid billing on the current plan.","operationId":"end_trial_and_start_paid_billing_api_payment_subscription_end_trial_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","title":"Organization Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response End Trial And Start Paid Billing Api Payment Subscription End Trial Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/payment/subscription/{subscription_id}/payment-status":{"get":{"tags":["payment"],"summary":"Get Subscription Payment Status","description":"Read and reconcile the invoice and any pending trial plan change.","operationId":"get_subscription_payment_status_api_payment_subscription__subscription_id__payment_status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"subscription_id","in":"path","required":true,"schema":{"type":"string","title":"Subscription Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/payment/subscription/debug":{"get":{"tags":["payment"],"summary":"Subscription Debug","description":"Diagnostics endpoint to verify Stripe configuration for subscriptions.\nDoes not expose full secrets; returns booleans and configured price IDs.","operationId":"subscription_debug_api_payment_subscription_debug_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Subscription Debug Api Payment Subscription Debug Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/payment/subscription/client-config":{"get":{"tags":["payment"],"summary":"Subscription Client Config","description":"Minimal runtime config needed by Stripe Elements on the client.\nThe publishable key is safe to expose to the browser.","operationId":"subscription_client_config_api_payment_subscription_client_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Subscription Client Config Api Payment Subscription Client Config Get"}}}}}}},"/api/payment/subscription/plans":{"get":{"tags":["payment"],"summary":"Get Subscription Plans","description":"Get all available subscription plans.","operationId":"get_subscription_plans_api_payment_subscription_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SubscriptionTier"},"type":"array","title":"Response Get Subscription Plans Api Payment Subscription Plans Get"}}}}}}},"/api/payment/subscription/init-payment-element":{"post":{"tags":["payment"],"summary":"Init Payment Element","description":"Initialize a Stripe Payment Element for subscriptions.\n\nCreates an incomplete subscription (default_incomplete) and returns the\nclient_secret of the underlying PaymentIntent from the latest invoice.\nThe client confirms payment using Payment Element; we rely on webhooks to\npersist final subscription state.\n\nRequest payload must include:\n- plan_id: Subscription tier (silver, gold, platinum)\n- organization_id: UUID of the organization to subscribe","operationId":"init_payment_element_api_payment_subscription_init_payment_element_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Init Payment Element Api Payment Subscription Init Payment Element Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/payment/subscription/subscribe":{"post":{"tags":["payment"],"summary":"Create Subscription","description":"Create a new subscription for an organization.\n\nRequires:\n- organization_id: UUID of the organization to subscribe\n- plan_id: Subscription tier (silver, gold, platinum)\n- payment_method_id: Stripe payment method ID\n\nUser must be an OWNER or ADMIN of the organization.","operationId":"create_subscription_api_payment_subscription_subscribe_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSubscriptionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Create Subscription Api Payment Subscription Subscribe Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/payment/subscription/init-setup":{"post":{"tags":["payment"],"summary":"Init Setup Intent","description":"Client-first flow: Create (or reuse) Stripe Customer and a SetupIntent to collect\ncard + billing address on the client. Returns the SetupIntent client_secret.\n\nRequest payload must include:\n- organization_id: UUID of the organization","operationId":"init_setup_intent_api_payment_subscription_init_setup_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Init Setup Intent Api Payment Subscription Init Setup Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/payment/subscription/apply-coupon":{"post":{"tags":["payment"],"summary":"Apply Coupon","description":"Validate a coupon/promotion code for a given plan and return discounted amount.\n\nExpects:\n- plan_id: one of SUBSCRIPTION_TIERS keys\n- coupon_code: promotion code string","operationId":"apply_coupon_api_payment_subscription_apply_coupon_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Apply Coupon Api Payment Subscription Apply Coupon Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/payment/subscription/create-subscription":{"post":{"tags":["payment"],"summary":"Create Subscription From Setup","description":"Create a subscription using a PaymentMethod saved via SetupIntent.\nThis is the second half of the client-first flow.\n\nExpects:\n- organization_id: UUID of the organization\n- setup_intent_id: Stripe SetupIntent ID\n- plan_id: Subscription tier","operationId":"create_subscription_from_setup_api_payment_subscription_create_subscription_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Subscription From Setup Api Payment Subscription Create Subscription Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/payment/subscription/current":{"get":{"tags":["payment"],"summary":"Get Current Subscription","description":"Get the current active subscription for a specific organization.\n\nQuery parameters:\n- organization_id: UUID of the organization\n\nReturns the active subscription if found, None otherwise.","operationId":"get_current_subscription_api_payment_subscription_current_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","title":"Organization Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/SubscriptionResponse"},{"type":"null"}],"title":"Response Get Current Subscription Api Payment Subscription Current Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/payment/subscription/cancel":{"post":{"tags":["payment"],"summary":"Cancel Subscription","description":"Cancel the current subscription for an organization.\nBy default, this will cancel at the end of the current billing period.\n\nQuery parameters:\n- organization_id: UUID of the organization\n\nArgs:\n    cancel_data: Contains at_period_end parameter indicating when to cancel","operationId":"cancel_subscription_api_payment_subscription_cancel_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","title":"Organization Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelSubscriptionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Cancel Subscription Api Payment Subscription Cancel Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/payment/subscription/validate-plan-change":{"post":{"tags":["payment"],"summary":"Validate Plan Change","description":"Validate if a plan change is possible for an organization.\n\nCRITICAL: For downgrades, this strictly validates current usage against target plan limits.\nReturns detailed errors if the downgrade would exceed limits.\n\nFor upgrades, this estimates the proration amount (actual amount calculated by Stripe).","operationId":"validate_plan_change_api_payment_subscription_validate_plan_change_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatePlanChangeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanChangeValidationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/payment/subscription/change-plan":{"post":{"tags":["payment"],"summary":"Change Subscription Plan","description":"Change the subscription plan for an organization.\n\nCRITICAL: This endpoint UPDATES the EXISTING subscription, never creates a new one.\n- For upgrades: Uses proration_behavior='create_prorations' (charges immediately)\n- For downgrades: Uses proration_behavior='none' (NO REFUNDS)\n\nThis prevents duplicate subscriptions which was the main issue.","operationId":"change_subscription_plan_api_payment_subscription_change_plan_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangePlanRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Change Subscription Plan Api Payment Subscription Change Plan Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/payment/subscription/portal-session":{"get":{"tags":["payment"],"summary":"Create Billing Portal Session","description":"Create a Stripe Customer Portal session for subscription management.\n\nQuery parameters:\n- return_url: The URL to redirect to after completing actions in the customer portal\n- organization_id: UUID of the organization","operationId":"create_billing_portal_session_api_payment_subscription_portal_session_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"return_url","in":"query","required":true,"schema":{"type":"string","title":"Return Url"}},{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","title":"Organization Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingPortalSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/payment/subscription/trial-payment-method-portal-session":{"post":{"tags":["payment"],"summary":"Create Trial Payment Method Portal Session","description":"Create a Stripe portal session dedicated to adding a payment method.","operationId":"create_trial_payment_method_portal_session_api_payment_subscription_trial_payment_method_portal_session_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingPortalSessionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingPortalSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/payment/subscription/payment-history":{"get":{"tags":["payment"],"summary":"Get Payment History","description":"Return recent Stripe-backed payment history for the current organization billing scope.","operationId":"get_payment_history_api_payment_subscription_payment_history_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","title":"Company Profile Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentHistoryListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/payment/subscription/checkout-session":{"post":{"tags":["payment"],"summary":"Create Checkout Session","description":"Create an embedded Stripe Checkout Session for subscription purchase.","operationId":"create_checkout_session_api_payment_subscription_checkout_session_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Checkout Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Checkout Session Api Payment Subscription Checkout Session Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/payment/subscription/invoice-subscription":{"post":{"tags":["payment"],"summary":"Create Invoice Subscription","description":"Let a customer whose card checkout failed pay by invoice instead.\n\nCard checkout can be impossible rather than merely inconvenient: registering\na recurring mandate in India requires a 3-D Secure challenge with the issuing\nbank, and when that bank's page does not respond the customer cannot pay at\nall, however many times they retry. Rather than leaving them to email us and\nwait out a timezone gap, this mints an invoice-billed subscription on the\nspot and Stripe emails them a payable link.\n\nNothing is granted by asking. The subscription reports itself active\nimmediately, but ``invoice_billed_access_is_withheld`` denies the\norganization until a settled payment is recorded, so this is a request to be\nbilled, not a way to obtain access.","operationId":"create_invoice_subscription_api_payment_subscription_invoice_subscription_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Request Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Invoice Subscription Api Payment Subscription Invoice Subscription Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/payment/subscription/checkout-session/{session_id}/status":{"get":{"tags":["payment"],"summary":"Get Checkout Session Status","description":"Report whether an in-flight embedded Checkout Session has already failed.\n\nThe embedded checkout iframe owns the 3-D Secure challenge, so when the\nissuer's ACS page hangs the browser has no way to learn that Stripe already\ngave up on the authentication behind it. The registration UI polls this so\nit can replace a dead blank overlay with a real error and a retry.\n\n``organization_id`` is optional. The session already names its organization\n(metadata / client_reference_id), so the caller's copy is only an early,\nStripe-free cross-check. It became required in #3004 and every browser\nstill running the previous bundle - which polls without it - got a 422 on\nevery tick, so the poll that exists to break the 3-D Secure deadlock never\nfired. A required parameter added to a live endpoint breaks every tab\nalready open across the deploy; the same checks now run either way, just\nas early as the information allows.","operationId":"get_checkout_session_status_api_payment_subscription_checkout_session__session_id__status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"organization_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Checkout Session Status Api Payment Subscription Checkout Session  Session Id  Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/payment/subscription/subscription-status":{"get":{"tags":["payment"],"summary":"Get Subscription Status","description":"Get subscription status for a specific organization.\n\nQuery parameters:\n- organization_id: UUID of the organization\n\nReturns details about the organization's current subscription status.","operationId":"get_subscription_status_api_payment_subscription_subscription_status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","title":"Organization Id"}},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Bypass the shared response cache","default":false,"title":"Force Refresh"},"description":"Bypass the shared response cache"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Subscription Status Api Payment Subscription Subscription Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/payment/subscription/webhook":{"post":{"tags":["payment"],"summary":"Handle Stripe Webhook","description":"Verify and process Stripe lifecycle events in a complete worker transaction.","operationId":"handle_stripe_webhook_api_payment_subscription_webhook_post","parameters":[{"name":"Stripe-Signature","in":"header","required":true,"schema":{"type":"string","title":"Stripe-Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/payment/usage/usage-stats":{"get":{"tags":["usage"],"summary":"Get Usage Stats","description":"Get usage statistics for the authenticated user.\nReturns current usage counts and limits based on subscription tier.","operationId":"get_usage_stats_api_payment_usage_usage_stats_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Usage Stats Api Payment Usage Usage Stats Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/payment/usage/usage-percentage":{"get":{"tags":["usage"],"summary":"Get Usage Percentage","description":"Get a simple usage percentage for dashboard display.\nReturns overall usage percentage based on subscription tier.","operationId":"get_usage_percentage_api_payment_usage_usage_percentage_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Usage Percentage Api Payment Usage Usage Percentage Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/payment/credits/purchase":{"post":{"tags":["credits","credits"],"summary":"Purchase Credits","description":"Create Stripe Payment Intent for credit purchase.\nCRITICAL: This only initiates payment. Credits are added via webhook.","operationId":"purchase_credits_api_payment_credits_purchase_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditPurchaseRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditPurchaseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/payment/credits/balance":{"get":{"tags":["credits","credits"],"summary":"Get Credit Balance","description":"Get current credit balance for an organization.","operationId":"get_credit_balance_api_payment_credits_balance_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","description":"Organization ID","title":"Organization Id"},"description":"Organization ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditBalanceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/payment/credits/calculate-charge":{"post":{"tags":["credits","credits"],"summary":"Calculate Ad Charge","description":"Calculate charge for an ad campaign including commission.\nShows what will be charged based on current tier.","operationId":"calculate_ad_charge_api_payment_credits_calculate_charge_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalculateChargeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalculateChargeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/payment/credits/transactions":{"get":{"tags":["credits","credits"],"summary":"Get Credit Transactions","description":"Get credit transaction history for an organization.\nSupports pagination and filtering by transaction type.","operationId":"get_credit_transactions_api_payment_credits_transactions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","description":"Organization ID","title":"Organization Id"},"description":"Organization ID"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"description":"Number of transactions to return","default":50,"title":"Limit"},"description":"Number of transactions to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of transactions to skip","default":0,"title":"Offset"},"description":"Number of transactions to skip"},{"name":"transaction_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by transaction type","title":"Transaction Type"},"description":"Filter by transaction type"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionHistoryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/payment/credits/hold":{"post":{"tags":["credits","credits"],"summary":"Create Credit Hold","description":"Create a credit hold for ad campaign launch.\nCRITICAL: This immediately reserves funds for up to 30 minutes.","operationId":"create_credit_hold_api_payment_credits_hold_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditHoldRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditHoldResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/payment/credits/capture":{"post":{"tags":["credits","credits"],"summary":"Capture Credit Hold","description":"Capture a credit hold after successful campaign launch.\nCRITICAL: This finalizes the charge - cannot be reversed except by manual refund.","operationId":"capture_credit_hold_api_payment_credits_capture_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditCaptureRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Capture Credit Hold Api Payment Credits Capture Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/payment/credits/release":{"post":{"tags":["credits","credits"],"summary":"Release Credit Hold","description":"Release a credit hold and refund.\nUsed when campaign launch fails or is cancelled.","operationId":"release_credit_hold_api_payment_credits_release_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditReleaseRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Release Credit Hold Api Payment Credits Release Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/payment/pricing/context":{"get":{"tags":["pricing","pricing"],"summary":"Get Pricing Context","description":"Resolve pricing context based on explicit billing country, request headers/IP,\nor the default country fallback.\nReturns country, currency, available intervals, plan prices, and credit packages.","operationId":"get_pricing_context_api_payment_pricing_context_get","parameters":[{"name":"billing_country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Explicit billing country override as a two-letter ISO code.","title":"Billing Country"},"description":"Explicit billing country override as a two-letter ISO code."},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Bypass the shared response cache","default":false,"title":"Force Refresh"},"description":"Bypass the shared response cache"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Pricing Context Api Payment Pricing Context Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/limits/company-profile/{profile_id}":{"get":{"tags":["limits","limits"],"summary":"Get Company Profile Limits","description":"Return effective per-plan limits relevant to a specific company profile.\n\nResponse:\n  {\n    \"max_company_profiles\": int | null,\n    \"max_competitors_per_profile\": int | null,\n    \"current_competitors\": int,\n    \"current_tier\": str | null,\n    \"competitor_upgrade_tier\": str | null,\n    \"competitor_upgrade_limit\": int | null,\n    \"profile_id\": str,\n    \"organization_id\": str\n  }\n\n``competitor_upgrade_tier`` is the plan code (such as \"gold\") of the next\nplan that tracks more competitors than the current one, and\n``competitor_upgrade_limit`` is that plan's cap (null for unlimited). Both\nare null when no plan tracks more, so the UI offers removal instead.","operationId":"get_company_profile_limits_api_limits_company_profile__profile_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-analytics/dashboard-summary":{"get":{"tags":["campaign-analytics","campaign-analytics"],"summary":"Get Dashboard Summary","description":"Get campaign analytics summary for dashboard display.\nReturns aggregated metrics for all active campaigns.","operationId":"get_dashboard_summary_api_campaign_analytics_dashboard_summary_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","description":"Number of days to look back","default":30,"title":"Days"},"description":"Number of days to look back"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignAnalyticsSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-analytics/campaigns/{campaign_id}":{"get":{"tags":["campaign-analytics","campaign-analytics"],"summary":"Get Campaign Analytics","description":"Get detailed analytics for a specific campaign.","operationId":"get_campaign_analytics_api_campaign_analytics_campaigns__campaign_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignAnalyticsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/quickbooks/review-queue":{"get":{"tags":["quickbooks","quickbooks"],"summary":"Get Quickbooks Review Queue","description":"Marketing expense review queue from Databricks silver tables.\n\nFlags:\n- uncategorized: marketing expense missing a category (or splits include uncategorized marketing)\n- low_confidence: marketing expense with low model confidence (only when no splits exist)\n- large_amount: high-dollar expense (marketing or non-marketing)\n- unmapped_vendor: marketing expense not classified via mapping rules (qb_marketing_source != 'mapping')","operationId":"get_quickbooks_review_queue_api_quickbooks_review_queue_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"},{"name":"min_amount","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"Flag expenses with amount >= min_amount","default":500.0,"title":"Min Amount"},"description":"Flag expenses with amount >= min_amount"},{"name":"confidence_lt","in":"query","required":false,"schema":{"type":"number","maximum":1,"minimum":0,"description":"Flag marketing expenses with confidence < threshold","default":0.7,"title":"Confidence Lt"},"description":"Flag marketing expenses with confidence < threshold"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":2000,"minimum":1,"description":"Max rows to return","default":200,"title":"Limit"},"description":"Max rows to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/QuickBooksReviewQueueRow"},"title":"Response Get Quickbooks Review Queue Api Quickbooks Review Queue Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/quickbooks/mappings":{"get":{"tags":["quickbooks","quickbooks"],"summary":"List Quickbooks Mappings","operationId":"list_quickbooks_mappings_api_quickbooks_mappings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/QuickBooksMappingRow"},"type":"array","title":"Response List Quickbooks Mappings Api Quickbooks Mappings Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["quickbooks","quickbooks"],"summary":"Create Quickbooks Mapping","operationId":"create_quickbooks_mapping_api_quickbooks_mappings_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickBooksMappingCreateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickBooksMappingRow"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/quickbooks/mappings/{mapping_id}":{"patch":{"tags":["quickbooks","quickbooks"],"summary":"Update Quickbooks Mapping","operationId":"update_quickbooks_mapping_api_quickbooks_mappings__mapping_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"mapping_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Mapping Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickBooksMappingUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickBooksMappingRow"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["quickbooks","quickbooks"],"summary":"Delete Quickbooks Mapping","operationId":"delete_quickbooks_mapping_api_quickbooks_mappings__mapping_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"mapping_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Mapping Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/quickbooks/expenses/{qb_token}/splits":{"get":{"tags":["quickbooks","quickbooks"],"summary":"Get Quickbooks Expense Splits","operationId":"get_quickbooks_expense_splits_api_quickbooks_expenses__qb_token__splits_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"qb_token","in":"path","required":true,"schema":{"type":"string","title":"Qb Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickBooksExpenseSplitsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["quickbooks","quickbooks"],"summary":"Upsert Quickbooks Expense Splits","operationId":"upsert_quickbooks_expense_splits_api_quickbooks_expenses__qb_token__splits_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"qb_token","in":"path","required":true,"schema":{"type":"string","title":"Qb Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickBooksExpenseSplitsUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickBooksExpenseSplitsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/quickbooks/expenses/{qb_token}":{"patch":{"tags":["quickbooks","quickbooks"],"summary":"Annotate Quickbooks Expense","operationId":"annotate_quickbooks_expense_api_quickbooks_expenses__qb_token__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"qb_token","in":"path","required":true,"schema":{"type":"string","title":"Qb Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickBooksExpenseAnnotateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QBMarketingAnnotationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/quickbooks/expenses/bulk-annotate":{"post":{"tags":["quickbooks","quickbooks"],"summary":"Bulk Annotate Quickbooks Expenses","operationId":"bulk_annotate_quickbooks_expenses_api_quickbooks_expenses_bulk_annotate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickBooksExpenseBulkAnnotateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickBooksExpenseBulkAnnotateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/quickbooks/audit":{"get":{"tags":["quickbooks","quickbooks"],"summary":"Get Quickbooks Audit","operationId":"get_quickbooks_audit_api_quickbooks_audit_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuickBooksAuditResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/users/analytics/genai-usage":{"get":{"tags":["users","users","analytics","analytics"],"summary":"Get Genai Usage Stats","description":"Get GenAI usage statistics for the current user.\n\nReturns counts of text and image generation events, total images generated,\nand usage by endpoint.","operationId":"get_genai_usage_stats_api_users_analytics_genai_usage_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Start date in ISO format with timezone","title":"Start Date"},"description":"Start date in ISO format with timezone"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"End date in ISO format with timezone","title":"End Date"},"description":"End date in ISO format with timezone"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Genai Usage Stats Api Users Analytics Genai Usage Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/users/analytics/genai-usage-with-quota":{"get":{"tags":["users","users","analytics","analytics"],"summary":"Get Genai Usage With Quota","description":"Get GenAI usage statistics with quota information for the current user.\nCombines usage counts with subscription limits and human-readable labels.","operationId":"get_genai_usage_with_quota_api_users_analytics_genai_usage_with_quota_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Start date in ISO format with timezone","title":"Start Date"},"description":"Start date in ISO format with timezone"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"End date in ISO format with timezone","title":"End Date"},"description":"End date in ISO format with timezone"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Genai Usage With Quota Api Users Analytics Genai Usage With Quota Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/debug/signed-urls-config":{"get":{"tags":["debug","debug"],"summary":"Check Signed Urls Config","description":"Check if signed URLs are properly configured","operationId":"check_signed_urls_config_api_debug_signed_urls_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/email-campaigns/v2/preview":{"post":{"tags":["email-campaigns-v2","Email Campaigns V2"],"summary":"Preview Campaign","description":"Generate preview of email campaign with sample personalization","operationId":"preview_campaign_api_email_campaigns_v2_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/email-campaigns/v2/test":{"post":{"tags":["email-campaigns-v2","Email Campaigns V2"],"summary":"Send Test Emails","description":"Send test emails to specified addresses","operationId":"send_test_emails_api_email_campaigns_v2_test_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestEmailRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/email-campaigns/v2/send":{"post":{"tags":["email-campaigns-v2","Email Campaigns V2"],"summary":"Send Campaign","description":"Send campaign to recipients or schedule for later","operationId":"send_campaign_api_email_campaigns_v2_send_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendCampaignRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/email-campaigns/v2/workflow-status":{"put":{"tags":["email-campaigns-v2","Email Campaigns V2"],"summary":"Update Workflow Status","description":"Update campaign workflow status","operationId":"update_workflow_status_api_email_campaigns_v2_workflow_status_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/email-campaigns/v2/validate-personalization":{"post":{"tags":["email-campaigns-v2","Email Campaigns V2"],"summary":"Validate Personalization","description":"Validate personalization template and get available variables","operationId":"validate_personalization_api_email_campaigns_v2_validate_personalization_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonalizationValidateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/email-campaigns/v2/{campaign_id}/performance":{"get":{"tags":["email-campaigns-v2","Email Campaigns V2"],"summary":"Get Campaign Performance","description":"Get campaign performance metrics","operationId":"get_campaign_performance_api_email_campaigns_v2__campaign_id__performance_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"integer","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/email-campaigns/v2/{campaign_id}/insights":{"get":{"tags":["email-campaigns-v2","Email Campaigns V2"],"summary":"Get Campaign Insights","description":"Get AI-generated insights and recommendations","operationId":"get_campaign_insights_api_email_campaigns_v2__campaign_id__insights_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"integer","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/email-campaigns/v2/{campaign_id}/complete-ab-test":{"post":{"tags":["email-campaigns-v2","Email Campaigns V2"],"summary":"Complete Ab Test","description":"Complete A/B test and send winning variant to holdout","operationId":"complete_ab_test_api_email_campaigns_v2__campaign_id__complete_ab_test_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"integer","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/guided-workflow/preview-campaign-references":{"post":{"tags":["guided-workflow"],"summary":"Preview Campaign References","description":"Prepare the automatic still-image selection before the person confirms it.","operationId":"preview_campaign_references_api_guided_workflow_preview_campaign_references_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignReferencePreviewRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/guided-workflow/landing-page-preflight":{"post":{"tags":["guided-workflow"],"summary":"Preflight Landing Page","operationId":"preflight_landing_page_api_guided_workflow_landing_page_preflight_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LandingPagePreflightRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/guided-workflow/generate-target-audience/job":{"post":{"tags":["guided-workflow"],"summary":"Start Target Audience Job","description":"Start asynchronous target audience generation and return job tracking info.","operationId":"start_target_audience_job_api_guided_workflow_generate_target_audience_job_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Force regeneration of target audiences","default":false,"title":"Force Refresh"},"description":"Force regeneration of target audiences"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TargetAudienceRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/guided-workflow/check-integrations":{"get":{"tags":["guided-workflow"],"summary":"Check Integrations","description":"Check integration status for all external platforms.\n\nReturn connection status and current workspace provider availability.","operationId":"check_integrations_api_guided_workflow_check_integrations_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/guided-workflow/audience-estimates":{"post":{"tags":["guided-workflow"],"summary":"Get Audience Estimates","description":"Estimate audience sizes for Meta and LinkedIn based on target audience options.","operationId":"get_audience_estimates_api_guided_workflow_audience_estimates_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AudienceEstimateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/guided-workflow/create-social-post-campaign":{"post":{"tags":["guided-workflow"],"summary":"Create Social Post Campaign","description":"Start social post campaign generation asynchronously. Returns a tracking job id.","operationId":"create_social_post_campaign_api_guided_workflow_create_social_post_campaign_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_create_social_post_campaign_api_guided_workflow_create_social_post_campaign_post"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/guided-workflow/create-email-campaign":{"post":{"tags":["guided-workflow"],"summary":"Create Email Campaign","description":"Start email campaign generation asynchronously. Returns a tracking job id.","operationId":"create_email_campaign_api_guided_workflow_create_email_campaign_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_create_email_campaign_api_guided_workflow_create_email_campaign_post"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/guided-workflow/create-ads-campaign":{"post":{"tags":["guided-workflow"],"summary":"Create Ads Campaign Endpoint","description":"Start ads campaign generation asynchronously. Returns a tracking job id.","operationId":"create_ads_campaign_endpoint_api_guided_workflow_create_ads_campaign_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_create_ads_campaign_endpoint_api_guided_workflow_create_ads_campaign_post"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/guided-workflow/campaigns/{campaign_id}/generate-video":{"post":{"tags":["guided-workflow"],"summary":"Finalize Video Campaign","description":"Start video generation for a draft video campaign (HITL finalize step).","operationId":"finalize_video_campaign_api_guided_workflow_campaigns__campaign_id__generate_video_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinalizeVideoRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/guided-workflow/campaigns/generate-videos":{"post":{"tags":["guided-workflow"],"summary":"Finalize Video Campaigns","description":"Finalize multiple draft video campaigns, then generate any deferred non-video campaigns.","operationId":"finalize_video_campaigns_api_guided_workflow_campaigns_generate_videos_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinalizeVideosRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/guided-workflow/social-campaigns/generate-videos":{"post":{"tags":["guided-workflow"],"summary":"Finalize Social Video Campaigns","description":"Finalize reviewed social video drafts, then generate deferred non-video social posts.","operationId":"finalize_social_video_campaigns_api_guided_workflow_social_campaigns_generate_videos_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinalizeSocialVideosRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/influencer-discovery/tiktok/challenges":{"get":{"tags":["influencer-discovery"],"summary":"Search Tiktok Challenge Endpoint","operationId":"search_tiktok_challenge_endpoint_api_influencer_discovery_tiktok_challenges_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"keywords","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":100,"title":"Keywords"}},{"name":"count","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Count"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Search Tiktok Challenge Endpoint Api Influencer Discovery Tiktok Challenges Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/tiktok/users/search":{"get":{"tags":["influencer-discovery"],"summary":"Search Tiktok Users Endpoint","operationId":"search_tiktok_users_endpoint_api_influencer_discovery_tiktok_users_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"keywords","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":100,"title":"Keywords"}},{"name":"follower_count","in":"query","required":false,"schema":{"type":"integer","maximum":4,"minimum":0,"default":0,"title":"Follower Count"}},{"name":"count","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":5,"title":"Count"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Cursor"}},{"name":"profile_type","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Profile Type"}},{"name":"other_pref","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Other Pref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Search Tiktok Users Endpoint Api Influencer Discovery Tiktok Users Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/tiktok/users/info":{"get":{"tags":["influencer-discovery"],"summary":"Get Tiktok User Info Endpoint","operationId":"get_tiktok_user_info_endpoint_api_influencer_discovery_tiktok_users_info_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"unique_id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":100,"title":"Unique Id"}},{"name":"region","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":16},{"type":"null"}],"title":"Region"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Tiktok User Info Endpoint Api Influencer Discovery Tiktok Users Info Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/tiktok/users/posts":{"get":{"tags":["influencer-discovery"],"summary":"Get Tiktok User Posts Endpoint","operationId":"get_tiktok_user_posts_endpoint_api_influencer_discovery_tiktok_users_posts_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"unique_id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":100,"title":"Unique Id"}},{"name":"count","in":"query","required":false,"schema":{"type":"integer","maximum":6,"minimum":1,"default":6,"title":"Count"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Cursor"}},{"name":"sort_type","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Sort Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Tiktok User Posts Endpoint Api Influencer Discovery Tiktok Users Posts Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/instagram/hashtags/search":{"get":{"tags":["influencer-discovery"],"summary":"Search Instagram Hashtag Endpoint","operationId":"search_instagram_hashtag_endpoint_api_influencer_discovery_instagram_hashtags_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"hashtag","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":100,"title":"Hashtag"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Search Instagram Hashtag Endpoint Api Influencer Discovery Instagram Hashtags Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/instagram/users/search":{"get":{"tags":["influencer-discovery"],"summary":"Search Instagram Users Endpoint","operationId":"search_instagram_users_endpoint_api_influencer_discovery_instagram_users_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":100,"title":"Query"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Search Instagram Users Endpoint Api Influencer Discovery Instagram Users Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/instagram/users/profile":{"get":{"tags":["influencer-discovery"],"summary":"Get Instagram Profile Endpoint","operationId":"get_instagram_profile_endpoint_api_influencer_discovery_instagram_users_profile_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"username","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Username"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Instagram Profile Endpoint Api Influencer Discovery Instagram Users Profile Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/instagram/reels":{"get":{"tags":["influencer-discovery"],"summary":"Get Instagram Reels Endpoint","operationId":"get_instagram_reels_endpoint_api_influencer_discovery_instagram_reels_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Id"}},{"name":"count","in":"query","required":false,"schema":{"type":"integer","maximum":12,"minimum":1,"default":12,"title":"Count"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Instagram Reels Endpoint Api Influencer Discovery Instagram Reels Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/youtube/channel/details":{"get":{"tags":["influencer-discovery"],"summary":"Get Youtube Channel Details Endpoint","operationId":"get_youtube_channel_details_endpoint_api_influencer_discovery_youtube_channel_details_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":300,"title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Youtube Channel Details Endpoint Api Influencer Discovery Youtube Channel Details Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/youtube/channel/videos":{"get":{"tags":["influencer-discovery"],"summary":"Get Youtube Channel Videos Endpoint","operationId":"get_youtube_channel_videos_endpoint_api_influencer_discovery_youtube_channel_videos_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"title":"Id"}},{"name":"filter","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":64,"default":"videos_latest","title":"Filter"}},{"name":"hl","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":16,"default":"en","title":"Hl"}},{"name":"gl","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":2,"default":"US","title":"Gl"}},{"name":"count","in":"query","required":false,"schema":{"type":"integer","maximum":12,"minimum":1,"default":6,"title":"Count"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Youtube Channel Videos Endpoint Api Influencer Discovery Youtube Channel Videos Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/youtube/auto-complete":{"get":{"tags":["influencer-discovery"],"summary":"Get Youtube Auto Complete Endpoint","operationId":"get_youtube_auto_complete_endpoint_api_influencer_discovery_youtube_auto_complete_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Q"}},{"name":"hl","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":16,"default":"en","title":"Hl"}},{"name":"gl","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":2,"default":"US","title":"Gl"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Youtube Auto Complete Endpoint Api Influencer Discovery Youtube Auto Complete Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/youtube/search":{"get":{"tags":["influencer-discovery"],"summary":"Search Youtube Endpoint","operationId":"search_youtube_endpoint_api_influencer_discovery_youtube_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Q"}},{"name":"hl","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":16,"default":"en","title":"Hl"}},{"name":"gl","in":"query","required":false,"schema":{"type":"string","minLength":2,"maxLength":2,"default":"US","title":"Gl"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Search Youtube Endpoint Api Influencer Discovery Youtube Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/hashtags/recommendations":{"get":{"tags":["influencer-discovery"],"summary":"Recommend Creator Hashtags Endpoint","operationId":"recommend_creator_hashtags_endpoint_api_influencer_discovery_hashtags_recommendations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"platform","in":"query","required":true,"schema":{"type":"string","pattern":"^(tiktok|instagram)$","title":"Platform"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Recommend Creator Hashtags Endpoint Api Influencer Discovery Hashtags Recommendations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/hashtags/product-offering-recommendations":{"get":{"tags":["influencer-discovery"],"summary":"Recommend Product Offering Creator Hashtags Endpoint","operationId":"recommend_product_offering_creator_hashtags_endpoint_api_influencer_discovery_hashtags_product_offering_recommendations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"platform","in":"query","required":true,"schema":{"type":"string","pattern":"^(tiktok|instagram)$","title":"Platform"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Recommend Product Offering Creator Hashtags Endpoint Api Influencer Discovery Hashtags Product Offering Recommendations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/outreach/draft-message":{"post":{"tags":["influencer-discovery"],"summary":"Draft Creator Outreach Message Endpoint","operationId":"draft_creator_outreach_message_endpoint_api_influencer_discovery_outreach_draft_message_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftCreatorOutreachMessageRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Draft Creator Outreach Message Endpoint Api Influencer Discovery Outreach Draft Message Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/influencer-discovery/pricing/estimate":{"post":{"tags":["influencer-discovery"],"summary":"Estimate Influencer Pricing Endpoint","operationId":"estimate_influencer_pricing_endpoint_api_influencer_discovery_pricing_estimate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerPricingEstimateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerPricingEstimateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/influencer-discovery/instagram/beta/sections":{"get":{"tags":["influencer-discovery"],"summary":"List Instagram Beta Sections Endpoint","operationId":"list_instagram_beta_sections_endpoint_api_influencer_discovery_instagram_beta_sections_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Instagram Beta Sections Endpoint Api Influencer Discovery Instagram Beta Sections Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/influencer-discovery/instagram/beta/section-selection":{"get":{"tags":["influencer-discovery"],"summary":"Select Instagram Beta Section Endpoint","operationId":"select_instagram_beta_section_endpoint_api_influencer_discovery_instagram_beta_section_selection_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Select Instagram Beta Section Endpoint Api Influencer Discovery Instagram Beta Section Selection Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/influencer-discovery/instagram/avatar":{"get":{"tags":["influencer-discovery"],"summary":"Proxy Instagram Avatar Endpoint","operationId":"proxy_instagram_avatar_endpoint_api_influencer_discovery_instagram_avatar_get","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":4096,"title":"Url"}},{"name":"username","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Username"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/instagram/avatar/refresh":{"post":{"tags":["influencer-discovery"],"summary":"Refresh Instagram Avatar Endpoint","operationId":"refresh_instagram_avatar_endpoint_api_influencer_discovery_instagram_avatar_refresh_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InstagramAvatarRefreshRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Refresh Instagram Avatar Endpoint Api Influencer Discovery Instagram Avatar Refresh Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/influencer-discovery/profile/avatar":{"get":{"tags":["influencer-discovery"],"summary":"Proxy Influencer Profile Avatar Endpoint","operationId":"proxy_influencer_profile_avatar_endpoint_api_influencer_discovery_profile_avatar_get","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":500,"title":"Url"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/tiktok/users/ingest":{"post":{"tags":["influencer-discovery"],"summary":"Ingest Tiktok User Endpoint","operationId":"ingest_tiktok_user_endpoint_api_influencer_discovery_tiktok_users_ingest_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"unique_id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":100,"title":"Unique Id"}},{"name":"region","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":16},{"type":"null"}],"title":"Region"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Ingest Tiktok User Endpoint Api Influencer Discovery Tiktok Users Ingest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/instagram/users/ingest":{"post":{"tags":["influencer-discovery"],"summary":"Ingest Instagram User Endpoint","operationId":"ingest_instagram_user_endpoint_api_influencer_discovery_instagram_users_ingest_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"username","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Username"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Ingest Instagram User Endpoint Api Influencer Discovery Instagram Users Ingest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/youtube/channel/ingest":{"post":{"tags":["influencer-discovery"],"summary":"Ingest Youtube Channel Endpoint","operationId":"ingest_youtube_channel_endpoint_api_influencer_discovery_youtube_channel_ingest_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":500,"title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Ingest Youtube Channel Endpoint Api Influencer Discovery Youtube Channel Ingest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/outreach-list":{"get":{"tags":["influencer-discovery"],"summary":"List Outreach Creators Endpoint","operationId":"list_outreach_creators_endpoint_api_influencer_discovery_outreach_list_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Outreach Creators Endpoint Api Influencer Discovery Outreach List Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/influencer-discovery/lists":{"post":{"tags":["influencer-discovery"],"summary":"Create Creator List Endpoint","operationId":"create_creator_list_endpoint_api_influencer_discovery_lists_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCreatorListRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Creator List Endpoint Api Influencer Discovery Lists Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["influencer-discovery"],"summary":"List Creator Lists Endpoint","operationId":"list_creator_lists_endpoint_api_influencer_discovery_lists_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Creator Lists Endpoint Api Influencer Discovery Lists Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/lists/{list_id}":{"get":{"tags":["influencer-discovery"],"summary":"Get Creator List Endpoint","operationId":"get_creator_list_endpoint_api_influencer_discovery_lists__list_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"string","title":"List Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Creator List Endpoint Api Influencer Discovery Lists  List Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["influencer-discovery"],"summary":"Update Creator List Endpoint","operationId":"update_creator_list_endpoint_api_influencer_discovery_lists__list_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"string","title":"List Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCreatorListRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Creator List Endpoint Api Influencer Discovery Lists  List Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["influencer-discovery"],"summary":"Archive Creator List Endpoint","operationId":"archive_creator_list_endpoint_api_influencer_discovery_lists__list_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"string","title":"List Id"}},{"name":"permanent","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Permanent"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Archive Creator List Endpoint Api Influencer Discovery Lists  List Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/lists/{list_id}/members":{"post":{"tags":["influencer-discovery"],"summary":"Add Creators To List Endpoint","operationId":"add_creators_to_list_endpoint_api_influencer_discovery_lists__list_id__members_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"string","title":"List Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddCreatorsToListRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Add Creators To List Endpoint Api Influencer Discovery Lists  List Id  Members Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/creators/{creator_id}/lists":{"post":{"tags":["influencer-discovery"],"summary":"Add Creator To Lists Endpoint","operationId":"add_creator_to_lists_endpoint_api_influencer_discovery_creators__creator_id__lists_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"creator_id","in":"path","required":true,"schema":{"type":"string","title":"Creator Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddCreatorToListsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Add Creator To Lists Endpoint Api Influencer Discovery Creators  Creator Id  Lists Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/lists/{list_id}/members/{creator_id}":{"patch":{"tags":["influencer-discovery"],"summary":"Update Creator List Member Endpoint","operationId":"update_creator_list_member_endpoint_api_influencer_discovery_lists__list_id__members__creator_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"string","title":"List Id"}},{"name":"creator_id","in":"path","required":true,"schema":{"type":"string","title":"Creator Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCreatorListMembershipRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Creator List Member Endpoint Api Influencer Discovery Lists  List Id  Members  Creator Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["influencer-discovery"],"summary":"Remove Creator From List Endpoint","operationId":"remove_creator_from_list_endpoint_api_influencer_discovery_lists__list_id__members__creator_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"string","title":"List Id"}},{"name":"creator_id","in":"path","required":true,"schema":{"type":"string","title":"Creator Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Remove Creator From List Endpoint Api Influencer Discovery Lists  List Id  Members  Creator Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/outreach-list/{creator_id}":{"delete":{"tags":["influencer-discovery"],"summary":"Remove Outreach Creator Endpoint","operationId":"remove_outreach_creator_endpoint_api_influencer_discovery_outreach_list__creator_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"creator_id","in":"path","required":true,"schema":{"type":"string","title":"Creator Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Remove Outreach Creator Endpoint Api Influencer Discovery Outreach List  Creator Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/outreach-list/{creator_id}/stage":{"patch":{"tags":["influencer-discovery"],"summary":"Update Outreach Creator Stage Endpoint","operationId":"update_outreach_creator_stage_endpoint_api_influencer_discovery_outreach_list__creator_id__stage_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"creator_id","in":"path","required":true,"schema":{"type":"string","title":"Creator Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateOutreachStageRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Outreach Creator Stage Endpoint Api Influencer Discovery Outreach List  Creator Id  Stage Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/outreach-list/{creator_id}/outreach-sent":{"post":{"tags":["influencer-discovery"],"summary":"Mark Creator Outreach Sent Endpoint","operationId":"mark_creator_outreach_sent_endpoint_api_influencer_discovery_outreach_list__creator_id__outreach_sent_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"creator_id","in":"path","required":true,"schema":{"type":"string","title":"Creator Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Mark Creator Outreach Sent Endpoint Api Influencer Discovery Outreach List  Creator Id  Outreach Sent Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/outreach-list/{creator_id}/drafts":{"get":{"tags":["influencer-discovery"],"summary":"List Creator Outreach Drafts Endpoint","operationId":"list_creator_outreach_drafts_endpoint_api_influencer_discovery_outreach_list__creator_id__drafts_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"creator_id","in":"path","required":true,"schema":{"type":"string","title":"Creator Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Creator Outreach Drafts Endpoint Api Influencer Discovery Outreach List  Creator Id  Drafts Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["influencer-discovery"],"summary":"Save Creator Outreach Draft Endpoint","operationId":"save_creator_outreach_draft_endpoint_api_influencer_discovery_outreach_list__creator_id__drafts_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"creator_id","in":"path","required":true,"schema":{"type":"string","title":"Creator Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveCreatorOutreachDraftRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Save Creator Outreach Draft Endpoint Api Influencer Discovery Outreach List  Creator Id  Drafts Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/outreach-list/{creator_id}/contacts":{"patch":{"tags":["influencer-discovery"],"summary":"Update Outreach Creator Contacts Endpoint","operationId":"update_outreach_creator_contacts_endpoint_api_influencer_discovery_outreach_list__creator_id__contacts_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"creator_id","in":"path","required":true,"schema":{"type":"string","title":"Creator Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCreatorContactsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Outreach Creator Contacts Endpoint Api Influencer Discovery Outreach List  Creator Id  Contacts Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/outreach-list/{creator_id}/locations":{"patch":{"tags":["influencer-discovery"],"summary":"Update Outreach Creator Locations Endpoint","operationId":"update_outreach_creator_locations_endpoint_api_influencer_discovery_outreach_list__creator_id__locations_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"creator_id","in":"path","required":true,"schema":{"type":"string","title":"Creator Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCreatorLocationsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Outreach Creator Locations Endpoint Api Influencer Discovery Outreach List  Creator Id  Locations Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-discovery/evidence/{snapshot_id}":{"get":{"tags":["influencer-discovery"],"summary":"Get Creator Evidence Snapshot Endpoint","operationId":"get_creator_evidence_snapshot_endpoint_api_influencer_discovery_evidence__snapshot_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"snapshot_id","in":"path","required":true,"schema":{"type":"string","title":"Snapshot Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Creator Evidence Snapshot Endpoint Api Influencer Discovery Evidence  Snapshot Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-inventory/search":{"post":{"tags":["influencer-inventory"],"summary":"Search Influencer Inventory","operationId":"search_influencer_inventory_api_influencer_inventory_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerInventorySearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerInventorySearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/influencer-inventory/profiles/related-accounts/discover":{"post":{"tags":["influencer-inventory"],"summary":"Discover Influencer Related Accounts","operationId":"discover_influencer_related_accounts_api_influencer_inventory_profiles_related_accounts_discover_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerRelatedAccountsDiscoveryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerRelatedAccountsDiscoveryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/influencer-inventory/search/brief":{"post":{"tags":["influencer-inventory"],"summary":"Upload Influencer Search Brief","description":"Read one attached brief and hand back its text plus what we actually got.\n\nNothing is stored. The text goes straight back to the caller, which sends it\nwith the search - so an abandoned brief leaves nothing behind, unlike an\nuploaded image, which does become a library asset.","operationId":"upload_influencer_search_brief_api_influencer_inventory_search_brief_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_influencer_search_brief_api_influencer_inventory_search_brief_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerBriefUploadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/influencer-inventory/search/web-discovery/jobs":{"post":{"tags":["influencer-inventory"],"summary":"Start Influencer Web Discovery Job","description":"Start one durable discovery job and return immediately.","operationId":"start_influencer_web_discovery_job_api_influencer_inventory_search_web_discovery_jobs_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerWebDiscoveryRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerWebDiscoveryJobSubmissionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/influencer-inventory/search/web-discovery/jobs/{job_id}":{"get":{"tags":["influencer-inventory"],"summary":"Get Influencer Web Discovery Job","description":"Return a tenant-scoped, product-specific job snapshot for polling.","operationId":"get_influencer_web_discovery_job_api_influencer_inventory_search_web_discovery_jobs__job_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerWebDiscoveryJobStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-inventory/search/web-discovery/jobs/{job_id}/cancel":{"post":{"tags":["influencer-inventory"],"summary":"Cancel Influencer Web Discovery Job","description":"Cancel one tenant-scoped discovery job without exposing generic job APIs.","operationId":"cancel_influencer_web_discovery_job_api_influencer_inventory_search_web_discovery_jobs__job_id__cancel_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-inventory/search/analyze-query":{"post":{"tags":["influencer-inventory"],"summary":"Analyze Influencer Inventory Search Query","operationId":"analyze_influencer_inventory_search_query_api_influencer_inventory_search_analyze_query_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerInventoryQueryFilterAnalysisRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerInventoryQueryFilterAnalysisResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/influencer-inventory/search/web-discovery/curated-lists/stream":{"post":{"tags":["influencer-inventory"],"summary":"Stream Influencer Inventory Curated Lists","description":"Keep long-running curated-list generation alive and return its final snapshot.","operationId":"stream_influencer_inventory_curated_lists_api_influencer_inventory_search_web_discovery_curated_lists_stream_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerInventoryCuratedListsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/influencer-inventory/search/web-discovery/curated-lists":{"post":{"tags":["influencer-inventory"],"summary":"Get Influencer Inventory Curated Lists","operationId":"get_influencer_inventory_curated_lists_api_influencer_inventory_search_web_discovery_curated_lists_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerInventoryCuratedListsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerInventoryCuratedListsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/influencer-inventory/creators/ingest":{"post":{"tags":["influencer-inventory"],"summary":"Ingest Influencer Inventory Creator","operationId":"ingest_influencer_inventory_creator_api_influencer_inventory_creators_ingest_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerInventoryCreatorIngestRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Ingest Influencer Inventory Creator Api Influencer Inventory Creators Ingest Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/influencer-campaigns/active":{"get":{"tags":["influencer-campaigns"],"summary":"Get Active Influencer Campaign","operationId":"get_active_influencer_campaign_api_influencer_campaigns_active_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignActiveResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/influencer-campaigns/active/summaries":{"get":{"tags":["influencer-campaigns"],"summary":"List Active Influencer Campaign Summaries","operationId":"list_active_influencer_campaign_summaries_api_influencer_campaigns_active_summaries_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignSummaryPageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-campaigns/target-market-seed":{"get":{"tags":["influencer-campaigns"],"summary":"Get Influencer Campaign Target Market Seed","operationId":"get_influencer_campaign_target_market_seed_api_influencer_campaigns_target_market_seed_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignTargetMarketSeedResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/influencer-campaigns/{campaign_id}":{"get":{"tags":["influencer-campaigns"],"summary":"Get Influencer Campaign Detail","operationId":"get_influencer_campaign_detail_api_influencer_campaigns__campaign_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignPlanResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["influencer-campaigns"],"summary":"Update Influencer Campaign","operationId":"update_influencer_campaign_api_influencer_campaigns__campaign_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignPlanResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["influencer-campaigns"],"summary":"Delete Influencer Campaign","operationId":"delete_influencer_campaign_api_influencer_campaigns__campaign_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignDeleteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-campaigns":{"post":{"tags":["influencer-campaigns"],"summary":"Create Influencer Campaign","operationId":"create_influencer_campaign_api_influencer_campaigns_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignUpsertRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignPlanResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/influencer-campaigns/from-creator-list/{list_id}":{"post":{"tags":["influencer-campaigns"],"summary":"Create Influencer Campaign From Creator List","operationId":"create_influencer_campaign_from_creator_list_api_influencer_campaigns_from_creator_list__list_id__post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"list_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"List Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignFromCreatorListRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignPlanResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-campaigns/{campaign_id}/source-list-sync":{"post":{"tags":["influencer-campaigns"],"summary":"Sync Influencer Campaign From Source Creator List","operationId":"sync_influencer_campaign_from_source_creator_list_api_influencer_campaigns__campaign_id__source_list_sync_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignSourceListSyncRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignPlanResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-campaigns/{campaign_id}/collection-creators":{"post":{"tags":["influencer-campaigns"],"summary":"Add Influencer Campaign Collection Creators","operationId":"add_influencer_campaign_collection_creators_api_influencer_campaigns__campaign_id__collection_creators_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignCollectionAddCreatorsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignCollectionAddCreatorsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-campaigns/{campaign_id}/collection":{"patch":{"tags":["influencer-campaigns"],"summary":"Update Influencer Campaign Collection","operationId":"update_influencer_campaign_collection_api_influencer_campaigns__campaign_id__collection_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignCollectionUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignPlanResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-campaigns/{campaign_id}/archive":{"post":{"tags":["influencer-campaigns"],"summary":"Archive Influencer Campaign","operationId":"archive_influencer_campaign_api_influencer_campaigns__campaign_id__archive_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignArchiveResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-campaigns/curated-lists/{curated_list_id}/save":{"post":{"tags":["influencer-campaigns"],"summary":"Save Influencer Campaign Curated List","operationId":"save_influencer_campaign_curated_list_api_influencer_campaigns_curated_lists__curated_list_id__save_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"curated_list_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Curated List Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignCuratedListSaveResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-campaigns/curated-lists/{curated_list_id}/roles":{"patch":{"tags":["influencer-campaigns"],"summary":"Update Influencer Campaign Creator Groups","operationId":"update_influencer_campaign_creator_groups_api_influencer_campaigns_curated_lists__curated_list_id__roles_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"curated_list_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Curated List Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignRoleEditsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignCuratedListMutationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-campaigns/curated-lists/{curated_list_id}/report":{"patch":{"tags":["influencer-campaigns"],"summary":"Update Influencer Campaign Report","operationId":"update_influencer_campaign_report_api_influencer_campaigns_curated_lists__curated_list_id__report_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"curated_list_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Curated List Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignReportUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignCuratedListMutationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-campaigns/curated-lists/{curated_list_id}/creators/{creator_id}/replacement-candidates":{"post":{"tags":["influencer-campaigns"],"summary":"Find Influencer Campaign Replacement Candidates","operationId":"find_influencer_campaign_replacement_candidates_api_influencer_campaigns_curated_lists__curated_list_id__creators__creator_id__replacement_candidates_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"curated_list_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Curated List Id"}},{"name":"creator_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Creator Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignReplacementCandidatesRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignReplacementCandidatesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/influencer-campaigns/curated-lists/{curated_list_id}/creators/{creator_id}/replace":{"post":{"tags":["influencer-campaigns"],"summary":"Replace Influencer Campaign Creator","operationId":"replace_influencer_campaign_creator_api_influencer_campaigns_curated_lists__curated_list_id__creators__creator_id__replace_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"curated_list_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Curated List Id"}},{"name":"creator_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Creator Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignReplaceCreatorRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InfluencerCampaignReplaceCreatorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/brand-generation/step1/preflight-url":{"post":{"tags":["brand-workflow","brand-workflow"],"summary":"Preflight Company Url","operationId":"preflight_company_url_api_workflow_brand_generation_step1_preflight_url_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyUrlPreflightRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/workflow/brand-generation/status":{"get":{"tags":["brand-workflow","brand-workflow"],"summary":"Get Workflow Status","operationId":"get_workflow_status_api_workflow_brand_generation_status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_url","in":"query","required":true,"schema":{"type":"string","title":"Company Url"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"workflow_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Workflow Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/brand-generation/step1/upload-files":{"post":{"tags":["brand-workflow","brand-workflow"],"summary":"Upload Analysis Files","operationId":"upload_analysis_files_api_workflow_brand_generation_step1_upload_files_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_analysis_files_api_workflow_brand_generation_step1_upload_files_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/workflow/brand-generation/step1/files":{"get":{"tags":["brand-workflow","brand-workflow"],"summary":"Get Workflow Files","operationId":"get_workflow_files_api_workflow_brand_generation_step1_files_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_url","in":"query","required":true,"schema":{"type":"string","title":"Company Url"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/brand-generation/step1/extract":{"post":{"tags":["brand-workflow","brand-workflow"],"summary":"Extract Company Info","description":"Extract company information using async pipeline with real-time SSE updates.","operationId":"extract_company_info_api_workflow_brand_generation_step1_extract_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Step1ExtractRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/workflow/brand-generation/step1/confirm":{"post":{"tags":["brand-workflow","brand-workflow"],"summary":"Confirm Company Info","description":"Confirm company information and proceed to step 2.","operationId":"confirm_company_info_api_workflow_brand_generation_step1_confirm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Step1ConfirmRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/workflow/brand-generation/step2/discover":{"post":{"tags":["brand-workflow","brand-workflow"],"summary":"Discover Product Offerings","operationId":"discover_product_offerings_api_workflow_brand_generation_step2_discover_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Step2DiscoverRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/workflow/brand-generation/step2/confirm":{"post":{"tags":["brand-workflow","brand-workflow"],"summary":"Confirm Product Lines","description":"Confirm SKUs and save to step2_data.","operationId":"confirm_product_lines_api_workflow_brand_generation_step2_confirm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Step2ConfirmRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/workflow/brand-generation/{workflow_id}/product-offerings":{"get":{"tags":["brand-workflow","brand-workflow"],"summary":"Get Workflow Product Offerings","operationId":"get_workflow_product_offerings_api_workflow_brand_generation__workflow_id__product_offerings_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workflow Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/brand-generation/product-offerings/inventory":{"get":{"tags":["brand-workflow","brand-workflow"],"summary":"Get Available Inventory Offerings","operationId":"get_available_inventory_offerings_api_workflow_brand_generation_product_offerings_inventory_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/brand-generation/product-offerings/augment":{"post":{"tags":["brand-workflow","brand-workflow"],"summary":"Augment Product Offerings Route","operationId":"augment_product_offerings_route_api_workflow_brand_generation_product_offerings_augment_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductOfferingAugmentRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/workflow/brand-generation/product-offerings/extract-url":{"post":{"tags":["brand-workflow","brand-workflow"],"summary":"Extract Product Offerings From Url Route","operationId":"extract_product_offerings_from_url_route_api_workflow_brand_generation_product_offerings_extract_url_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductOfferingExtractUrlRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/workflow/brand-generation/product-offerings/extract-document":{"post":{"tags":["brand-workflow","brand-workflow"],"summary":"Extract Product Offerings From Document Route","operationId":"extract_product_offerings_from_document_route_api_workflow_brand_generation_product_offerings_extract_document_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_extract_product_offerings_from_document_route_api_workflow_brand_generation_product_offerings_extract_document_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/workflow/brand-generation/product-offerings/{offering_id}/restart":{"post":{"tags":["brand-workflow","brand-workflow"],"summary":"Restart Product Offering Analysis","operationId":"restart_product_offering_analysis_api_workflow_brand_generation_product_offerings__offering_id__restart_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Offering Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/brand-generation/product-offerings/{offering_id}/intelligence/retry":{"post":{"tags":["brand-workflow","brand-workflow"],"summary":"Retry Product Offering Intelligence","operationId":"retry_product_offering_intelligence_api_workflow_brand_generation_product_offerings__offering_id__intelligence_retry_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Offering Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/brand-generation/step3/competitors-status/{workflow_id}":{"get":{"tags":["brand-workflow","brand-workflow"],"summary":"Get Competitors Discovery Status","operationId":"get_competitors_discovery_status_api_workflow_brand_generation_step3_competitors_status__workflow_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workflow Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/brand-generation/step3/competitors/sse/{workflow_id}":{"get":{"tags":["brand-workflow","brand-workflow"],"summary":"Competitors Discovery Sse Stream","operationId":"competitors_discovery_sse_stream_api_workflow_brand_generation_step3_competitors_sse__workflow_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workflow Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/brand-generation/step3/regenerate-competitors":{"post":{"tags":["brand-workflow","brand-workflow"],"summary":"Regenerate Competitors","operationId":"regenerate_competitors_api_workflow_brand_generation_step3_regenerate_competitors_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompetitorRegenerateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/workflow/brand-generation/step3/confirm-competitors":{"post":{"tags":["brand-workflow","brand-workflow"],"summary":"Confirm Competitors Workflow Id","description":"Confirm selected competitors and continue workflow processing.","operationId":"confirm_competitors_workflow_id_api_workflow_brand_generation_step3_confirm_competitors_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmCompetitorsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/workflow/brand-generation/step3/validate-competitor":{"post":{"tags":["brand-workflow","brand-workflow"],"summary":"Validate Competitor Url","operationId":"validate_competitor_url_api_workflow_brand_generation_step3_validate_competitor_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_validate_competitor_url_api_workflow_brand_generation_step3_validate_competitor_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/workflow/brand-generation/onboarding/runs":{"get":{"tags":["brand-workflow","brand-workflow"],"summary":"Get Onboarding Runs","operationId":"get_onboarding_runs_api_workflow_brand_generation_onboarding_runs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/brand-generation/onboarding/view/{workflow_id}":{"get":{"tags":["brand-workflow","brand-workflow"],"summary":"Get Onboarding View","operationId":"get_onboarding_view_api_workflow_brand_generation_onboarding_view__workflow_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workflow Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/brand-generation/onboarding/stream/{workflow_id}":{"get":{"tags":["brand-workflow","brand-workflow"],"summary":"Onboarding View Stream","operationId":"onboarding_view_stream_api_workflow_brand_generation_onboarding_stream__workflow_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workflow Id"}},{"name":"last_event_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Event Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/brand-generation/recent":{"get":{"tags":["brand-workflow","brand-workflow"],"summary":"Get Recent Workflows","operationId":"get_recent_workflows_api_workflow_brand_generation_recent_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/workflow/brand-generation/recent/status":{"get":{"tags":["brand-workflow","brand-workflow"],"summary":"Get Recent Workflows Status","operationId":"get_recent_workflows_status_api_workflow_brand_generation_recent_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/workflow/brand-generation/marketing-profile/sse/{workflow_id}":{"get":{"tags":["brand-workflow","brand-workflow"],"summary":"Marketing Profile Sse Stream","operationId":"marketing_profile_sse_stream_api_workflow_brand_generation_marketing_profile_sse__workflow_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workflow Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/brand-generation/marketing-profile/state/{workflow_id}":{"get":{"tags":["brand-workflow","brand-workflow"],"summary":"Get Marketing Profile State Route","operationId":"get_marketing_profile_state_route_api_workflow_brand_generation_marketing_profile_state__workflow_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workflow Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/brand-generation/marketing-profile/generate/{workflow_id}":{"post":{"tags":["brand-workflow","brand-workflow"],"summary":"Generate Marketing Profile Route","operationId":"generate_marketing_profile_route_api_workflow_brand_generation_marketing_profile_generate__workflow_id__post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workflow Id"}},{"name":"force_restart","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Force Restart"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/MarketingProfileGenerationRequest"},{"type":"null"}],"title":"Request Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/brand-generation/marketing-profile/{workflow_id}":{"get":{"tags":["brand-workflow","brand-workflow"],"summary":"Get Marketing Profile","operationId":"get_marketing_profile_api_workflow_brand_generation_marketing_profile__workflow_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workflow Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/brand-generation/onboarding/narrative/{workflow_id}":{"post":{"tags":["brand-workflow","brand-workflow"],"summary":"Summarize Onboarding Narrative Route","operationId":"summarize_onboarding_narrative_route_api_workflow_brand_generation_onboarding_narrative__workflow_id__post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workflow Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OnboardingNarrativeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/brand-generation/agent-mode/start":{"post":{"tags":["brand-workflow","brand-workflow"],"summary":"Start Agent Mode","description":"Enable agent mode for a brand workflow and start a background task to\nauto-advance the workflow where possible.","operationId":"start_agent_mode_api_workflow_brand_generation_agent_mode_start_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentModeStartRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/brand-workflow/sse/stream/{process_id}":{"get":{"tags":["brand-workflow-sse","brand-workflow-sse"],"summary":"Stream Brand Workflow Events","description":"Stream brand workflow events for a specific process.\n\nArgs:\n    request: FastAPI request\n    process_id: Workflow process ID\n    last_event_id: Last event ID for reconnection\n    current_user: Authenticated user\n    \nReturns:\n    EventSourceResponse streaming workflow events","operationId":"stream_brand_workflow_events_api_brand_workflow_sse_stream__process_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"process_id","in":"path","required":true,"schema":{"type":"string","title":"Process Id"}},{"name":"last_event_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Event Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/brand-workflow/sse/stream":{"get":{"tags":["brand-workflow-sse","brand-workflow-sse"],"summary":"Stream All Workflow Events","description":"Stream all brand workflow events for the current user.\n\nArgs:\n    request: FastAPI request\n    last_event_id: Last event ID for reconnection\n    current_user: Authenticated user\n    \nReturns:\n    EventSourceResponse streaming all user's workflow events","operationId":"stream_all_workflow_events_api_brand_workflow_sse_stream_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"last_event_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Event Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/brand-workflow/sse/test/{process_id}":{"post":{"tags":["brand-workflow-sse","brand-workflow-sse"],"summary":"Test Workflow Events","description":"Test endpoint to emit sample workflow events.\nFor development/testing only.","operationId":"test_workflow_events_api_brand_workflow_sse_test__process_id__post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"process_id","in":"path","required":true,"schema":{"type":"string","title":"Process Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/brand-workflow/sse/state/{process_id}":{"get":{"tags":["brand-workflow-sse","brand-workflow-sse"],"summary":"Get Workflow State","description":"Return the full, latest live state JSON for the given process_id from Redis.","operationId":"get_workflow_state_api_brand_workflow_sse_state__process_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"process_id","in":"path","required":true,"schema":{"type":"string","title":"Process Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"title":"Response Get Workflow State Api Brand Workflow Sse State  Process Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/brand-workflow/sse/active":{"get":{"tags":["brand-workflow-sse","brand-workflow-sse"],"summary":"Get Active Workflow","description":"Return the active process_id for this user+company+url if any (Redis-backed).","operationId":"get_active_workflow_api_brand_workflow_sse_active_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_url","in":"query","required":true,"schema":{"type":"string","title":"Company Url"}},{"name":"company_profile_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/first-look/documents":{"post":{"tags":["first-look","first-look"],"summary":"Upload First Look Document","description":"A brand deck, product sheet or brief the owner adds beside the website. Its text rides along with the run; the website stays required.","operationId":"upload_first_look_document_api_workflow_first_look_documents_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_first_look_document_api_workflow_first_look_documents_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Upload First Look Document Api Workflow First Look Documents Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/workflow/first-look/start":{"post":{"tags":["first-look","first-look"],"summary":"Start First Look","operationId":"start_first_look_api_workflow_first_look_start_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Start First Look Api Workflow First Look Start Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/workflow/first-look/active":{"get":{"tags":["first-look","first-look"],"summary":"Active First Look","operationId":"active_first_look_api_workflow_first_look_active_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Active First Look Api Workflow First Look Active Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/first-look/latest":{"get":{"tags":["first-look","first-look"],"summary":"Latest First Look","description":"The first look's brief for a profile: live from Redis while it runs, then from the workflow row.","operationId":"latest_first_look_api_workflow_first_look_latest_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Latest First Look Api Workflow First Look Latest Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/first-look/creative-preview/{image_id}":{"get":{"tags":["first-look","first-look"],"summary":"First Look Creative Preview","description":"Serve public ad thumbnails through our origin instead of an ad-serving domain.","operationId":"first_look_creative_preview_api_workflow_first_look_creative_preview__image_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"image_id","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{1,30}$","title":"Image Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/first-look/{workflow_id}/state":{"get":{"tags":["first-look","first-look"],"summary":"First Look State","operationId":"first_look_state_api_workflow_first_look__workflow_id__state_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workflow Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response First Look State Api Workflow First Look  Workflow Id  State Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/first-look/{workflow_id}/stream":{"get":{"tags":["first-look","first-look"],"summary":"First Look Stream","operationId":"first_look_stream_api_workflow_first_look__workflow_id__stream_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workflow Id"}},{"name":"last_event_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Event Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/workflow/first-look/{workflow_id}/answers":{"post":{"tags":["first-look","first-look"],"summary":"First Look Answers","operationId":"first_look_answers_api_workflow_first_look__workflow_id__answers_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Workflow Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswersRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response First Look Answers Api Workflow First Look  Workflow Id  Answers Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/metrics":{"get":{"tags":["metrics","metrics"],"summary":"Get Metrics","description":"Expose Prometheus metrics.\n\nThis endpoint returns metrics in Prometheus text format.\nMetrics include:\n- SSE connection counts and duration\n- Active SSE connections\n- Other application metrics","operationId":"get_metrics_metrics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/gallery/images/ids":{"get":{"tags":["gallery","gallery"],"summary":"Get Gallery Image Ids","description":"Every visible asset id matching the library filters, newest first.\n\nBacks \"Select all N matching\" so a bulk action can cover assets the page\nhas not loaded yet. Bounded so one request cannot page an entire tenant.","operationId":"get_gallery_image_ids_api_gallery_images_ids_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"subcategory","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subcategory"}},{"name":"media_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Media Type"}},{"name":"asset_origin","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(brand_assets|pomo_generations|external_ads)$"},{"type":"null"}],"title":"Asset Origin"}},{"name":"ad_platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9_-]{1,32}$"},{"type":"null"}],"title":"Ad Platform"}},{"name":"performance_tier","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(high|typical|low|learning)$"},{"type":"null"}],"title":"Performance Tier"}},{"name":"analysis_status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^completed$"},{"type":"null"}],"title":"Analysis Status"}},{"name":"is_favorite","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Favorite"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryImageIdsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/gallery/images/removed":{"get":{"tags":["gallery","gallery"],"summary":"Get Removed Gallery Images","description":"Assets removed from the library, most recently removed first.","operationId":"get_removed_gallery_images_api_gallery_images_removed_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":60,"minimum":1,"default":20,"title":"Limit"}},{"name":"media_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(image|video)$"},{"type":"null"}],"title":"Media Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/gallery/images/removed/restore-all":{"post":{"tags":["gallery","gallery"],"summary":"Restore All Removed Gallery Images Route","description":"Put every removed asset back, optionally one media type, without paging.","operationId":"restore_all_removed_gallery_images_route_api_gallery_images_removed_restore_all_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"media_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(image|video)$"},{"type":"null"}],"title":"Media Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryRestoreResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/gallery/images/restore":{"post":{"tags":["gallery","gallery"],"summary":"Restore Removed Gallery Images","description":"Put removed assets back in the library. Ids that are not removed are ignored.","operationId":"restore_removed_gallery_images_api_gallery_images_restore_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryRestoreRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryRestoreResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/gallery/images/removed/empty":{"post":{"tags":["gallery","gallery"],"summary":"Empty Removed Gallery Images","description":"Delete every removed asset for good, optionally one media type, ahead of the sweep.","operationId":"empty_removed_gallery_images_api_gallery_images_removed_empty_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"media_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(image|video)$"},{"type":"null"}],"title":"Media Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryRemovedEmptyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/gallery/images":{"get":{"tags":["gallery","gallery"],"summary":"Get Gallery Images","description":"Get paginated gallery images with filtering and sorting options","operationId":"get_gallery_images_api_gallery_images_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":20,"title":"Limit"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"subcategory","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subcategory"}},{"name":"media_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Media Type"}},{"name":"asset_origin","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(brand_assets|pomo_generations|external_ads)$"},{"type":"null"}],"title":"Asset Origin"}},{"name":"ad_platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^[A-Za-z0-9_-]{1,32}$"},{"type":"null"}],"title":"Ad Platform"}},{"name":"performance_tier","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(high|typical|low|learning)$"},{"type":"null"}],"title":"Performance Tier"}},{"name":"analysis_status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^completed$"},{"type":"null"}],"title":"Analysis Status"}},{"name":"is_favorite","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Favorite"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","pattern":"^(created_at|updated_at|title)$","default":"created_at","title":"Sort By"}},{"name":"sort_order","in":"query","required":false,"schema":{"type":"string","pattern":"^(asc|desc)$","default":"desc","title":"Sort Order"}},{"name":"selection_purpose","in":"query","required":false,"schema":{"anyOf":[{"const":"markee_reference","type":"string"},{"type":"null"}],"title":"Selection Purpose"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/gallery/images/{image_id}":{"get":{"tags":["gallery","gallery"],"summary":"Get Gallery Image","description":"Get a specific gallery image by ID","operationId":"get_gallery_image_api_gallery_images__image_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"image_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Image Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryImageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["gallery","gallery"],"summary":"Update Gallery Image","description":"Update gallery image metadata","operationId":"update_gallery_image_api_gallery_images__image_id__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"image_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Image Id"}},{"name":"title","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"}},{"name":"description","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},{"name":"is_favorite","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Favorite"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Tags"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryImageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["gallery","gallery"],"summary":"Delete Gallery Image","description":"Delete a gallery image (soft delete by default, permanent if specified)","operationId":"delete_gallery_image_api_gallery_images__image_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"image_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Image Id"}},{"name":"permanent","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Permanent"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/gallery/images/{image_id}/preview":{"get":{"tags":["gallery","gallery"],"summary":"Get Gallery Image Preview","description":"Proxy a gallery image or managed video poster through profile-scoped auth.","operationId":"get_gallery_image_preview_api_gallery_images__image_id__preview_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"image_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Image Id"}},{"name":"generation","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Generation"}},{"name":"content_version","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/gallery/images/{image_id}/media-playback":{"get":{"tags":["gallery","gallery"],"summary":"Get Gallery Video Playback","description":"Mint a short-lived, asset- and profile-scoped URL for native video playback.","operationId":"get_gallery_video_playback_api_gallery_images__image_id__media_playback_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"image_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Image Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/gallery/images/{image_id}/media":{"get":{"tags":["gallery","gallery"],"summary":"Stream Gallery Video","description":"Authenticated range endpoint for canonical Gallery video assets.","operationId":"stream_gallery_video_api_gallery_images__image_id__media_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"image_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Image Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/gallery/images/{image_id}/campaign-asset-intelligence":{"post":{"tags":["gallery","gallery"],"summary":"Analyze Gallery Image For Campaign","description":"Score a gallery image/video as user-provided creative for a campaign idea.","operationId":"analyze_gallery_image_for_campaign_api_gallery_images__image_id__campaign_asset_intelligence_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"image_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Image Id"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/gallery/create-with-ai":{"post":{"tags":["gallery","gallery"],"summary":"Create Gallery Image With Ai","description":"Create images using AI and add them to the gallery.\nThis uses the content editing generate_image endpoint internally.","operationId":"create_gallery_image_with_ai_api_gallery_create_with_ai_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_create_gallery_image_with_ai_api_gallery_create_with_ai_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryCreateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/gallery/upload":{"post":{"tags":["gallery","gallery"],"summary":"Upload Gallery Image","description":"Upload a new image to the gallery","operationId":"upload_gallery_image_api_gallery_upload_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_gallery_image_api_gallery_upload_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryImageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/gallery/upload-bulk":{"post":{"tags":["gallery","gallery"],"summary":"Upload Gallery Images Bulk","description":"Upload multiple images to the gallery at once (up to 9 images)","operationId":"upload_gallery_images_bulk_api_gallery_upload_bulk_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_gallery_images_bulk_api_gallery_upload_bulk_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GalleryUploadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/gallery/create-with-ai/job":{"post":{"tags":["gallery","gallery"],"summary":"Create Gallery Image With Ai Job","description":"Start an async AI Studio generation job (agent job pattern).\nReturns job info for polling/SSE.","operationId":"create_gallery_image_with_ai_job_api_gallery_create_with_ai_job_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_create_gallery_image_with_ai_job_api_gallery_create_with_ai_job_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/gallery/create-video-with-ai/job":{"post":{"tags":["gallery","gallery"],"summary":"Create Gallery Video With Ai Job","description":"Start an async AI Studio video generation job (agent job pattern).\nReturns job info for polling/SSE.","operationId":"create_gallery_video_with_ai_job_api_gallery_create_video_with_ai_job_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_create_gallery_video_with_ai_job_api_gallery_create_video_with_ai_job_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/gallery/images/bulk-delete":{"post":{"tags":["gallery","gallery"],"summary":"Bulk Delete Gallery Images","description":"Delete multiple gallery images at once","operationId":"bulk_delete_gallery_images_api_gallery_images_bulk_delete_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"permanent","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Permanent"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","items":{"type":"string","format":"uuid"},"title":"Image Ids"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/gallery/categories":{"get":{"tags":["gallery","gallery"],"summary":"Get Gallery Categories","description":"Get all available categories and subcategories for the company's gallery","operationId":"get_gallery_categories_api_gallery_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response Get Gallery Categories Api Gallery Categories Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/gallery-media/{image_id}":{"get":{"tags":["gallery-media","gallery-media"],"summary":"Stream Gallery Video Playback","description":"Range-stream a video after validating its short-lived playback capability.","operationId":"stream_gallery_video_playback_api_gallery_media__image_id__get","parameters":[{"name":"image_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Image Id"}},{"name":"token","in":"query","required":true,"schema":{"type":"string","minLength":32,"maxLength":4096,"title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/social-work-media/{post_id}/{media_id}":{"get":{"tags":["social-media","social-media"],"summary":"Stream Social Video","operationId":"stream_social_video_api_social_work_media__post_id___media_id__get","parameters":[{"name":"post_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Post Id"}},{"name":"media_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Media Id"}},{"name":"token","in":"query","required":true,"schema":{"type":"string","minLength":32,"maxLength":4096,"title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/paid-work-media/{ad_id}/{rendition_id}":{"get":{"tags":["paid-media","paid-media"],"summary":"Stream Paid Video","operationId":"stream_paid_video_api_paid_work_media__ad_id___rendition_id__get","parameters":[{"name":"ad_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ad Id"}},{"name":"rendition_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Rendition Id"}},{"name":"token","in":"query","required":true,"schema":{"type":"string","minLength":32,"maxLength":4096,"title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/change-management/settings":{"get":{"tags":["change-management","change-management"],"summary":"Get Settings","operationId":"get_settings_api_change_management_settings_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Bypass the shared response cache","default":false,"title":"Force Refresh"},"description":"Bypass the shared response cache"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeManagementSettingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["change-management","change-management"],"summary":"Update Settings","operationId":"update_settings_api_change_management_settings_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeManagementSettingsUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeManagementSettingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/change-management/approval-groups":{"get":{"tags":["change-management","change-management"],"summary":"Get Approval Groups","operationId":"get_approval_groups_api_change_management_approval_groups_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Bypass the shared response cache","default":false,"title":"Force Refresh"},"description":"Bypass the shared response cache"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ApprovalGroupResponse"},"title":"Response Get Approval Groups Api Change Management Approval Groups Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["change-management","change-management"],"summary":"Create Approval Group","operationId":"create_approval_group_api_change_management_approval_groups_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalGroupCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalGroupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/change-management/approval-groups/{group_id}":{"put":{"tags":["change-management","change-management"],"summary":"Update Approval Group","operationId":"update_approval_group_api_change_management_approval_groups__group_id__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Group Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalGroupUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalGroupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["change-management","change-management"],"summary":"Delete Approval Group","operationId":"delete_approval_group_api_change_management_approval_groups__group_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Group Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/change-management/approval-groups/{group_id}/members":{"put":{"tags":["change-management","change-management"],"summary":"Set Approval Group Members","operationId":"set_approval_group_members_api_change_management_approval_groups__group_id__members_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Group Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalGroupSetMembersRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalGroupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/change-management/requests":{"post":{"tags":["change-management","change-management"],"summary":"Create Request","operationId":"create_request_api_change_management_requests_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeRequestCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeRequestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["change-management","change-management"],"summary":"List Requests","operationId":"list_requests_api_change_management_requests_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ChangeRequestResponse"},"title":"Response List Requests Api Change Management Requests Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/change-management/requests/summary":{"get":{"tags":["change-management","change-management"],"summary":"Get Requests Summary","operationId":"get_requests_summary_api_change_management_requests_summary_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeRequestSummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/change-management/requests/{change_request_id}":{"get":{"tags":["change-management","change-management"],"summary":"Get Request","operationId":"get_request_api_change_management_requests__change_request_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"change_request_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Change Request Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeRequestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/change-management/requests/{change_request_id}/preview":{"get":{"tags":["change-management","change-management"],"summary":"Get Request Preview","operationId":"get_request_preview_api_change_management_requests__change_request_id__preview_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"change_request_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Change Request Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeRequestPreviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/change-management/requests/{change_request_id}/approvals":{"post":{"tags":["change-management","change-management"],"summary":"Approve Request","operationId":"approve_request_api_change_management_requests__change_request_id__approvals_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"change_request_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Change Request Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeRequestApproveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeRequestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/change-management/requests/{change_request_id}/execute":{"post":{"tags":["change-management","change-management"],"summary":"Execute Request","operationId":"execute_request_api_change_management_requests__change_request_id__execute_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"change_request_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Change Request Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ChangeRequestExecuteRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/system-findings/review-queue":{"get":{"tags":["system-finding-reviews","system-finding-reviews"],"summary":"List System Finding Review Queue","operationId":"list_system_finding_review_queue_api_system_findings_review_queue_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"lane","in":"query","required":true,"schema":{"enum":["reports_action_outcome","reports_output_qa"],"type":"string","title":"Lane"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":1024},{"type":"null"}],"title":"Cursor"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SystemFindingReviewQueuePage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/system-findings/{system_finding_id}/adjudications":{"post":{"tags":["system-finding-reviews","system-finding-reviews"],"summary":"Record System Finding Adjudication","operationId":"record_system_finding_adjudication_api_system_findings__system_finding_id__adjudications_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"system_finding_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"System Finding Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SystemFindingAdjudicationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SystemFindingAdjudicationResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-policy":{"get":{"tags":["ai-policy"],"summary":"Get Ai Policy State","operationId":"get_ai_policy_state_api_ai_policy_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"policy_purpose","in":"query","required":false,"schema":{"type":"string","description":"Policy purpose: compliance|brand_guidelines","default":"compliance","title":"Policy Purpose"},"description":"Policy purpose: compliance|brand_guidelines"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiPolicyStateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-policy/settings":{"put":{"tags":["ai-policy"],"summary":"Update Ai Policy Settings","operationId":"update_ai_policy_settings_api_ai_policy_settings_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"policy_purpose","in":"query","required":false,"schema":{"type":"string","description":"Policy purpose: compliance|brand_guidelines","default":"compliance","title":"Policy Purpose"},"description":"Policy purpose: compliance|brand_guidelines"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiPolicySettingsUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiPolicyStateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-policy/generate":{"post":{"tags":["ai-policy"],"summary":"Generate Ai Policy Draft","operationId":"generate_ai_policy_draft_api_ai_policy_generate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"policy_purpose","in":"query","required":false,"schema":{"type":"string","description":"Policy purpose: compliance|brand_guidelines","default":"compliance","title":"Policy Purpose"},"description":"Policy purpose: compliance|brand_guidelines"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiPolicyStateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-policy/draft":{"put":{"tags":["ai-policy"],"summary":"Update Ai Policy Draft","operationId":"update_ai_policy_draft_api_ai_policy_draft_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"policy_purpose","in":"query","required":false,"schema":{"type":"string","description":"Policy purpose: compliance|brand_guidelines","default":"compliance","title":"Policy Purpose"},"description":"Policy purpose: compliance|brand_guidelines"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiPolicyDraftUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiPolicyStateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-policy/save":{"post":{"tags":["ai-policy"],"summary":"Save Ai Policy","operationId":"save_ai_policy_api_ai_policy_save_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"policy_purpose","in":"query","required":false,"schema":{"type":"string","description":"Policy purpose: compliance|brand_guidelines","default":"compliance","title":"Policy Purpose"},"description":"Policy purpose: compliance|brand_guidelines"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiPolicySaveVersionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiPolicyStateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-policy/generate-version-name":{"post":{"tags":["ai-policy"],"summary":"Generate Ai Policy Version Name","operationId":"generate_ai_policy_version_name_api_ai_policy_generate_version_name_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"policy_purpose","in":"query","required":false,"schema":{"type":"string","description":"Policy purpose: compliance|brand_guidelines","default":"compliance","title":"Policy Purpose"},"description":"Policy purpose: compliance|brand_guidelines"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiPolicyGenerateVersionNameRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiPolicyGenerateVersionNameResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-policy/activate":{"post":{"tags":["ai-policy"],"summary":"Activate Ai Policy","operationId":"activate_ai_policy_api_ai_policy_activate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"policy_purpose","in":"query","required":false,"schema":{"type":"string","description":"Policy purpose: compliance|brand_guidelines","default":"compliance","title":"Policy Purpose"},"description":"Policy purpose: compliance|brand_guidelines"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiPolicyActivateVersionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiPolicyStateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-policy/violations":{"get":{"tags":["ai-policy"],"summary":"List Ai Policy Violations","operationId":"list_ai_policy_violations_api_ai_policy_violations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"surface","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional surface filter: chat|ads|social|images|cm","title":"Surface"},"description":"Optional surface filter: chat|ads|social|images|cm"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AiPolicyViolationEvent"},"title":"Response List Ai Policy Violations Api Ai Policy Violations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-policy/latest-warning":{"get":{"tags":["ai-policy"],"summary":"Get Latest Ai Policy Warning","operationId":"get_latest_ai_policy_warning_api_ai_policy_latest_warning_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"surface","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional surface filter: chat|ads|social|images|cm","title":"Surface"},"description":"Optional surface filter: chat|ads|social|images|cm"},{"name":"ad_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"}},{"name":"campaign_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id"}},{"name":"primary_campaign_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Campaign Id"}},{"name":"batch_campaign_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Batch Campaign Id"}},{"name":"conversation_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id"}},{"name":"change_request_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Request Id"}},{"name":"gallery_image_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gallery Image Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AiPolicyContextWarningResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/social-posts/platforms":{"get":{"tags":["social-posts"],"summary":"Get Platforms","description":"Get all supported platforms and their configurations.","operationId":"get_platforms_api_social_posts_platforms_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/social-posts/platforms/{platform}/post-types":{"get":{"tags":["social-posts"],"summary":"Get Platform Post Types","description":"Get supported post types for a specific platform.","operationId":"get_platform_post_types_api_social_posts_platforms__platform__post_types_get","parameters":[{"name":"platform","in":"path","required":true,"schema":{"type":"string","title":"Platform"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/social-posts/generate":{"post":{"tags":["social-posts"],"summary":"Generate Social Posts","description":"Generate social media posts for a specific platform and format.","operationId":"generate_social_posts_api_social_posts_generate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialPostRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/social-posts/batch-generate":{"post":{"tags":["social-posts"],"summary":"Batch Generate Posts","description":"Generate posts for multiple platforms in one request.","operationId":"batch_generate_posts_api_social_posts_batch_generate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchGenerateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/social-posts/campaigns":{"get":{"tags":["social-posts"],"summary":"Get Campaigns","description":"Get user's social media campaigns with filtering.","operationId":"get_campaigns_api_social_posts_campaigns_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"}},{"name":"post_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Post Type"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/social-posts/campaigns/{campaign_db_id}":{"get":{"tags":["social-posts"],"summary":"Get Campaign Details","description":"Get campaign details by the row's database UUID.","operationId":"get_campaign_details_api_social_posts_campaigns__campaign_db_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_db_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Db Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/social-posts/campaigns/{campaign_id}":{"put":{"tags":["social-posts"],"summary":"Update Campaign","description":"Update a campaign's content.","operationId":"update_campaign_api_social_posts_campaigns__campaign_id__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePostRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["social-posts"],"summary":"Delete Campaign","description":"Delete a campaign and all its variations.","operationId":"delete_campaign_api_social_posts_campaigns__campaign_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/social-posts/campaigns/{campaign_id}/variation":{"post":{"tags":["social-posts"],"summary":"Generate Variation","description":"Generate a variation of an existing post.","operationId":"generate_variation_api_social_posts_campaigns__campaign_id__variation_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Campaign Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateVariationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-refresh":{"get":{"tags":["competitor-tracking"],"summary":"State","operationId":"state_api_competitor_refresh_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/competitor-refresh/settings":{"put":{"tags":["competitor-tracking"],"summary":"Configure","operationId":"configure_api_competitor_refresh_settings_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Settings"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/competitor-refresh/check":{"post":{"tags":["competitor-tracking"],"summary":"Check","operationId":"check_api_competitor_refresh_check_post","responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/competitor-refresh/{review_id}/approve":{"post":{"tags":["competitor-tracking"],"summary":"Approve","operationId":"approve_api_competitor_refresh__review_id__approve_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"review_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Review Id"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-refresh/{review_id}/dismiss":{"post":{"tags":["competitor-tracking"],"summary":"Dismiss","operationId":"dismiss_api_competitor_refresh__review_id__dismiss_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"review_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Review Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/setup":{"post":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Setup Competitors","description":"Add competitor rows quickly and enqueue the slow setup/scan work.\n\nThe UI polls persisted scan state from /status. Keeping the initial HTTP\nrequest lightweight avoids ALB 504s when crawling, ad scanning, and\nenrichment take multiple minutes.","operationId":"setup_competitors_api_competitor_tracking_setup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompetitorSetupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CompetitorInfo"},"type":"array","title":"Response Setup Competitors Api Competitor Tracking Setup Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/competitor-tracking/list":{"get":{"tags":["competitor-tracking","competitor-tracking"],"summary":"List Competitors","description":"List all competitors being tracked by the user.\n\nReturns:\n    List of competitor information with active campaign counts","operationId":"list_competitors_api_competitor_tracking_list_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CompetitorInfo"},"type":"array","title":"Response List Competitors Api Competitor Tracking List Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/competitor-tracking/status":{"get":{"tags":["competitor-tracking","competitor-tracking"],"summary":"List Competitor Statuses","operationId":"list_competitor_statuses_api_competitor_tracking_status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"title":"Competitor Ids"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CompetitorLiveStatus"},"title":"Response List Competitor Statuses Api Competitor Tracking Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/onboarding/ads-preview":{"get":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Get Onboarding Ads Preview","description":"Backend-owned onboarding ads payload for rendering and narrative context.\n\nReturns per-competitor creatives scoped to:\n- top N longest-running ads\n- top N newest ads","operationId":"get_onboarding_ads_preview_api_competitor_tracking_onboarding_ads_preview_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"title":"Competitor Ids"}},{"name":"competitors_limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":6,"title":"Competitors Limit"}},{"name":"longest_running_per_competitor","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":0,"default":5,"title":"Longest Running Per Competitor"}},{"name":"newest_per_competitor","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":0,"default":5,"title":"Newest Per Competitor"}},{"name":"ensure_analysis","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Ensure Analysis"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/scan/{competitor_id}":{"post":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Scan Competitor","description":"Scan a specific competitor for new campaigns.\n\nArgs:\n    competitor_id: ID of the competitor to scan\n    scan_types: Optional list of scan types (website, facebook, social)\n\nReturns:\n    Scan results with campaigns found","operationId":"scan_competitor_api_competitor_tracking_scan__competitor_id__post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"Types of scans to perform","title":"Scan Types"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScanResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/details-batch":{"get":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Get Competitor Details Batch","description":"Fetch the same competitor-detail payload in one request for overview-style fan-out.","operationId":"get_competitor_details_batch_api_competitor_tracking_details_batch_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_ids","in":"query","required":true,"schema":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Competitor IDs to fetch","title":"Competitor Ids"},"description":"Competitor IDs to fetch"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CompetitorDetailsResponse"},"title":"Response Get Competitor Details Batch Api Competitor Tracking Details Batch Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/{competitor_id}":{"get":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Get Competitor Details","description":"Get detailed information about a competitor including campaigns.\n\nArgs:\n    competitor_id: ID of the competitor\n\nReturns:\n    Detailed competitor information with campaigns","operationId":"get_competitor_details_api_competitor_tracking__competitor_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompetitorDetailsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Delete Competitor","description":"Soft-archive a competitor from tracking (legacy delete route).\nKept for backward compatibility; use /archive for clarity.","operationId":"delete_competitor_api_competitor_tracking__competitor_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/{competitor_id}/insights":{"get":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Get Competitor Insights","description":"Return the cached or freshly generated marketing insight for a competitor.","operationId":"get_competitor_insights_api_competitor_tracking__competitor_id__insights_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Regenerate the insight even when the cached version is still fresh.","default":false,"title":"Force Refresh"},"description":"Regenerate the insight even when the cached version is still fresh."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompetitorInsightsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/{competitor_id}/scan-status":{"get":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Get Competitor Scan Status","description":"Lightweight scan status endpoint for polling.\n\nReturns latest scan log times and a computed is_scanning flag (started within 60 minutes and not completed).","operationId":"get_competitor_scan_status_api_competitor_tracking__competitor_id__scan_status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/{competitor_id}/brand-facebook-official-url":{"get":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Get Brand Facebook Official Url","description":"Resolve the competitor's official Facebook URL for Campaigns -> Facebook tab.\n\nStep 1: Check competitors.facebook_page_url.\nStep 2: If empty, ask LLM (with competitor name + competitor website), then persist back to competitors.facebook_page_url.\nStep 3: Use facebook_page_id to fetch public About fields from Graph API.","operationId":"get_brand_facebook_official_url_api_competitor_tracking__competitor_id__brand_facebook_official_url_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandFacebookOfficialUrlResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/{competitor_id}/facebook-ads":{"get":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Get Competitor Facebook Ads","description":"Get all Facebook ads for a competitor (debug endpoint).\n\nArgs:\n    competitor_id: ID of the competitor\n\nReturns:\n    List of Facebook ads with full details","operationId":"get_competitor_facebook_ads_api_competitor_tracking__competitor_id__facebook_ads_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/{competitor_id}/update-handles":{"post":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Update Competitor Handles","description":"Update competitor's social media handles using web search.\n\nArgs:\n    competitor_id: ID of the competitor\n\nReturns:\n    Update results with found handles","operationId":"update_competitor_handles_api_competitor_tracking__competitor_id__update_handles_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/bulk/archive":{"post":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Archive Competitors","operationId":"archive_competitors_api_competitor_tracking_bulk_archive_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkArchiveCompetitorsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Archive Competitors Api Competitor Tracking Bulk Archive Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/competitor-tracking/{competitor_id}/archive":{"post":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Archive Competitor","description":"Archive a competitor (soft delete) so it no longer participates in scans.","operationId":"archive_competitor_api_competitor_tracking__competitor_id__archive_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/{competitor_id}/restore":{"post":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Restore Competitor","description":"Restore an archived competitor back to active tracking.","operationId":"restore_competitor_api_competitor_tracking__competitor_id__restore_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/scan-all":{"post":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Scan All Competitors","description":"Scan all competitors for the company profile.\n\nReturns:\n    Summary of scan results","operationId":"scan_all_competitors_api_competitor_tracking_scan_all_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/competitor-tracking/{competitor_id}/ads":{"get":{"tags":["competitor-tracking","competitor-tracking"],"summary":"List Competitor Ads","description":"Paginated, filterable list of ads for a competitor, including matched product offerings.","operationId":"list_competitor_ads_api_competitor_tracking__competitor_id__ads_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},{"name":"ad_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Type"}},{"name":"active","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From"}},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To"}},{"name":"offering_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offering Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompetitorAdListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/{competitor_id}/matchups":{"get":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Get Competitor Matchups","description":"Return aggregated mapping of product offerings matched by this competitor's ads.","operationId":"get_competitor_matchups_api_competitor_tracking__competitor_id__matchups_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/{competitor_id}/social-posts":{"get":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Get Competitor Social Posts","description":"Get social media posts for a competitor.\n\nArgs:\n    competitor_id: ID of the competitor\n    platform: Filter by platform (instagram, facebook, twitter, linkedin)\n    days: Number of days to look back (default 30)\n\nReturns:\n    List of social media posts with engagement metrics","operationId":"get_competitor_social_posts_api_competitor_tracking__competitor_id__social_posts_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}},{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/start-tracking-all":{"post":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Start Tracking All Competitors","description":"Start tracking all competitors found in the company profile.\n\nThis endpoint:\n1. Reads the company profile and all product line profiles\n2. Extracts all direct competitors and market leaders\n3. Normalizes and deduplicates domains\n4. Sets up tracking for each competitor in parallel\n\nRequires X-Company-Profile-Id header or company_profile_id parameter.","operationId":"start_tracking_all_competitors_api_competitor_tracking_start_tracking_all_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/competitor-tracking/platform-summaries":{"get":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Get Latest Platform Summaries","operationId":"get_latest_platform_summaries_api_competitor_tracking_platform_summaries_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional platform filter: facebook_ads, google_ads, website","title":"Platform"},"description":"Optional platform filter: facebook_ads, google_ads, website"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/platform-summaries/history":{"get":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Get Platform Summary History","operationId":"get_platform_summary_history_api_competitor_tracking_platform_summaries_history_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"platform","in":"query","required":true,"schema":{"type":"string","description":"Platform: facebook_ads, google_ads, website","title":"Platform"},"description":"Platform: facebook_ads, google_ads, website"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":60,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/competitors/{competitor_id}/platform-summaries":{"get":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Get Latest Competitor Platform Summary","operationId":"get_latest_competitor_platform_summary_api_competitor_tracking_competitors__competitor_id__platform_summaries_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}},{"name":"platform","in":"query","required":true,"schema":{"type":"string","description":"Platform: google_ads, website","title":"Platform"},"description":"Platform: google_ads, website"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/competitors/{competitor_id}/platform-summaries/history":{"get":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Get Competitor Platform Summary History","operationId":"get_competitor_platform_summary_history_api_competitor_tracking_competitors__competitor_id__platform_summaries_history_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}},{"name":"platform","in":"query","required":true,"schema":{"type":"string","description":"Platform: google_ads, website","title":"Platform"},"description":"Platform: google_ads, website"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":60,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/{competitor_id}/campaign-opportunities":{"get":{"tags":["competitor-tracking","competitor-tracking"],"summary":"List Competitor Campaign Opportunities","description":"List active opportunities without mutating cache or generation state.","operationId":"list_competitor_campaign_opportunities_api_competitor_tracking__competitor_id__campaign_opportunities_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10,"minimum":1,"default":3,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompetitorCampaignOpportunityListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/{competitor_id}/campaign-opportunities/generate/job":{"post":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Start Competitor Campaign Opportunity Job","description":"Validate evidence ownership, then enqueue durable opportunity generation.","operationId":"start_competitor_campaign_opportunity_job_api_competitor_tracking__competitor_id__campaign_opportunities_generate_job_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompetitorCampaignOpportunityGenerateRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-tracking/{competitor_id}/campaign-opportunities/{opportunity_id}/prepare":{"post":{"tags":["competitor-tracking","competitor-tracking"],"summary":"Prepare Competitor Campaign Opportunity","description":"Return the exact stored campaign prefill; never invoke generation.","operationId":"prepare_competitor_campaign_opportunity_api_competitor_tracking__competitor_id__campaign_opportunities__opportunity_id__prepare_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}},{"name":"opportunity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Opportunity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompetitorCampaignOpportunityPrepareResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-ad-insights/{competitor_id}/analyze":{"post":{"tags":["competitor-ad-insights","competitor-ad-insights"],"summary":"Analyze Competitor Ads","description":"Perform bulk analysis of all competitor ads to generate insights.\nThis analyzes both text and display ads together.","operationId":"analyze_competitor_ads_api_competitor_ad_insights__competitor_id__analyze_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}},{"name":"days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of days to analyze","default":30,"title":"Days"},"description":"Number of days to analyze"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-ad-insights/{competitor_id}/latest":{"get":{"tags":["competitor-ad-insights","competitor-ad-insights"],"summary":"Get Latest Ad Insights","description":"Get the most recent ad insights for a competitor.","operationId":"get_latest_ad_insights_api_competitor_ad_insights__competitor_id__latest_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitor-ad-insights/{competitor_id}/history":{"get":{"tags":["competitor-ad-insights","competitor-ad-insights"],"summary":"Get Ad Insights History","description":"Get historical ad insights for a competitor.","operationId":"get_ad_insights_history_api_competitor_ad_insights__competitor_id__history_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"competitor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Competitor Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","description":"Number of historical insights to return","default":10,"title":"Limit"},"description":"Number of historical insights to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitive-gap-analysis/{company_profile_id}":{"get":{"tags":["competitive-gap-analysis","competitive_gap_analysis"],"summary":"Get Gap Analysis","description":"Get competitive gap analysis for a company profile.\n\nArgs:\n    company_profile_id: ID of the company profile\n    version: Optional specific version to retrieve\n    \nReturns:\n    Gap analysis data formatted for API response","operationId":"get_gap_analysis_api_competitive_gap_analysis__company_profile_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"version","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Specific version to retrieve","title":"Version"},"description":"Specific version to retrieve"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Gap Analysis Api Competitive Gap Analysis  Company Profile Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitive-gap-analysis/{company_profile_id}/dashboard-summary":{"get":{"tags":["competitive-gap-analysis","competitive_gap_analysis"],"summary":"Get Gap Analysis Dashboard","description":"Get comprehensive gap analysis data for marketing wizard dashboard.\nReturns ALL data properly formatted for visualization.","operationId":"get_gap_analysis_dashboard_api_competitive_gap_analysis__company_profile_id__dashboard_summary_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Gap Analysis Dashboard Api Competitive Gap Analysis  Company Profile Id  Dashboard Summary Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitive-gap-analysis/{company_profile_id}/versions":{"get":{"tags":["competitive-gap-analysis","competitive_gap_analysis"],"summary":"Get Analysis Versions","description":"Get all versions of gap analysis for a company profile.\n\nReturns:\n    List of analysis versions with summary data","operationId":"get_analysis_versions_api_competitive_gap_analysis__company_profile_id__versions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Analysis Versions Api Competitive Gap Analysis  Company Profile Id  Versions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitive-gap-analysis/{company_profile_id}/generate":{"post":{"tags":["competitive-gap-analysis","competitive_gap_analysis"],"summary":"Generate Gap Analysis","description":"Generate competitive gap analysis for a company profile.\n\nThis follows the same logic as the brand workflow generation.","operationId":"generate_gap_analysis_api_competitive_gap_analysis__company_profile_id__generate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Gap Analysis Api Competitive Gap Analysis  Company Profile Id  Generate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitive-gap-analysis/{company_profile_id}/regenerate":{"post":{"tags":["competitive-gap-analysis","competitive_gap_analysis"],"summary":"Regenerate Gap Analysis","description":"Regenerate competitive gap analysis for a company profile.\n\nThis will create a new version of the analysis.","operationId":"regenerate_gap_analysis_api_competitive_gap_analysis__company_profile_id__regenerate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Regenerate Gap Analysis Api Competitive Gap Analysis  Company Profile Id  Regenerate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitive-gap-analysis/{company_profile_id}/strategic-campaigns":{"get":{"tags":["competitive-gap-analysis","competitive_gap_analysis"],"summary":"Get Strategic Campaigns","description":"Get strategic campaign recommendations from the latest gap analysis.\nAutomatically generates fresh analysis daily to incorporate latest market trends.\n\n**DEPRECATED**: Use POST /generate-simple-campaigns for faster, goal-focused generation.\nThis endpoint does full competitive analysis which takes 15-20 seconds.","operationId":"get_strategic_campaigns_api_competitive_gap_analysis__company_profile_id__strategic_campaigns_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Force regeneration of analysis","default":false,"title":"Force Refresh"},"description":"Force regeneration of analysis"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Strategic Campaigns Api Competitive Gap Analysis  Company Profile Id  Strategic Campaigns Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitive-gap-analysis/{company_profile_id}/competitor-insights":{"get":{"tags":["competitive-gap-analysis","competitive_gap_analysis"],"summary":"Get Competitor Insights","description":"Get detailed competitor insights from ProductOfferingCompetitiveAnalysis.\n\nReturns company-wide competitive analysis.","operationId":"get_competitor_insights_api_competitive_gap_analysis__company_profile_id__competitor_insights_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Competitor Insights Api Competitive Gap Analysis  Company Profile Id  Competitor Insights Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/competitive-gap-analysis/{company_profile_id}/generate-simple-campaigns":{"post":{"tags":["competitive-gap-analysis","competitive_gap_analysis"],"summary":"Generate Simple Campaign Recommendations","description":"Simplified endpoint to generate 5-8 campaign recommendations based on:\n- Target audiences (from request body)\n- Customer goal (from request body)\n\nThis bypasses the full competitive analysis and focuses purely on campaign generation.\nResults are cached to avoid regenerating for identical parameters.\n\nRequest body should contain:\n{\n    \"target_audiences\": [...],\n    \"customer_goal\": \"string\",\n    \"additional_context\": \"string\" (optional),\n    \"force_refresh\": false (optional - bypasses cache)\n}","operationId":"generate_simple_campaign_recommendations_api_competitive_gap_analysis__company_profile_id__generate_simple_campaigns_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Request Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Simple Campaign Recommendations Api Competitive Gap Analysis  Company Profile Id  Generate Simple Campaigns Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-ideas/{company_profile_id}/brief":{"post":{"tags":["campaign-ideas","campaign-ideas"],"summary":"Upload Campaign Brief","description":"Attach a campaign brief the generation call will make the model read.\n\nThe upload to the model provider happens here, while the marketer is still\nin the builder, so an unreadable file is refused at attach time instead of\nsurfacing minutes later as a failed generation.\n\nWhat comes back is the attachment record's opaque id. The provider file id\nand the storage location stay on the server, so nothing the browser holds\ncan be edited into a claim on another workspace's document.","operationId":"upload_campaign_brief_api_campaign_ideas__company_profile_id__brief_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_campaign_brief_api_campaign_ideas__company_profile_id__brief_post"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Upload Campaign Brief Api Campaign Ideas  Company Profile Id  Brief Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-ideas/{company_profile_id}/brief/{brief_id}":{"delete":{"tags":["campaign-ideas","campaign-ideas"],"summary":"Remove Campaign Brief","description":"Remove an attached brief and retire both copies of the document.\n\nDeliberately not entitlement-gated: a marketer whose plan changed must\nstill be able to take their own confidential document back out of our\nstores. Tenant scope is the gate.","operationId":"remove_campaign_brief_api_campaign_ideas__company_profile_id__brief__brief_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"brief_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Brief Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Remove Campaign Brief Api Campaign Ideas  Company Profile Id  Brief  Brief Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-ideas/{company_profile_id}/simple":{"post":{"tags":["campaign-ideas","campaign-ideas"],"summary":"Generate Simple Campaigns","description":"Answer simple campaign generation from the cache (200), or start a job (202).\n\nA repeat request whose settings need no model is answered in place with the\nsame result shape the job would have produced. Anything else gets job\ntracking info and is generated in the worker.","operationId":"generate_simple_campaigns_api_campaign_ideas__company_profile_id__simple_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"product_offering_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Product offering ID","title":"Product Offering Id"},"description":"Product offering ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Request Body"}}}},"responses":{"202":{"description":"Generation started; poll or stream the job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"200":{"description":"The finished result, served from the ideas cache when nothing on the path needs a model. Same shape as the completed job's result."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-ideas/{company_profile_id}/save":{"post":{"tags":["campaign-ideas","campaign-ideas"],"summary":"Save Campaigns","description":"Persist edited campaign ideas for a company profile/product offering.\n\nSaves into the same cache table used for generation so future loads pick up\nthe edited content without re-running generation.","operationId":"save_campaigns_api_campaign_ideas__company_profile_id__save_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"product_offering_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Product offering ID","title":"Product Offering Id"},"description":"Product offering ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Request Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Save Campaigns Api Campaign Ideas  Company Profile Id  Save Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-campaign/from-intelligence/job":{"post":{"tags":["ai-campaign","ai-campaign"],"summary":"Start Ai Campaign From Intelligence Job","description":"Start an ai-campaign orchestration job from one normalized intelligence card.","operationId":"start_ai_campaign_from_intelligence_job_api_ai_campaign_from_intelligence_job_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AICampaignFromIntelligenceRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/ai-campaign/from-intelligence/offering-suggestion":{"post":{"tags":["ai-campaign","ai-campaign"],"summary":"Suggest Ai Campaign Offering From Intelligence","description":"Suggest the best product offering or main company target before full ai-campaign generation.","operationId":"suggest_ai_campaign_offering_from_intelligence_api_ai_campaign_from_intelligence_offering_suggestion_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AICampaignFromIntelligenceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AICampaignOfferingSuggestionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/product-offerings/audiences/save":{"post":{"tags":["product-offerings","product_offerings"],"summary":"Save Target Audiences","description":"Persist edited target audiences for the company or a specific product offering.\n\nKeeps the same cache key format used by the generation service so the detail view\ncan read the latest values without regeneration.","operationId":"save_target_audiences_api_product_offerings_audiences_save_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Payload"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/product-offerings/status":{"get":{"tags":["product-offerings","product_offerings"],"summary":"Get Product Offering Statuses","description":"Return minimal status for active product offerings for polling.\n\nIf `ids` are provided, only return statuses for those offerings; otherwise return all.","operationId":"get_product_offering_statuses_api_product_offerings_status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ids","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string","format":"uuid"}},{"type":"null"}],"title":"Ids"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Get Product Offering Statuses Api Product Offerings Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/{offering_id}/status":{"get":{"tags":["product-offerings","product_offerings"],"summary":"Get Single Product Offering Status","description":"Return minimal status for a single product offering, ensuring tenant isolation.","operationId":"get_single_product_offering_status_api_product_offerings__offering_id__status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Offering Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Single Product Offering Status Api Product Offerings  Offering Id  Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/company/details":{"get":{"tags":["product-offerings","product_offerings"],"summary":"Get Company Offering Details","description":"Company-wide view aligned with the product offering detail shape.","operationId":"get_company_offering_details_api_product_offerings_company_details_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Company Offering Details Api Product Offerings Company Details Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/product-offerings/{offering_id}/details":{"get":{"tags":["product-offerings","product_offerings"],"summary":"Get Product Offering Details","description":"Get a rich view of a single product offering, including strategy and intelligence.","operationId":"get_product_offering_details_api_product_offerings__offering_id__details_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Offering Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Product Offering Details Api Product Offerings  Offering Id  Details Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/company/refresh-reviews":{"get":{"tags":["product-offerings","product_offerings"],"summary":"List Product Refresh Reviews","operationId":"list_product_refresh_reviews_api_product_offerings_company_refresh_reviews_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Product Refresh Reviews Api Product Offerings Company Refresh Reviews Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/product-offerings/{product_offering_id}/refresh-history":{"get":{"tags":["product-offerings","product_offerings"],"summary":"Get Product Refresh History","operationId":"get_product_refresh_history_api_product_offerings__product_offering_id__refresh_history_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}},{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Before"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Product Refresh History Api Product Offerings  Product Offering Id  Refresh History Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/{product_offering_id}/refresh-review":{"get":{"tags":["product-offerings","product_offerings"],"summary":"Get Product Refresh Review","operationId":"get_product_refresh_review_api_product_offerings__product_offering_id__refresh_review_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Product Refresh Review Api Product Offerings  Product Offering Id  Refresh Review Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/{product_offering_id}/refresh-review/{review_id}/dismiss":{"post":{"tags":["product-offerings","product_offerings"],"summary":"Dismiss Product Refresh Review","operationId":"dismiss_product_refresh_review_api_product_offerings__product_offering_id__refresh_review__review_id__dismiss_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}},{"name":"review_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Review Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"},"title":"Response Dismiss Product Refresh Review Api Product Offerings  Product Offering Id  Refresh Review  Review Id  Dismiss Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/{product_offering_id}/refresh-preview":{"post":{"tags":["product-offerings","product_offerings"],"summary":"Preview Product Refresh","description":"Queue a product refresh preview job and return polling details.","operationId":"preview_product_refresh_api_product_offerings__product_offering_id__refresh_preview_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductRefreshPreviewRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/{product_offering_id}/refresh-apply":{"post":{"tags":["product-offerings","product_offerings"],"summary":"Apply Product Refresh Route","description":"Persist selected product refresh changes and source page preferences.","operationId":"apply_product_refresh_route_api_product_offerings__product_offering_id__refresh_apply_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductRefreshApplyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Apply Product Refresh Route Api Product Offerings  Product Offering Id  Refresh Apply Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/summary":{"get":{"tags":["product-offerings","product_offerings"],"summary":"Get Product Offerings Summary","description":"Get lightweight product offering data for list/grid pages.","operationId":"get_product_offerings_summary_api_product_offerings_summary_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","default":"active","title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Product Offerings Summary Api Product Offerings Summary Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/company-with-offerings":{"get":{"tags":["product-offerings","product_offerings"],"summary":"Get Company With Offerings","description":"Get company profile with all product offerings.","operationId":"get_company_with_offerings_api_product_offerings_company_with_offerings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Company With Offerings Api Product Offerings Company With Offerings Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/product-offerings/list":{"get":{"tags":["product-offerings","product_offerings"],"summary":"List Product Offerings","description":"Get product offerings for AI Product Lab dropdown.","operationId":"list_product_offerings_api_product_offerings_list_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response List Product Offerings Api Product Offerings List Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/product-offerings/ai-ready":{"get":{"tags":["product-offerings","product_offerings"],"summary":"Get Ai Ready Offerings","description":"Get offerings with enough data for AI generation.","operationId":"get_ai_ready_offerings_api_product_offerings_ai_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response Get Ai Ready Offerings Api Product Offerings Ai Ready Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/product-offerings/{offering_id}/ads":{"get":{"tags":["product-offerings","product_offerings"],"summary":"Get Product Offering Ads","description":"Get ad data for a single product offering without loading the full portfolio payload.","operationId":"get_product_offering_ads_api_product_offerings__offering_id__ads_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Offering Id"}},{"name":"competitor_limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":24,"title":"Competitor Limit"}},{"name":"competitor_offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Competitor Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Product Offering Ads Api Product Offerings  Offering Id  Ads Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/with-ads":{"get":{"tags":["product-offerings","product_offerings"],"summary":"Get Product Offerings With Ads","description":"Get all product offerings/SKUs for the company with competing ads count.","operationId":"get_product_offerings_with_ads_api_product_offerings_with_ads_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","default":"active","title":"Status"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/bulk/archive":{"post":{"tags":["product-offerings","product_offerings"],"summary":"Archive Product Offerings","operationId":"archive_product_offerings_api_product_offerings_bulk_archive_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkArchiveProductsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Archive Product Offerings Api Product Offerings Bulk Archive Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/product-offerings/{product_offering_id}/archive":{"post":{"tags":["product-offerings","product_offerings"],"summary":"Archive Product Offering","description":"Archive (soft delete) a product offering by toggling is_active to False.","operationId":"archive_product_offering_api_product_offerings__product_offering_id__archive_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Archive Product Offering Api Product Offerings  Product Offering Id  Archive Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/{product_offering_id}/restore":{"post":{"tags":["product-offerings","product_offerings"],"summary":"Restore Product Offering","description":"Restore a previously archived product offering by toggling is_active to True.","operationId":"restore_product_offering_api_product_offerings__product_offering_id__restore_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Restore Product Offering Api Product Offerings  Product Offering Id  Restore Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/{product_offering_id}/competitive-analysis":{"get":{"tags":["product-offerings","product_offerings"],"summary":"Get Product Competitive Analysis","description":"Get competitive analysis for a specific product offering.","operationId":"get_product_competitive_analysis_api_product_offerings__product_offering_id__competitive_analysis_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Product Competitive Analysis Api Product Offerings  Product Offering Id  Competitive Analysis Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/{product_offering_id}":{"get":{"tags":["product-offerings","product_offerings"],"summary":"Get Product Offering","description":"Get a specific product offering.","operationId":"get_product_offering_api_product_offerings__product_offering_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Product Offering Api Product Offerings  Product Offering Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["product-offerings","product_offerings"],"summary":"Update Product Offering","description":"Partially update a product offering owned by the active company profile.","operationId":"update_product_offering_api_product_offerings__product_offering_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductOfferingUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Product Offering Api Product Offerings  Product Offering Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/{product_offering_id}/current-price":{"patch":{"tags":["product-offerings","product_offerings"],"summary":"Update Product Offering Current Price","description":"Update only the current public price for a product offering.","operationId":"update_product_offering_current_price_api_product_offerings__product_offering_id__current_price_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductOfferingCurrentPriceUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Product Offering Current Price Api Product Offerings  Product Offering Id  Current Price Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/{product_offering_id}/images/upload":{"post":{"tags":["product-offerings","product_offerings"],"summary":"Upload Product Offering Images","description":"Upload product images directly onto an offering and mirror them into product-scoped gallery storage.","operationId":"upload_product_offering_images_api_product_offerings__product_offering_id__images_upload_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_product_offering_images_api_product_offerings__product_offering_id__images_upload_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductOfferingUploadImagesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/{product_offering_id}/images/delete":{"post":{"tags":["product-offerings","product_offerings"],"summary":"Delete Product Offering Image","description":"Delete a product image from product records and matching gallery assets.","operationId":"delete_product_offering_image_api_product_offerings__product_offering_id__images_delete_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductOfferingDeleteImageRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Product Offering Image Api Product Offerings  Product Offering Id  Images Delete Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/{product_offering_id}/rewrite-copy":{"post":{"tags":["product-offerings","product_offerings"],"summary":"Rewrite Product Offering Copy","description":"Rewrite product detail copy with AI and persist the result.","operationId":"rewrite_product_offering_copy_api_product_offerings__product_offering_id__rewrite_copy_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductOfferingRewriteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Rewrite Product Offering Copy Api Product Offerings  Product Offering Id  Rewrite Copy Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/{product_offering_id}/research":{"get":{"tags":["product_offerings"],"summary":"Get Product Research","operationId":"get_product_research_api_product_offerings__product_offering_id__research_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/{product_offering_id}/research/refresh":{"post":{"tags":["product_offerings"],"summary":"Refresh Product Research","operationId":"refresh_product_research_api_product_offerings__product_offering_id__research_refresh_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/{product_offering_id}/research/history":{"get":{"tags":["product_offerings"],"summary":"Get Product Research History","operationId":"get_product_research_history_api_product_offerings__product_offering_id__research_history_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}},{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Before"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResearchHistoryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/{product_offering_id}/research/settings":{"patch":{"tags":["product_offerings"],"summary":"Update Product Research Settings","operationId":"update_product_research_settings_api_product_offerings__product_offering_id__research_settings_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResearchSettingsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/research/settings":{"get":{"tags":["product_offerings"],"summary":"Get Brand Research Settings","operationId":"get_brand_research_settings_api_product_offerings_research_settings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandResearchSettings"}}}}},"security":[{"HTTPBearer":[]}]},"patch":{"tags":["product_offerings"],"summary":"Update Brand Research Settings","operationId":"update_brand_research_settings_api_product_offerings_research_settings_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandResearchSettingsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandResearchSettings"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/product-offerings/research/products":{"patch":{"tags":["product_offerings"],"summary":"Update Bulk Research Settings","operationId":"update_bulk_research_settings_api_product_offerings_research_products_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkResearchSettingsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandResearchSettings"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/product-offerings/{offering_id}/insights":{"get":{"tags":["product-insights"],"summary":"Get Product Insights","operationId":"get_product_insights_api_product_offerings__offering_id__insights_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Offering Id"}},{"name":"current_offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Current Offset"}},{"name":"history_offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"History Offset"}},{"name":"activity_offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Activity Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductInsightResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/{offering_id}/insights/seen":{"post":{"tags":["product-insights"],"summary":"Mark Product Insights Seen","operationId":"mark_product_insights_seen_api_product_offerings__offering_id__insights_seen_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Offering Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductInsightSeenRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"integer"},"title":"Response Mark Product Insights Seen Api Product Offerings  Offering Id  Insights Seen Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/{offering_id}/insights/{card_id}/history":{"get":{"tags":["product-insights"],"summary":"Get Product Insight Revisions","operationId":"get_product_insight_revisions_api_product_offerings__offering_id__insights__card_id__history_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Offering Id"}},{"name":"card_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Card Id"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","maximum":100000,"minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Product Insight Revisions Api Product Offerings  Offering Id  Insights  Card Id  History Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/product-offerings/content-edit/preview":{"post":{"tags":["profile-content-editor","profile-content-editor"],"summary":"Preview Profile Content Edits","description":"Generate a reviewed before/after proposal for selected profile content.","operationId":"preview_profile_content_edits_api_product_offerings_content_edit_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileContentEditPreviewRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileContentEditPreviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/product-offerings/content-edit/document-preview":{"post":{"tags":["profile-content-editor","profile-content-editor"],"summary":"Preview Profile Content Edits From Documents","description":"Generate a reviewed edit proposal from uploaded Knowledge Base documents.","operationId":"preview_profile_content_edits_from_documents_api_product_offerings_content_edit_document_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileContentEditDocumentPreviewRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileContentEditPreviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/product-offerings/content-edit/apply":{"post":{"tags":["profile-content-editor","profile-content-editor"],"summary":"Apply Profile Content Edit Route","description":"Apply selected changes from a reviewed profile content edit preview.","operationId":"apply_profile_content_edit_route_api_product_offerings_content_edit_apply_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileContentEditApplyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfileContentEditApplyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/ai-testing/ads":{"get":{"tags":["ai-testing"],"summary":"List Ai Testing Ads","description":"Return launchable ads across every platform supported by AI Testing.","operationId":"list_ai_testing_ads_api_ai_testing_ads_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/ai-testing/personas":{"get":{"tags":["ai-testing"],"summary":"Get Ai Personas","description":"Get all AI personas for the current company profile.","operationId":"get_ai_personas_api_ai_testing_personas_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AIPersonaResponse"},"type":"array","title":"Response Get Ai Personas Api Ai Testing Personas Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["ai-testing"],"summary":"Create Ai Persona","description":"Create a new AI persona for testing.","operationId":"create_ai_persona_api_ai_testing_personas_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIPersonaCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AIPersonaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/ai-testing/personas/generate":{"post":{"tags":["ai-testing"],"summary":"Generate Ai Personas","description":"Generate AI personas for the appropriate company profile based on ad context.","operationId":"generate_ai_personas_api_ai_testing_personas_generate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ad_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"}},{"name":"ad_platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Platform"}},{"name":"personas_per_group","in":"query","required":false,"schema":{"type":"integer","maximum":100,"description":"Number of personas per target group","default":30,"title":"Personas Per Group"},"description":"Number of personas per target group"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/routes__ai_testing__GeneratePersonasRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-testing/personas/by-company":{"get":{"tags":["ai-testing"],"summary":"Get Personas By Company","description":"Get AI personas for the user's company, optionally filtered by target audience group.","operationId":"get_personas_by_company_api_ai_testing_personas_by_company_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"target_audience_group","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Audience Group"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AIPersonaResponse"},"title":"Response Get Personas By Company Api Ai Testing Personas By Company Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-testing/personas/groups-with-count":{"get":{"tags":["ai-testing"],"summary":"Get Persona Groups With Count","description":"Get all target audience groups with persona counts for the user's company.","operationId":"get_persona_groups_with_count_api_ai_testing_personas_groups_with_count_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response Get Persona Groups With Count Api Ai Testing Personas Groups With Count Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/ai-testing/test":{"post":{"tags":["ai-testing"],"summary":"Start Ai Test","description":"Start an AI customer test for an ad using real personas and market intelligence.","operationId":"start_ai_test_api_ai_testing_test_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AITestRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AITestSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/ai-testing/test/{session_id}":{"get":{"tags":["ai-testing"],"summary":"Get Test Session","description":"Get a specific test session by ID with paginated test results.","operationId":"get_test_session_api_ai_testing_test__session_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AITestSessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-testing/test/{session_id}/results":{"get":{"tags":["ai-testing"],"summary":"Get Test Results","description":"Get paginated test results for a specific session.","operationId":"get_test_results_api_ai_testing_test__session_id__results_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":25,"minimum":1,"default":5,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-testing/test/ad/{ad_id}":{"get":{"tags":["ai-testing"],"summary":"Get Ad Test Sessions","description":"Get all test sessions for a specific ad.","operationId":"get_ad_test_sessions_api_ai_testing_test_ad__ad_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ad_id","in":"path","required":true,"schema":{"type":"string","title":"Ad Id"}},{"name":"ad_platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Platform"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-testing/test/{session_id}/heatmaps":{"get":{"tags":["ai-testing"],"summary":"Get Test Heatmaps","description":"Get detailed heatmap data for a test session.","operationId":"get_test_heatmaps_api_ai_testing_test__session_id__heatmaps_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-testing/persona-sets":{"get":{"tags":["ai-testing"],"summary":"Get Persona Sets","description":"Get all persona sets for the organization's company profiles.","operationId":"get_persona_sets_api_ai_testing_persona_sets_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PersonaSetResponse"},"title":"Response Get Persona Sets Api Ai Testing Persona Sets Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["ai-testing"],"summary":"Create Persona Set","description":"Create a new persona set.","operationId":"create_persona_set_api_ai_testing_persona_sets_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonaSetCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonaSetResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-testing/persona-sets/{set_id}":{"get":{"tags":["ai-testing"],"summary":"Get Persona Set","description":"Get a specific persona set.","operationId":"get_persona_set_api_ai_testing_persona_sets__set_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"set_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Set Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonaSetResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["ai-testing"],"summary":"Update Persona Set","description":"Update a persona set.","operationId":"update_persona_set_api_ai_testing_persona_sets__set_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"set_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Set Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonaSetUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonaSetResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ai-testing"],"summary":"Delete Persona Set","description":"Delete a persona set and all its personas.","operationId":"delete_persona_set_api_ai_testing_persona_sets__set_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"set_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Set Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-testing/persona-sets/{set_id}/personas":{"get":{"tags":["ai-testing"],"summary":"Get Persona Set Personas","description":"Get all personas in a specific persona set.","operationId":"get_persona_set_personas_api_ai_testing_persona_sets__set_id__personas_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"set_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Set Id"}},{"name":"target_audience_group","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Audience Group"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AIPersonaResponse"},"title":"Response Get Persona Set Personas Api Ai Testing Persona Sets  Set Id  Personas Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-testing/persona-sets/{set_id}/generate":{"post":{"tags":["ai-testing"],"summary":"Generate Personas For Set","description":"Generate personas for a specific persona set.","operationId":"generate_personas_for_set_api_ai_testing_persona_sets__set_id__generate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"set_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Set Id"}},{"name":"personas_per_group","in":"query","required":false,"schema":{"type":"integer","maximum":100,"description":"Number of personas per target group","default":30,"title":"Personas Per Group"},"description":"Number of personas per target group"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-testing/test/ad/{ad_id}/latest":{"get":{"tags":["ai-testing"],"summary":"Get Latest Test Result","description":"Get the latest test result for an ad (for caching on ad card).","operationId":"get_latest_test_result_api_ai_testing_test_ad__ad_id__latest_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ad_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/intelligence":{"get":{"tags":["market-intelligence"],"summary":"Get Market Intelligence","description":"Get market intelligence data with filters.","operationId":"get_market_intelligence_api_market_intelligence_intelligence_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"intelligence_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by type: trend, competitor, opportunity, threat","title":"Intelligence Type"},"description":"Filter by type: trend, competitor, opportunity, threat"},{"name":"impact_level","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by impact level: low, medium, high, critical","title":"Impact Level"},"description":"Filter by impact level: low, medium, high, critical"},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"product_offering_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter by product offering ID (None = company-wide)","title":"Product Offering Id"},"description":"Filter by product offering ID (None = company-wide)"},{"name":"days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of days to look back","default":30,"title":"Days"},"description":"Number of days to look back"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Start date for filtering (YYYY-MM-DD)","title":"Start Date"},"description":"Start date for filtering (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"End date for filtering (YYYY-MM-DD)","title":"End Date"},"description":"End date for filtering (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MarketIntelligenceResponse"},"title":"Response Get Market Intelligence Api Market Intelligence Intelligence Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/intelligence/report-dates":{"get":{"tags":["market-intelligence"],"summary":"Get Intelligence Report Dates","description":"Get distinct dates when intelligence reports were generated.","operationId":"get_intelligence_report_dates_api_market_intelligence_intelligence_report_dates_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Product offering ID (None = company-wide)","title":"Product Offering Id"},"description":"Product offering ID (None = company-wide)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/google-trends":{"get":{"tags":["market-intelligence"],"summary":"Get Google Trends Analysis","description":"Fetch Google Trends analysis rows for the active company profile within the requested window.","operationId":"get_google_trends_analysis_api_market_intelligence_google_trends_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of days to look back (ignored when start_date is supplied)","default":14,"title":"Days"},"description":"Number of days to look back (ignored when start_date is supplied)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional start date (YYYY-MM-DD or ISO8601)","title":"Start Date"},"description":"Optional start date (YYYY-MM-DD or ISO8601)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional end date (YYYY-MM-DD or ISO8601)","title":"End Date"},"description":"Optional end date (YYYY-MM-DD or ISO8601)"},{"name":"include_details","in":"query","required":false,"schema":{"type":"boolean","description":"Return detailed fields (analysis, notable changes, recommendations, news)","default":true,"title":"Include Details"},"description":"Return detailed fields (analysis, notable changes, recommendations, news)"},{"name":"include_meta","in":"query","required":false,"schema":{"type":"boolean","description":"Include preview metadata for tier-limited responses","default":false,"title":"Include Meta"},"description":"Include preview metadata for tier-limited responses"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/google-news/thumbnail":{"get":{"tags":["market-intelligence"],"summary":"Proxy Google News Thumbnail","description":"Proxy Google News thumbnail images to avoid CORS issues in the browser.","operationId":"proxy_google_news_thumbnail_api_market_intelligence_google_news_thumbnail_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","description":"Direct URL to the news thumbnail image","title":"Url"},"description":"Direct URL to the news thumbnail image"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/tiktok-video/thumbnail":{"get":{"tags":["market-intelligence"],"summary":"Proxy Tiktok Video Thumbnail","description":"Resolve a TikTok video URL to an oEmbed thumbnail and proxy the image to avoid browser CORS failures.","operationId":"proxy_tiktok_video_thumbnail_api_market_intelligence_tiktok_video_thumbnail_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string","description":"TikTok video URL used to resolve the oEmbed thumbnail","title":"Url"},"description":"TikTok video URL used to resolve the oEmbed thumbnail"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/trends-bundle":{"get":{"tags":["market-intelligence"],"summary":"Get Trends Bundle","description":"Fetch the Trends page data in a single cached backend request.","operationId":"get_trends_bundle_api_market_intelligence_trends_bundle_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of days to look back (ignored when start_date is supplied)","default":14,"title":"Days"},"description":"Number of days to look back (ignored when start_date is supplied)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional start date (YYYY-MM-DD or ISO8601)","title":"Start Date"},"description":"Optional start date (YYYY-MM-DD or ISO8601)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional end date (YYYY-MM-DD or ISO8601)","title":"End Date"},"description":"Optional end date (YYYY-MM-DD or ISO8601)"},{"name":"include_details","in":"query","required":false,"schema":{"type":"boolean","description":"Return detailed trend fields for each platform","default":true,"title":"Include Details"},"description":"Return detailed trend fields for each platform"},{"name":"include_meta","in":"query","required":false,"schema":{"type":"boolean","description":"Include preview metadata for tier-limited responses","default":false,"title":"Include Meta"},"description":"Include preview metadata for tier-limited responses"},{"name":"include_social_mentions","in":"query","required":false,"schema":{"type":"boolean","description":"Include the legacy social-mentions section in the aggregate response","default":true,"title":"Include Social Mentions"},"description":"Include the legacy social-mentions section in the aggregate response"},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Bypass the shared response cache","default":false,"title":"Force Refresh"},"description":"Bypass the shared response cache"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/yelp-trends":{"get":{"tags":["market-intelligence"],"summary":"Get Yelp Trends Analysis","description":"Fetch Yelp trends analysis rows for the active company profile within the requested window.","operationId":"get_yelp_trends_analysis_api_market_intelligence_yelp_trends_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of days to look back (ignored when start_date is supplied)","default":14,"title":"Days"},"description":"Number of days to look back (ignored when start_date is supplied)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional start date (YYYY-MM-DD or ISO8601)","title":"Start Date"},"description":"Optional start date (YYYY-MM-DD or ISO8601)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional end date (YYYY-MM-DD or ISO8601)","title":"End Date"},"description":"Optional end date (YYYY-MM-DD or ISO8601)"},{"name":"include_details","in":"query","required":false,"schema":{"type":"boolean","description":"Return detailed fields (analysis, notable changes, recommendations, search results)","default":true,"title":"Include Details"},"description":"Return detailed fields (analysis, notable changes, recommendations, search results)"},{"name":"include_meta","in":"query","required":false,"schema":{"type":"boolean","description":"Include preview metadata for tier-limited responses","default":false,"title":"Include Meta"},"description":"Include preview metadata for tier-limited responses"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/amazon-trends":{"get":{"tags":["market-intelligence"],"summary":"Get Amazon Trends Analysis","description":"Fetch Amazon trends analysis rows for the active company profile within the requested window.","operationId":"get_amazon_trends_analysis_api_market_intelligence_amazon_trends_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of days to look back (ignored when start_date is supplied)","default":14,"title":"Days"},"description":"Number of days to look back (ignored when start_date is supplied)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional start date (YYYY-MM-DD or ISO8601)","title":"Start Date"},"description":"Optional start date (YYYY-MM-DD or ISO8601)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional end date (YYYY-MM-DD or ISO8601)","title":"End Date"},"description":"Optional end date (YYYY-MM-DD or ISO8601)"},{"name":"include_details","in":"query","required":false,"schema":{"type":"boolean","description":"Return detailed fields (analysis, notable changes, recommendations, best sellers)","default":true,"title":"Include Details"},"description":"Return detailed fields (analysis, notable changes, recommendations, best sellers)"},{"name":"include_meta","in":"query","required":false,"schema":{"type":"boolean","description":"Include preview metadata for tier-limited responses","default":false,"title":"Include Meta"},"description":"Include preview metadata for tier-limited responses"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/youtube-trends":{"get":{"tags":["market-intelligence"],"summary":"Get Youtube Trends Analysis","description":"Fetch YouTube trends analysis rows for the active company profile within the requested window.","operationId":"get_youtube_trends_analysis_api_market_intelligence_youtube_trends_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of days to look back (ignored when start_date is supplied)","default":14,"title":"Days"},"description":"Number of days to look back (ignored when start_date is supplied)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional start date (YYYY-MM-DD or ISO8601)","title":"Start Date"},"description":"Optional start date (YYYY-MM-DD or ISO8601)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional end date (YYYY-MM-DD or ISO8601)","title":"End Date"},"description":"Optional end date (YYYY-MM-DD or ISO8601)"},{"name":"include_details","in":"query","required":false,"schema":{"type":"boolean","description":"Return detailed fields (analysis, notable changes, recommendations, videos)","default":true,"title":"Include Details"},"description":"Return detailed fields (analysis, notable changes, recommendations, videos)"},{"name":"include_meta","in":"query","required":false,"schema":{"type":"boolean","description":"Include preview metadata for tier-limited responses","default":false,"title":"Include Meta"},"description":"Include preview metadata for tier-limited responses"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/ads-winners":{"get":{"tags":["market-intelligence"],"summary":"Get Ads Winners","description":"Fetch TikTok top ads selected by company matching results.","operationId":"get_ads_winners_api_market_intelligence_ads_winners_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"search_mode","in":"query","required":false,"schema":{"enum":["general","precise"],"type":"string","description":"general uses candidate_video_ids; precise uses related_tiktok_topads","default":"general","title":"Search Mode"},"description":"general uses candidate_video_ids; precise uses related_tiktok_topads"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdsWinnerResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/competitive-intelligence":{"get":{"tags":["market-intelligence"],"summary":"Get Competitive Intelligence","description":"Fetch business intelligence snapshots for the active company profile.","operationId":"get_competitive_intelligence_api_market_intelligence_competitive_intelligence_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of days to look back","default":90,"title":"Days"},"description":"Number of days to look back"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Start date for filtering (YYYY-MM-DD)","title":"Start Date"},"description":"Start date for filtering (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"End date for filtering (YYYY-MM-DD)","title":"End Date"},"description":"End date for filtering (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CompetitiveIntelligenceRecord"},"title":"Response Get Competitive Intelligence Api Market Intelligence Competitive Intelligence Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/tiktok-trends":{"get":{"tags":["market-intelligence"],"summary":"Get Tiktok Trends Analysis","description":"Fetch TikTok trends analysis rows for the active company profile within the requested window.","operationId":"get_tiktok_trends_analysis_api_market_intelligence_tiktok_trends_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of days to look back (ignored when start_date is supplied)","default":14,"title":"Days"},"description":"Number of days to look back (ignored when start_date is supplied)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional start date (YYYY-MM-DD or ISO8601)","title":"Start Date"},"description":"Optional start date (YYYY-MM-DD or ISO8601)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional end date (YYYY-MM-DD or ISO8601)","title":"End Date"},"description":"Optional end date (YYYY-MM-DD or ISO8601)"},{"name":"include_details","in":"query","required":false,"schema":{"type":"boolean","description":"Return detailed fields (analysis, notable changes, recommendations, videos)","default":true,"title":"Include Details"},"description":"Return detailed fields (analysis, notable changes, recommendations, videos)"},{"name":"include_meta","in":"query","required":false,"schema":{"type":"boolean","description":"Include preview metadata for tier-limited responses","default":false,"title":"Include Meta"},"description":"Include preview metadata for tier-limited responses"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/instagram-trends":{"get":{"tags":["market-intelligence"],"summary":"Get Instagram Trends Analysis","description":"Fetch Instagram trends analysis rows for the active company profile within the requested window.","operationId":"get_instagram_trends_analysis_api_market_intelligence_instagram_trends_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Number of days to look back (ignored when start_date is supplied)","default":14,"title":"Days"},"description":"Number of days to look back (ignored when start_date is supplied)"},{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional start date (YYYY-MM-DD or ISO8601)","title":"Start Date"},"description":"Optional start date (YYYY-MM-DD or ISO8601)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional end date (YYYY-MM-DD or ISO8601)","title":"End Date"},"description":"Optional end date (YYYY-MM-DD or ISO8601)"},{"name":"include_details","in":"query","required":false,"schema":{"type":"boolean","description":"Return detailed fields (analysis, notable changes, recommendations, posts)","default":true,"title":"Include Details"},"description":"Return detailed fields (analysis, notable changes, recommendations, posts)"},{"name":"include_meta","in":"query","required":false,"schema":{"type":"boolean","description":"Include preview metadata for tier-limited responses","default":false,"title":"Include Meta"},"description":"Include preview metadata for tier-limited responses"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/trend-suppressions":{"put":{"tags":["market-intelligence"],"summary":"Upsert Trend Suppression","operationId":"upsert_trend_suppression_api_market_intelligence_trend_suppressions_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendSuppressionUpsertRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrendSuppressionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/market-intelligence/social-listening-mentions":{"get":{"tags":["market-intelligence"],"summary":"Get Social Listening Mentions","description":"Fetch recent social listening mentions ordered by created_datetime.\nOptionally filter to a specific competitor.","operationId":"get_social_listening_mentions_api_market_intelligence_social_listening_mentions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":365,"minimum":1},{"type":"null"}],"description":"Number of days to look back","title":"Days"},"description":"Number of days to look back"},{"name":"include_meta","in":"query","required":false,"schema":{"type":"boolean","description":"Include preview metadata for tier-limited responses","default":false,"title":"Include Meta"},"description":"Include preview metadata for tier-limited responses"},{"name":"canonical","in":"query","required":false,"schema":{"type":"boolean","description":"Return canonical whole-market conversations","default":false,"title":"Canonical"},"description":"Return canonical whole-market conversations"},{"name":"competitor_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter by competitor ID","title":"Competitor Id"},"description":"Filter by competitor ID"},{"name":"scope","in":"query","required":false,"schema":{"enum":["all","brands","brand","competitors","products"],"type":"string","description":"Filter by tracked target scope","default":"all","title":"Scope"},"description":"Filter by tracked target scope"},{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":2,"maxLength":100},{"type":"null"}],"title":"Query"}},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Source"}},{"name":"target_type","in":"query","required":false,"schema":{"anyOf":[{"enum":["company","competitor","product_offering"],"type":"string"},{"type":"null"}],"title":"Target Type"}},{"name":"target_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Id"}},{"name":"sentiment","in":"query","required":false,"schema":{"anyOf":[{"enum":["positive","neutral","negative","mixed"],"type":"string"},{"type":"null"}],"title":"Sentiment"}},{"name":"risk","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Risk"}},{"name":"buying_interest","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Buying Interest"}},{"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":"theme_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":80},{"type":"null"}],"title":"Theme Key"}},{"name":"summary_days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Summary Days"}},{"name":"sort","in":"query","required":false,"schema":{"enum":["recent","engagement","target_relevance"],"type":"string","default":"recent","title":"Sort"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/social-listening-dashboard":{"get":{"tags":["market-intelligence"],"summary":"Get Social Listening Dashboard","description":"Fetch the v2 social listening command-center payload for the active company.","operationId":"get_social_listening_dashboard_api_market_intelligence_social_listening_dashboard_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","description":"Company profile ID","title":"Company Profile Id"},"description":"Company profile ID"},{"name":"days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":365,"minimum":1},{"type":"null"}],"description":"Optional dashboard lookback override","title":"Days"},"description":"Optional dashboard lookback override"},{"name":"scope","in":"query","required":false,"schema":{"enum":["all","brands","brand","competitors","products"],"type":"string","description":"Filter by tracked target scope","default":"all","title":"Scope"},"description":"Filter by tracked target scope"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/social-listening-summary":{"get":{"tags":["market-intelligence"],"summary":"Get Social Listening Summary","description":"Fetch the latest pipeline-generated social-listening summary for the company profile.\nThe v2 ingestion job owns summary generation; this route does not run a one-off AI summary.","operationId":"get_social_listening_summary_api_market_intelligence_social_listening_summary_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","description":"Company profile ID","title":"Company Profile Id"},"description":"Company profile ID"},{"name":"days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Optional summary display window (7 or 30)","title":"Days"},"description":"Optional summary display window (7 or 30)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialListeningSummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/social-listening-settings":{"get":{"tags":["market-intelligence"],"summary":"Get Social Listening Settings","description":"Fetch company-level social listening scan settings.","operationId":"get_social_listening_settings_api_market_intelligence_social_listening_settings_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","description":"Company profile ID","title":"Company Profile Id"},"description":"Company profile ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialListeningSettingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["market-intelligence"],"summary":"Update Social Listening Settings","description":"Update company-level social listening scan settings.","operationId":"update_social_listening_settings_api_market_intelligence_social_listening_settings_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","description":"Company profile ID","title":"Company Profile Id"},"description":"Company profile ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialListeningSettingsUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialListeningSettingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/social-prospecting":{"get":{"tags":["market-intelligence"],"summary":"Get Social Prospecting","description":"Fetch the Social Prospecting Analyst inbox for the active company profile.","operationId":"get_social_prospecting_api_market_intelligence_social_prospecting_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","description":"Company profile ID","title":"Company Profile Id"},"description":"Company profile ID"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Prospect candidates per page","default":15,"title":"Limit"},"description":"Prospect candidates per page"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Zero-based candidate offset","default":0,"title":"Offset"},"description":"Zero-based candidate offset"},{"name":"generated","in":"query","required":false,"schema":{"type":"string","description":"Generated-date filter","default":"last_7_days","title":"Generated"},"description":"Generated-date filter"},{"name":"platform","in":"query","required":false,"schema":{"type":"string","description":"Platform filter","default":"all","title":"Platform"},"description":"Platform filter"},{"name":"lead_type","in":"query","required":false,"schema":{"type":"string","description":"Lead type filter","default":"all","title":"Lead Type"},"description":"Lead type filter"},{"name":"next_step","in":"query","required":false,"schema":{"type":"string","description":"Next-step filter","default":"active","title":"Next Step"},"description":"Next-step filter"},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"description":"Search text","title":"Search"},"description":"Search text"},{"name":"sort_key","in":"query","required":false,"schema":{"type":"string","description":"Sort key","default":"score","title":"Sort Key"},"description":"Sort key"},{"name":"sort_direction","in":"query","required":false,"schema":{"type":"string","description":"Sort direction","default":"desc","title":"Sort Direction"},"description":"Sort direction"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialProspectingResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/social-prospecting/export":{"get":{"tags":["market-intelligence"],"summary":"Export Social Prospecting","description":"Return every prospect matching the active inbox query for CSV export.","operationId":"export_social_prospecting_api_market_intelligence_social_prospecting_export_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","description":"Company profile ID","title":"Company Profile Id"},"description":"Company profile ID"},{"name":"generated","in":"query","required":false,"schema":{"type":"string","description":"Generated-date filter","default":"last_7_days","title":"Generated"},"description":"Generated-date filter"},{"name":"platform","in":"query","required":false,"schema":{"type":"string","description":"Platform filter","default":"all","title":"Platform"},"description":"Platform filter"},{"name":"lead_type","in":"query","required":false,"schema":{"type":"string","description":"Lead type filter","default":"all","title":"Lead Type"},"description":"Lead type filter"},{"name":"next_step","in":"query","required":false,"schema":{"type":"string","description":"Next-step filter","default":"active","title":"Next Step"},"description":"Next-step filter"},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"description":"Search text","title":"Search"},"description":"Search text"},{"name":"sort_key","in":"query","required":false,"schema":{"type":"string","description":"Sort key","default":"score","title":"Sort Key"},"description":"Sort key"},{"name":"sort_direction","in":"query","required":false,"schema":{"type":"string","description":"Sort direction","default":"desc","title":"Sort Direction"},"description":"Sort direction"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialProspectingExportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/social-prospecting-settings":{"get":{"tags":["market-intelligence"],"summary":"Get Social Prospecting Settings","description":"Fetch Social Prospecting Analyst settings and plan access metadata.","operationId":"get_social_prospecting_settings_api_market_intelligence_social_prospecting_settings_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","description":"Company profile ID","title":"Company Profile Id"},"description":"Company profile ID"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["market-intelligence"],"summary":"Update Social Prospecting Settings","description":"Update Social Prospecting Analyst settings. Manual reruns are not exposed in V0.","operationId":"update_social_prospecting_settings_api_market_intelligence_social_prospecting_settings_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","description":"Company profile ID","title":"Company Profile Id"},"description":"Company profile ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialProspectingSettingsUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/social-prospecting-candidates/{candidate_id}":{"patch":{"tags":["market-intelligence"],"summary":"Update Social Prospecting Candidate Status","description":"Update prospect inbox status. This is review workflow only; it does not send messages.","operationId":"update_social_prospecting_candidate_status_api_market_intelligence_social_prospecting_candidates__candidate_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"candidate_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Candidate Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","description":"Company profile ID","title":"Company Profile Id"},"description":"Company profile ID"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialProspectingCandidateStatusUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/intelligence/generate":{"post":{"tags":["market-intelligence"],"summary":"Generate Market Intelligence","description":"Start asynchronous market intelligence generation so clients can poll or stream progress.","operationId":"generate_market_intelligence_api_market_intelligence_intelligence_generate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Product offering ID (None = company-wide intelligence)","title":"Product Offering Id"},"description":"Product offering ID (None = company-wide intelligence)"},{"name":"include_evolution","in":"query","required":false,"schema":{"type":"boolean","description":"Run evolution analysis after generation","default":true,"title":"Include Evolution"},"description":"Run evolution analysis after generation"}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/intelligence/{intelligence_id}":{"get":{"tags":["market-intelligence"],"summary":"Get Intelligence Item","description":"Get a specific market intelligence item.","operationId":"get_intelligence_item_api_market_intelligence_intelligence__intelligence_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"intelligence_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Intelligence Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketIntelligenceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["market-intelligence"],"summary":"Update Intelligence Item","description":"Update a market intelligence item (mark as inactive, update expiry, etc.).","operationId":"update_intelligence_item_api_market_intelligence_intelligence__intelligence_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"intelligence_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Intelligence Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketIntelligenceUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketIntelligenceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/intelligence/refresh":{"post":{"tags":["market-intelligence"],"summary":"Refresh Market Intelligence","description":"Refresh market intelligence data via the async job system.","operationId":"refresh_market_intelligence_api_market_intelligence_intelligence_refresh_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"force","in":"query","required":false,"schema":{"type":"boolean","description":"Force refresh even if recent data exists","default":false,"title":"Force"},"description":"Force refresh even if recent data exists"},{"name":"include_evolution","in":"query","required":false,"schema":{"type":"boolean","description":"Run evolution analysis after generation","default":true,"title":"Include Evolution"},"description":"Run evolution analysis after generation"}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/intelligence/evolution/analyze":{"post":{"tags":["market-intelligence"],"summary":"Analyze Market Evolution","description":"Analyze market trend evolution.\nSame endpoint for initial analysis and refresh.\n\nArgs:\n    product_offering_id: Optional product offering to analyze\n    force_refresh: Force re-analysis even if recent evolution exists","operationId":"analyze_market_evolution_api_market_intelligence_intelligence_evolution_analyze_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id"}},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Force Refresh"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/market-intelligence/intelligence/evolution/history":{"get":{"tags":["market-intelligence"],"summary":"Get Evolution History","description":"Get historical evolution data with snapshots.","operationId":"get_evolution_history_api_market_intelligence_intelligence_evolution_history_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":90,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/first-party-data/profile":{"post":{"tags":["first-party-data"],"summary":"Profile First Party Data File","description":"Profile headers/sample rows and return a confirmable mapping proposal.","operationId":"profile_first_party_data_file_api_first_party_data_profile_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_profile_first_party_data_file_api_first_party_data_profile_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Profile First Party Data File Api First Party Data Profile Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/first-party-data/uploads":{"get":{"tags":["first-party-data"],"summary":"List First Party Data Uploads","operationId":"list_first_party_data_uploads_api_first_party_data_uploads_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List First Party Data Uploads Api First Party Data Uploads Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["first-party-data"],"summary":"Create First Party Data Upload","description":"Persist an analyzed upload snapshot after the user confirms mapping.","operationId":"create_first_party_data_upload_api_first_party_data_uploads_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_create_first_party_data_upload_api_first_party_data_uploads_post"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create First Party Data Upload Api First Party Data Uploads Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/first-party-data/uploads/async":{"post":{"tags":["first-party-data"],"summary":"Create First Party Data Upload Async Job","description":"Persist the parsed workspace immediately and finish AI enrichment in the background.","operationId":"create_first_party_data_upload_async_job_api_first_party_data_uploads_async_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_create_first_party_data_upload_async_job_api_first_party_data_uploads_async_post"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create First Party Data Upload Async Job Api First Party Data Uploads Async Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/first-party-data/channel-trends":{"get":{"tags":["first-party-data"],"summary":"Get First Party Channel Trends","description":"One channel's true-week trend, merged across its same-feed reports.\n\nAn unknown label is an empty payload, not a 404 - the frontend gates\nrendering on the series, and a channel with nothing analyzed yet is a\nnormal state, not an error.","operationId":"get_first_party_channel_trends_api_first_party_data_channel_trends_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"retailer_label","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":240,"title":"Retailer Label"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get First Party Channel Trends Api First Party Data Channel Trends Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/first-party-data/uploads/{upload_id}":{"delete":{"tags":["first-party-data"],"summary":"Delete First Party Data Upload","operationId":"delete_first_party_data_upload_api_first_party_data_uploads__upload_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete First Party Data Upload Api First Party Data Uploads  Upload Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["first-party-data"],"summary":"Get First Party Data Upload","operationId":"get_first_party_data_upload_api_first_party_data_uploads__upload_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Id"}},{"name":"view","in":"query","required":false,"schema":{"type":"string","default":"full","title":"View"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get First Party Data Upload Api First Party Data Uploads  Upload Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/first-party-data/uploads/{upload_id}/coverage-policy":{"put":{"tags":["first-party-data"],"summary":"Update First Party Coverage Policy","description":"Persist retailer coverage thresholds and recompute WOS alert states.","operationId":"update_first_party_coverage_policy_api_first_party_data_uploads__upload_id__coverage_policy_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Upload Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirstPartyCoveragePolicyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update First Party Coverage Policy Api First Party Data Uploads  Upload Id  Coverage Policy Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/first-party-data/uploads/{upload_id}/buyer-target":{"put":{"tags":["first-party-data"],"summary":"Update First Party Buyer Target","description":"Persist the velocity the retail buyer expects, with where it came from.\n\nSend `unit_per_store_per_week: null` to clear it. `source` is required\nwhenever a value is sent; see the note on the request model.","operationId":"update_first_party_buyer_target_api_first_party_data_uploads__upload_id__buyer_target_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Upload Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirstPartyBuyerTargetRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update First Party Buyer Target Api First Party Data Uploads  Upload Id  Buyer Target Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/first-party-data/uploads/{upload_id}/retailer":{"put":{"tags":["first-party-data"],"summary":"Update First Party Retailer Label","description":"File this workspace under a sales channel, overriding any detected label.\n\nA user-set label outranks filename detection and import inheritance; the\ndialog that sends it warns that the assertion propagates into campaign copy\nand lineage comparisons.","operationId":"update_first_party_retailer_label_api_first_party_data_uploads__upload_id__retailer_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Upload Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirstPartyRetailerLabelRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update First Party Retailer Label Api First Party Data Uploads  Upload Id  Retailer Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/first-party-data/uploads/{upload_id}/experiment-package":{"post":{"tags":["first-party-data"],"summary":"Prepare First Party Experiment Package","description":"Recompute the experiment package preview with user-entered budget, duration, and variant states.","operationId":"prepare_first_party_experiment_package_api_first_party_data_uploads__upload_id__experiment_package_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","title":"Upload Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirstPartyExperimentPackageRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Prepare First Party Experiment Package Api First Party Data Uploads  Upload Id  Experiment Package Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/first-party-data/uploads/{upload_id}/sku-performance":{"get":{"tags":["first-party-data"],"summary":"List First Party Sku Performance","operationId":"list_first_party_sku_performance_api_first_party_data_uploads__upload_id__sku_performance_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Upload Id"}},{"name":"search","in":"query","required":false,"schema":{"type":"string","maxLength":200,"default":"","title":"Search"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":24,"title":"Page Size"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","maxLength":40,"default":"priority","title":"Sort"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirstPartySkuListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/first-party-data/uploads/{upload_id}/sku-performance/{sku_key}":{"get":{"tags":["first-party-data"],"summary":"Get First Party Sku Performance","operationId":"get_first_party_sku_performance_api_first_party_data_uploads__upload_id__sku_performance__sku_key__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"upload_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Upload Id"}},{"name":"sku_key","in":"path","required":true,"schema":{"type":"string","title":"Sku Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirstPartySkuDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/first-party-data/grounding-preference":{"get":{"tags":["first-party-data"],"summary":"Get First Party Grounding Preference","description":"Whether cross-lane recommendations may ground in sales uploads.","operationId":"get_first_party_grounding_preference_api_first_party_data_grounding_preference_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirstPartyGroundingPreferenceResponse"}}}}},"security":[{"HTTPBearer":[]}]},"put":{"tags":["first-party-data"],"summary":"Update First Party Grounding Preference","description":"Persist the cross-lane sales-grounding opt-in/opt-out for this profile.","operationId":"update_first_party_grounding_preference_api_first_party_data_grounding_preference_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirstPartyGroundingPreferenceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirstPartyGroundingPreferenceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/brand-articles/references":{"post":{"tags":["brand-articles"],"summary":"Upload Brand Article Reference","description":"Attach a file the draft will be written from.\n\nThe upload to the model provider happens here, while the marketer is still\nat the composer, so an unreadable file is refused at attach time rather\nthan surfacing minutes later as a draft that did not finish.\n\nWhat comes back is the attachment record's opaque id. The provider file id\nand the storage location stay on the server, so nothing the browser holds\ncan be edited into a claim on another workspace's document.","operationId":"upload_brand_article_reference_api_brand_articles_references_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_brand_article_reference_api_brand_articles_references_post"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Upload Brand Article Reference Api Brand Articles References Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/brand-articles/references/{reference_id}":{"delete":{"tags":["brand-articles"],"summary":"Remove Brand Article Reference","description":"Detach a reference and retire both copies of the file.\n\nTenant scope is the gate, and it is the only one: a marketer must always be\nable to take their own confidential document back out of our stores.","operationId":"remove_brand_article_reference_api_brand_articles_references__reference_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"reference_id","in":"path","required":true,"schema":{"type":"string","title":"Reference Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Remove Brand Article Reference Api Brand Articles References  Reference Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/brand-articles/ideas":{"post":{"tags":["brand-articles"],"summary":"Generate Brand Article Ideas","description":"Propose grounded article angles for the composer landing.\n\nStateless: the composer caches results per profile client-side, and a\n\"Show different ideas\" press is simply another call.","operationId":"generate_brand_article_ideas_api_brand_articles_ideas_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Generate Brand Article Ideas Api Brand Articles Ideas Post"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/brand-articles/types":{"get":{"tags":["brand-articles"],"summary":"List Brand Article Types","description":"The article types the picker offers, with an example prompt for each.","operationId":"list_brand_article_types_api_brand_articles_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Brand Article Types Api Brand Articles Types Get"}}}}}}},"/api/brand-articles":{"get":{"tags":["brand-articles"],"summary":"List Brand Articles","operationId":"list_brand_articles_api_brand_articles_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Brand Articles Api Brand Articles Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["brand-articles"],"summary":"Create Brand Article","operationId":"create_brand_article_api_brand_articles_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandArticleCreateRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Brand Article Api Brand Articles Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/brand-articles/{article_id}":{"get":{"tags":["brand-articles"],"summary":"Get Brand Article","operationId":"get_brand_article_api_brand_articles__article_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"article_id","in":"path","required":true,"schema":{"type":"string","title":"Article Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Brand Article Api Brand Articles  Article Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["brand-articles"],"summary":"Update Brand Article","operationId":"update_brand_article_api_brand_articles__article_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"article_id","in":"path","required":true,"schema":{"type":"string","title":"Article Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandArticleUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Brand Article Api Brand Articles  Article Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["brand-articles"],"summary":"Delete Brand Article","operationId":"delete_brand_article_api_brand_articles__article_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"article_id","in":"path","required":true,"schema":{"type":"string","title":"Article Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Brand Article Api Brand Articles  Article Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/website-improvements/assets/wordpress-plugin":{"get":{"tags":["website-improvements"],"summary":"Wordpress Plugin","description":"Deliver the exact reviewed connector code without embedding credentials.","operationId":"wordpress_plugin_api_website_improvements_assets_wordpress_plugin_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/website-improvements/analysis/reports":{"get":{"tags":["website-improvements"],"summary":"Analysis Reports","description":"Brand-scoped reports also work before a marketing team has been created.","operationId":"analysis_reports_api_website_improvements_analysis_reports_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Analysis Reports Api Website Improvements Analysis Reports Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/website-improvements/analysis/reports/aeo":{"get":{"tags":["website-improvements"],"summary":"Analysis Aeo Overview","description":"Bounded AI Search snapshot for a brand that has no active team.","operationId":"analysis_aeo_overview_api_website_improvements_analysis_reports_aeo_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Analysis Aeo Overview Api Website Improvements Analysis Reports Aeo Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/website-improvements/analysis/reports/seo":{"get":{"tags":["website-improvements"],"summary":"Analysis Seo Overview","description":"Bounded SEO snapshot for a brand that has no active team.","operationId":"analysis_seo_overview_api_website_improvements_analysis_reports_seo_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Analysis Seo Overview Api Website Improvements Analysis Reports Seo Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/website-improvements/analysis/reports/seo/sources/{source}/{report_id}":{"get":{"tags":["website-improvements"],"summary":"Analysis Saved Seo Source","operationId":"analysis_saved_seo_source_api_website_improvements_analysis_reports_seo_sources__source___report_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source","in":"path","required":true,"schema":{"enum":["audit","search_visibility","search_traffic","backlinks"],"type":"string","title":"Source"}},{"name":"report_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Report Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Analysis Saved Seo Source Api Website Improvements Analysis Reports Seo Sources  Source   Report Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/website-improvements/analysis/reports/ai-visibility/{snapshot_id}":{"get":{"tags":["website-improvements"],"summary":"Analysis Ai Visibility Report","operationId":"analysis_ai_visibility_report_api_website_improvements_analysis_reports_ai_visibility__snapshot_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"snapshot_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Snapshot Id"}},{"name":"answer_offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Answer Offset"}},{"name":"answer_limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":8,"title":"Answer Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Analysis Ai Visibility Report Api Website Improvements Analysis Reports Ai Visibility  Snapshot Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/website-improvements/analysis/reports/ai-visibility/{snapshot_id}/answers":{"get":{"tags":["website-improvements"],"summary":"Analysis Ai Visibility Answers","operationId":"analysis_ai_visibility_answers_api_website_improvements_analysis_reports_ai_visibility__snapshot_id__answers_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"snapshot_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Snapshot Id"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":8,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Analysis Ai Visibility Answers Api Website Improvements Analysis Reports Ai Visibility  Snapshot Id  Answers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/website-improvements/analysis/reports/aeo/{report_id}":{"get":{"tags":["website-improvements"],"summary":"Analysis Aeo Report","operationId":"analysis_aeo_report_api_website_improvements_analysis_reports_aeo__report_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"report_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Report Id"}},{"name":"answer_offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Answer Offset"}},{"name":"answer_limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":8,"title":"Answer Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Analysis Aeo Report Api Website Improvements Analysis Reports Aeo  Report Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/website-improvements/analysis/reports/aeo/{report_id}/answers":{"get":{"tags":["website-improvements"],"summary":"Analysis Aeo Answers","operationId":"analysis_aeo_answers_api_website_improvements_analysis_reports_aeo__report_id__answers_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"report_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Report Id"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":8,"title":"Limit"}},{"name":"answer_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Answer Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Analysis Aeo Answers Api Website Improvements Analysis Reports Aeo  Report Id  Answers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/website-improvements/analysis/reports/seo/{snapshot_id}/sections/{section}":{"get":{"tags":["website-improvements"],"summary":"Analysis Seo Section","operationId":"analysis_seo_section_api_website_improvements_analysis_reports_seo__snapshot_id__sections__section__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"snapshot_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Snapshot Id"}},{"name":"section","in":"path","required":true,"schema":{"type":"string","title":"Section"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Analysis Seo Section Api Website Improvements Analysis Reports Seo  Snapshot Id  Sections  Section  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/website-improvements/providers":{"get":{"tags":["website-improvements"],"summary":"Providers","operationId":"providers_api_website_improvements_providers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Providers Api Website Improvements Providers Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/website-improvements/sites":{"get":{"tags":["website-improvements"],"summary":"Sites","operationId":"sites_api_website_improvements_sites_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Sites Api Website Improvements Sites Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["website-improvements"],"summary":"Add Site","operationId":"add_site_api_website_improvements_sites_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteSiteCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Add Site Api Website Improvements Sites Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/website-improvements/sites/{site_id}":{"patch":{"tags":["website-improvements"],"summary":"Edit Site","operationId":"edit_site_api_website_improvements_sites__site_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"site_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Site Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteSiteUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Edit Site Api Website Improvements Sites  Site Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["website-improvements"],"summary":"Disconnect Site","operationId":"disconnect_site_api_website_improvements_sites__site_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"site_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Site Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Disconnect Site Api Website Improvements Sites  Site Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/website-improvements/sites/{site_id}/verify":{"post":{"tags":["website-improvements"],"summary":"Verify Site","operationId":"verify_site_api_website_improvements_sites__site_id__verify_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"site_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Site Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Verify Site Api Website Improvements Sites  Site Id  Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/website-improvements/sites/{site_id}/resources":{"get":{"tags":["website-improvements"],"summary":"Resources","operationId":"resources_api_website_improvements_sites__site_id__resources_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"site_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Site Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Cursor"}},{"name":"resource_kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Resource Kind"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Resources Api Website Improvements Sites  Site Id  Resources Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/website-improvements/changes":{"get":{"tags":["website-improvements"],"summary":"Changes","operationId":"changes_api_website_improvements_changes_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Changes Api Website Improvements Changes Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["website-improvements"],"summary":"Add Change","operationId":"add_change_api_website_improvements_changes_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteChangeCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Add Change Api Website Improvements Changes Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/website-improvements/changes/{change_id}":{"get":{"tags":["website-improvements"],"summary":"Get Change","operationId":"get_change_api_website_improvements_changes__change_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"change_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Change Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Change Api Website Improvements Changes  Change Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["website-improvements"],"summary":"Edit Change","operationId":"edit_change_api_website_improvements_changes__change_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"change_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Change Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteChangeUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Edit Change Api Website Improvements Changes  Change Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/website-improvements/changes/{change_id}/prepare":{"post":{"tags":["website-improvements"],"summary":"Prepare Change","operationId":"prepare_change_api_website_improvements_changes__change_id__prepare_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"change_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Change Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Prepare Change Api Website Improvements Changes  Change Id  Prepare Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/website-improvements/changes/{change_id}/approve":{"post":{"tags":["website-improvements"],"summary":"Approve Change","operationId":"approve_change_api_website_improvements_changes__change_id__approve_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"change_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Change Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebsiteApprovalRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Approve Change Api Website Improvements Changes  Change Id  Approve Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/website-improvements/changes/{change_id}/publish":{"post":{"tags":["website-improvements"],"summary":"Retry Publish","operationId":"retry_publish_api_website_improvements_changes__change_id__publish_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"change_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Change Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Retry Publish Api Website Improvements Changes  Change Id  Publish Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/website-improvements/sites/{site_id}/technical":{"get":{"tags":["website-improvements"],"summary":"Technical Issues","operationId":"technical_issues_api_website_improvements_sites__site_id__technical_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"site_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Site Id"}},{"name":"resource_key","in":"query","required":false,"schema":{"type":"string","pattern":"^(robots|page:[1-9][0-9]*)$","default":"robots","title":"Resource Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/earned-media/projects":{"get":{"tags":["earned-media"],"summary":"List Earned Media Projects","operationId":"list_earned_media_projects_api_earned_media_projects_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"enum":["draft","generating","ready","needs_review","failed","archived"],"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Earned Media Projects Api Earned Media Projects Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["earned-media"],"summary":"Create Earned Media Project","operationId":"create_earned_media_project_api_earned_media_projects_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EarnedMediaProjectCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Earned Media Project Api Earned Media Projects Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/earned-media/projects/{project_id}":{"get":{"tags":["earned-media"],"summary":"Get Earned Media Project","operationId":"get_earned_media_project_api_earned_media_projects__project_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Earned Media Project Api Earned Media Projects  Project Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["earned-media"],"summary":"Update Earned Media Project","operationId":"update_earned_media_project_api_earned_media_projects__project_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EarnedMediaProjectUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Earned Media Project Api Earned Media Projects  Project Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/earned-media/projects/{project_id}/archive":{"post":{"tags":["earned-media"],"summary":"Archive Earned Media Project","description":"Retire a story. Idempotent; refused while a generation lease is live.","operationId":"archive_earned_media_project_api_earned_media_projects__project_id__archive_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Archive Earned Media Project Api Earned Media Projects  Project Id  Archive Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/earned-media/projects/{project_id}/generate":{"post":{"tags":["earned-media"],"summary":"Generate Earned Media Project","operationId":"generate_earned_media_project_api_earned_media_projects__project_id__generate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EarnedMediaGenerateRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Generate Earned Media Project Api Earned Media Projects  Project Id  Generate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/earned-media/projects/{project_id}/refresh-research":{"post":{"tags":["earned-media"],"summary":"Refresh Earned Media Research","operationId":"refresh_earned_media_research_api_earned_media_projects__project_id__refresh_research_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EarnedMediaRefreshResearchRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Refresh Earned Media Research Api Earned Media Projects  Project Id  Refresh Research Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/earned-media/projects/{project_id}/drafts/{draft_id}":{"put":{"tags":["earned-media"],"summary":"Save Earned Media Draft","operationId":"save_earned_media_draft_api_earned_media_projects__project_id__drafts__draft_id__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EarnedMediaDraftSaveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Save Earned Media Draft Api Earned Media Projects  Project Id  Drafts  Draft Id  Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/earned-media/projects/{project_id}/drafts/{draft_id}/export":{"get":{"tags":["earned-media"],"summary":"Export Earned Media Draft","description":"Download the current saved draft as a recipient-ready PDF or HTML file.","operationId":"export_earned_media_draft_api_earned_media_projects__project_id__drafts__draft_id__export_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}},{"name":"format","in":"query","required":false,"schema":{"enum":["pdf","html"],"type":"string","default":"pdf","title":"Format"}},{"name":"expected_version","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Expected Version"}},{"name":"timezone","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Timezone"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/earned-media/projects/{project_id}/drafts/{draft_id}/rewrite":{"post":{"tags":["earned-media"],"summary":"Rewrite Earned Media Draft","description":"Claim the project for a rewrite, then hand the model call to the worker.\n\nThe rewrite waits on one model call with nothing to stream, so the request\nis idle for its whole duration and the proxy closes it before the model\nanswers. The client then sees a gateway error for work the server went on\nto finish. The project row carries the run the studio already polls, so the\nclaim happens here and the call happens there.","operationId":"rewrite_earned_media_draft_api_earned_media_projects__project_id__drafts__draft_id__rewrite_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EarnedMediaDraftRewriteRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Rewrite Earned Media Draft Api Earned Media Projects  Project Id  Drafts  Draft Id  Rewrite Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/earned-media/projects/{project_id}/drafts/{draft_id}/versions":{"get":{"tags":["earned-media"],"summary":"List Earned Media Draft Versions","operationId":"list_earned_media_draft_versions_api_earned_media_projects__project_id__drafts__draft_id__versions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Earned Media Draft Versions Api Earned Media Projects  Project Id  Drafts  Draft Id  Versions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/earned-media/projects/{project_id}/drafts/{draft_id}/versions/{version_number}/preview":{"get":{"tags":["earned-media"],"summary":"Read Earned Media Draft Preview","operationId":"read_earned_media_draft_preview_api_earned_media_projects__project_id__drafts__draft_id__versions__version_number__preview_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}},{"name":"version_number","in":"path","required":true,"schema":{"type":"integer","title":"Version Number"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Read Earned Media Draft Preview Api Earned Media Projects  Project Id  Drafts  Draft Id  Versions  Version Number  Preview Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/earned-media/projects/{project_id}/drafts/{draft_id}/versions/{version_number}/restore":{"post":{"tags":["earned-media"],"summary":"Restore Earned Media Draft Version","operationId":"restore_earned_media_draft_version_api_earned_media_projects__project_id__drafts__draft_id__versions__version_number__restore_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"draft_id","in":"path","required":true,"schema":{"type":"string","title":"Draft Id"}},{"name":"version_number","in":"path","required":true,"schema":{"type":"integer","title":"Version Number"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EarnedMediaVersionRestoreRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Restore Earned Media Draft Version Api Earned Media Projects  Project Id  Drafts  Draft Id  Versions  Version Number  Restore Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/earned-media/projects/{project_id}/targets/{target_id}/enrich-contact":{"post":{"tags":["earned-media"],"summary":"Enrich Earned Media Target Contact","description":"Look up the outlet's published press contact route via live web search.","operationId":"enrich_earned_media_target_contact_api_earned_media_projects__project_id__targets__target_id__enrich_contact_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"target_id","in":"path","required":true,"schema":{"type":"string","title":"Target Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Enrich Earned Media Target Contact Api Earned Media Projects  Project Id  Targets  Target Id  Enrich Contact Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/earned-media/projects/{project_id}/targets/{target_id}/pitch":{"post":{"tags":["earned-media"],"summary":"Draft Earned Media Target Pitch","description":"Draft an outlet-specific pitch email from the story's verified material.","operationId":"draft_earned_media_target_pitch_api_earned_media_projects__project_id__targets__target_id__pitch_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"target_id","in":"path","required":true,"schema":{"type":"string","title":"Target Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Draft Earned Media Target Pitch Api Earned Media Projects  Project Id  Targets  Target Id  Pitch Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/earned-media/projects/{project_id}/targets/{target_id}":{"patch":{"tags":["earned-media"],"summary":"Update Earned Media Target","operationId":"update_earned_media_target_api_earned_media_projects__project_id__targets__target_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"project_id","in":"path","required":true,"schema":{"type":"string","title":"Project Id"}},{"name":"target_id","in":"path","required":true,"schema":{"type":"string","title":"Target Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EarnedMediaTargetUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Earned Media Target Api Earned Media Projects  Project Id  Targets  Target Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/earned-media/press-room":{"get":{"tags":["earned-media"],"summary":"Get Earned Media Press Room","operationId":"get_earned_media_press_room_api_earned_media_press_room_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Earned Media Press Room Api Earned Media Press Room Get"}}}}},"security":[{"HTTPBearer":[]}]},"put":{"tags":["earned-media"],"summary":"Save Earned Media Press Room","operationId":"save_earned_media_press_room_api_earned_media_press_room_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EarnedMediaPressRoomSaveRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Save Earned Media Press Room Api Earned Media Press Room Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/earned-media/press-room/generate":{"post":{"tags":["earned-media"],"summary":"Generate Earned Media Press Room","operationId":"generate_earned_media_press_room_api_earned_media_press_room_generate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EarnedMediaPressRoomGenerateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Generate Earned Media Press Room Api Earned Media Press Room Generate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/earned-media/press-room/coverage":{"post":{"tags":["earned-media"],"summary":"Discover Earned Media Press Coverage","description":"Claim the press room for a coverage sweep, then hand it to the worker.","operationId":"discover_earned_media_press_coverage_api_earned_media_press_room_coverage_post","responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Discover Earned Media Press Coverage Api Earned Media Press Room Coverage Post"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/earned-media/press-room/coverage/url":{"post":{"tags":["earned-media"],"summary":"Add Earned Media Press Coverage Url","description":"Add one page the user already knows about.","operationId":"add_earned_media_press_coverage_url_api_earned_media_press_room_coverage_url_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EarnedMediaCoverageUrlRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Add Earned Media Press Coverage Url Api Earned Media Press Room Coverage Url Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/earned-media/story-ideas":{"post":{"tags":["earned-media"],"summary":"Generate Earned Media Story Ideas","description":"Propose grounded press-story angles for the composer landing.\n\nStateless: the composer caches results per profile client-side, and a\n\"Show different ideas\" press is simply another call.","operationId":"generate_earned_media_story_ideas_api_earned_media_story_ideas_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Generate Earned Media Story Ideas Api Earned Media Story Ideas Post"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/experiment-packages/drafts":{"post":{"tags":["experiment-packages"],"summary":"Create Experiment Draft","description":"Save an experiment idea without generating or launching any campaign.","operationId":"create_experiment_draft_api_experiment_packages_drafts_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExperimentDraftCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Experiment Draft Api Experiment Packages Drafts Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/experiment-packages/{package_id}/draft":{"put":{"tags":["experiment-packages"],"summary":"Save Experiment Draft","operationId":"save_experiment_draft_api_experiment_packages__package_id__draft_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"package_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Package Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExperimentDraftSave"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Save Experiment Draft Api Experiment Packages  Package Id  Draft Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/experiment-packages/{package_id}/archive":{"put":{"tags":["experiment-packages"],"summary":"Archive Experiment","description":"Organize history; this operation never pauses or deletes provider work.","operationId":"archive_experiment_api_experiment_packages__package_id__archive_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"package_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Package Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExperimentArchiveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Archive Experiment Api Experiment Packages  Package Id  Archive Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/experiment-packages":{"post":{"tags":["experiment-packages"],"summary":"Create Experiment Package","description":"Persist a test package from a tuned preview at Create Test Campaign time.","operationId":"create_experiment_package_api_experiment_packages_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExperimentPackageCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Create Experiment Package Api Experiment Packages Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["experiment-packages"],"summary":"List Experiment Packages","operationId":"list_experiment_packages_api_experiment_packages_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source_upload_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Upload Id"}},{"name":"include_archived","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Archived"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Experiment Packages Api Experiment Packages Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/experiment-packages/{package_id}/readout":{"post":{"tags":["experiment-packages"],"summary":"Compute Experiment Package Readout","description":"Compute and store the lift readout from a paired post-test upload.","operationId":"compute_experiment_package_readout_api_experiment_packages__package_id__readout_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"package_id","in":"path","required":true,"schema":{"type":"string","title":"Package Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExperimentReadoutRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Compute Experiment Package Readout Api Experiment Packages  Package Id  Readout Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/experiment-packages/{package_id}":{"get":{"tags":["experiment-packages"],"summary":"Get Experiment Package","operationId":"get_experiment_package_api_experiment_packages__package_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"package_id","in":"path","required":true,"schema":{"type":"string","title":"Package Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Experiment Package Api Experiment Packages  Package Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/experiment-packages/{package_id}/campaigns/{campaign_id}":{"delete":{"tags":["experiment-packages"],"summary":"Remove Experiment Package Campaign","description":"Remove an unsubmitted draft; fixed/provider-bound membership is immutable.","operationId":"remove_experiment_package_campaign_api_experiment_packages__package_id__campaigns__campaign_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"package_id","in":"path","required":true,"schema":{"type":"string","title":"Package Id"}},{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Remove Experiment Package Campaign Api Experiment Packages  Package Id  Campaigns  Campaign Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/experiment-packages/{package_id}/campaigns/{campaign_id}/refresh":{"post":{"tags":["experiment-packages"],"summary":"Refresh Experiment Package Campaign","description":"Regenerate one unsubmitted version, rechecking membership in the worker.","operationId":"refresh_experiment_package_campaign_api_experiment_packages__package_id__campaigns__campaign_id__refresh_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"package_id","in":"path","required":true,"schema":{"type":"string","title":"Package Id"}},{"name":"campaign_id","in":"path","required":true,"schema":{"type":"string","title":"Campaign Id"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Refresh Experiment Package Campaign Api Experiment Packages  Package Id  Campaigns  Campaign Id  Refresh Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/seo/recommendations/{recommendation_id}/status":{"put":{"tags":["seo-recommendations"],"summary":"Update Seo Recommendation Status","description":"Mark one SEO recommendation open, done, or dismissed.\n\nContributor-or-higher: recording that a fix landed (or was declined) is a\nprofile-scoped content mutation, and OBSERVER is the product's read-only\nrole.","operationId":"update_seo_recommendation_status_api_seo_recommendations__recommendation_id__status_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"recommendation_id","in":"path","required":true,"schema":{"type":"string","title":"Recommendation Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SEORecommendationStatusRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Seo Recommendation Status Api Seo Recommendations  Recommendation Id  Status Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/settings":{"get":{"tags":["campaign-pages"],"summary":"Settings","operationId":"settings_api_campaign_pages_settings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaign-pages/pages":{"get":{"tags":["campaign-pages"],"summary":"List Pages","operationId":"list_pages_api_campaign_pages_pages_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["campaign-pages"],"summary":"Create Page","operationId":"create_page_api_campaign_pages_pages_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/campaign-options":{"get":{"tags":["campaign-pages"],"summary":"Campaign Options","description":"Small, scoped picker projection; never return draft or intake settings.","operationId":"campaign_options_api_campaign_pages_campaign_options_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaign-pages/pages/{page_id}/campaign-context":{"get":{"tags":["campaign-pages"],"summary":"Campaign Context","operationId":"campaign_context_api_campaign_pages_pages__page_id__campaign_context_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Page Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/pages/{page_id}":{"get":{"tags":["campaign-pages"],"summary":"Read Page","operationId":"read_page_api_campaign_pages_pages__page_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Page Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["campaign-pages"],"summary":"Update Page","operationId":"update_page_api_campaign_pages_pages__page_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Page Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagePatchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/pages/{page_id}/generate":{"post":{"tags":["campaign-pages"],"summary":"Generate Page","operationId":"generate_page_api_campaign_pages_pages__page_id__generate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Page Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageGenerateRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/pages/{page_id}/retry-generation":{"post":{"tags":["campaign-pages"],"summary":"Retry Page Generation","operationId":"retry_page_generation_api_campaign_pages_pages__page_id__retry_generation_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Page Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageGenerationRetryRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/pages/{page_id}/rewrite":{"post":{"tags":["campaign-pages"],"summary":"Rewrite Page","operationId":"rewrite_page_api_campaign_pages_pages__page_id__rewrite_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Page Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageRewriteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/pages/{page_id}/publish":{"post":{"tags":["campaign-pages"],"summary":"Publish Page","operationId":"publish_page_api_campaign_pages_pages__page_id__publish_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Page Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageRevisionRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/pages/{page_id}/generation-proposal/{decision}":{"post":{"tags":["campaign-pages"],"summary":"Decide Generation","operationId":"decide_generation_api_campaign_pages_pages__page_id__generation_proposal__decision__post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Page Id"}},{"name":"decision","in":"path","required":true,"schema":{"type":"string","title":"Decision"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageRevisionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/pages/{page_id}/versions":{"get":{"tags":["campaign-pages"],"summary":"Page Versions","operationId":"page_versions_api_campaign_pages_pages__page_id__versions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Page Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/pages/{page_id}/versions/{release_id}/restore":{"post":{"tags":["campaign-pages"],"summary":"Restore Published Version","operationId":"restore_published_version_api_campaign_pages_pages__page_id__versions__release_id__restore_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Page Id"}},{"name":"release_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Release Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageRevisionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/pages/{page_id}/unpublish":{"post":{"tags":["campaign-pages"],"summary":"Unpublish Page","operationId":"unpublish_page_api_campaign_pages_pages__page_id__unpublish_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Page Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageRevisionRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/pages/{page_id}/delete":{"post":{"tags":["campaign-pages"],"summary":"Delete Page","operationId":"delete_page_api_campaign_pages_pages__page_id__delete_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Page Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageRevisionRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/pages/{page_id}/restore":{"post":{"tags":["campaign-pages"],"summary":"Restore Page","operationId":"restore_page_api_campaign_pages_pages__page_id__restore_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Page Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageRevisionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/pages/{page_id}/inquiries":{"get":{"tags":["campaign-pages"],"summary":"Inquiries","operationId":"inquiries_api_campaign_pages_pages__page_id__inquiries_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Page Id"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/pages/{page_id}/inquiries/export":{"get":{"tags":["campaign-pages"],"summary":"Export Inquiries","operationId":"export_inquiries_api_campaign_pages_pages__page_id__inquiries_export_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Page Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/inquiries/{inquiry_id}/decision":{"post":{"tags":["campaign-pages"],"summary":"Decide Inquiry","operationId":"decide_inquiry_api_campaign_pages_inquiries__inquiry_id__decision_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"inquiry_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Inquiry Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InquiryDecisionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/inquiries/{inquiry_id}/qualification":{"post":{"tags":["campaign-pages"],"summary":"Review Inquiry Qualification","operationId":"review_inquiry_qualification_api_campaign_pages_inquiries__inquiry_id__qualification_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"inquiry_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Inquiry Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InquiryQualificationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/inquiries/{inquiry_id}/events":{"get":{"tags":["campaign-pages"],"summary":"Inquiry Events","operationId":"inquiry_events_api_campaign_pages_inquiries__inquiry_id__events_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"inquiry_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Inquiry Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/inquiries/{inquiry_id}/erase":{"post":{"tags":["campaign-pages"],"summary":"Erase Inquiry","operationId":"erase_inquiry_api_campaign_pages_inquiries__inquiry_id__erase_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"inquiry_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Inquiry Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InquiryEraseRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/booking/connect":{"post":{"tags":["campaign-pages"],"summary":"Connect Booking","operationId":"connect_booking_api_campaign_pages_booking_connect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaign-pages/booking/disconnect":{"post":{"tags":["campaign-pages"],"summary":"Disconnect Booking","operationId":"disconnect_booking_api_campaign_pages_booking_disconnect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaign-pages/domains":{"post":{"tags":["campaign-pages"],"summary":"Connect Domain","operationId":"connect_domain_api_campaign_pages_domains_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainConnectRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/campaign-pages/domains/{domain_id}/verify":{"post":{"tags":["campaign-pages"],"summary":"Verify Domain","operationId":"verify_domain_api_campaign_pages_domains__domain_id__verify_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"domain_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Domain Id"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/campaign-pages/domains/{domain_id}/disconnect":{"post":{"tags":["campaign-pages"],"summary":"Disconnect Domain","operationId":"disconnect_domain_api_campaign_pages_domains__domain_id__disconnect_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"domain_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Domain Id"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/inquiry-pages/booking/callback":{"get":{"tags":["public-inquiry-pages"],"summary":"Booking Callback","operationId":"booking_callback_api_public_inquiry_pages_booking_callback_get","parameters":[{"name":"state","in":"query","required":true,"schema":{"type":"string","maxLength":200,"title":"State"}},{"name":"code","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Code"}},{"name":"error","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Error"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/inquiry-pages/booking/webhooks/{connection_id}":{"post":{"tags":["public-inquiry-pages"],"summary":"Booking Webhook","operationId":"booking_webhook_api_public_inquiry_pages_booking_webhooks__connection_id__post","parameters":[{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Connection Id"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/inquiry-pages/{public_id}/context":{"get":{"tags":["public-inquiry-pages"],"summary":"Context","operationId":"context_api_public_inquiry_pages__public_id__context_get","parameters":[{"name":"public_id","in":"path","required":true,"schema":{"type":"string","minLength":20,"maxLength":40,"pattern":"^[A-Za-z0-9_-]+$","title":"Public Id"}},{"name":"release_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Release Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/inquiry-pages/{public_id}/submissions":{"post":{"tags":["public-inquiry-pages"],"summary":"Submit","operationId":"submit_api_public_inquiry_pages__public_id__submissions_post","parameters":[{"name":"public_id","in":"path","required":true,"schema":{"type":"string","minLength":20,"maxLength":40,"pattern":"^[A-Za-z0-9_-]+$","title":"Public Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InquirySubmission"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/inquiry-pages/{public_id}/receipts/{receipt_token}":{"get":{"tags":["public-inquiry-pages"],"summary":"Receipt","operationId":"receipt_api_public_inquiry_pages__public_id__receipts__receipt_token__get","parameters":[{"name":"public_id","in":"path","required":true,"schema":{"type":"string","minLength":20,"maxLength":40,"pattern":"^[A-Za-z0-9_-]+$","title":"Public Id"}},{"name":"receipt_token","in":"path","required":true,"schema":{"type":"string","minLength":20,"maxLength":2000,"title":"Receipt Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/b2b-leads/searches":{"post":{"tags":["crm-b2b-leads"],"summary":"Search B2B Leads","operationId":"search_b2b_leads_api_crm_b2b_leads_searches_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/B2BLeadSearchRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/B2BLeadSearchJobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["crm-b2b-leads"],"summary":"List B2B Lead Searches","operationId":"list_b2b_lead_searches_api_crm_b2b_leads_searches_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":10,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/B2BLeadSearchHistoryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/b2b-leads/searches/{search_id}/refresh":{"post":{"tags":["crm-b2b-leads"],"summary":"Refresh B2B Lead Search","operationId":"refresh_b2b_lead_search_api_crm_b2b_leads_searches__search_id__refresh_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"search_id","in":"path","required":true,"schema":{"type":"string","title":"Search Id"}}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/B2BLeadSearchJobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/b2b-leads/searches/{search_id}":{"get":{"tags":["crm-b2b-leads"],"summary":"Get B2B Lead Search","operationId":"get_b2b_lead_search_api_crm_b2b_leads_searches__search_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"search_id","in":"path","required":true,"schema":{"type":"string","title":"Search Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/B2BLeadSearchJobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/b2b-leads/searches/{search_id}/hydrate-emails":{"post":{"tags":["crm-b2b-leads"],"summary":"Hydrate B2B Lead Emails","operationId":"hydrate_b2b_lead_emails_api_crm_b2b_leads_searches__search_id__hydrate_emails_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"search_id","in":"path","required":true,"schema":{"type":"string","title":"Search Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/B2BHydrateEmailsRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/B2BHydrateEmailsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/b2b-leads/searches/{search_id}/accounts/{account_key}/contacts":{"post":{"tags":["crm-b2b-leads"],"summary":"Expand B2B Account Contacts","operationId":"expand_b2b_account_contacts_api_crm_b2b_leads_searches__search_id__accounts__account_key__contacts_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"search_id","in":"path","required":true,"schema":{"type":"string","title":"Search Id"}},{"name":"account_key","in":"path","required":true,"schema":{"type":"string","title":"Account Key"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/B2BAccountContactsRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/B2BAccountContactsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/b2b-leads/searches/{search_id}/candidates/{candidate_id}/draft":{"post":{"tags":["crm-b2b-leads"],"summary":"Draft B2B Lead Email","operationId":"draft_b2b_lead_email_api_crm_b2b_leads_searches__search_id__candidates__candidate_id__draft_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"search_id","in":"path","required":true,"schema":{"type":"string","title":"Search Id"}},{"name":"candidate_id","in":"path","required":true,"schema":{"type":"string","title":"Candidate Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/B2BDraftRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/B2BDraftResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/b2b-leads/searches/{search_id}/candidates/{candidate_id}/save":{"post":{"tags":["crm-b2b-leads"],"summary":"Save B2B Lead Candidate","operationId":"save_b2b_lead_candidate_api_crm_b2b_leads_searches__search_id__candidates__candidate_id__save_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"search_id","in":"path","required":true,"schema":{"type":"string","title":"Search Id"}},{"name":"candidate_id","in":"path","required":true,"schema":{"type":"string","title":"Candidate Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/B2BSaveCandidateRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/B2BSaveCandidateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/b2b-leads/prospects/{prospect_id}/draft":{"put":{"tags":["crm-b2b-leads"],"summary":"Update B2B Prospect Draft","operationId":"update_b2b_prospect_draft_api_crm_b2b_leads_prospects__prospect_id__draft_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"prospect_id","in":"path","required":true,"schema":{"type":"string","title":"Prospect Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/B2BUpdateDraftRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/B2BUpdateDraftResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/people":{"get":{"tags":["crm-people"],"summary":"List Crm People","description":"Return the unified People projection for the active company profile.","operationId":"list_crm_people_api_crm_people_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"People per page","default":25,"title":"Limit"},"description":"People per page"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Zero-based offset","default":0,"title":"Offset"},"description":"Zero-based offset"},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Source filter","title":"Source"},"description":"Source filter"},{"name":"stage","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Unified stage filter","title":"Stage"},"description":"Unified stage filter"},{"name":"hubspot","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"HubSpot sync filter","title":"Hubspot"},"description":"HubSpot sync filter"},{"name":"signal","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Dedupe-signal filter","title":"Signal"},"description":"Dedupe-signal filter"},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Search text","title":"Search"},"description":"Search text"},{"name":"sort_key","in":"query","required":false,"schema":{"type":"string","description":"Sort key","default":"last_activity","title":"Sort Key"},"description":"Sort key"},{"name":"sort_direction","in":"query","required":false,"schema":{"type":"string","description":"Sort direction","default":"desc","title":"Sort Direction"},"description":"Sort direction"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmPeopleListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/people/export":{"get":{"tags":["crm-people"],"summary":"Export Crm People","description":"Download every person matching the active list query as one CSV.","operationId":"export_crm_people_api_crm_people_export_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Source filter","title":"Source"},"description":"Source filter"},{"name":"stage","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Unified stage filter","title":"Stage"},"description":"Unified stage filter"},{"name":"hubspot","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"HubSpot sync filter","title":"Hubspot"},"description":"HubSpot sync filter"},{"name":"signal","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Dedupe-signal filter","title":"Signal"},"description":"Dedupe-signal filter"},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"description":"Search text","title":"Search"},"description":"Search text"},{"name":"sort_key","in":"query","required":false,"schema":{"type":"string","description":"Sort key","default":"last_activity","title":"Sort Key"},"description":"Sort key"},{"name":"sort_direction","in":"query","required":false,"schema":{"type":"string","description":"Sort direction","default":"desc","title":"Sort Direction"},"description":"Sort direction"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/people/{person_ref}":{"get":{"tags":["crm-people"],"summary":"Get Crm Person","description":"Return full detail for a single unified person.","operationId":"get_crm_person_api_crm_people__person_ref__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"person_ref","in":"path","required":true,"schema":{"type":"string","title":"Person Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmPersonDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/people/{person_ref}/contacted":{"post":{"tags":["crm-people"],"summary":"Mark Person Contacted","description":"Log a manual ``contacted`` touch against a person; return refreshed detail.\n\nThe single write surface over the otherwise read-through People projection.\nA 404 means the person_ref does not resolve within the active profile.","operationId":"mark_person_contacted_api_crm_people__person_ref__contacted_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"person_ref","in":"path","required":true,"schema":{"type":"string","title":"Person Ref"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CrmMarkContactedRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmPersonDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["crm-people"],"summary":"Unmark Person Contacted","description":"Undo: clear this profile's ``contacted`` touches for a person.","operationId":"unmark_person_contacted_api_crm_people__person_ref__contacted_delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"person_ref","in":"path","required":true,"schema":{"type":"string","title":"Person Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmPersonDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/people/{person_ref}/stage":{"put":{"tags":["crm-people"],"summary":"Set Person Stage","description":"Manually set a person's pipeline stage (a reversible override over auto).","operationId":"set_person_stage_api_crm_people__person_ref__stage_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"person_ref","in":"path","required":true,"schema":{"type":"string","title":"Person Ref"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmSetStageRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmPersonDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["crm-people"],"summary":"Clear Person Stage","description":"Revert a manual stage override back to the source-derived auto stage.","operationId":"clear_person_stage_api_crm_people__person_ref__stage_delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"person_ref","in":"path","required":true,"schema":{"type":"string","title":"Person Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmPersonDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/people/{person_ref}/split":{"post":{"tags":["crm-people"],"summary":"Split Person Source","description":"Peel one contributing source out of a wrongly-merged person.\n\nRecords a persistent do-not-merge override so the projection keeps that\nsource as its own standalone person. A 404 means the person_ref does not\nresolve in the active profile, the source_ref is not one of its sources, or\nthe person has nothing to split (a single source).","operationId":"split_person_source_api_crm_people__person_ref__split_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"person_ref","in":"path","required":true,"schema":{"type":"string","title":"Person Ref"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmSplitSourceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmPersonDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["crm-people"],"summary":"Unsplit Person Source","description":"Undo a split — drop the do-not-merge override so the source re-fuses.\n\nA 404 means ``person_ref`` no longer resolves in the active profile.","operationId":"unsplit_person_source_api_crm_people__person_ref__split_delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"person_ref","in":"path","required":true,"schema":{"type":"string","title":"Person Ref"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmSplitSourceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmPersonDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/sync/hubspot":{"post":{"tags":["crm"],"summary":"Sync People To Hubspot","description":"Stage or execute a HubSpot sync for the given People.\n\nDirect path (policy off) upserts immediately; governed path (policy on, or\nany agent-initiated request) creates a ChangeRequest gated by the CRM Sync\nApprovers group. One-diff parity is preserved by build_sync_diff.","operationId":"sync_people_to_hubspot_api_crm_sync_hubspot_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmSyncRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmSyncResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/crm/audiences":{"get":{"tags":["crm"],"summary":"Get Audiences","operationId":"get_audiences_api_crm_audiences_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmAudienceListResponse"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["crm"],"summary":"Create Audience","operationId":"create_audience_api_crm_audiences_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmAudienceCreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmAudienceSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/crm/audiences/add":{"post":{"tags":["crm"],"summary":"Add To Audience","operationId":"add_to_audience_api_crm_audiences_add_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmAudienceAddRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmAudienceAddResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/crm/audiences/detail":{"get":{"tags":["crm"],"summary":"Get Audiences With Sync","operationId":"get_audiences_with_sync_api_crm_audiences_detail_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmAudienceDetailListResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/crm/audiences/{group_id}/refresh":{"post":{"tags":["crm"],"summary":"Refresh Audience Sync","description":"Re-read a synced audience's matched size from the platform.\n\nUploads resolve asynchronously, so the status recorded at upload time is\nprovisional. This settles `syncing` into `ready` or `too_small` once the\nplatform has actually matched.","operationId":"refresh_audience_sync_api_crm_audiences__group_id__refresh_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","title":"Group Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmAudienceSyncRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmAudienceSyncResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/audiences/platform-readiness/recheck":{"post":{"tags":["crm"],"summary":"Recheck Platform Readiness","description":"Forget a recorded platform blocker so the next sync re-tests it.\n\nBacks the \"I've accepted it\" affordance. We cannot verify an acceptance made\non the platform's own site -- only a real write can -- so this drops what we\nlearned rather than claiming to have confirmed anything.","operationId":"recheck_platform_readiness_api_crm_audiences_platform_readiness_recheck_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmAudienceRecheckRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmAudienceDetailListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/crm/audiences/{group_id}":{"patch":{"tags":["crm"],"summary":"Rename Audience","operationId":"rename_audience_api_crm_audiences__group_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","title":"Group Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmAudienceRenameRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmAudienceSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["crm"],"summary":"Delete Audience","operationId":"delete_audience_api_crm_audiences__group_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","title":"Group Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/audiences/{group_id}/members":{"get":{"tags":["crm"],"summary":"Get Audience Members","operationId":"get_audience_members_api_crm_audiences__group_id__members_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","title":"Group Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmAudienceMemberListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["crm"],"summary":"Add Audience Members","operationId":"add_audience_members_api_crm_audiences__group_id__members_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","title":"Group Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmAudienceMembersAddRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmAudienceMembersAddResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/audiences/{group_id}/members/{member_id}":{"delete":{"tags":["crm"],"summary":"Remove Audience Member","operationId":"remove_audience_member_api_crm_audiences__group_id__members__member_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","title":"Group Id"}},{"name":"member_id","in":"path","required":true,"schema":{"type":"string","title":"Member Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmAudienceMembersAddResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/audiences/{group_id}/sync":{"post":{"tags":["crm"],"summary":"Sync Audience","operationId":"sync_audience_api_crm_audiences__group_id__sync_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","title":"Group Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmAudienceSyncRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmAudienceSyncResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/settings":{"get":{"tags":["crm"],"summary":"Get Crm Settings","operationId":"get_crm_settings_api_crm_settings_get","security":[{"HTTPBearer":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmSettingsResponse"}}}}}},"put":{"tags":["crm"],"summary":"Update Crm Settings","operationId":"update_crm_settings_api_crm_settings_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmSettingsUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmSettingsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/crm/approver-group":{"get":{"tags":["crm"],"summary":"Get Approver Group","operationId":"get_approver_group_api_crm_approver_group_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmApproverGroupResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/hubspot/auth":{"get":{"tags":["external-platform"],"summary":"Hubspot Auth","description":"Get the HubSpot OAuth authorization URL for the current company profile.\n\nReturns:\n    HubSpotAuthResponse with the OAuth authorization URL.","operationId":"hubspot_auth_api_external_platform_hubspot_auth_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HubSpotAuthResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/hubspot/callback":{"get":{"tags":["external-platform"],"summary":"Hubspot Callback","description":"Handle the HubSpot OAuth callback and store tokens.\n\nStores credentials in the data_source_integrations table.","operationId":"hubspot_callback_api_external_platform_hubspot_callback_get","parameters":[{"name":"code","in":"query","required":false,"schema":{"type":"string","title":"Code"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","title":"State"}},{"name":"error","in":"query","required":false,"schema":{"type":"string","title":"Error"}},{"name":"error_description","in":"query","required":false,"schema":{"type":"string","title":"Error Description"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/external-platform/hubspot/status":{"get":{"tags":["external-platform"],"summary":"Get Hubspot Status","description":"Check HubSpot integration status for the current company profile.","operationId":"get_hubspot_status_api_external_platform_hubspot_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HubSpotStatusResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/hubspot/health":{"get":{"tags":["external-platform"],"summary":"Get Hubspot Health","description":"Get HubSpot connection health status.","operationId":"get_hubspot_health_api_external_platform_hubspot_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HubSpotHealthResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/hubspot/disconnect":{"post":{"tags":["external-platform"],"summary":"Disconnect Hubspot","description":"Disconnect HubSpot by revoking tokens and marking the integration inactive.","operationId":"disconnect_hubspot_api_external_platform_hubspot_disconnect_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/external-platform/hubspot/initial-sync-status":{"get":{"tags":["external-platform"],"summary":"Hubspot Initial Sync Status","description":"Get the HubSpot initial Databricks sync status for the current profile.","operationId":"hubspot_initial_sync_status_api_external_platform_hubspot_initial_sync_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Hubspot Initial Sync Status Api External Platform Hubspot Initial Sync Status Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/overview/bootstrap":{"get":{"tags":["overview","overview"],"summary":"Get Overview Bootstrap","description":"Return the overview page's primary data in one response without changing its UI contract.","operationId":"get_overview_bootstrap_api_overview_bootstrap_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OverviewBootstrapResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/overview/sections":{"get":{"tags":["overview","overview"],"summary":"Get Overview Sections","description":"Existing PostgreSQL observations, with no workflow or source refresh.","operationId":"get_overview_sections_api_overview_sections_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"sections","in":"query","required":true,"schema":{"type":"string","title":"Sections"}},{"name":"check_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Check Id"}},{"name":"card_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Card Id"}},{"name":"paid_integration_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Paid Integration Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OverviewSectionsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-product-lab/product-brainstorm/sessions":{"get":{"tags":["ai-product-lab","Product Brainstorm"],"summary":"Get Brainstorm Sessions","description":"Get previous brainstorming sessions for this company profile.","operationId":"get_brainstorm_sessions_api_ai_product_lab_product_brainstorm_sessions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductIdeaResponse"},"title":"Response Get Brainstorm Sessions Api Ai Product Lab Product Brainstorm Sessions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-product-lab/product-brainstorm/sessions/{session_id}":{"get":{"tags":["ai-product-lab","Product Brainstorm"],"summary":"Get Brainstorm Session","description":"Get a specific brainstorming session.","operationId":"get_brainstorm_session_api_ai_product_lab_product_brainstorm_sessions__session_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductIdeaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ai-product-lab","Product Brainstorm"],"summary":"Delete Brainstorm Session","description":"Delete a brainstorming session.","operationId":"delete_brainstorm_session_api_ai_product_lab_product_brainstorm_sessions__session_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Session Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-product-lab/product-brainstorm/sessions/by-offering/{offering_id}":{"get":{"tags":["ai-product-lab","Product Brainstorm"],"summary":"Get Sessions By Offering","description":"Get brainstorming sessions for a specific product offering.","operationId":"get_sessions_by_offering_api_ai_product_lab_product_brainstorm_sessions_by_offering__offering_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Offering Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductIdeaResponse"},"title":"Response Get Sessions By Offering Api Ai Product Lab Product Brainstorm Sessions By Offering  Offering Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-product-lab/product-brainstorm/test":{"post":{"tags":["ai-product-lab","Product Brainstorm Test"],"summary":"Test Product Launch","description":"Start testing a product idea with AI personas.","operationId":"test_product_launch_api_ai_product_lab_product_brainstorm_test_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductLaunchTestRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductLaunchTestResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/ai-product-lab/product-brainstorm/test/{test_id}":{"get":{"tags":["ai-product-lab","Product Brainstorm Test"],"summary":"Get Test Results","description":"Get results of a product launch test with paginated persona responses.","operationId":"get_test_results_api_ai_product_lab_product_brainstorm_test__test_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"test_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Test Id"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductLaunchTestResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-product-lab/product-brainstorm/test/{test_id}/responses":{"get":{"tags":["ai-product-lab","Product Brainstorm Test"],"summary":"Get Test Persona Responses","description":"Get paginated persona responses for a product launch test.","operationId":"get_test_persona_responses_api_ai_product_lab_product_brainstorm_test__test_id__responses_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"test_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Test Id"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":10,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-product-lab/product-brainstorm/tests":{"get":{"tags":["ai-product-lab","Product Brainstorm Test"],"summary":"Get All Tests","description":"Get all product launch tests for the user's company profile.","operationId":"get_all_tests_api_ai_product_lab_product_brainstorm_tests_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"launch_session_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Launch Session Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductLaunchTestResult"},"title":"Response Get All Tests Api Ai Product Lab Product Brainstorm Tests Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-product-lab/product-brainstorm/test/{test_id}/heatmaps":{"get":{"tags":["ai-product-lab","Product Brainstorm Test"],"summary":"Get Test Heatmaps","description":"Get heatmap data for a product launch test.","operationId":"get_test_heatmaps_api_ai_product_lab_product_brainstorm_test__test_id__heatmaps_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"test_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Test Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-personas/personas":{"get":{"tags":["ai-personas"],"summary":"Get Personas","description":"Get AI personas for the current company profile with pagination.","operationId":"get_personas_api_ai_personas_personas_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter by specific product offering (None for company-wide)","title":"Product Offering Id"},"description":"Filter by specific product offering (None for company-wide)"},{"name":"target_group","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by target audience group","title":"Target Group"},"description":"Filter by target audience group"},{"name":"persona_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by persona type","title":"Persona Type"},"description":"Filter by persona type"},{"name":"persona_set_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter by specific persona set","title":"Persona Set Id"},"description":"Filter by specific persona set"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"description":"Number of personas to return","default":50,"title":"Limit"},"description":"Number of personas to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of personas to skip","default":0,"title":"Offset"},"description":"Number of personas to skip"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-personas/personas/groups":{"get":{"tags":["ai-personas"],"summary":"Get Persona Groups","description":"Get all target audience groups with persona counts.","operationId":"get_persona_groups_api_ai_personas_personas_groups_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter by specific product offering","title":"Product Offering Id"},"description":"Filter by specific product offering"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-personas/personas/generate":{"post":{"tags":["ai-personas"],"summary":"Generate Personas","description":"Generate AI personas for company or specific product offering.","operationId":"generate_personas_api_ai_personas_personas_generate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/routes__ai_personas__GeneratePersonasRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/ai-personas/personas/{persona_id}":{"delete":{"tags":["ai-personas"],"summary":"Delete Persona","description":"Delete (deactivate) a specific persona.","operationId":"delete_persona_api_ai_personas_personas__persona_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"persona_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Persona Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ai-personas/personas/bulk-delete":{"post":{"tags":["ai-personas"],"summary":"Bulk Delete Personas","description":"Delete multiple personas at once.","operationId":"bulk_delete_personas_api_ai_personas_personas_bulk_delete_post","requestBody":{"content":{"application/json":{"schema":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Persona Ids"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/marketing-wizard/product-offerings/{product_offering_id}/generate-pdp":{"post":{"tags":["marketing-wizard"],"summary":"Generate Product Description Page","description":"Start asynchronous PDP generation for a specific product offering.","operationId":"generate_product_description_page_api_marketing_wizard_product_offerings__product_offering_id__generate_pdp_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PDPGenerationRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/marketing-wizard/product-offerings/{product_offering_id}/pdps":{"get":{"tags":["marketing-wizard"],"summary":"List Product Description Pages","description":"Return previously generated PDPs for a product offering.","operationId":"list_product_description_pages_api_marketing_wizard_product_offerings__product_offering_id__pdps_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PDPHistoryItem"},"title":"Response List Product Description Pages Api Marketing Wizard Product Offerings  Product Offering Id  Pdps Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/marketing-wizard/product-offerings/{product_offering_id}/pdps/{pdp_id}":{"get":{"tags":["marketing-wizard"],"summary":"Get Product Description Page Detail","description":"Fetch a stored PDP generation for preview within the wizard.","operationId":"get_product_description_page_detail_api_marketing_wizard_product_offerings__product_offering_id__pdps__pdp_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}},{"name":"pdp_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Pdp Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PDPGenerationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/marketing-wizard/product-offerings/{product_offering_id}/pdps/{pdp_id}/download":{"get":{"tags":["marketing-wizard"],"summary":"Download Product Description Page Html","description":"Download a persisted PDP variant as a self-contained HTML bundle.","operationId":"download_product_description_page_html_api_marketing_wizard_product_offerings__product_offering_id__pdps__pdp_id__download_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_offering_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Offering Id"}},{"name":"pdp_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Pdp Id"}},{"name":"variant","in":"query","required":false,"schema":{"$ref":"#/components/schemas/PDPVariantType","default":"modern"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/marketing-wizard/intelligence/product/{product_id}":{"get":{"tags":["marketing-wizard"],"summary":"Get Product Intelligence","description":"Get market intelligence for a specific product\n\nArgs:\n    product_id: ID of the product\n    intelligence_type: Optional filter for intelligence type\n    limit: Maximum number of results\n    current_user: Authenticated user\n    db: Database session\n\nReturns:\n    Dictionary with grouped intelligence data","operationId":"get_product_intelligence_api_marketing_wizard_intelligence_product__product_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"product_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Product Id"}},{"name":"intelligence_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intelligence Type"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Product Intelligence Api Marketing Wizard Intelligence Product  Product Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/marketing-docs/gamma/deck/generate":{"post":{"tags":["marketing-docs"],"summary":"Generate Pitch Deck","description":"Reject new pitch deck generation while the feature is unavailable.","operationId":"generate_pitch_deck_api_marketing_docs_gamma_deck_generate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateDeckRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/marketing-docs/gamma/deck/status":{"get":{"tags":["marketing-docs"],"summary":"Get Pitch Deck Status","description":"Proxy status polling to Gamma. Frontend can poll every ~5s.\n\nFor now, we do on-demand polling per request. If needed we can later\npersist jobs and background-poll.","operationId":"get_pitch_deck_status_api_marketing_docs_gamma_deck_status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"doc_id","in":"query","required":true,"schema":{"type":"string","title":"Doc Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeckStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/marketing-docs/market-opportunity/generate":{"post":{"tags":["marketing-docs"],"summary":"Generate Market Opportunity Document","description":"Store one-run supporting files and start document generation.","operationId":"generate_market_opportunity_document_api_marketing_docs_market_opportunity_generate_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_generate_market_opportunity_document_api_marketing_docs_market_opportunity_generate_post"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/marketing-docs/gtm/generate":{"post":{"tags":["marketing-docs"],"summary":"Generate Gtm Document","description":"Reject new GTM generation while the feature is unavailable.","operationId":"generate_gtm_document_api_marketing_docs_gtm_generate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateGTMRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/marketing-docs/gamma/deck/download":{"get":{"tags":["marketing-docs"],"summary":"Download Pitch Deck","description":"Download the generated deck (pptx or pdf) by proxying Gamma file response.\n\nThis keeps the API key server-side and streams bytes to the client.","operationId":"download_pitch_deck_api_marketing_docs_gamma_deck_download_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"doc_id","in":"query","required":true,"schema":{"type":"string","title":"Doc Id"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"pptx","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ab-groups":{"get":{"tags":["ab-groups","ab-groups"],"summary":"List Ab Groups","operationId":"list_ab_groups_api_ab_groups_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ads_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ads Type"}},{"name":"status_filter","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Filter"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ABGroupResponse"},"title":"Response List Ab Groups Api Ab Groups Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["ab-groups","ab-groups"],"summary":"Create Ab Group","operationId":"create_ab_group_api_ab_groups_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ABGroupCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ABGroupDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ab-groups/{ab_group_id}":{"get":{"tags":["ab-groups","ab-groups"],"summary":"Get Ab Group","operationId":"get_ab_group_api_ab_groups__ab_group_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ab_group_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ab Group Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ABGroupDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["ab-groups","ab-groups"],"summary":"Update Ab Group","operationId":"update_ab_group_api_ab_groups__ab_group_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ab_group_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ab Group Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ABGroupUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ABGroupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["ab-groups","ab-groups"],"summary":"Delete Ab Group","operationId":"delete_ab_group_api_ab_groups__ab_group_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ab_group_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ab Group Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ab-groups/{ab_group_id}/metrics":{"get":{"tags":["ab-groups","ab-groups"],"summary":"Get Ab Group Metrics","operationId":"get_ab_group_metrics_api_ab_groups__ab_group_id__metrics_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ab_group_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ab Group Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ABGroupMetricsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ab-groups/{ab_group_id}/members":{"post":{"tags":["ab-groups","ab-groups"],"summary":"Add Members","operationId":"add_members_api_ab_groups__ab_group_id__members_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ab_group_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ab Group Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ABGroupAddMembersRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ABGroupDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ab-groups/{ab_group_id}/members/{ad_id}":{"delete":{"tags":["ab-groups","ab-groups"],"summary":"Remove Member","operationId":"remove_member_api_ab_groups__ab_group_id__members__ad_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ab_group_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ab Group Id"}},{"name":"ad_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ad Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ABGroupDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/ab-groups/{ab_group_id}/members/reorder":{"post":{"tags":["ab-groups","ab-groups"],"summary":"Reorder Members","operationId":"reorder_members_api_ab_groups__ab_group_id__members_reorder_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"ab_group_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Ab Group Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ABGroupReorderMembersRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ABGroupDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profiles/{company_profile_id}/mcp":{"get":{"tags":["assistant-settings"],"summary":"Get Profile Summary","operationId":"get_profile_summary_api_company_profiles__company_profile_id__mcp_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpProfileSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profiles/{company_profile_id}/mcp/policy":{"patch":{"tags":["assistant-settings"],"summary":"Update Profile Policy","operationId":"update_profile_policy_api_company_profiles__company_profile_id__mcp_policy_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpProfilePolicyUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpProfileSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profiles/{company_profile_id}/mcp/connections":{"get":{"tags":["assistant-settings"],"summary":"List Connections","operationId":"list_connections_api_company_profiles__company_profile_id__mcp_connections_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"scope","in":"query","required":false,"schema":{"enum":["mine","profile"],"type":"string","default":"mine","title":"Scope"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpConnections"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profiles/{company_profile_id}/mcp/connections/{connection_id}/revoke":{"post":{"tags":["assistant-settings"],"summary":"Revoke Profile Connection","operationId":"revoke_profile_connection_api_company_profiles__company_profile_id__mcp_connections__connection_id__revoke_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Connection Id"}},{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpMutationResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profiles/{company_profile_id}/mcp/activity":{"get":{"tags":["assistant-settings"],"summary":"List Activity","operationId":"list_activity_api_company_profiles__company_profile_id__mcp_activity_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Cursor"}},{"name":"scope","in":"query","required":false,"schema":{"enum":["mine","profile"],"type":"string","default":"mine","title":"Scope"}},{"name":"outcome","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Outcome"}},{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"From"}},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"To"}},{"name":"client_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Client Id"}},{"name":"actor_user_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Actor User Id"}},{"name":"action","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Action"}},{"name":"target","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Target"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpActivityPage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profiles/{company_profile_id}/mcp/activity/export":{"post":{"tags":["assistant-settings"],"summary":"Export Activity","operationId":"export_activity_api_company_profiles__company_profile_id__mcp_activity_export_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpActivityFilters"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpActivityExport"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/company-profiles/{company_profile_id}/mcp/activity/{event_id}":{"get":{"tags":["assistant-settings"],"summary":"Get Activity","operationId":"get_activity_api_company_profiles__company_profile_id__mcp_activity__event_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Event Id"}},{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpActivityDetail"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/programmatic/v1/hello":{"get":{"tags":["programmatic"],"summary":"Hello","operationId":"hello_api_programmatic_v1_hello_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/programmatic/v1/campaign-ideas":{"post":{"tags":["programmatic"],"summary":"Generate Campaign Ideas","operationId":"generate_campaign_ideas_api_programmatic_v1_campaign_ideas_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgrammaticCampaignIdeasRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgrammaticCampaignIdeasResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/programmatic/v1/campaign-ideas/generate":{"post":{"tags":["programmatic"],"summary":"Generate Campaigns From Ideas","operationId":"generate_campaigns_from_ideas_api_programmatic_v1_campaign_ideas_generate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgrammaticCampaignGenerationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgrammaticCampaignGenerationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/programmatic-keys":{"get":{"tags":["programmatic-keys"],"summary":"List Api Keys","operationId":"list_api_keys_api_programmatic_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyListResponse"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["programmatic-keys"],"summary":"Create Api Key For Profile","operationId":"create_api_key_for_profile_api_programmatic_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreateRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/programmatic-keys/{api_key_id}/revoke":{"post":{"tags":["programmatic-keys"],"summary":"Revoke Api Key","operationId":"revoke_api_key_api_programmatic_keys__api_key_id__revoke_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"api_key_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Api Key Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyRevokeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/programmatic-keys/{api_key_id}/usage":{"get":{"tags":["programmatic-keys"],"summary":"List Api Key Usage","operationId":"list_api_key_usage_api_programmatic_keys__api_key_id__usage_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"api_key_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Api Key Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyUsageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/chat/mention-targets":{"get":{"tags":["agentic-chat","agentic-chat"],"summary":"Mention Targets","description":"Return @mention autocomplete targets: teams and their active agents.\n\nGated by ENABLE_DIRECT_AGENT_CHAT feature flag.","operationId":"mention_targets_api_agentic_chat_mention_targets_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MentionTargetsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/conversations":{"post":{"tags":["conversations","conversations"],"summary":"Create Conversation","operationId":"create_conversation_api_conversations_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateConversation"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["conversations","conversations"],"summary":"List Conversations","operationId":"list_conversations_api_conversations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Page Size"}},{"name":"conversation_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/conversations/inbox-summary":{"get":{"tags":["conversations","conversations"],"summary":"Inbox Summary","description":"Closed-panel summary: unread count, newest unread, and the latest conversations.","operationId":"inbox_summary_api_conversations_inbox_summary_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"preview_limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":3,"title":"Preview Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/conversations/search":{"get":{"tags":["conversations","conversations"],"summary":"Search Conversation History","description":"Find the member's chats by title, visible message or saved-output text.","operationId":"search_conversation_history_api_conversations_search_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":160,"title":"Query"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Cursor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/conversations/events":{"get":{"tags":["conversations","conversations"],"summary":"Conversation Updates","description":"Stream the member's conversation events for the active brand.\n\nCommitted events publish a wake-up for the brand (conversation_platform.wakeups);\nthe stream then reads only what changed. A timed reconciliation read covers a\nlost wake-up and doubles as the keepalive.","operationId":"conversation_updates_api_conversations_events_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"after","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"After"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/conversations/{conversation_id}":{"get":{"tags":["conversations","conversations"],"summary":"Get Conversation","operationId":"get_conversation_api_conversations__conversation_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["conversations","conversations"],"summary":"Update Conversation","operationId":"update_conversation_api_conversations__conversation_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateConversation"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["conversations","conversations"],"summary":"Hide Conversation","description":"Remove the conversation from this person's lists and stop their tasks in it.\n\nOther members keep the conversation and their own tasks; erasure is separate.","operationId":"hide_conversation_api_conversations__conversation_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/conversations/{conversation_id}/messages":{"get":{"tags":["conversations","conversations"],"summary":"Get Messages","operationId":"get_messages_api_conversations__conversation_id__messages_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}},{"name":"after","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"After"}},{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Before"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/conversations/{conversation_id}/events":{"get":{"tags":["conversations","conversations"],"summary":"Get Events","operationId":"get_events_api_conversations__conversation_id__events_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}},{"name":"after","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"After"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/conversations/{conversation_id}/turns":{"post":{"tags":["conversations","conversations"],"summary":"Admit Turn","operationId":"admit_turn_api_conversations__conversation_id__turns_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/conversations/{conversation_id}/turns/{turn_id}":{"get":{"tags":["conversations","conversations"],"summary":"Get Turn","operationId":"get_turn_api_conversations__conversation_id__turns__turn_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}},{"name":"turn_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Turn Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/conversations/{conversation_id}/turns/{turn_id}/cancel":{"post":{"tags":["conversations","conversations"],"summary":"Cancel Turn","operationId":"cancel_turn_api_conversations__conversation_id__turns__turn_id__cancel_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}},{"name":"turn_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Turn Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/conversations/{conversation_id}/members":{"post":{"tags":["conversations","conversations"],"summary":"Add Member","operationId":"add_member_api_conversations__conversation_id__members_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddMember"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["conversations","conversations"],"summary":"Members","operationId":"members_api_conversations__conversation_id__members_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/conversations/{conversation_id}/members/me":{"patch":{"tags":["conversations","conversations"],"summary":"Update Member","operationId":"update_member_api_conversations__conversation_id__members_me_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberPreferences"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/conversations/{conversation_id}/members/me/read-cursor":{"put":{"tags":["conversations","conversations"],"summary":"Mark Read","operationId":"mark_read_api_conversations__conversation_id__members_me_read_cursor_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadCursor"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/conversations/{conversation_id}/messages/{message_id}/feedback":{"patch":{"tags":["conversations","conversations"],"summary":"Feedback","operationId":"feedback_api_conversations__conversation_id__messages__message_id__feedback_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}},{"name":"message_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Message Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feedback"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/conversations/{conversation_id}/attachments":{"post":{"tags":["conversations","conversations"],"summary":"Upload Attachments","operationId":"upload_attachments_api_conversations__conversation_id__attachments_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_attachments_api_conversations__conversation_id__attachments_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/conversations/{conversation_id}/eligible-members":{"get":{"tags":["conversations","conversations"],"summary":"Eligible Members","operationId":"eligible_members_api_conversations__conversation_id__eligible_members_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}},{"name":"query","in":"query","required":false,"schema":{"type":"string","maxLength":100,"default":"","title":"Query"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/conversations/{conversation_id}/members/{actor_id}":{"delete":{"tags":["conversations","conversations"],"summary":"Revoke Member","operationId":"revoke_member_api_conversations__conversation_id__members__actor_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}},{"name":"actor_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Actor Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/conversations/{conversation_id}/work/{work_id}":{"put":{"tags":["conversations","conversations"],"summary":"Share Saved Work","operationId":"share_saved_work_api_conversations__conversation_id__work__work_id__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}},{"name":"work_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Work Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkDisclosure"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["conversations","conversations"],"summary":"Unshare Saved Work","operationId":"unshare_saved_work_api_conversations__conversation_id__work__work_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}},{"name":"work_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Work Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/capabilities":{"get":{"tags":["marketing-work"],"summary":"Discover Capabilities","operationId":"discover_capabilities_api_agentic_capabilities_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1,"maxLength":500},{"type":"null"}],"title":"Query"}},{"name":"domain","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"title":"Domain"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":1,"default":12,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/front-door":{"get":{"tags":["marketing-work"],"summary":"Front Door","operationId":"front_door_api_agentic_front_door_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FrontDoorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/arrangements":{"get":{"tags":["marketing-work"],"summary":"Arrangements","description":"Everything Markee is handling on a schedule for this person and brand.","operationId":"arrangements_api_agentic_arrangements_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"finished_offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Finished Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArrangementListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/work":{"get":{"tags":["marketing-work"],"summary":"List Work","operationId":"list_work_api_agentic_work_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":1,"default":12,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Cursor"}},{"name":"disclosure_conversation_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Disclosure Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/work/{work_id}":{"get":{"tags":["marketing-work"],"summary":"Get Work","operationId":"get_work_api_agentic_work__work_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"work_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Work Id"}},{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"disclosure_conversation_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Disclosure Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkItemSnapshot"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/saved-emails/{source_kind}/{record_id}/body":{"get":{"tags":["marketing-work"],"summary":"Get Saved Email Body","operationId":"get_saved_email_body_api_agentic_saved_emails__source_kind___record_id__body_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source_kind","in":"path","required":true,"schema":{"enum":["marketing_email_campaign","crm_outreach_draft"],"type":"string","title":"Source Kind"}},{"name":"record_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Record Id"}},{"name":"version","in":"query","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedEmailBody"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/social-posts/{post_id}/body":{"get":{"tags":["marketing-work"],"summary":"Get Social Post Body","description":"The complete saved post a typed social preview names by ``body_href``,\nread through the native reader of saved posts.","operationId":"get_social_post_body_api_agentic_social_posts__post_id__body_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"post_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Post Id"}},{"name":"creative_state_token","in":"query","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Creative State Token"}},{"name":"schedule_state_token","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"type":"null"}],"title":"Schedule State Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SocialPostBody"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/read-artifacts/{receipt_id}/{artifact_index}":{"get":{"tags":["marketing-work"],"summary":"Get Read Artifact","operationId":"get_read_artifact_api_agentic_read_artifacts__receipt_id___artifact_index__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"receipt_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Receipt Id"}},{"name":"artifact_index","in":"path","required":true,"schema":{"type":"integer","title":"Artifact Index"}},{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"conversation_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadArtifactFocus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/work/{work_id}/actions":{"post":{"tags":["marketing-work"],"summary":"Control Work","operationId":"control_work_api_agentic_work__work_id__actions_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"work_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Work Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkControlRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkItemSnapshot"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/tasks/capability-check":{"post":{"tags":["agentic-tasks","agentic-tasks"],"summary":"Capability Check","operationId":"capability_check_api_agentic_tasks_capability_check_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Request"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTaskCapabilityResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/agentic/tasks":{"post":{"tags":["agentic-tasks","agentic-tasks"],"summary":"Create Agent Task","operationId":"create_agent_task_api_agentic_tasks_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTaskCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTaskResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["agentic-tasks","agentic-tasks"],"summary":"List Agent Tasks","operationId":"list_agent_tasks_api_agentic_tasks_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Profile Id"}},{"name":"conversation_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Conversation Id"}},{"name":"include_paused","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Paused"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTaskListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/tasks/{task_id}":{"patch":{"tags":["agentic-tasks","agentic-tasks"],"summary":"Patch Agent Task","operationId":"patch_agent_task_api_agentic_tasks__task_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Task Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTaskUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTaskResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["agentic-tasks","agentic-tasks"],"summary":"Delete Agent Task","operationId":"delete_agent_task_api_agentic_tasks__task_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Task Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/tasks/{task_id}/run-now":{"post":{"tags":["agentic-tasks","agentic-tasks"],"summary":"Run Task Now","operationId":"run_task_now_api_agentic_tasks__task_id__run_now_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Task Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTaskRunNowResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/tasks/{task_id}/runs":{"get":{"tags":["agentic-tasks","agentic-tasks"],"summary":"List Task Runs","operationId":"list_task_runs_api_agentic_tasks__task_id__runs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Task Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTaskRunListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/follow-ups/messages/{message_id}/source-articles":{"get":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Get Update Source Articles","operationId":"get_update_source_articles_api_agentic_follow_ups_messages__message_id__source_articles_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Message Id"}},{"name":"conversation_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}},{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceArticlesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/follow-ups/messages/{message_id}/article-view":{"get":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Get Update Article View","operationId":"get_update_article_view_api_agentic_follow_ups_messages__message_id__article_view_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Message Id"}},{"name":"conversation_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}},{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"action_reference","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":191,"pattern":"^[a-z][a-z0-9_.:-]{0,190}$","title":"Action Reference"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NativeArticleViewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/follow-ups/messages/{message_id}/observations":{"post":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Observe Intervention","operationId":"observe_intervention_api_agentic_follow_ups_messages__message_id__observations_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Message Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterventionObservationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InterventionObservationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/follow-ups/slack-consent":{"post":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Set Slack Proactive Consent","operationId":"set_slack_proactive_consent_api_agentic_follow_ups_slack_consent_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlackProactiveConsentRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/agentic/follow-ups/offers/{offer_id}/accept":{"post":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Accept Follow Up Offer","operationId":"accept_follow_up_offer_api_agentic_follow_ups_offers__offer_id__accept_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"offer_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Offer Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FollowUpAcceptRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/follow-ups/offers/{offer_id}/change-time":{"post":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Change Offer Time","operationId":"change_offer_time_api_agentic_follow_ups_offers__offer_id__change_time_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"offer_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Offer Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FollowUpDeferRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/follow-ups/offers/{offer_id}/dismiss":{"post":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Dismiss Follow Up Offer","operationId":"dismiss_follow_up_offer_api_agentic_follow_ups_offers__offer_id__dismiss_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"offer_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Offer Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FollowUpDismissRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/follow-ups/tasks/{task_id}/defer":{"post":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Defer Accepted Follow Up","operationId":"defer_accepted_follow_up_api_agentic_follow_ups_tasks__task_id__defer_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Task Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FollowUpDeferRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/follow-ups/tasks/{task_id}/cancel":{"post":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Cancel Accepted Follow Up","operationId":"cancel_accepted_follow_up_api_agentic_follow_ups_tasks__task_id__cancel_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Task Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FollowUpCancelRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/follow-ups/offers/{offer_id}/preference":{"post":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Set Follow Up Offer Preference","operationId":"set_follow_up_offer_preference_api_agentic_follow_ups_offers__offer_id__preference_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"offer_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Offer Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FollowUpPreferenceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/follow-ups/tasks/{task_id}/pause":{"post":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Pause Accepted Follow Up","operationId":"pause_accepted_follow_up_api_agentic_follow_ups_tasks__task_id__pause_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Task Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FollowUpCancelRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/follow-ups/tasks/{task_id}/resume":{"post":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Resume Accepted Follow Up","operationId":"resume_accepted_follow_up_api_agentic_follow_ups_tasks__task_id__resume_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Task Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FollowUpResumeRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/business-memory/understanding":{"get":{"tags":["business-memory"],"summary":"Read Understanding","description":"What Pomo understands about this brand, from the model's own context.\n\nThe saved notes below this are what the person told Pomo. This is what\nPomo worked out on its own, so the screen answers its own title.","operationId":"read_understanding_api_agentic_business_memory_understanding_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"work_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Work Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessUnderstanding"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/business-memory":{"get":{"tags":["business-memory"],"summary":"List Memories","operationId":"list_memories_api_agentic_business_memory_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"include_withdrawn","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Withdrawn"}},{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"work_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Work Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessMemoryPage"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["business-memory"],"summary":"Remember Memory","operationId":"remember_memory_api_agentic_business_memory_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"work_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Work Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessMemoryRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/business-memory/{memory_id}":{"get":{"tags":["business-memory"],"summary":"Get Memory","operationId":"get_memory_api_agentic_business_memory__memory_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"memory_id","in":"path","required":true,"schema":{"type":"string","title":"Memory Id"}},{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"work_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Work Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessMemoryRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["business-memory"],"summary":"Correct Memory","operationId":"correct_memory_api_agentic_business_memory__memory_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"memory_id","in":"path","required":true,"schema":{"type":"string","title":"Memory Id"}},{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"work_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Work Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryCorrection"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessMemoryRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/business-memory/{memory_id}/withdraw":{"post":{"tags":["business-memory"],"summary":"Withdraw Memory","operationId":"withdraw_memory_api_agentic_business_memory__memory_id__withdraw_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"memory_id","in":"path","required":true,"schema":{"type":"string","title":"Memory Id"}},{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"work_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Work Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryDecision"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessMemoryRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/business-memory/{memory_id}/accept":{"post":{"tags":["business-memory"],"summary":"Accept Memory","operationId":"accept_memory_api_agentic_business_memory__memory_id__accept_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"memory_id","in":"path","required":true,"schema":{"type":"string","title":"Memory Id"}},{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"work_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Work Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemoryDecision"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BusinessMemoryRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/follow-ups/active-updates-consent":{"get":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Read Active Updates Consent","operationId":"read_active_updates_consent_api_agentic_follow_ups_active_updates_consent_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Update Active Updates Consent","operationId":"update_active_updates_consent_api_agentic_follow_ups_active_updates_consent_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActiveUpdatesConsentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/follow-ups/director-consent":{"get":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Read Consent","operationId":"read_consent_api_agentic_follow_ups_director_consent_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"team_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Update Consent","operationId":"update_consent_api_agentic_follow_ups_director_consent_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectorConsentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/follow-ups/director-destinations":{"get":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Available Director Destinations","operationId":"available_director_destinations_api_agentic_follow_ups_director_destinations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"conversation_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/follow-ups/active-updates-destinations":{"get":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Available Director Destinations","operationId":"available_director_destinations_api_agentic_follow_ups_active_updates_destinations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"conversation_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/follow-ups/findings/{message_id}/dismiss":{"post":{"tags":["agentic-follow-through","agentic-follow-through"],"summary":"Dismiss Finding","operationId":"dismiss_finding_api_agentic_follow_ups_findings__message_id__dismiss_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Message Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindingDismissRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Create Team","operationId":"create_team_api_agentic_teams_post","security":[{"HTTPBearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["agentic-teams","agentic-teams"],"summary":"List Teams","operationId":"list_teams_api_agentic_teams_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Profile Id"}},{"name":"include_deleted","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Deleted"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/templates":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"List Team Templates","description":"Return the catalog of available team templates.","operationId":"list_team_templates_api_agentic_teams_templates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/api/agentic/teams/policy":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Team Policy","operationId":"get_team_policy_api_agentic_teams_policy_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Profile Id"}},{"name":"template_version","in":"query","required":false,"schema":{"type":"string","default":"data_intel_team","title":"Template Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamPolicyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/active":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Active Team","operationId":"get_active_team_api_agentic_teams_active_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamDetailResponse"},{"type":"null"}],"title":"Response Get Active Team Api Agentic Teams Active Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/fleet":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Team Fleet Snapshot","operationId":"get_team_fleet_snapshot_api_agentic_teams_fleet_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Profile Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":200,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by team status","title":"Status"},"description":"Filter by team status"},{"name":"blocked_only","in":"query","required":false,"schema":{"type":"boolean","description":"Include only blocked teams","default":false,"title":"Blocked Only"},"description":"Include only blocked teams"},{"name":"sort_by","in":"query","required":false,"schema":{"type":"string","description":"Sort key","default":"updated_at","title":"Sort By"},"description":"Sort key"},{"name":"sort_order","in":"query","required":false,"schema":{"type":"string","description":"Sort order (asc|desc)","default":"desc","title":"Sort Order"},"description":"Sort order (asc|desc)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamFleetSnapshotResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/overview":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Team Overview","description":"Return the complete morning-brief screen through one bounded read path.\n\nAsync cache coordination and cold-start assembly remain on the application's\nevent loop. Synchronous SQLAlchemy, Redis, and URL-signing phases in this\nread model are explicitly offloaded so they cannot create pod-wide\nhead-of-line blocking.","operationId":"get_team_overview_api_agentic_teams_overview_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"report_run_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Report Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamOverviewResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/workspace-init":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Team Workspace Init","operationId":"get_team_workspace_init_api_agentic_teams_workspace_init_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"organization_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Organization Id"}},{"name":"company_profile_id","in":"query","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"template_version","in":"query","required":false,"schema":{"type":"string","default":"data_intel_team","title":"Template Version"}},{"name":"include_workspace_data","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Workspace Data"}},{"name":"include_report_summary","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Report Summary"}},{"name":"include_presentation_daily_report","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Include Presentation Daily Report"}},{"name":"include_morning_brief","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Morning Brief"}},{"name":"include_team_detail","in":"query","required":false,"schema":{"type":"boolean","default":true,"title":"Include Team Detail"}},{"name":"report_run_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamWorkspaceInitResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/agents/{agent_id}":{"patch":{"tags":["agentic-teams","agentic-teams"],"summary":"Update Team Agent","operationId":"update_team_agent_api_agentic_teams__team_id__agents__agent_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Agent Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamAgentUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamAgentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}":{"patch":{"tags":["agentic-teams","agentic-teams"],"summary":"Update Team Settings","operationId":"update_team_settings_api_agentic_teams__team_id__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Team","operationId":"get_team_api_agentic_teams__team_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/control-snapshot":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Team Control Snapshot","description":"Read current card preflight state without synchronizing team policy.","operationId":"get_team_control_snapshot_api_agentic_teams__team_id__control_snapshot_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamControlSnapshotResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/interaction-policy":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Team Interaction Policy","operationId":"get_team_interaction_policy_api_agentic_teams__team_id__interaction_policy_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamInteractionPolicyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["agentic-teams","agentic-teams"],"summary":"Update Team Interaction Policy","operationId":"update_team_interaction_policy_api_agentic_teams__team_id__interaction_policy_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamInteractionPolicyUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamInteractionPolicyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/consult":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Consult Team Agent","operationId":"consult_team_agent_api_agentic_teams__team_id__consult_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamConsultRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamConsultResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/run-guidance":{"put":{"tags":["agentic-teams","agentic-teams"],"summary":"Save Team Run Guidance","description":"Save (or clear) the focus the team's next run should use.\n\nSaving never starts a run: the next run to start — scheduled or manual —\nconsumes the saved focus and clears it.","operationId":"save_team_run_guidance_api_agentic_teams__team_id__run_guidance_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamRunGuidanceSaveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamPendingRunGuidanceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/run-now":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Run Team Now","operationId":"run_team_now_api_agentic_teams__team_id__run_now_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamRunNowRequest"},{"type":"null"}],"title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamRunNowResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/pause":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Pause Team","operationId":"pause_team_api_agentic_teams__team_id__pause_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/resume":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Resume Team","operationId":"resume_team_api_agentic_teams__team_id__resume_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/start-fresh":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Start Team Fresh","operationId":"start_team_fresh_api_agentic_teams__team_id__start_fresh_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamStartFreshRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamStartFreshResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/runs":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"List Team Runs","operationId":"list_team_runs_api_agentic_teams__team_id__runs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamRunListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/runs/{run_id}/graph":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Team Run Graph","operationId":"get_team_run_graph_api_agentic_teams__team_id__runs__run_id__graph_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamRunGraphResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/runs/{run_id}/stop":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Stop Team Run","operationId":"stop_team_run_api_agentic_teams__team_id__runs__run_id__stop_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamRunStopRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamRunResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/runs/{run_id}/graph/intervene":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Intervene Team Run Graph Node","operationId":"intervene_team_run_graph_node_api_agentic_teams__team_id__runs__run_id__graph_intervene_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"run_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Run Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamRunNodeInterventionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamRunNodeInterventionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/events":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"List Team Events","operationId":"list_team_events_api_agentic_teams__team_id__events_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"run_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":200,"title":"Limit"}},{"name":"cursor_created_at","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cursor Created At"}},{"name":"cursor_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Cursor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamEventListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/messages":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"List Team Messages","operationId":"list_team_messages_api_agentic_teams__team_id__messages_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"run_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":200,"title":"Limit"}},{"name":"cursor_created_at","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cursor Created At"}},{"name":"cursor_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Cursor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamMessageListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/mission-feed":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"List Team Mission Feed","operationId":"list_team_mission_feed_api_agentic_teams__team_id__mission_feed_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"run_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":200,"title":"Limit"}},{"name":"cursor_created_at","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cursor Created At"}},{"name":"cursor_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamMissionFeedListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/insight-cards":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"List Team Insight Cards","operationId":"list_team_insight_cards_api_agentic_teams__team_id__insight_cards_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"report_run_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Report Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamInsightCardListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/insight-cards-history":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"List Team Insight Card History","description":"Every measured or closed thread, paginated and ordered explicitly.\n\nNo derivation pass here, unlike the list and detail reads: this page is\nthe record of what already happened, and re-deriving the open cards on\nevery page of it was a write on every read.","operationId":"list_team_insight_card_history_api_agentic_teams__team_id__insight_cards_history_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"activity","title":"Sort"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":25,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamInsightCardHistoryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/insight-cards/seen":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Mark Team Insight Cards Seen","description":"Stamp that this reader has now been shown the team's cards.\n\nThe card surfaces call this after they paint. It is a POST and not a side\neffect of the list GET on purpose: a read that stamped its own receipt\nwould mark every card seen on the same request that decided which ones\nwere new, and nothing would ever render as New.\n\nA read role is enough — looking at a page is not a content write.","operationId":"mark_team_insight_cards_seen_api_agentic_teams__team_id__insight_cards_seen_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamInsightCardSeenResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/insight-cards/by-key/{insight_key}":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Team Insight Card Detail By Key","description":"Resolve one Director authored key before the UI sees the native UUID.","operationId":"get_team_insight_card_detail_by_key_api_agentic_teams__team_id__insight_cards_by_key__insight_key__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"insight_key","in":"path","required":true,"schema":{"type":"string","title":"Insight Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamInsightCardDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/insight-cards/{card_id}":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Team Insight Card Detail","description":"One card in full, refreshed before it is read.\n\nThe refresh is the same one the list route runs, for the same reason and\nwith no second implementation: a plan step reports the state of the lane\nwork carrying it, and that state is re-read from the approval and action\nrows during derivation rather than pushed at the step when it changes. A\nread that skips the refresh therefore serves the step's last derived\nstatus, not its current one.\n\nIt has to be here as well as on the list, because this page is reachable\nwithout the list: the card link in a brief, a bookmark, or a reload lands\nstraight on this route. Approving a bundle in Campaigns and returning to\nthe card that asked for it left the checklist still saying \"waiting on\nyour approval\" for a decision already made.","operationId":"get_team_insight_card_detail_api_agentic_teams__team_id__insight_cards__card_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"card_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Card Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamInsightCardDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/insight-cards/{card_id}/feedback":{"put":{"tags":["agentic-teams","agentic-teams"],"summary":"Write Team Insight Card Feedback","description":"Save an observation without changing the insight or authorizing work.","operationId":"write_team_insight_card_feedback_api_agentic_teams__team_id__insight_cards__card_id__feedback_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"card_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Card Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamInsightCardFeedbackWriteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamInsightCardFeedbackSubjectResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/insight-cards/{card_id}/stance":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Set Team Insight Card Stance","description":"Record where the marketer stands on an insight: agree, dismiss, remove.\n\nOne endpoint for all three, because they are one thing — a view, recorded.\nNone of them hands work to a lane, and agreeing never answers an ask whose\napproving would reach a platform: that decision spends money or publishes,\nand it belongs to the control that says so.\n\nA stance can always be given and always be changed, including on a card\nwhose approval this system already inferred from work the reader started.\nThat case used to come back 400 \"Approval is already resolved\" — the\nreader was told they had agreed and then refused the right to disagree.","operationId":"set_team_insight_card_stance_api_agentic_teams__team_id__insight_cards__card_id__stance_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"card_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Card Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamInsightCardStanceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamInsightCardDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/insight-cards/{card_id}/remove":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Remove Team Insight Card","description":"Take an insight off the reader's queue.\n\nRemoving is a stance about the queue, not about the claim: the card leaves\nevery list, the home's ranked rows and the daily brief's decisions, and\nnothing else about it changes. A direct link still opens it and says it\nwas removed, and the history view still counts it. Repeating the call is a\nno-op.","operationId":"remove_team_insight_card_api_agentic_teams__team_id__insight_cards__card_id__remove_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"card_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Card Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamInsightCardDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/insight-cards/{card_id}/restore":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Restore Team Insight Card","description":"Put a removed or dismissed insight back where the reader can review it.\n\nThe undo behind the removal toast, and the way back for anyone who reaches\na removed card later by link. The card returns to the state its own rows\nsay it is in — the refresh re-derives it, measurement clock included — and\nits stance goes back to nothing recorded.","operationId":"restore_team_insight_card_api_agentic_teams__team_id__insight_cards__card_id__restore_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"card_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Card Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamInsightCardDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/insight-cards/{card_id}/close-early":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Close Team Insight Card Early","description":"End the card's measurement window now: readout_at is stamped to the\npresent and the results refresher resolves the card on the spot.","operationId":"close_team_insight_card_early_api_agentic_teams__team_id__insight_cards__card_id__close_early_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"card_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Card Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamInsightCardDetailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/workspace-bootstrap":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Team Workspace Bootstrap","operationId":"get_team_workspace_bootstrap_api_agentic_teams__team_id__workspace_bootstrap_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamWorkspaceBootstrapResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/reports/workspace":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Team Report Workspace","operationId":"get_team_report_workspace_api_agentic_teams__team_id__reports_workspace_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"section_key","in":"query","required":true,"schema":{"type":"string","description":"Report section key","title":"Section Key"},"description":"Report section key"},{"name":"report_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Report Id"}},{"name":"run_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Scope to a single agent-team run.","title":"Run Id"},"description":"Scope to a single agent-team run."},{"name":"states","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional comma-separated approval states for lifecycle-specific report views.","title":"States"},"description":"Optional comma-separated approval states for lifecycle-specific report views."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":3,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"include_linked","in":"query","required":false,"schema":{"type":"boolean","description":"Include linked recommendations and actions for detail views.","default":false,"title":"Include Linked"},"description":"Include linked recommendations and actions for detail views."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamReportWorkspaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/stream":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Stream Team Activity","operationId":"stream_team_activity_api_agentic_teams__team_id__stream_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"run_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO cursor timestamp to resume stream","title":"Cursor"},"description":"ISO cursor timestamp to resume stream"},{"name":"poll_seconds","in":"query","required":false,"schema":{"type":"number","maximum":5.0,"minimum":0.5,"default":1.5,"title":"Poll Seconds"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/recommendations":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"List Team Recommendations","operationId":"list_team_recommendations_api_agentic_teams__team_id__recommendations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"states","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated lifecycle states","title":"States"},"description":"Comma-separated lifecycle states"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamRecommendationListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/mmm/latest":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Latest Mmm Measurement","operationId":"get_latest_mmm_measurement_api_agentic_teams__team_id__mmm_latest_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Latest Mmm Measurement Api Agentic Teams  Team Id  Mmm Latest Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/mmm/reports":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"List Mmm Measurement Reports","operationId":"list_mmm_measurement_reports_api_agentic_teams__team_id__mmm_reports_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":3,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"run_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Scope to a single agent-team run.","title":"Run Id"},"description":"Scope to a single agent-team run."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Mmm Measurement Reports Api Agentic Teams  Team Id  Mmm Reports Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/search-readiness/reports":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"List Search Readiness Reports","operationId":"list_search_readiness_reports_api_agentic_teams__team_id__search_readiness_reports_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":3,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"run_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Scope to a single agent-team run.","title":"Run Id"},"description":"Scope to a single agent-team run."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Search Readiness Reports Api Agentic Teams  Team Id  Search Readiness Reports Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/search-readiness/summary":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Search Readiness Summary","operationId":"get_search_readiness_summary_api_agentic_teams__team_id__search_readiness_summary_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"window","in":"query","required":false,"schema":{"type":"integer","maximum":26,"minimum":2,"default":8,"title":"Window"}},{"name":"run_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Scope to a single agent-team run.","title":"Run Id"},"description":"Scope to a single agent-team run."},{"name":"compact","in":"query","required":false,"schema":{"type":"boolean","description":"Return only the aggregate report fields needed by dashboard cards.","default":false,"title":"Compact"},"description":"Return only the aggregate report fields needed by dashboard cards."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Search Readiness Summary Api Agentic Teams  Team Id  Search Readiness Summary Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/search-readiness/aeo-overview":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Search Readiness Aeo Overview","description":"Bounded AI Search snapshot. Does not include SEO history or answer text.","operationId":"get_search_readiness_aeo_overview_api_agentic_teams__team_id__search_readiness_aeo_overview_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"window","in":"query","required":false,"schema":{"type":"integer","maximum":26,"minimum":2,"default":12,"title":"Window"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Search Readiness Aeo Overview Api Agentic Teams  Team Id  Search Readiness Aeo Overview Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/search-readiness/seo-overview":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Search Readiness Seo Overview","description":"Bounded SEO snapshot. Does not include AEO reports.","operationId":"get_search_readiness_seo_overview_api_agentic_teams__team_id__search_readiness_seo_overview_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Search Readiness Seo Overview Api Agentic Teams  Team Id  Search Readiness Seo Overview Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/search-readiness/aeo-reports/{report_id}":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Search Readiness Aeo Report","operationId":"get_search_readiness_aeo_report_api_agentic_teams__team_id__search_readiness_aeo_reports__report_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"report_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Report Id"}},{"name":"answer_offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Answer Offset"}},{"name":"answer_limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":8,"title":"Answer Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Search Readiness Aeo Report Api Agentic Teams  Team Id  Search Readiness Aeo Reports  Report Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/search-readiness/aeo-reports/{report_id}/answers":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"List Search Readiness Aeo Answers","operationId":"list_search_readiness_aeo_answers_api_agentic_teams__team_id__search_readiness_aeo_reports__report_id__answers_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"report_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Report Id"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":1,"default":8,"title":"Limit"}},{"name":"answer_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Answer Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Search Readiness Aeo Answers Api Agentic Teams  Team Id  Search Readiness Aeo Reports  Report Id  Answers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/search-readiness/seo-reports/{snapshot_id}/sections/{section}":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Search Readiness Seo Section","operationId":"get_search_readiness_seo_section_api_agentic_teams__team_id__search_readiness_seo_reports__snapshot_id__sections__section__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"snapshot_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Snapshot Id"}},{"name":"section","in":"path","required":true,"schema":{"type":"string","title":"Section"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Search Readiness Seo Section Api Agentic Teams  Team Id  Search Readiness Seo Reports  Snapshot Id  Sections  Section  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/search-readiness/actions/{action_key}":{"put":{"tags":["agentic-teams","agentic-teams"],"summary":"Update Search Readiness Action Status","operationId":"update_search_readiness_action_status_api_agentic_teams__team_id__search_readiness_actions__action_key__put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"action_key","in":"path","required":true,"schema":{"type":"string","title":"Action Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AeoActionStatusUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Search Readiness Action Status Api Agentic Teams  Team Id  Search Readiness Actions  Action Key  Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/actions":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"List Team Actions","operationId":"list_team_actions_api_agentic_teams__team_id__actions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"statuses","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated action statuses","title":"Statuses"},"description":"Comma-separated action statuses"},{"name":"owner_agent_keys","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated owner agent keys","title":"Owner Agent Keys"},"description":"Comma-separated owner agent keys"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":200,"title":"Limit"}},{"name":"cursor_updated_at","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cursor Updated At"}},{"name":"cursor_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Cursor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamActionListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/actions/{action_id}/status":{"patch":{"tags":["agentic-teams","agentic-teams"],"summary":"Update Team Action Status","operationId":"update_team_action_status_api_agentic_teams__team_id__actions__action_id__status_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"action_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Action Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamActionStatusUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/actions/{action_id}/retry":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Retry Team Action Execution","operationId":"retry_team_action_execution_api_agentic_teams__team_id__actions__action_id__retry_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"action_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Action Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamActionRetryRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamActionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/goal-contract":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Team Goal Contract","operationId":"get_team_goal_contract_api_agentic_teams__team_id__goal_contract_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamGoalContractResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["agentic-teams","agentic-teams"],"summary":"Update Team Goal Contract","operationId":"update_team_goal_contract_api_agentic_teams__team_id__goal_contract_patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamGoalContractRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamGoalContractResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/goal-contract/result":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Record Team Goal Result","operationId":"record_team_goal_result_api_agentic_teams__team_id__goal_contract_result_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamGoalResultRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamGoalContractResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/daily-summaries":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"List Daily Summaries","operationId":"list_daily_summaries_api_agentic_teams__team_id__daily_summaries_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":30,"title":"Limit"}},{"name":"cursor_created_at","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cursor Created At"}},{"name":"cursor_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Cursor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamDailySummaryListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/digest-emails":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"List Team Digest Emails","description":"List a team's delivered daily digest emails.\n\nThe digest belongs to the company profile, not to whichever teammate the\nemail happened to be addressed to, so visibility is scoped to the team —\n``_get_team_or_404`` has already validated org + profile access — and never\nto ``recipient_user_id``.","operationId":"list_team_digest_emails_api_agentic_teams__team_id__digest_emails_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":30,"title":"Limit"}},{"name":"cursor_sent_at","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cursor Sent At"}},{"name":"cursor_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Cursor Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AITeamDigestEmailListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/digest-emails/{send_id}":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Team Digest Email","description":"Return a single delivered digest email's browser-renderable HTML.\n\nReadable by anyone with access to the team's company profile (see\n``list_team_digest_emails``); the team filter still blocks reads across\nprofiles. Signed image URLs nearing expiry are refreshed (and re-persisted)\nbefore the HTML is returned, so old digests keep rendering their creative\nthumbnails.","operationId":"get_team_digest_email_api_agentic_teams__team_id__digest_emails__send_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"send_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Send Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AITeamDigestEmailHtmlResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/commands":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Create Team Command","operationId":"create_team_command_api_agentic_teams__team_id__commands_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamCommandCreate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamCommandResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["agentic-teams","agentic-teams"],"summary":"List Team Commands","operationId":"list_team_commands_api_agentic_teams__team_id__commands_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamCommandListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/approvals":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"List Team Approvals","operationId":"list_team_approvals_api_agentic_teams__team_id__approvals_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"states","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Comma-separated approval states","title":"States"},"description":"Comma-separated approval states"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamApprovalListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/approvals/bulk-decision":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Decide Team Approvals Bulk","operationId":"decide_team_approvals_bulk_api_agentic_teams__team_id__approvals_bulk_decision_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamApprovalBulkDecisionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamApprovalBulkDecisionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/approvals/{approval_id}/items/{item_id}/generate":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Generate Team Approval Bundle Item","description":"Draft one item of a selectable bundle, leaving the rest of it open.\n\nThe bundle approval can be decided only once, so drafting a single story\nthrough the decision route would take the rest of the week's plan with it.","operationId":"generate_team_approval_bundle_item_api_agentic_teams__team_id__approvals__approval_id__items__item_id__generate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Approval Id"}},{"name":"item_id","in":"path","required":true,"schema":{"type":"string","title":"Item Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamBundleItemGenerationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/approvals/{approval_id}/items/{item_id}/skip":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Skip Team Approval Bundle Item","description":"Decline one item of a selectable bundle, leaving the rest of it open.","operationId":"skip_team_approval_bundle_item_api_agentic_teams__team_id__approvals__approval_id__items__item_id__skip_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Approval Id"}},{"name":"item_id","in":"path","required":true,"schema":{"type":"string","title":"Item Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamBundleItemSkipResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/approvals/{approval_id}/report-feedback":{"put":{"tags":["agentic-teams","agentic-teams"],"summary":"Write Team Report Feedback","description":"Record or retract feedback without changing the Reports decision.\n\nThe approval only locates the visible card.  The service independently\nresolves and verifies the exact action/recommendation subject before the\nappend-only evidence transaction is allowed to commit.","operationId":"write_team_report_feedback_api_agentic_teams__team_id__approvals__approval_id__report_feedback_put","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Approval Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamReportFeedbackWriteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamReportFeedbackSubjectResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/reports/claim-safety-notices/{approval_id}/response":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Write Team Claim Safety Notice Response","description":"Record an actor-scoped notice response without changing the decision.","operationId":"write_team_claim_safety_notice_response_api_agentic_teams__team_id__reports_claim_safety_notices__approval_id__response_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Approval Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamClaimSafetyNoticeWriteRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamClaimSafetyNoticeWriteResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/report-feedback-cues/claim":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Claim Team Report Feedback Cue","description":"Atomically claim one optional Reports feedback question.\n\nKeep this synchronous: source projection and cue policy use blocking\nSQLAlchemy, so FastAPI must dispatch the handler through its thread pool.","operationId":"claim_team_report_feedback_cue_api_agentic_teams__team_id__report_feedback_cues_claim_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamReportFeedbackCueClaimRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamReportFeedbackCueClaimResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/report-feedback-cues/{exposure_event_id}/disposition":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Disposition Team Report Feedback Cue","description":"Persist one actor-owned cue disposition without touching approvals.","operationId":"disposition_team_report_feedback_cue_api_agentic_teams__team_id__report_feedback_cues__exposure_event_id__disposition_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"exposure_event_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Exposure Event Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamReportFeedbackCueDispositionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamReportFeedbackCueDispositionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/approvals/{approval_id}/decision":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Decide Team Approval","operationId":"decide_team_approval_api_agentic_teams__team_id__approvals__approval_id__decision_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Approval Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamApprovalDecisionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamApprovalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/agent-reliability":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"List Team Agent Reliability","operationId":"list_team_agent_reliability_api_agentic_teams__team_id__agent_reliability_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AgentTeamAgentReliabilityResponse"},"title":"Response List Team Agent Reliability Api Agentic Teams  Team Id  Agent Reliability Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/learning/summary":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Get Team Learning Summary","operationId":"get_team_learning_summary_api_agentic_teams__team_id__learning_summary_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamLearningSummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/learning/notes/{category}":{"patch":{"tags":["agentic-teams","agentic-teams"],"summary":"Update Team Learning Note","operationId":"update_team_learning_note_api_agentic_teams__team_id__learning_notes__category__patch","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"category","in":"path","required":true,"schema":{"type":"string","title":"Category"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamLearningNoteUpdateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Team Learning Note Api Agentic Teams  Team Id  Learning Notes  Category  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/recommendations/{recommendation_id}/outcome":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Record Team Recommendation Outcome","operationId":"record_team_recommendation_outcome_api_agentic_teams__team_id__recommendations__recommendation_id__outcome_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"recommendation_id","in":"path","required":true,"schema":{"type":"string","title":"Recommendation Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamRecommendationOutcomeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamRecommendationOutcomeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/approvals/{approval_id}/customer-exclusion-review":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Renew Team Customer Exclusion Review","operationId":"renew_team_customer_exclusion_review_api_agentic_teams__team_id__approvals__approval_id__customer_exclusion_review_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Approval Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentTeamApprovalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/approvals/{approval_id}/launch-preview":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Preview Team Approval Launch","description":"What launching this approval would do, before the user commits.\n\nDeliberately a read: it is what a confirmation dialog draws, so it must be\nsafe to call while the user is still deciding.","operationId":"preview_team_approval_launch_api_agentic_teams__team_id__approvals__approval_id__launch_preview_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Approval Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/approvals/{approval_id}/launch":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Launch Team Approval","description":"Launch the ads this approval authorized.\n\nThe approval is the authorization, so this refuses to run on anything the\nuser has not approved. It performs the launch directly rather than resuming\nthe agent team: the decision is already made, and what remains - call the\nplatform, write down what happened - needs no model.","operationId":"launch_team_approval_api_agentic_teams__team_id__approvals__approval_id__launch_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Approval Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/approvals/{approval_id}/optimization-preview":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Preview Team Approval Optimization","description":"What applying this approval's optimizations would change.\n\nA pure read of the approval payload, like the launch preview: it is what the\nconfirmation dialog draws, so it must be safe to call while the user is\nstill deciding.","operationId":"preview_team_approval_optimization_api_agentic_teams__team_id__approvals__approval_id__optimization_preview_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Approval Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/approvals/{approval_id}/optimization":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Apply Team Approval Optimization","description":"Apply the optimizations this approval authorized.\n\nThe approval is the authorization, so this refuses anything the user has\nnot approved. It patches the campaigns directly rather than resuming the\nagent team: the decision is already made, and what remains - call the\nprovider, write down what happened - needs no model.","operationId":"apply_team_approval_optimization_api_agentic_teams__team_id__approvals__approval_id__optimization_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Approval Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamOptimizationApplyRequest"},{"type":"null"}],"title":"Request"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/approvals/{approval_id}/schedule-preview":{"get":{"tags":["agentic-teams","agentic-teams"],"summary":"Preview Team Approval Social Schedule","description":"When and where the approved social posts would go out.\n\nA read, like the ads launch preview: it is what the confirmation dialog\ndraws, so it must be safe to call while the user is still deciding.","operationId":"preview_team_approval_social_schedule_api_agentic_teams__team_id__approvals__approval_id__schedule_preview_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Approval Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/agentic/teams/{team_id}/approvals/{approval_id}/schedule":{"post":{"tags":["agentic-teams","agentic-teams"],"summary":"Schedule Team Approval Social","description":"Schedule the social posts this approval authorized, and record it.\n\nScheduling is the social counterpart of launching: the user has decided,\nand what remains - write the schedule rows, note what happened - needs no\nmodel. Posts publish later via the social schedule dispatcher.","operationId":"schedule_team_approval_social_api_agentic_teams__team_id__approvals__approval_id__schedule_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"team_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Team Id"}},{"name":"approval_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Approval Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/chat/agentic/async":{"post":{"tags":["agent-jobs","agent-jobs"],"summary":"Start Async Job","description":"Start an async job (returns immediately with job_id).\n\nJob runs in background. Client can monitor via SSE stream or poll status.\n\nPer Issue #271 specification.","operationId":"start_async_job_api_chat_agentic_async_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AsyncJobRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/chat/agentic/jobs/{job_id}/stream":{"get":{"tags":["agent-jobs","agent-jobs"],"summary":"Stream Job Progress","description":"SSE endpoint for real-time job progress.\n\nStream format:\n    event: started\n    data: {\"job_id\": \"...\", \"job_type\": \"...\", \"timestamp\": \"...\"}\n\n    event: progress\n    data: {\"step\": \"...\", \"message\": \"...\", \"progress\": 0.5}\n\n    event: completed\n    data: {\"job_id\": \"...\", \"result\": {...}, \"duration_seconds\": 45.2}\n\n    event: failed\n    data: {\"job_id\": \"...\", \"error\": \"...\", \"error_type\": \"...\"}\n\nPer Issue #271 specification.","operationId":"stream_job_progress_api_chat_agentic_jobs__job_id__stream_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"Last-Event-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last-Event-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/chat/agentic/jobs/{job_id}":{"get":{"tags":["agent-jobs","agent-jobs"],"summary":"Get Job Status","description":"Poll job status (for clients that don't want to use SSE).\n\nPer Issue #271 specification.","operationId":"get_job_status_api_chat_agentic_jobs__job_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobStatusResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/chat/agentic/jobs/{job_id}/cancel":{"post":{"tags":["agent-jobs","agent-jobs"],"summary":"Cancel Job","description":"Cancel a running job.\n\nReturns 204 No Content on success.","operationId":"cancel_job_api_chat_agentic_jobs__job_id__cancel_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/chat/agentic/jobs":{"get":{"tags":["agent-jobs","agent-jobs"],"summary":"List Jobs","description":"List user's jobs.\n\nFilters:\n- status: Optional filter by job status (running, completed, failed, cancelled)\n- limit: Maximum number of jobs (default 100, max 1000)\n\nReturns jobs sorted by created_at descending (most recent first).","operationId":"list_jobs_api_chat_agentic_jobs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by status","title":"Status"},"description":"Filter by status"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"description":"Maximum number of jobs to return","default":100,"title":"Limit"},"description":"Maximum number of jobs to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/feedback/bug-report":{"post":{"tags":["feedback"],"summary":"Submit a bug report with diagnostics","description":"Submit a bug report with sanitized browser diagnostics and an optional screenshot artifact.","operationId":"create_bug_report_api_feedback_bug_report_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Company-Profile-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Company-Profile-Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_create_bug_report_api_feedback_bug_report_post"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackBugReportResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/feedback":{"post":{"tags":["feedback"],"summary":"Submit user feedback","description":"Submit feedback including bug reports, feature requests, or general comments.","operationId":"create_feedback_api_feedback_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackCreate"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["feedback"],"summary":"List user's feedback","description":"Get a paginated list of the current user's feedback submissions.","operationId":"list_my_feedback_api_feedback_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Items per page","default":10,"title":"Page Size"},"description":"Items per page"},{"name":"feedback_type","in":"query","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/FeedbackType"},{"type":"null"}],"description":"Filter by feedback type","title":"Feedback Type"},"description":"Filter by feedback type"},{"name":"company_profile_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Filter by company profile","title":"Company Profile Id"},"description":"Filter by company profile"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/feedback/screenshot":{"post":{"tags":["feedback"],"summary":"Upload a screenshot for feedback","description":"Upload a screenshot image to attach to feedback submission.","operationId":"upload_screenshot_api_feedback_screenshot_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_screenshot_api_feedback_screenshot_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScreenshotUploadResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/feedback/{feedback_id}":{"get":{"tags":["feedback"],"summary":"Get feedback details","description":"Get details of a specific feedback submission.","operationId":"get_feedback_api_feedback__feedback_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"feedback_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Feedback Id"}},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/booking-config":{"get":{"tags":["contact-submissions"],"summary":"Get Booking Config","operationId":"get_booking_config_api_booking_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BookingConfigResponse"}}}}}}},"/api/contact-submissions":{"post":{"tags":["contact-submissions"],"summary":"Create Contact Submission","operationId":"create_contact_submission_api_contact_submissions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactSubmissionCreate"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/contact-submissions/{submission_id}/confirm-scheduling":{"post":{"tags":["contact-submissions"],"summary":"Confirm Demo Scheduling","description":"Send the appropriate demo email after the user interacts with the calendar.","operationId":"confirm_demo_scheduling_api_contact_submissions__submission_id__confirm_scheduling_post","parameters":[{"name":"submission_id","in":"path","required":true,"schema":{"type":"string","title":"Submission Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoSchedulingConfirmation"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/notifications/organization-inbox":{"get":{"tags":["notifications"],"summary":"Get Organization Notifications","description":"Get a merged notifications inbox for the current user in the active organization.","operationId":"get_organization_notifications_api_notifications_organization_inbox_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"unread_only","in":"query","required":false,"schema":{"type":"boolean","description":"Return only unread notifications","default":false,"title":"Unread Only"},"description":"Return only unread notifications"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum number of notifications","default":50,"title":"Limit"},"description":"Maximum number of notifications"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Offset for pagination","default":0,"title":"Offset"},"description":"Offset for pagination"},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Bypass the shared response cache","default":false,"title":"Force Refresh"},"description":"Bypass the shared response cache"},{"name":"X-Organization-Id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Organization-Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Organization Notifications Api Notifications Organization Inbox Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/notifications/company-profile/{company_profile_id}":{"get":{"tags":["notifications"],"summary":"Get Notifications","description":"Get notifications for a company profile.\n\nArgs:\n    company_profile_id: Company profile ID\n    unread_only: Whether to return only unread notifications\n    limit: Maximum number of notifications to return\n    offset: Offset for pagination\n    current_user: Current authenticated user\n    db: Database session\n\nReturns:\n    Dictionary with notifications, total count, and pagination info","operationId":"get_notifications_api_notifications_company_profile__company_profile_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"unread_only","in":"query","required":false,"schema":{"type":"boolean","description":"Return only unread notifications","default":false,"title":"Unread Only"},"description":"Return only unread notifications"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum number of notifications","default":50,"title":"Limit"},"description":"Maximum number of notifications"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Offset for pagination","default":0,"title":"Offset"},"description":"Offset for pagination"},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","description":"Bypass the shared response cache","default":false,"title":"Force Refresh"},"description":"Bypass the shared response cache"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Notifications Api Notifications Company Profile  Company Profile Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/notifications/{notification_id}/action":{"post":{"tags":["notifications"],"summary":"Apply Notification Action","description":"Apply an action (accepted/declined) to a notification.","operationId":"apply_notification_action_api_notifications__notification_id__action_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"notification_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Notification Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Payload"},"example":{"action":"accepted","payload":{"applied_at":"2024-05-20T10:00:00Z"}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Apply Notification Action Api Notifications  Notification Id  Action Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/notifications/{notification_id}/read":{"post":{"tags":["notifications"],"summary":"Mark Notification Read","description":"Mark a notification as read.\n\nArgs:\n    notification_id: Notification ID\n    current_user: Current authenticated user\n    db: Database session\n\nReturns:\n    Success status","operationId":"mark_notification_read_api_notifications__notification_id__read_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"notification_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Notification Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Mark Notification Read Api Notifications  Notification Id  Read Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/notifications/company-profile/{company_profile_id}/mark-all-read":{"post":{"tags":["notifications"],"summary":"Mark All Notifications Read","description":"Mark all notifications as read for a company profile.\nUses optimized bulk SQL operations.\n\nArgs:\n    company_profile_id: Company profile ID\n    current_user: Current authenticated user\n    db: Database session\n\nReturns:\n    Number of notifications marked as read","operationId":"mark_all_notifications_read_api_notifications_company_profile__company_profile_id__mark_all_read_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Mark All Notifications Read Api Notifications Company Profile  Company Profile Id  Mark All Read Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/notifications/company-profile/{company_profile_id}/unread-count":{"get":{"tags":["notifications"],"summary":"Get Unread Count","description":"Get count of unread notifications with multi-tab deduplication support.\n\nArgs:\n    company_profile_id: Company profile ID\n    session_id: Optional session ID for multi-tab deduplication\n    current_user: Current authenticated user\n    db: Database session\n\nReturns:\n    Count of unread notifications","operationId":"get_unread_count_api_notifications_company_profile__company_profile_id__unread_count_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"session_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Session ID for multi-tab deduplication","title":"Session Id"},"description":"Session ID for multi-tab deduplication"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Unread Count Api Notifications Company Profile  Company Profile Id  Unread Count Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/notifications/company-profile/{company_profile_id}/stats":{"get":{"tags":["notifications"],"summary":"Get Notification Stats","description":"Get notification delivery statistics for monitoring.\n\nArgs:\n    company_profile_id: Company profile ID\n    days: Number of days to look back\n    current_user: Current authenticated user\n    db: Database session\n\nReturns:\n    Delivery statistics","operationId":"get_notification_stats_api_notifications_company_profile__company_profile_id__stats_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"company_profile_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Company Profile Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":1,"description":"Number of days to look back","default":7,"title":"Days"},"description":"Number of days to look back"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Notification Stats Api Notifications Company Profile  Company Profile Id  Stats Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/revenue/daily":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get daily revenue by channel","description":"Returns daily revenue breakdown by vendor and channel (in-store, online, etc.)","operationId":"get_revenue_daily_api_udm_revenue_daily_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD). Defaults to 30 days ago.","title":"Start Date"},"description":"Start date (YYYY-MM-DD). Defaults to 30 days ago."},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD). Defaults to today.","title":"End Date"},"description":"End date (YYYY-MM-DD). Defaults to today."},{"name":"preset","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date preset: today, yesterday, last_7_days, last_30_days, this_month, last_month, this_quarter, year_to_date","title":"Preset"},"description":"Date preset: today, yesterday, last_7_days, last_30_days, this_month, last_month, this_quarter, year_to_date"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RevenueByChannelResponse"},"title":"Response Get Revenue Daily Api Udm Revenue Daily Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/revenue/summary":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get revenue summary","description":"Returns aggregated revenue metrics for the specified date range","operationId":"get_revenue_summary_api_udm_revenue_summary_get","security":[{"HTTPBearer":[]}],"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":"preset","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevenueSummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/ads/performance":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get daily ad performance","description":"Returns daily ad performance metrics by platform","operationId":"get_ad_performance_api_udm_ads_performance_get","security":[{"HTTPBearer":[]}],"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":"preset","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preset"}},{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by platform: meta, tiktok","title":"Platform"},"description":"Filter by platform: meta, tiktok"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdPerformanceResponse"},"title":"Response Get Ad Performance Api Udm Ads Performance Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/ads/roas":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get blended ROAS","description":"Returns blended ROAS across all advertising platforms","operationId":"get_blended_roas_api_udm_ads_roas_get","security":[{"HTTPBearer":[]}],"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":"preset","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlendedROASResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/customers/top":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get top customers","description":"Returns top customers by LTV or other metrics","operationId":"get_top_customers_api_udm_customers_top_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Number of customers to return","default":100,"title":"Limit"},"description":"Number of customers to return"},{"name":"order_by","in":"query","required":false,"schema":{"type":"string","description":"Sort by: ltv_cents, total_orders, total_spent_cents","default":"ltv_cents","title":"Order By"},"description":"Sort by: ltv_cents, total_orders, total_spent_cents"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CustomerSummaryResponse"},"title":"Response Get Top Customers Api Udm Customers Top Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/customers/quality-segments":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get customer quality segments","description":"Returns high-LTV, repeat, one-time, discount-heavy, at-risk, and lapsed customer segments.","operationId":"get_customer_quality_segments_api_udm_customers_quality_segments_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"source_vendor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional source vendor filter, e.g. shopify","title":"Source Vendor"},"description":"Optional source vendor filter, e.g. shopify"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Get Customer Quality Segments Api Udm Customers Quality Segments Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/customers/acquisition-quality":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get acquisition source quality","description":"Returns customer quality grouped by first observed Shopify source/UTM campaign.","operationId":"get_acquisition_source_quality_api_udm_customers_acquisition_quality_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":50,"title":"Limit"}},{"name":"order_by","in":"query","required":false,"schema":{"type":"string","default":"avg_ltv_cents","title":"Order By"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Get Acquisition Source Quality Api Udm Customers Acquisition Quality Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/customers/discount-quality":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get discount buyer quality","description":"Returns repeat/LTV outcomes for full-price, discount-exposed, and discount-heavy buyers.","operationId":"get_discount_buyer_quality_api_udm_customers_discount_quality_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response Get Discount Buyer Quality Api Udm Customers Discount Quality Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/udm/customers/geo-quality":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get customer geo quality","description":"Returns geography clusters for high-quality customer demand.","operationId":"get_customer_geo_quality_api_udm_customers_geo_quality_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"order_by","in":"query","required":false,"schema":{"type":"string","default":"avg_ltv_cents","title":"Order By"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Get Customer Geo Quality Api Udm Customers Geo Quality Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/customers/quality-pack":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get customer quality intelligence pack","description":"Returns customer segments, acquisition quality, discount buyer quality, product quality, and geo quality.","operationId":"get_customer_quality_pack_api_udm_customers_quality_pack_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Customer Quality Pack Api Udm Customers Quality Pack Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/products/quality":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get product quality","description":"Returns product and variant quality metrics tied to customer LTV, repeat behavior, and discounts.","operationId":"get_product_quality_api_udm_products_quality_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"order_by","in":"query","required":false,"schema":{"type":"string","default":"net_revenue_cents","title":"Order By"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Get Product Quality Api Udm Products Quality Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/customers/{customer_key}":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get customer 360 view","description":"Returns comprehensive view of a customer including orders, LTV, and segmentation","operationId":"get_customer_api_udm_customers__customer_key__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"customer_key","in":"path","required":true,"schema":{"type":"string","title":"Customer Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerSummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/cross-channel":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get cross-channel metrics","description":"Returns daily blended metrics combining revenue and ad spend","operationId":"get_cross_channel_metrics_api_udm_cross_channel_get","security":[{"HTTPBearer":[]}],"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":"preset","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CrossChannelMetricsResponse"},"title":"Response Get Cross Channel Metrics Api Udm Cross Channel Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/google-analytics/channel-inputs":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get GA4 Gold daily channel inputs","description":"Returns GA4-derived daily channel rows from the Gold MMM input table. These rows are refreshed by the UDM pipeline on its daily schedule.","operationId":"get_google_analytics_channel_inputs_api_udm_google_analytics_channel_inputs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"},{"name":"preset","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date preset","default":"last_30_days","title":"Preset"},"description":"Date preset"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20000,"minimum":1,"description":"Maximum Gold rows to return","default":500,"title":"Limit"},"description":"Maximum Gold rows to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Number of ordered Gold rows to skip","default":0,"title":"Offset"},"description":"Number of ordered Gold rows to skip"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GoogleAnalyticsChannelInputResponse"},"title":"Response Get Google Analytics Channel Inputs Api Udm Google Analytics Channel Inputs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/quickbooks/daily":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get daily QuickBooks financials","description":"Get daily QuickBooks financial metrics for the company.","operationId":"get_qb_daily_financials_api_udm_quickbooks_daily_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"},{"name":"preset","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date preset (last_7_days, last_30_days, etc.)","title":"Preset"},"description":"Date preset (last_7_days, last_30_days, etc.)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/QBDailyFinancialsResponse"},"title":"Response Get Qb Daily Financials Api Udm Quickbooks Daily Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/quickbooks/summary":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get QuickBooks summary for date range","description":"Get QuickBooks summary metrics for the company.","operationId":"get_qb_summary_api_udm_quickbooks_summary_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"},{"name":"preset","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date preset (last_7_days, last_30_days, etc.)","title":"Preset"},"description":"Date preset (last_7_days, last_30_days, etc.)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QBRangeSummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/quickbooks/customers":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get top customers from QuickBooks","description":"Get top customers by revenue from QuickBooks.","operationId":"get_qb_customers_api_udm_quickbooks_customers_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Number of customers to return","default":100,"title":"Limit"},"description":"Number of customers to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/QBCustomerSummaryResponse"},"title":"Response Get Qb Customers Api Udm Quickbooks Customers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/quickbooks/vendors":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get top vendors from QuickBooks","description":"Get top vendors by expense from QuickBooks.","operationId":"get_qb_vendors_api_udm_quickbooks_vendors_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Number of vendors to return","default":100,"title":"Limit"},"description":"Number of vendors to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/QBVendorSummaryResponse"},"title":"Response Get Qb Vendors Api Udm Quickbooks Vendors Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/quickbooks/products":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get sales by product from QuickBooks","description":"Get product-level sales from QuickBooks invoice lines.","operationId":"get_qb_sales_by_product_api_udm_quickbooks_products_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":1,"description":"Number of products to return","default":100,"title":"Limit"},"description":"Number of products to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/QBSalesByProductResponse"},"title":"Response Get Qb Sales By Product Api Udm Quickbooks Products Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/quickbooks/monthly":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get monthly QuickBooks financials with MoM trends","description":"Get monthly QuickBooks financials with month-over-month trends.","operationId":"get_qb_monthly_financials_api_udm_quickbooks_monthly_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_month","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Start month (YYYY-MM). Defaults to 12 months ago.","title":"Start Month"},"description":"Start month (YYYY-MM). Defaults to 12 months ago."},{"name":"end_month","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"End month (YYYY-MM). Defaults to current month.","title":"End Month"},"description":"End month (YYYY-MM). Defaults to current month."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/QBMonthlyFinancialsResponse"},"title":"Response Get Qb Monthly Financials Api Udm Quickbooks Monthly Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/quickbooks/marketing":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get marketing spend by category from QuickBooks","description":"Returns monthly marketing expense breakdown by category and entity type","operationId":"get_qb_marketing_by_category_api_udm_quickbooks_marketing_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_month","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Start month (YYYY-MM). Defaults to 12 months ago.","title":"Start Month"},"description":"Start month (YYYY-MM). Defaults to 12 months ago."},{"name":"end_month","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"End month (YYYY-MM). Defaults to current month.","title":"End Month"},"description":"End month (YYYY-MM). Defaults to current month."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/QBMarketingByCategoryResponse"},"title":"Response Get Qb Marketing By Category Api Udm Quickbooks Marketing Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/quickbooks/daily-full":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get full daily QuickBooks financials with all entity columns","description":"Get full daily QuickBooks financials with all entity-level columns.","operationId":"get_qb_daily_financials_full_api_udm_quickbooks_daily_full_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"},{"name":"preset","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date preset (last_7_days, last_30_days, etc.)","title":"Preset"},"description":"Date preset (last_7_days, last_30_days, etc.)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/QBDailyFinancialsFullResponse"},"title":"Response Get Qb Daily Financials Full Api Udm Quickbooks Daily Full Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/quickbooks/daily-marketing":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get daily marketing spend totals from QuickBooks","description":"Get daily marketing spend totals from QuickBooks.","operationId":"get_qb_daily_marketing_spend_api_udm_quickbooks_daily_marketing_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"},{"name":"preset","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date preset (last_7_days, last_30_days, etc.)","title":"Preset"},"description":"Date preset (last_7_days, last_30_days, etc.)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/QBDailyMarketingSpendResponse"},"title":"Response Get Qb Daily Marketing Spend Api Udm Quickbooks Daily Marketing Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/quickbooks/daily-marketing-by-category":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get daily marketing spend by category from QuickBooks","description":"Get daily marketing spend by category from QuickBooks.","operationId":"get_qb_daily_marketing_by_category_api_udm_quickbooks_daily_marketing_by_category_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"},{"name":"preset","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Date preset (last_7_days, last_30_days, etc.)","title":"Preset"},"description":"Date preset (last_7_days, last_30_days, etc.)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/QBDailyMarketingByCategoryResponse"},"title":"Response Get Qb Daily Marketing By Category Api Udm Quickbooks Daily Marketing By Category Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/quickbooks/date/{txn_date}":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get all QuickBooks transactions for a single date","description":"Get all QuickBooks transactions for a single date from Silver tables.","operationId":"get_qb_date_detail_api_udm_quickbooks_date__txn_date__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"txn_date","in":"path","required":true,"schema":{"type":"string","format":"date","title":"Txn Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/QBTransactionResponse"},"title":"Response Get Qb Date Detail Api Udm Quickbooks Date  Txn Date  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/square/daily-sales":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get daily Square sales metrics","description":"Get daily Square sales metrics for the company.","operationId":"get_sq_daily_sales_api_udm_square_daily_sales_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SQDailySalesResponse"},"title":"Response Get Sq Daily Sales Api Udm Square Daily Sales Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/square/daily-sales-by-location":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get daily Square sales by location","description":"Get daily Square sales broken down by location.","operationId":"get_sq_daily_sales_by_location_api_udm_square_daily_sales_by_location_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SQDailySalesByLocationResponse"},"title":"Response Get Sq Daily Sales By Location Api Udm Square Daily Sales By Location Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/square/summary":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get Square summary for date range","description":"Get Square summary metrics for the company.","operationId":"get_sq_summary_api_udm_square_summary_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SQRangeSummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/square/products":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get sales by product from Square","description":"Get product-level sales from Square.","operationId":"get_sq_products_api_udm_square_products_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Max products to return","default":50,"title":"Limit"},"description":"Max products to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SQProductSalesResponse"},"title":"Response Get Sq Products Api Udm Square Products Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/square/locations":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get sales by location from Square","description":"Get monthly location-level sales from Square.","operationId":"get_sq_locations_api_udm_square_locations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SQLocationSalesResponse"},"title":"Response Get Sq Locations Api Udm Square Locations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/square/date/{txn_date}":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get all Square transactions for a single date","description":"Get all Square transactions for a single date from Silver tables.","operationId":"get_sq_date_detail_api_udm_square_date__txn_date__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"txn_date","in":"path","required":true,"schema":{"type":"string","format":"date","title":"Txn Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SQTransactionResponse"},"title":"Response Get Sq Date Detail Api Udm Square Date  Txn Date  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/stripe/daily-sales":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get daily Stripe sales metrics","description":"Get daily Stripe sales metrics for the company.","operationId":"get_st_daily_sales_route_api_udm_stripe_daily_sales_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StripeDailySalesResponse"},"title":"Response Get St Daily Sales Route Api Udm Stripe Daily Sales Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/stripe/summary":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get Stripe summary for date range","description":"Get Stripe summary metrics for the company.","operationId":"get_st_summary_route_api_udm_stripe_summary_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StripeRangeSummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/klaviyo/daily-email-performance":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get daily Klaviyo email performance metrics","description":"Get daily Klaviyo email performance metrics for the company.","operationId":"get_kl_daily_email_performance_api_udm_klaviyo_daily_email_performance_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":true,"schema":{"type":"string","description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":true,"schema":{"type":"string","description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/KLDailyEmailPerformanceResponse"},"title":"Response Get Kl Daily Email Performance Api Udm Klaviyo Daily Email Performance Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/klaviyo/campaigns":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get Klaviyo campaign performance","description":"Get Klaviyo campaign performance metrics for the company.","operationId":"get_kl_campaigns_api_udm_klaviyo_campaigns_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":true,"schema":{"type":"string","description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":true,"schema":{"type":"string","description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Max campaigns to return","default":20,"title":"Limit"},"description":"Max campaigns to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/KLCampaignPerformanceResponse"},"title":"Response Get Kl Campaigns Api Udm Klaviyo Campaigns Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/klaviyo/flows":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get Klaviyo flow performance","description":"Get Klaviyo flow performance metrics for the company.","operationId":"get_kl_flows_api_udm_klaviyo_flows_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Max flows to return","default":20,"title":"Limit"},"description":"Max flows to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/KLFlowPerformanceResponse"},"title":"Response Get Kl Flows Api Udm Klaviyo Flows Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/klaviyo/lists":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get Klaviyo list growth metrics","description":"Get Klaviyo list growth metrics for the company.","operationId":"get_kl_lists_api_udm_klaviyo_lists_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":true,"schema":{"type":"string","description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":true,"schema":{"type":"string","description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/KLListGrowthResponse"},"title":"Response Get Kl Lists Api Udm Klaviyo Lists Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/klaviyo/summary":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get Klaviyo summary for date range","description":"Get Klaviyo summary metrics for the company.","operationId":"get_kl_summary_api_udm_klaviyo_summary_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":true,"schema":{"type":"string","description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":true,"schema":{"type":"string","description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KLRangeSummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/klaviyo/date/{date}":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get all Klaviyo events for a single date","description":"Get all Klaviyo events for a single date from Silver tables.","operationId":"get_kl_date_detail_api_udm_klaviyo_date__date__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"date","in":"path","required":true,"schema":{"type":"string","title":"Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/KLTransactionRowResponse"},"title":"Response Get Kl Date Detail Api Udm Klaviyo Date  Date  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/shopify/daily-sales":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get daily Shopify sales metrics","description":"Get daily Shopify sales metrics for the company.","operationId":"get_sh_daily_sales_api_udm_shopify_daily_sales_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SHDailySalesResponse"},"title":"Response Get Sh Daily Sales Api Udm Shopify Daily Sales Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/shopify/products":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get product catalog from Shopify","description":"Get product catalog from Shopify Silver tables.","operationId":"get_sh_products_api_udm_shopify_products_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Max products to return","default":100,"title":"Limit"},"description":"Max products to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SHProductCatalogResponse"},"title":"Response Get Sh Products Api Udm Shopify Products Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/shopify/customers":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get Shopify customer overview","description":"Get monthly customer overview from Shopify.","operationId":"get_sh_customers_api_udm_shopify_customers_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SHCustomerOverviewResponse"},"title":"Response Get Sh Customers Api Udm Shopify Customers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/shopify/fulfillment":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get Shopify fulfillment status","description":"Get daily fulfillment status from Shopify.","operationId":"get_sh_fulfillment_api_udm_shopify_fulfillment_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SHFulfillmentStatusResponse"},"title":"Response Get Sh Fulfillment Api Udm Shopify Fulfillment Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/shopify/summary":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get Shopify summary for date range","description":"Get Shopify summary metrics for the company.","operationId":"get_sh_summary_api_udm_shopify_summary_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"start_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Start date (YYYY-MM-DD)","title":"Start Date"},"description":"Start date (YYYY-MM-DD)"},{"name":"end_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"End date (YYYY-MM-DD)","title":"End Date"},"description":"End date (YYYY-MM-DD)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SHRangeSummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/udm/shopify/date/{txn_date}":{"get":{"tags":["udm","Unified Data Model"],"summary":"Get all Shopify orders for a single date","description":"Get all Shopify orders for a single date from Silver tables.","operationId":"get_sh_date_detail_api_udm_shopify_date__txn_date__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"txn_date","in":"path","required":true,"schema":{"type":"string","format":"date","title":"Txn Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SHTransactionResponse"},"title":"Response Get Sh Date Detail Api Udm Shopify Date  Txn Date  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/robots.txt":{"get":{"summary":"Robots Txt","description":"Serve robots.txt for search engine crawlers","operationId":"robots_txt_robots_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/llms.txt":{"get":{"summary":"Llms Txt","description":"Serve llms.txt for AI crawlers and LLMs","operationId":"llms_txt_llms_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/sitemap.xml":{"get":{"summary":"Sitemap Xml","description":"Serve sitemap.xml for search engines","operationId":"sitemap_xml_sitemap_xml_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/live":{"get":{"summary":"Liveness Check","description":"Kubernetes liveness probe - is the process alive?\n\nThis should always succeed if the process is running.\nFailing this causes container restart.","operationId":"liveness_check_health_live_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/ready":{"get":{"summary":"Readiness Check","description":"Kubernetes readiness probe - can the app accept traffic?\n\nChecks database connectivity and auth configuration. Failing\nthis removes the pod from the service load balancer.","operationId":"readiness_check_health_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health Check","description":"Standard health check for load balancers.\n\nQuick check that the app can respond and database is accessible.\nIncludes database latency and pool utilization.","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/detailed":{"get":{"summary":"Detailed Health Check","description":"Detailed health check for debugging and monitoring.\n\nComprehensive check of all system components:\n- Database connectivity and latency\n- Connection pool status\n- Critical tables existence\n- Redis connectivity and latency","operationId":"detailed_health_check_health_detailed_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/health/database":{"get":{"summary":"Database Health Check","description":"Database-specific health check.\n\nProvides detailed information about the database status,\nincluding connection pool statistics and configuration.","operationId":"database_health_check_health_database_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/test-logging":{"get":{"summary":"Test Logging","description":"Test endpoint to verify request ID logging is working.\nThis will log messages with the request ID and user ID.","operationId":"test_logging_test_logging_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/health/events":{"get":{"summary":"Check Event System Health","description":"Check health of the event system","operationId":"check_event_system_health_health_events_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/events/redis":{"get":{"summary":"Check Redis Health","description":"Check Redis connectivity","operationId":"check_redis_health_health_events_redis_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health/events/sse":{"get":{"summary":"Check Sse Health","description":"Check SSE connections","operationId":"check_sse_health_health_events_sse_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"ABGroupAddMembersRequest":{"properties":{"ad_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Ad Ids"}},"type":"object","required":["ad_ids"],"title":"ABGroupAddMembersRequest"},"ABGroupCreateRequest":{"properties":{"name":{"type":"string","title":"Name"},"ads_type":{"type":"string","title":"Ads Type","description":"Canonical ads type key, e.g., google_display"},"ad_ids":{"anyOf":[{"items":{"type":"string","format":"uuid"},"type":"array"},{"type":"null"}],"title":"Ad Ids","description":"Initial member Ad IDs for the given type"},"settings":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Settings"}},"type":"object","required":["name","ads_type"],"title":"ABGroupCreateRequest"},"ABGroupDetailResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"ads_type":{"type":"string","title":"Ads Type"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"settings":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Settings"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"member_count":{"type":"integer","title":"Member Count"},"members":{"items":{"$ref":"#/components/schemas/ABGroupMemberResponse"},"type":"array","title":"Members"}},"type":"object","required":["id","name","ads_type","member_count","members"],"title":"ABGroupDetailResponse"},"ABGroupMemberResponse":{"properties":{"ad_id":{"type":"string","format":"uuid","title":"Ad Id"},"position":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Position"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"type":"object","required":["ad_id"],"title":"ABGroupMemberResponse"},"ABGroupMetricsResponse":{"properties":{"summary":{"$ref":"#/components/schemas/ABGroupMetricsSummary"},"trends":{"items":{"$ref":"#/components/schemas/ABGroupMetricsTrend"},"type":"array","title":"Trends"},"variants":{"additionalProperties":{"$ref":"#/components/schemas/ABGroupMetricsSummary"},"type":"object","title":"Variants"},"per_variant_trends":{"additionalProperties":{"items":{"$ref":"#/components/schemas/ABGroupMetricsTrend"},"type":"array"},"type":"object","title":"Per Variant Trends"},"variant_labels":{"additionalProperties":{"type":"string"},"type":"object","title":"Variant Labels"}},"type":"object","required":["summary","trends","variants"],"title":"ABGroupMetricsResponse"},"ABGroupMetricsSummary":{"properties":{"impressions":{"type":"integer","title":"Impressions","default":0},"clicks":{"type":"integer","title":"Clicks","default":0},"cost_micros":{"type":"integer","title":"Cost Micros","default":0},"conversions":{"type":"number","title":"Conversions","default":0.0},"video_views":{"type":"integer","title":"Video Views","default":0},"ctr":{"type":"number","title":"Ctr","default":0.0},"average_cpc":{"type":"number","title":"Average Cpc","default":0.0},"cost_per_conversion":{"type":"number","title":"Cost Per Conversion","default":0.0}},"type":"object","title":"ABGroupMetricsSummary"},"ABGroupMetricsTrend":{"properties":{"date":{"type":"string","title":"Date"},"impressions":{"type":"integer","title":"Impressions"},"clicks":{"type":"integer","title":"Clicks"},"cost_micros":{"type":"integer","title":"Cost Micros"}},"type":"object","required":["date","impressions","clicks","cost_micros"],"title":"ABGroupMetricsTrend"},"ABGroupReorderMembersRequest":{"properties":{"ordered_ad_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Ordered Ad Ids"}},"type":"object","required":["ordered_ad_ids"],"title":"ABGroupReorderMembersRequest"},"ABGroupResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"ads_type":{"type":"string","title":"Ads Type"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"settings":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Settings"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"member_count":{"type":"integer","title":"Member Count"}},"type":"object","required":["id","name","ads_type","member_count"],"title":"ABGroupResponse"},"ABGroupUpdateRequest":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","description":"draft|active|paused|ended"},"settings":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Settings"}},"type":"object","title":"ABGroupUpdateRequest"},"ABTestConfig":{"properties":{"test_type":{"type":"string","pattern":"^(subject_line|content|send_time|from_name|multivariate)$","title":"Test Type"},"test_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Test Name"},"test_size":{"type":"number","maximum":50.0,"minimum":5.0,"title":"Test Size","default":20.0},"winner_metric":{"type":"string","pattern":"^(open_rate|click_rate|conversion_rate)$","title":"Winner Metric","default":"click_rate"},"duration_hours":{"type":"integer","maximum":168.0,"minimum":1.0,"title":"Duration Hours","default":24},"auto_select":{"type":"boolean","title":"Auto Select","default":true},"min_sample_size":{"type":"integer","minimum":50.0,"title":"Min Sample Size","default":100},"variants":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Variants"}},"type":"object","required":["test_type","variants"],"title":"ABTestConfig","description":"A/B test configuration"},"AICampaignAssetReference":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"gallery_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gallery Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"media_url":{"type":"string","title":"Media Url"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"media_type":{"type":"string","enum":["image","video"],"title":"Media Type","default":"image"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"source_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Type"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"duration":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Duration"}},"type":"object","required":["media_url"],"title":"AICampaignAssetReference"},"AICampaignFromIntelligenceRequest":{"properties":{"source_type":{"type":"string","enum":["trend","social_summary","ads_winner","asset_set"],"title":"Source Type"},"preferred_mode":{"type":"string","enum":["auto","ads_campaign","social_post_campaign"],"title":"Preferred Mode","default":"auto"},"source_payload":{"$ref":"#/components/schemas/AICampaignSourcePayload"}},"type":"object","required":["source_type","source_payload"],"title":"AICampaignFromIntelligenceRequest"},"AICampaignOfferingSuggestionResponse":{"properties":{"selected_offering_id":{"type":"string","title":"Selected Offering Id"},"selected_offering_reason":{"type":"string","title":"Selected Offering Reason"}},"type":"object","required":["selected_offering_id","selected_offering_reason"],"title":"AICampaignOfferingSuggestionResponse"},"AICampaignReference":{"properties":{"title":{"type":"string","title":"Title"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"}},"type":"object","required":["title"],"title":"AICampaignReference"},"AICampaignRelevantProduct":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"}},"type":"object","required":["id","name"],"title":"AICampaignRelevantProduct"},"AICampaignSourcePayload":{"properties":{"title":{"type":"string","title":"Title"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"recommendation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recommendation"},"user_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Prompt"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"confirmed_offering_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confirmed Offering Id"},"locations":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Locations"},"raw_ids":{"additionalProperties":true,"type":"object","title":"Raw Ids"},"references":{"items":{"$ref":"#/components/schemas/AICampaignReference"},"type":"array","title":"References"},"relevant_products":{"items":{"$ref":"#/components/schemas/AICampaignRelevantProduct"},"type":"array","title":"Relevant Products"},"assets":{"items":{"$ref":"#/components/schemas/AICampaignAssetReference"},"type":"array","title":"Assets"},"trend_context":{"anyOf":[{"$ref":"#/components/schemas/AICampaignTrendContext"},{"type":"null"}]},"social_context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Social Context"}},"type":"object","required":["title"],"title":"AICampaignSourcePayload"},"AICampaignTrendContext":{"properties":{"trend_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trend Title"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"analysis_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Analysis Summary"},"priority_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority Label"},"trend_keywords":{"items":{"type":"string"},"type":"array","title":"Trend Keywords"},"supporting_keywords":{"items":{"type":"string"},"type":"array","title":"Supporting Keywords"},"signal_points":{"items":{"type":"string"},"type":"array","title":"Signal Points"},"recommendation_points":{"items":{"type":"string"},"type":"array","title":"Recommendation Points"},"relevant_product_names":{"items":{"type":"string"},"type":"array","title":"Relevant Product Names"},"source_examples":{"items":{"$ref":"#/components/schemas/AICampaignTrendSourceExample"},"type":"array","title":"Source Examples"}},"type":"object","title":"AICampaignTrendContext"},"AICampaignTrendSourceExample":{"properties":{"title":{"type":"string","title":"Title"},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subtitle"},"metric":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"}},"type":"object","required":["title"],"title":"AICampaignTrendSourceExample"},"AIPersonaCreate":{"properties":{"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"demographics":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Demographics"},"interests":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Interests"},"behaviors":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Behaviors"},"pain_points":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Pain Points"},"goals":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Goals"},"preferred_channels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Preferred Channels"},"company_profile_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Profile Id"}},"type":"object","required":["name"],"title":"AIPersonaCreate"},"AIPersonaResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"demographics":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Demographics"},"interests":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Interests"},"behaviors":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Behaviors"},"pain_points":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Pain Points"},"goals":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Goals"},"preferred_channels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Preferred Channels"},"is_active":{"type":"boolean","title":"Is Active"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","description","demographics","behaviors","is_active","created_at","updated_at"],"title":"AIPersonaResponse"},"AITeamDigestEmailHighlights":{"properties":{"recommendation_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Recommendation Count"},"decision_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Decision Count"},"ads_draft_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ads Draft Count"},"social_draft_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Social Draft Count"}},"type":"object","title":"AITeamDigestEmailHighlights","description":"Compact per-digest activity counts for the history rail glance line."},"AITeamDigestEmailHtmlResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject"},"sent_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Sent At"},"summary_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary Date"},"highlights":{"anyOf":[{"$ref":"#/components/schemas/AITeamDigestEmailHighlights"},{"type":"null"}]},"rendered_html":{"type":"string","title":"Rendered Html"}},"type":"object","required":["id","rendered_html"],"title":"AITeamDigestEmailHtmlResponse","description":"A single delivered digest plus its browser-renderable HTML body."},"AITeamDigestEmailListItem":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject"},"sent_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Sent At"},"summary_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary Date"},"highlights":{"anyOf":[{"$ref":"#/components/schemas/AITeamDigestEmailHighlights"},{"type":"null"}]}},"type":"object","required":["id"],"title":"AITeamDigestEmailListItem","description":"One delivered daily digest email available for in-app re-display."},"AITeamDigestEmailListResponse":{"properties":{"digests":{"items":{"$ref":"#/components/schemas/AITeamDigestEmailListItem"},"type":"array","title":"Digests"},"total":{"type":"integer","title":"Total"},"has_more":{"type":"boolean","title":"Has More","default":false},"next_cursor_sent_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Cursor Sent At"},"next_cursor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Next Cursor Id"}},"type":"object","required":["digests","total"],"title":"AITeamDigestEmailListResponse"},"AITestRequest":{"properties":{"ad_id":{"type":"string","title":"Ad Id"},"ad_platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Platform"},"persona_ids":{"anyOf":[{"items":{"type":"string","format":"uuid"},"type":"array"},{"type":"null"}],"title":"Persona Ids"},"audience_groups":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Audience Groups"},"target_audience_data":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Target Audience Data"},"persona_set_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Persona Set Id"}},"type":"object","required":["ad_id"],"title":"AITestRequest"},"AITestSessionResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"session_id":{"type":"string","format":"uuid","title":"Session Id"},"persona_ids":{"anyOf":[{"items":{"type":"string","format":"uuid"},"type":"array"},{"type":"null"}],"title":"Persona Ids"},"summary":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Summary"},"overall_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Overall Score"},"status":{"type":"string","title":"Status"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"test_results":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Test Results","default":[]},"pagination":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pagination"}},"type":"object","required":["id","session_id","persona_ids","summary","overall_score","status","started_at","completed_at","created_at"],"title":"AITestSessionResponse"},"AbandonUnknownRequest":{"properties":{"idempotency_key":{"type":"string","maxLength":255,"minLength":8,"title":"Idempotency Key"},"reason":{"type":"string","maxLength":255,"minLength":1,"title":"Reason"}},"type":"object","required":["idempotency_key","reason"],"title":"AbandonUnknownRequest"},"AcceptInvitationRequest":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"tos_hash":{"type":"string","title":"Tos Hash"},"tos_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tos Version"},"invite_token":{"type":"string","title":"Invite Token"}},"type":"object","required":["tos_hash","invite_token"],"title":"AcceptInvitationRequest"},"AcceptInvitationResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id"},"organization_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"},"organization_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Name"},"is_new_user":{"type":"boolean","title":"Is New User","default":false},"on_waitlist":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"On Waitlist","default":false}},"type":"object","required":["success","message"],"title":"AcceptInvitationResponse","description":"Response from accept invitation endpoint."},"AcceptInvitationSessionRequest":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"tos_hash":{"type":"string","title":"Tos Hash"},"tos_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tos Version"},"invitation_id":{"type":"string","format":"uuid","title":"Invitation Id"}},"type":"object","required":["tos_hash","invitation_id"],"title":"AcceptInvitationSessionRequest"},"AccountReportSubject":{"properties":{"kind":{"type":"string","const":"account_report","title":"Kind","default":"account_report"},"integration_id":{"type":"string","format":"uuid","title":"Integration Id"},"platform":{"type":"string","maxLength":40,"minLength":1,"title":"Platform"},"account_id":{"type":"string","maxLength":200,"minLength":1,"title":"Account Id"},"generated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Generated At"},"evidence_hash":{"anyOf":[{"type":"string","maxLength":64,"minLength":64},{"type":"null"}],"title":"Evidence Hash"},"source_job_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Job Id"},"approval_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Approval Id"},"approval_version":{"anyOf":[{"type":"string","maxLength":64,"minLength":64},{"type":"null"}],"title":"Approval Version"},"selected_campaign_id":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Selected Campaign Id"},"selected_option_id":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Selected Option Id"}},"additionalProperties":false,"type":"object","required":["integration_id","platform","account_id"],"title":"AccountReportSubject","description":"Untrusted pointer to the native, latest account-report snapshot.\n\nThe report payload is deliberately absent. Core rereads the native\nintegration row and binds the selected generation/evidence before the\nruntime sees this subject."},"ActionAvailabilityReason":{"type":"string","enum":["preparation_failed"],"title":"ActionAvailabilityReason","description":"Closed customer-safe reason an action is not available."},"ActiveLeadFormEditRequest":{"properties":{"config_schema_version":{"type":"integer","const":1,"title":"Config Schema Version"},"config":{"$ref":"#/components/schemas/GoogleLeadFormConfigV1"},"base_revision":{"type":"integer","minimum":1.0,"title":"Base Revision"}},"additionalProperties":false,"type":"object","required":["config_schema_version","config","base_revision"],"title":"ActiveLeadFormEditRequest","description":"Reviewed post-launch edit bound to the applied canonical revision."},"ActiveUpdatesConsentRequest":{"properties":{"version":{"type":"integer","const":2,"title":"Version"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"enabled":{"type":"boolean","title":"Enabled"},"source_families":{"items":{"type":"string","const":"director_insights"},"type":"array","maxItems":1,"title":"Source Families"},"conversation_mode":{"type":"string","enum":["selected_conversation","per_opportunity"],"title":"Conversation Mode","default":"selected_conversation"},"delivery":{"oneOf":[{"$ref":"#/components/schemas/DirectorWebDelivery"},{"$ref":"#/components/schemas/DirectorSlackDelivery"}],"title":"Delivery","discriminator":{"propertyName":"surface","mapping":{"both":"#/components/schemas/DirectorSlackDelivery","web":"#/components/schemas/DirectorWebDelivery"}}}},"additionalProperties":false,"type":"object","required":["version","organization_id","company_profile_id","conversation_id","enabled","source_families"],"title":"ActiveUpdatesConsentRequest"},"AdAccountCard":{"properties":{"platform":{"type":"string","title":"Platform"},"platform_label":{"type":"string","title":"Platform Label"},"integration_id":{"type":"string","title":"Integration Id"},"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"activated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Activated At"},"report_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Status"},"report_step":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Step"},"report_steps":{"items":{"type":"string"},"type":"array","title":"Report Steps"},"requested_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Requested At"},"generated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generated At"},"findings_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Findings Status"},"account_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account State"},"headline":{"items":{"$ref":"#/components/schemas/AdAccountHeadlineTile"},"type":"array","title":"Headline"},"findings_summary":{"anyOf":[{"$ref":"#/components/schemas/AdAccountFindingsSummary"},{"type":"null"}]},"spark":{"items":{"$ref":"#/components/schemas/AdAccountSparkPoint"},"type":"array","title":"Spark"},"proposals_waiting":{"type":"integer","title":"Proposals Waiting","default":0},"changes_waiting":{"type":"integer","title":"Changes Waiting","default":0},"campaign_ids":{"items":{"type":"string"},"type":"array","title":"Campaign Ids"},"error":{"anyOf":[{"$ref":"#/components/schemas/AdAccountReportError"},{"type":"null"}]},"report_path":{"type":"string","title":"Report Path"}},"type":"object","required":["platform","platform_label","integration_id","report_path"],"title":"AdAccountCard"},"AdAccountFindingsSummary":{"properties":{"total":{"type":"integer","title":"Total","default":0},"critical":{"type":"integer","title":"Critical","default":0},"warning":{"type":"integer","title":"Warning","default":0},"success":{"type":"integer","title":"Success","default":0},"info":{"type":"integer","title":"Info","default":0},"to_know":{"type":"integer","title":"To Know","default":0}},"type":"object","title":"AdAccountFindingsSummary"},"AdAccountHeadlineTile":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value"},"display":{"type":"string","title":"Display"},"unit":{"type":"string","title":"Unit"},"tone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tone"},"accent":{"type":"boolean","title":"Accent","default":false},"hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hint"}},"type":"object","required":["key","label","display","unit"],"title":"AdAccountHeadlineTile"},"AdAccountReportError":{"properties":{"message":{"type":"string","title":"Message"},"failed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failed At"}},"type":"object","required":["message"],"title":"AdAccountReportError"},"AdAccountReportRefreshRequest":{"properties":{"return_binding":{"anyOf":[{"$ref":"#/components/schemas/ReportReadyBindingInput"},{"type":"null"}]}},"type":"object","title":"AdAccountReportRefreshRequest","description":"Optional explicit Markee return binding for this refresh."},"AdAccountReportResponse":{"properties":{"account":{"$ref":"#/components/schemas/AdAccountCard"},"report":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Report"},"team":{"$ref":"#/components/schemas/AdAccountTeamSchedule"},"proposals_waiting":{"type":"integer","title":"Proposals Waiting","default":0},"changes_waiting":{"type":"integer","title":"Changes Waiting","default":0},"runs_since_connected":{"type":"integer","title":"Runs Since Connected","default":0},"recommendations_total":{"type":"integer","title":"Recommendations Total","default":0},"recommendations_executed":{"type":"integer","title":"Recommendations Executed","default":0},"campaigns_path":{"type":"string","title":"Campaigns Path","default":"/campaigns"},"campaign_ids":{"items":{"type":"string"},"type":"array","title":"Campaign Ids"}},"type":"object","required":["account","team"],"title":"AdAccountReportResponse"},"AdAccountSparkPoint":{"properties":{"date":{"type":"string","title":"Date"},"spend":{"type":"number","title":"Spend"}},"type":"object","required":["date","spend"],"title":"AdAccountSparkPoint"},"AdAccountTeamSchedule":{"properties":{"team_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id"},"cadence_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cadence Minutes"},"next_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Run At"},"last_completed_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Completed Run At"}},"type":"object","title":"AdAccountTeamSchedule"},"AdAccountsResponse":{"properties":{"accounts":{"items":{"$ref":"#/components/schemas/AdAccountCard"},"type":"array","title":"Accounts"},"connectable":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Connectable"}},"type":"object","required":["accounts","connectable"],"title":"AdAccountsResponse"},"AdPerformanceResponse":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"source_platform":{"type":"string","title":"Source Platform"},"impressions":{"type":"integer","title":"Impressions"},"clicks":{"type":"integer","title":"Clicks"},"spend_cents":{"type":"integer","title":"Spend Cents"},"conversions":{"type":"integer","title":"Conversions"},"purchase_value_cents":{"type":"integer","title":"Purchase Value Cents"},"roas":{"type":"number","title":"Roas"},"cpc_cents":{"type":"integer","title":"Cpc Cents"},"cpm_cents":{"type":"integer","title":"Cpm Cents"}},"type":"object","required":["metric_date","source_platform","impressions","clicks","spend_cents","conversions","purchase_value_cents","roas","cpc_cents","cpm_cents"],"title":"AdPerformanceResponse","description":"Response model for ad performance."},"AddCreatorToListsRequest":{"properties":{"list_ids":{"items":{"type":"string"},"type":"array","minItems":1,"title":"List Ids"}},"type":"object","required":["list_ids"],"title":"AddCreatorToListsRequest"},"AddCreatorsToListRequest":{"properties":{"creator_ids":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Creator Ids"},"positions_by_creator_id":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Positions By Creator Id"}},"type":"object","required":["creator_ids"],"title":"AddCreatorsToListRequest"},"AddMember":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id"},"role":{"type":"string","enum":["manager","contributor","viewer"],"title":"Role","default":"contributor"}},"additionalProperties":false,"type":"object","required":["user_id"],"title":"AddMember"},"AdsCampaignUpdateRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"ad_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"long_headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Long Headline"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"ad_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Name"},"call_to_action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Call To Action"},"keywords":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"items":{"$ref":"#/components/schemas/KeywordWithCpc"},"type":"array"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords"},"negative_keywords":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"items":{"$ref":"#/components/schemas/KeywordWithCpc"},"type":"array"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Negative Keywords"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"recommended_daily_budget":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Recommended Daily Budget"},"total_budget":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Budget"},"duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration"},"target_platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Platform"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"business_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Name"},"final_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Final Url"},"headlines":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Headlines"},"descriptions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Descriptions"},"format_setting":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Format Setting"},"primary_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Text"},"destination_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Destination Url"},"ad_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Format"},"placements":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Placements"},"introductory_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Introductory Text"},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt Text"},"aspect_ratio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aspect Ratio"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"linkedin_lead_form_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Linkedin Lead Form Config"},"meta_lead_form_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta Lead Form Config"},"asin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asin"},"sku":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sku"},"targeting_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Targeting Type"},"bidding_strategy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bidding Strategy"},"default_bid":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Default Bid"},"brand_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand Name"},"landing_page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Landing Page Url"},"showcase_products":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Showcase Products"},"targeting_products":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Targeting Products"},"audience_segments":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Audience Segments"},"interests":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Interests"},"lead_form_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Lead Form Enabled"},"bid_strategy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bid Strategy"},"max_cpc":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Cpc"},"ad_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Text"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"objective_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Objective Type"},"video_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Video Length"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"price":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price"},"target_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Url"},"context_hints":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Context Hints"},"objective":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Objective"},"max_bid":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Bid"},"conversion_event_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversion Event Type"},"dayparting_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"string"},{"type":"null"}],"title":"Dayparting Config"},"media_operations":{"anyOf":[{"items":{"$ref":"#/components/schemas/CampaignMediaOperation"},"type":"array"},{"type":"null"}],"title":"Media Operations"},"target_audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Audience"},"target_audience_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Target Audience Json"},"locations":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Locations"}},"type":"object","required":["campaign_id"],"title":"AdsCampaignUpdateRequest","description":"Request model for updating ad campaign data"},"AdsCampaignUpdateResponse":{"properties":{"status":{"type":"string","title":"Status"},"message":{"type":"string","title":"Message"},"campaign_id":{"type":"string","title":"Campaign Id"},"campaign":{"anyOf":[{"$ref":"#/components/schemas/CampaignResponse"},{"type":"null"}]},"ad":{"anyOf":[{},{"type":"null"}],"title":"Ad"}},"type":"object","required":["status","message","campaign_id"],"title":"AdsCampaignUpdateResponse","description":"Standardized response for ad update operations within a campaign."},"AdsWinnerItem":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"industry_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry Id"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"},"sub_industry_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sub Industry Id"},"sub_industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sub Industry"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"ad_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"},"ad_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Title"},"analysis":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Analysis"},"brand_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand Name"},"like":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Like"},"cost":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cost"},"ctr":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ctr"},"video_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Id"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Url"},"thumbnail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail"},"created_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created Date"},"updated_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated Date"}},"type":"object","title":"AdsWinnerItem"},"AdsWinnerResponse":{"properties":{"search_mode":{"type":"string","enum":["general","precise"],"title":"Search Mode","default":"general"},"industry_ids":{"items":{"type":"string"},"type":"array","title":"Industry Ids"},"sub_industries":{"items":{"type":"string"},"type":"array","title":"Sub Industries"},"items":{"items":{"$ref":"#/components/schemas/AdsWinnerItem"},"type":"array","title":"Items"}},"type":"object","required":["industry_ids","sub_industries","items"],"title":"AdsWinnerResponse"},"AeoActionStatusUpdateRequest":{"properties":{"status":{"type":"string","enum":["open","done","dismissed"],"title":"Status"},"title":{"type":"string","maxLength":512,"minLength":1,"title":"Title"},"report_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Report Id"}},"type":"object","required":["status","title"],"title":"AeoActionStatusUpdateRequest","description":"Set the lifecycle state of a recommended AEO/GEO action."},"AgentModeStartRequest":{"properties":{"company_url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"string"}],"title":"Company Url"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"keep_existing_images":{"type":"boolean","title":"Keep Existing Images","default":false},"force_restart":{"type":"boolean","title":"Force Restart","default":false},"social_overrides":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Social Overrides"}},"type":"object","required":["company_url","company_profile_id"],"title":"AgentModeStartRequest","description":"Request payload for starting agent mode on a brand workflow."},"AgentSelection":{"properties":{"agent_key":{"type":"string","maxLength":64,"minLength":1,"title":"Agent Key"},"enabled":{"type":"boolean","title":"Enabled","default":true},"display_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Display Name"}},"type":"object","required":["agent_key"],"title":"AgentSelection"},"AgentTaskCapabilityResult":{"properties":{"supported":{"type":"boolean","title":"Supported"},"task_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Task Type"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"suggestions":{"items":{"type":"string"},"type":"array","title":"Suggestions"}},"type":"object","required":["supported"],"title":"AgentTaskCapabilityResult"},"AgentTaskCreate":{"properties":{"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"objective_nl":{"type":"string","maxLength":2000,"minLength":6,"title":"Objective Nl"},"name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Name"},"task_type":{"anyOf":[{"type":"string","enum":["competitor_new_ads","competitor_top_ads","campaign_metrics","market_trends_changes","industry_intel_digest","social_mentions","campaign_ideas_lucky"]},{"type":"null"}],"title":"Task Type"},"no_change_behavior":{"type":"string","enum":["silent","notify_no_change"],"title":"No Change Behavior","default":"silent"},"delivery_mode":{"type":"string","enum":["immediate","digest"],"title":"Delivery Mode","default":"immediate"},"delivery_destination":{"type":"string","enum":["thread","slack","both"],"title":"Delivery Destination","default":"thread"},"schedule":{"$ref":"#/components/schemas/AgentTaskScheduleInput"},"thresholds":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Thresholds"},"quiet_hours":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Quiet Hours"}},"type":"object","required":["organization_id","company_profile_id","conversation_id","objective_nl"],"title":"AgentTaskCreate"},"AgentTaskListResponse":{"properties":{"tasks":{"items":{"$ref":"#/components/schemas/AgentTaskResponse"},"type":"array","title":"Tasks"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["tasks","total"],"title":"AgentTaskListResponse"},"AgentTaskResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"conversation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Conversation Id"},"work_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Work Id"},"name":{"type":"string","title":"Name"},"objective_nl":{"type":"string","title":"Objective Nl"},"objective_structured_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Objective Structured Json"},"task_type":{"type":"string","title":"Task Type"},"tool_profile":{"type":"string","title":"Tool Profile"},"schedule_type":{"type":"string","title":"Schedule Type"},"schedule_expression":{"type":"string","title":"Schedule Expression"},"timezone":{"type":"string","title":"Timezone"},"status":{"type":"string","title":"Status"},"no_change_behavior":{"type":"string","title":"No Change Behavior"},"delivery_mode":{"type":"string","title":"Delivery Mode"},"delivery_destination":{"type":"string","title":"Delivery Destination"},"quiet_hours_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Quiet Hours Json"},"thresholds_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Thresholds Json"},"definition_revision":{"type":"integer","title":"Definition Revision","default":1},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"next_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Run At"},"last_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Run At"},"last_run_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Run Status"},"last_result_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Result Summary"},"run_count":{"type":"integer","title":"Run Count","default":0},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","organization_id","user_id","company_profile_id","name","objective_nl","task_type","tool_profile","schedule_type","schedule_expression","timezone","status","no_change_behavior","delivery_mode","delivery_destination","created_at","updated_at"],"title":"AgentTaskResponse"},"AgentTaskRunListResponse":{"properties":{"runs":{"items":{"$ref":"#/components/schemas/AgentTaskRunResponse"},"type":"array","title":"Runs"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["runs","total"],"title":"AgentTaskRunListResponse"},"AgentTaskRunNowResponse":{"properties":{"task":{"$ref":"#/components/schemas/AgentTaskResponse"},"run":{"$ref":"#/components/schemas/AgentTaskRunResponse"}},"type":"object","required":["task","run"],"title":"AgentTaskRunNowResponse"},"AgentTaskRunResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"task_id":{"type":"string","format":"uuid","title":"Task Id"},"run_key":{"type":"string","title":"Run Key"},"status":{"type":"string","title":"Status"},"scheduled_at":{"type":"string","format":"date-time","title":"Scheduled At"},"occurrence_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Occurrence At"},"definition_revision":{"type":"integer","title":"Definition Revision","default":1},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"summary_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Summary Json"},"source_refs_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Source Refs Json"},"alert_emitted":{"type":"boolean","title":"Alert Emitted"},"emitted_message_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Emitted Message Id"},"error_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Text"},"retry_count":{"type":"integer","title":"Retry Count"},"attempt":{"type":"integer","title":"Attempt"},"lease_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Lease Expires At"},"heartbeat_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Heartbeat At"},"worker_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Worker Id"},"recovery_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recovery Reason"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","task_id","run_key","status","scheduled_at","alert_emitted","retry_count","attempt","created_at","updated_at"],"title":"AgentTaskRunResponse"},"AgentTaskScheduleInput":{"properties":{"interval_minutes":{"type":"integer","maximum":10080.0,"minimum":5.0,"title":"Interval Minutes","description":"Run interval in minutes","default":1440}},"type":"object","title":"AgentTaskScheduleInput","description":"Simple interval schedule (minutes)."},"AgentTaskUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Name"},"status":{"anyOf":[{"type":"string","enum":["active","paused","completed","expired","ended","error","deleted"]},{"type":"null"}],"title":"Status"},"no_change_behavior":{"anyOf":[{"type":"string","enum":["silent","notify_no_change"]},{"type":"null"}],"title":"No Change Behavior"},"delivery_mode":{"anyOf":[{"type":"string","enum":["immediate","digest"]},{"type":"null"}],"title":"Delivery Mode"},"delivery_destination":{"anyOf":[{"type":"string","enum":["thread","slack","both"]},{"type":"null"}],"title":"Delivery Destination"},"schedule":{"anyOf":[{"$ref":"#/components/schemas/AgentTaskScheduleInput"},{"type":"null"}]},"thresholds":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Thresholds"},"quiet_hours":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Quiet Hours"}},"type":"object","title":"AgentTaskUpdate"},"AgentTeamActionListResponse":{"properties":{"actions":{"items":{"$ref":"#/components/schemas/AgentTeamActionResponse"},"type":"array","title":"Actions"},"total":{"type":"integer","title":"Total"},"has_more":{"type":"boolean","title":"Has More","default":false},"next_cursor_updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Cursor Updated At"},"next_cursor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Next Cursor Id"}},"type":"object","required":["actions","total"],"title":"AgentTeamActionListResponse"},"AgentTeamActionResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"team_id":{"type":"string","format":"uuid","title":"Team Id"},"run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"},"recommendation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Recommendation Id"},"recommendation_key":{"type":"string","title":"Recommendation Key"},"recommendation_external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recommendation External Id"},"approval_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Approval Id"},"owner_agent_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner Agent Key"},"title":{"type":"string","title":"Title"},"priority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority"},"risk":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Risk"},"status":{"anyOf":[{"type":"string","enum":["proposed","needs_approval","approved","executing","in_progress","live","completed","failed","blocked","cancelled"]},{"type":"string"}],"title":"Status"},"status_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Reason"},"due_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Due At"},"change_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Scope"},"change_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change From"},"change_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change To"},"why_now":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Why Now"},"impact_estimate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Impact Estimate"},"rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rationale"},"execution_started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Execution Started At"},"execution_completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Execution Completed At"},"outcome_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Outcome State"},"outcome_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Outcome Summary"},"payload_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payload Json"},"first_seen_at":{"type":"string","format":"date-time","title":"First Seen At"},"last_seen_at":{"type":"string","format":"date-time","title":"Last Seen At"},"last_transition_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Transition At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","team_id","recommendation_key","title","status","first_seen_at","last_seen_at","created_at","updated_at"],"title":"AgentTeamActionResponse"},"AgentTeamActionRetryRequest":{"properties":{"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"},"launch_account_overrides":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamLaunchAccountOverrides"},{"type":"null"}]}},"type":"object","title":"AgentTeamActionRetryRequest"},"AgentTeamActionStatusUpdateRequest":{"properties":{"status":{"type":"string","enum":["proposed","needs_approval","approved","executing","in_progress","live","completed","failed","blocked","cancelled"],"title":"Status"},"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"},"outcome_state":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Outcome State"},"outcome_summary":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Outcome Summary"}},"type":"object","required":["status"],"title":"AgentTeamActionStatusUpdateRequest"},"AgentTeamAgentReliabilityResponse":{"properties":{"agent_key":{"type":"string","title":"Agent Key"},"display_name":{"type":"string","title":"Display Name"},"success_count":{"type":"integer","title":"Success Count","default":0},"failure_count":{"type":"integer","title":"Failure Count","default":0},"neutral_count":{"type":"integer","title":"Neutral Count","default":0},"total_count":{"type":"integer","title":"Total Count","default":0},"score":{"type":"number","title":"Score","default":0.0},"score_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Score Level"},"rubric_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rubric Version"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["agent_key","display_name"],"title":"AgentTeamAgentReliabilityResponse"},"AgentTeamAgentResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"team_id":{"type":"string","format":"uuid","title":"Team Id"},"agent_key":{"type":"string","title":"Agent Key"},"display_name":{"type":"string","title":"Display Name"},"role":{"type":"string","title":"Role"},"is_active":{"type":"boolean","title":"Is Active"},"capabilities_json":{"items":{"type":"string"},"type":"array","title":"Capabilities Json"},"tool_allowlist_json":{"items":{"type":"string"},"type":"array","title":"Tool Allowlist Json"},"config_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Config Json"},"prompt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt Text"},"base_daily_routine":{"items":{"$ref":"#/components/schemas/AgentTeamRoutineStepResponse"},"type":"array","title":"Base Daily Routine"},"effective_daily_routine":{"items":{"$ref":"#/components/schemas/AgentTeamRoutineStepResponse"},"type":"array","title":"Effective Daily Routine"},"custom_daily_routine_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Daily Routine Text"},"custom_daily_routine_updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Custom Daily Routine Updated At"},"custom_daily_routine_updated_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Daily Routine Updated By User Id"},"custom_daily_routine_updated_by_agent_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Daily Routine Updated By Agent Key"},"custom_daily_routine_update_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Daily Routine Update Source"},"effective_is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Effective Is Active"},"module_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Module Key"},"disabled_by_module_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Disabled By Module Key"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","team_id","agent_key","display_name","role","is_active","capabilities_json","tool_allowlist_json","created_at","updated_at"],"title":"AgentTeamAgentResponse"},"AgentTeamAgentUpdate":{"properties":{"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"display_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Display Name"},"custom_daily_routine_text":{"anyOf":[{"type":"string","maxLength":8000},{"type":"null"}],"title":"Custom Daily Routine Text"}},"type":"object","title":"AgentTeamAgentUpdate"},"AgentTeamApprovalBulkDecisionError":{"properties":{"approval_id":{"type":"string","format":"uuid","title":"Approval Id"},"message":{"type":"string","title":"Message"}},"type":"object","required":["approval_id","message"],"title":"AgentTeamApprovalBulkDecisionError"},"AgentTeamApprovalBulkDecisionRequest":{"properties":{"approval_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Approval Ids"},"decision":{"type":"string","enum":["approved","rejected","deferred"],"title":"Decision"},"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"},"defer_hours":{"anyOf":[{"type":"integer","maximum":168.0,"minimum":1.0},{"type":"null"}],"title":"Defer Hours"}},"type":"object","required":["decision"],"title":"AgentTeamApprovalBulkDecisionRequest"},"AgentTeamApprovalBulkDecisionResponse":{"properties":{"approvals":{"items":{"$ref":"#/components/schemas/AgentTeamApprovalResponse"},"type":"array","title":"Approvals"},"applied_count":{"type":"integer","title":"Applied Count","default":0},"skipped_count":{"type":"integer","title":"Skipped Count","default":0},"errors":{"items":{"$ref":"#/components/schemas/AgentTeamApprovalBulkDecisionError"},"type":"array","title":"Errors"}},"type":"object","title":"AgentTeamApprovalBulkDecisionResponse"},"AgentTeamApprovalDecisionRequest":{"properties":{"decision":{"type":"string","enum":["approved","rejected","deferred"],"title":"Decision"},"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"},"defer_hours":{"anyOf":[{"type":"integer","maximum":720.0,"minimum":1.0},{"type":"null"}],"title":"Defer Hours"},"decline_reason":{"anyOf":[{"type":"string","enum":["wrong_objective","too_aggressive","bad_timing","distrust_metric","handling_manually","other"]},{"type":"null"}],"title":"Decline Reason"},"snooze_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Snooze Until"},"snooze_condition":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamSnoozeCondition"},{"type":"null"}]},"selected_alternative_id":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Selected Alternative Id"},"counter_daily_budget":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"null"}],"title":"Counter Daily Budget"},"counter_option_id":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Counter Option Id"},"selected_bundle_item_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":100},{"type":"null"}],"title":"Selected Bundle Item Ids"},"selected_plan_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":100},{"type":"null"}],"title":"Selected Plan Ids"},"selected_creative_ids":{"items":{"type":"string"},"type":"array","maxItems":100,"title":"Selected Creative Ids"},"creative_schedule_overrides":{"items":{"$ref":"#/components/schemas/AgentTeamCreativeScheduleOverride"},"type":"array","maxItems":100,"title":"Creative Schedule Overrides"},"launch_account_overrides":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamLaunchAccountOverrides"},{"type":"null"}]},"audience_exclusions":{"items":{"$ref":"#/components/schemas/AgentTeamAudienceExclusionSelection"},"type":"array","maxItems":100,"title":"Audience Exclusions"},"selected_optimization_option_id":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Selected Optimization Option Id"},"selected_optimization_option_ids":{"items":{"type":"string"},"type":"array","maxItems":200,"title":"Selected Optimization Option Ids"},"selected_optimization_action_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":400},{"type":"null"}],"title":"Selected Optimization Action Ids"}},"type":"object","required":["decision"],"title":"AgentTeamApprovalDecisionRequest"},"AgentTeamApprovalListResponse":{"properties":{"approvals":{"items":{"$ref":"#/components/schemas/AgentTeamApprovalResponse"},"type":"array","title":"Approvals"},"total":{"type":"integer","title":"Total"},"matching_total":{"type":"integer","title":"Matching Total","default":0}},"type":"object","required":["approvals","total"],"title":"AgentTeamApprovalListResponse"},"AgentTeamApprovalResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"team_id":{"type":"string","format":"uuid","title":"Team Id"},"run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"},"recommendation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recommendation Id"},"owner_agent_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner Agent Key"},"title":{"type":"string","title":"Title"},"priority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority"},"risk":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Risk"},"approval_state":{"anyOf":[{"type":"string","enum":["pending_approval","approved","rejected","auto_approved","deferred","escalated","expired"]},{"type":"string"}],"title":"Approval State"},"approval_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approval Reason"},"decision_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Decision Note"},"decided_by_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Decided By User Id"},"decided_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Decided At"},"defer_until_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Defer Until At"},"escalated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Escalated At"},"expired_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expired At"},"payload_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payload Json"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","team_id","title","approval_state","created_at","updated_at"],"title":"AgentTeamApprovalResponse"},"AgentTeamAudienceExclusionSelection":{"properties":{"selection_id":{"type":"string","maxLength":200,"minLength":1,"title":"Selection Id"},"audience_group_id":{"type":"string","format":"uuid","title":"Audience Group Id"},"members_revision":{"type":"integer","minimum":0.0,"title":"Members Revision"},"ad_account_id":{"type":"string","maxLength":128,"minLength":1,"title":"Ad Account Id"}},"additionalProperties":false,"type":"object","required":["selection_id","audience_group_id","members_revision","ad_account_id"],"title":"AgentTeamAudienceExclusionSelection","description":"The audience/version shown to the person for one selected Meta ad."},"AgentTeamBundleItemGenerationResponse":{"properties":{"approval":{"$ref":"#/components/schemas/AgentTeamApprovalResponse"},"action_id":{"type":"string","format":"uuid","title":"Action Id"},"item_id":{"type":"string","title":"Item Id"},"generated_item_ids":{"items":{"type":"string"},"type":"array","title":"Generated Item Ids"},"remaining_item_ids":{"items":{"type":"string"},"type":"array","title":"Remaining Item Ids"},"approval_resolved":{"type":"boolean","title":"Approval Resolved"},"project_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Project Id"}},"type":"object","required":["approval","action_id","item_id","generated_item_ids","remaining_item_ids","approval_resolved"],"title":"AgentTeamBundleItemGenerationResponse","description":"Result of sending one selectable bundle item to private generation."},"AgentTeamBundleItemSkipResponse":{"properties":{"approval":{"$ref":"#/components/schemas/AgentTeamApprovalResponse"},"item_id":{"type":"string","title":"Item Id"},"skipped_item_ids":{"items":{"type":"string"},"type":"array","title":"Skipped Item Ids"},"remaining_item_ids":{"items":{"type":"string"},"type":"array","title":"Remaining Item Ids"},"approval_resolved":{"type":"boolean","title":"Approval Resolved"}},"type":"object","required":["approval","item_id","skipped_item_ids","remaining_item_ids","approval_resolved"],"title":"AgentTeamBundleItemSkipResponse","description":"Result of declining one selectable bundle item."},"AgentTeamClaimSafetyNoticeCurrentResponse":{"properties":{"state":{"anyOf":[{"type":"string","enum":["confirmed","dismissed"]},{"type":"null"}],"title":"State"},"current_event_id":{"type":"string","format":"uuid","title":"Current Event Id"},"current_event_content_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Current Event Content Hash"},"responded_at":{"type":"string","format":"date-time","title":"Responded At"}},"type":"object","required":["current_event_id","current_event_content_hash","responded_at"],"title":"AgentTeamClaimSafetyNoticeCurrentResponse"},"AgentTeamClaimSafetyNoticeResponse":{"properties":{"notice_id":{"type":"string","format":"uuid","title":"Notice Id"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"team_id":{"type":"string","format":"uuid","title":"Team Id"},"run_id":{"type":"string","format":"uuid","title":"Run Id"},"approval_id":{"type":"string","format":"uuid","title":"Approval Id"},"recommendation_id":{"type":"string","format":"uuid","title":"Recommendation Id"},"finding_event_id":{"type":"string","format":"uuid","title":"Finding Event Id"},"finding_event_content_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Finding Event Content Hash"},"notice_packet_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Notice Packet Hash"},"copy_version":{"type":"string","const":"reports_claim_safety_notice_copy_v1","title":"Copy Version","default":"reports_claim_safety_notice_copy_v1"},"heading":{"type":"string","const":"Wording to review","title":"Heading"},"body":{"type":"string","const":"The title or rationale may overstate certainty. Recheck the wording before relying on or reusing this recommendation.","title":"Body"},"current_response":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamClaimSafetyNoticeCurrentResponse"},{"type":"null"}]}},"type":"object","required":["notice_id","organization_id","company_profile_id","team_id","run_id","approval_id","recommendation_id","finding_event_id","finding_event_content_hash","notice_packet_hash","heading","body"],"title":"AgentTeamClaimSafetyNoticeResponse","description":"Customer-safe DET-2 projection for one exact Reports recommendation."},"AgentTeamClaimSafetyNoticeWriteRequest":{"properties":{"client_request_id":{"type":"string","format":"uuid","title":"Client Request Id"},"notice_id":{"type":"string","format":"uuid","title":"Notice Id"},"finding_event_id":{"type":"string","format":"uuid","title":"Finding Event Id"},"finding_event_content_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Finding Event Content Hash"},"notice_packet_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Notice Packet Hash"},"action":{"type":"string","enum":["confirm","dismiss","undo"],"title":"Action"},"expected_current_response_event_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Expected Current Response Event Id"}},"type":"object","required":["client_request_id","notice_id","finding_event_id","finding_event_content_hash","notice_packet_hash","action"],"title":"AgentTeamClaimSafetyNoticeWriteRequest"},"AgentTeamClaimSafetyNoticeWriteResponse":{"properties":{"notice":{"$ref":"#/components/schemas/AgentTeamClaimSafetyNoticeResponse"},"replayed":{"type":"boolean","title":"Replayed","default":false}},"type":"object","required":["notice"],"title":"AgentTeamClaimSafetyNoticeWriteResponse"},"AgentTeamCommandCreate":{"properties":{"content":{"type":"string","maxLength":4000,"minLength":1,"title":"Content"},"context_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context Json"}},"type":"object","required":["content"],"title":"AgentTeamCommandCreate"},"AgentTeamCommandListResponse":{"properties":{"commands":{"items":{"$ref":"#/components/schemas/AgentTeamCommandResponse"},"type":"array","title":"Commands"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["commands","total"],"title":"AgentTeamCommandListResponse"},"AgentTeamCommandResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"team_id":{"type":"string","format":"uuid","title":"Team Id"},"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id"},"run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"},"content":{"type":"string","title":"Content"},"context_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context Json"},"status":{"type":"string","title":"Status"},"consumed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Consumed At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","team_id","content","status","created_at","updated_at"],"title":"AgentTeamCommandResponse"},"AgentTeamConsideredGuidanceResponse":{"properties":{"guidance_id":{"type":"string","title":"Guidance Id"},"memory_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Memory Id"},"team_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"},"card_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Card Id"},"note":{"type":"string","title":"Note"},"saved_by_you":{"type":"boolean","title":"Saved By You"},"active":{"type":"boolean","title":"Active"},"is_current_version":{"type":"boolean","title":"Is Current Version"},"feedback_subject":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardFeedbackSubjectResponse"},{"type":"null"}]}},"type":"object","required":["guidance_id","note","saved_by_you","active","is_current_version"],"title":"AgentTeamConsideredGuidanceResponse"},"AgentTeamConsultRequest":{"properties":{"agent_key":{"type":"string","maxLength":64,"minLength":1,"title":"Agent Key"},"message":{"type":"string","maxLength":4000,"minLength":1,"title":"Message"},"intent":{"type":"string","enum":["ask","propose"],"title":"Intent","default":"ask"},"context_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context Json"}},"type":"object","required":["agent_key","message"],"title":"AgentTeamConsultRequest"},"AgentTeamConsultResponse":{"properties":{"policy":{"$ref":"#/components/schemas/AgentTeamInteractionPolicyResponse"},"run":{"$ref":"#/components/schemas/AgentTeamRunResponse"},"target_agent_key":{"type":"string","title":"Target Agent Key"},"user_message":{"$ref":"#/components/schemas/AgentTeamMessageResponse"},"agent_response":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamMessageResponse"},{"type":"null"}]},"manager_handoff_message":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamMessageResponse"},{"type":"null"}]},"manager_decision_message":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamMessageResponse"},{"type":"null"}]}},"type":"object","required":["policy","run","target_agent_key","user_message"],"title":"AgentTeamConsultResponse"},"AgentTeamControlSnapshotResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"status":{"type":"string","enum":["active","paused","error","deleted"],"title":"Status"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","organization_id","company_profile_id","status","updated_at"],"title":"AgentTeamControlSnapshotResponse","description":"Minimal read-only preflight for a server-authored chat control card."},"AgentTeamCreate":{"properties":{"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Name"},"schedule_minutes":{"type":"integer","maximum":10080.0,"minimum":1.0,"title":"Schedule Minutes","default":1440},"approval_mode":{"type":"string","enum":["approval_first","auto_low_risk","auto_all"],"title":"Approval Mode","default":"approval_first"},"template_version":{"type":"string","maxLength":80,"minLength":1,"title":"Template Version","default":"data_intel_team"},"agents":{"anyOf":[{"items":{"$ref":"#/components/schemas/AgentSelection"},"type":"array"},{"type":"null"}],"title":"Agents"},"goal_contract_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Goal Contract Json"}},"type":"object","required":["organization_id","company_profile_id"],"title":"AgentTeamCreate"},"AgentTeamCreativeScheduleOverride":{"properties":{"selection_id":{"type":"string","maxLength":200,"minLength":1,"title":"Selection Id"},"scheduled_local_date":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Scheduled Local Date"},"scheduled_local_time":{"anyOf":[{"type":"string","maxLength":10},{"type":"null"}],"title":"Scheduled Local Time"},"schedule_timezone":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Schedule Timezone"}},"type":"object","required":["selection_id"],"title":"AgentTeamCreativeScheduleOverride"},"AgentTeamDailySummaryListResponse":{"properties":{"summaries":{"items":{"$ref":"#/components/schemas/AgentTeamDailySummaryResponse"},"type":"array","title":"Summaries"},"total":{"type":"integer","title":"Total"},"has_more":{"type":"boolean","title":"Has More","default":false},"next_cursor_created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Cursor Created At"},"next_cursor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Next Cursor Id"}},"type":"object","required":["summaries","total"],"title":"AgentTeamDailySummaryListResponse"},"AgentTeamDailySummaryResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"team_id":{"type":"string","format":"uuid","title":"Team Id"},"run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"},"summary_date":{"type":"string","format":"date","title":"Summary Date"},"title":{"type":"string","title":"Title"},"ops_blog_markdown":{"type":"string","title":"Ops Blog Markdown"},"marketing_blog_markdown":{"type":"string","title":"Marketing Blog Markdown"},"highlights_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Highlights Json"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","team_id","summary_date","title","ops_blog_markdown","marketing_blog_markdown","created_at"],"title":"AgentTeamDailySummaryResponse"},"AgentTeamDetailResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"created_by_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Created By User Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","enum":["active","paused","error","deleted"],"title":"Status"},"approval_mode":{"type":"string","title":"Approval Mode"},"template_version":{"type":"string","title":"Template Version"},"default_schedule_minutes":{"type":"integer","title":"Default Schedule Minutes"},"next_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Run At"},"last_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Run At"},"last_run_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Run Status"},"task_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Task Id"},"conversation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Conversation Id"},"settings_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Settings Json"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"primary_agent_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Agent Key"},"agents":{"items":{"$ref":"#/components/schemas/AgentTeamAgentResponse"},"type":"array","title":"Agents"},"modules":{"items":{"$ref":"#/components/schemas/AgentTeamModuleResponse"},"type":"array","title":"Modules"},"pending_run_guidance":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamRunGuidanceResponse"},{"type":"null"}]}},"type":"object","required":["id","organization_id","company_profile_id","name","status","approval_mode","template_version","default_schedule_minutes","created_at","updated_at"],"title":"AgentTeamDetailResponse"},"AgentTeamDirectorInsightProjectionResponse":{"properties":{"run_id":{"type":"string","format":"uuid","title":"Run Id"},"package":{"$ref":"#/components/schemas/DirectorInsightPackageResponse"}},"type":"object","required":["run_id","package"],"title":"AgentTeamDirectorInsightProjectionResponse","description":"Run-bound Director package for the lightweight daily-report endpoint."},"AgentTeamEventListResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/AgentTeamEventResponse"},"type":"array","title":"Events"},"total":{"type":"integer","title":"Total"},"has_more":{"type":"boolean","title":"Has More","default":false},"next_cursor_created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Cursor Created At"},"next_cursor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Next Cursor Id"}},"type":"object","required":["events","total"],"title":"AgentTeamEventListResponse"},"AgentTeamEventResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"team_id":{"type":"string","format":"uuid","title":"Team Id"},"run_id":{"type":"string","format":"uuid","title":"Run Id"},"agent_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Key"},"event_type":{"type":"string","title":"Event Type"},"title":{"type":"string","title":"Title"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"payload_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payload Json"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","team_id","run_id","event_type","title","created_at"],"title":"AgentTeamEventResponse"},"AgentTeamFleetSnapshotResponse":{"properties":{"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"offset":{"type":"integer","title":"Offset","default":0},"limit":{"type":"integer","title":"Limit","default":200},"has_more":{"type":"boolean","title":"Has More","default":false},"sort_by":{"type":"string","title":"Sort By","default":"updated_at"},"sort_order":{"type":"string","title":"Sort Order","default":"desc"},"status_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Filter"},"blocked_only":{"type":"boolean","title":"Blocked Only","default":false},"totals":{"additionalProperties":{"type":"integer"},"type":"object","title":"Totals"},"teams":{"items":{"$ref":"#/components/schemas/AgentTeamFleetTeamResponse"},"type":"array","title":"Teams"}},"type":"object","required":["organization_id","generated_at"],"title":"AgentTeamFleetSnapshotResponse"},"AgentTeamFleetTeamResponse":{"properties":{"team_id":{"type":"string","format":"uuid","title":"Team Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"team_name":{"type":"string","title":"Team Name"},"status":{"anyOf":[{"type":"string","enum":["active","paused","error","deleted"]},{"type":"string"}],"title":"Status"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"last_run_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Run Status"},"last_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Run At"},"next_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Run At"},"pending_approvals":{"type":"integer","title":"Pending Approvals","default":0},"escalated_approvals":{"type":"integer","title":"Escalated Approvals","default":0},"open_approvals":{"type":"integer","title":"Open Approvals","default":0},"live_runs":{"type":"integer","title":"Live Runs","default":0},"recommendation_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Recommendation Counts"},"blocked":{"type":"boolean","title":"Blocked","default":false},"blocker_reasons":{"items":{"type":"string"},"type":"array","title":"Blocker Reasons"}},"type":"object","required":["team_id","company_profile_id","team_name","status"],"title":"AgentTeamFleetTeamResponse"},"AgentTeamGoalContractRequest":{"properties":{"goal_contract_json":{"additionalProperties":true,"type":"object","title":"Goal Contract Json"},"expected_revision":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Expected Revision"}},"additionalProperties":false,"type":"object","title":"AgentTeamGoalContractRequest"},"AgentTeamGoalContractResponse":{"properties":{"goal_contract_json":{"additionalProperties":true,"type":"object","title":"Goal Contract Json"},"measurement_options":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Measurement Options"},"can_edit":{"type":"boolean","title":"Can Edit","default":false},"measurement":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Measurement"}},"type":"object","title":"AgentTeamGoalContractResponse"},"AgentTeamGoalResultRequest":{"properties":{"expected_goal_revision":{"type":"integer","minimum":1.0,"title":"Expected Goal Revision"},"value":{"type":"number","maximum":1000000000000000.0,"minimum":-1000000000000000.0,"title":"Value"},"observed_through":{"type":"string","format":"date","title":"Observed Through"}},"additionalProperties":false,"type":"object","required":["expected_goal_revision","value","observed_through"],"title":"AgentTeamGoalResultRequest"},"AgentTeamInsightCardActivationResponse":{"properties":{"kind":{"type":"string","enum":["action","approval_decision"],"title":"Kind"},"id":{"type":"string","title":"Id"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"at":{"type":"string","title":"At"},"basis":{"type":"string","enum":["observed","claimed"],"title":"Basis"}},"type":"object","required":["kind","id","at","basis"],"title":"AgentTeamInsightCardActivationResponse","description":"The work whose success opened a card's measurement window.\n\n``basis`` is the difference between something watching the work go live\nand a person saying it did, and it travels with the identity so no surface\ncan render the second as the first."},"AgentTeamInsightCardCompetitorMovementResponse":{"properties":{"title":{"type":"string","title":"Title"},"movement_type":{"type":"string","title":"Movement Type","default":""},"timing_basis":{"type":"string","title":"Timing Basis","default":""},"current_signal":{"type":"string","title":"Current Signal","default":""},"why_it_matters":{"type":"string","title":"Why It Matters","default":""},"sources":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardCompetitorSourceResponse"},"type":"array","title":"Sources"},"source_count":{"type":"integer","minimum":0.0,"title":"Source Count","default":0}},"type":"object","required":["title"],"title":"AgentTeamInsightCardCompetitorMovementResponse","description":"One competitor movement, verbatim from the extractor's own schema.\n\n``movement_type`` is a short label the model chose, not a vocabulary: it\nis rendered as written and never switched on."},"AgentTeamInsightCardCompetitorMovementsResponse":{"properties":{"movements":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardCompetitorMovementResponse"},"type":"array","title":"Movements"},"movement_count":{"type":"integer","minimum":0.0,"title":"Movement Count","default":0},"competitor_count":{"type":"integer","minimum":0.0,"title":"Competitor Count","default":0},"tracked_ad_count":{"type":"integer","minimum":0.0,"title":"Tracked Ad Count","default":0},"scan":{"$ref":"#/components/schemas/AgentTeamInsightCardCompetitorScanResponse"}},"type":"object","required":["scan"],"title":"AgentTeamInsightCardCompetitorMovementsResponse","description":"What the rivals did, for a card that rests on watching them.\n\nAn empty ``movements`` list is a real answer, not an empty section: read\nwith ``scan`` beside it, it says either \"nothing moved that we could see\"\nor \"we could not look\", and those are different sentences."},"AgentTeamInsightCardCompetitorScanResponse":{"properties":{"freshness":{"type":"string","enum":["fresh","stale","never_scanned","unknown"],"title":"Freshness"},"last_scanned_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Scanned At"},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"},"age_days":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Age Days"}},"type":"object","required":["freshness"],"title":"AgentTeamInsightCardCompetitorScanResponse","description":"When the competitor scan last looked, and whether that look still counts.\n\n``never_scanned`` (no observation exists) and ``unknown`` (this result\npredates the freshness stamp) are deliberately distinct from ``stale``:\neach is a different answer to \"why is there nothing here\", and collapsing\nthem is how an outage in collection gets reported as a quiet market."},"AgentTeamInsightCardCompetitorSourceResponse":{"properties":{"competitor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Competitor"},"channel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Channel"},"quote":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quote"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Url"}},"type":"object","title":"AgentTeamInsightCardCompetitorSourceResponse","description":"One signal a movement cited, resolved into something readable.\n\nThe cited id itself never appears: it is a correlation key with a database\nid inside it. What survives is who ran it, where, what it said, and the\nrival's own creative when one was cached."},"AgentTeamInsightCardCreativeAnalysisAdResponse":{"properties":{"ad_identity_id":{"type":"string","title":"Ad Identity Id"},"platform":{"type":"string","title":"Platform"},"campaign_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Name"},"ad_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Name"},"performance_tier":{"type":"string","enum":["high","typical","low","learning"],"title":"Performance Tier","default":"learning"},"facets":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardCreativeAnalysisFacetResponse"},"type":"array","title":"Facets"}},"type":"object","required":["ad_identity_id","platform"],"title":"AgentTeamInsightCardCreativeAnalysisAdResponse"},"AgentTeamInsightCardCreativeAnalysisFacetResponse":{"properties":{"evidence_id":{"type":"string","title":"Evidence Id"},"media_type":{"type":"string","enum":["text","image","video"],"title":"Media Type"},"media_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Media Role"},"preview_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preview Url"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"strengths":{"items":{"type":"string"},"type":"array","title":"Strengths"},"risks":{"items":{"type":"string"},"type":"array","title":"Risks"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"}},"type":"object","required":["evidence_id","media_type"],"title":"AgentTeamInsightCardCreativeAnalysisFacetResponse"},"AgentTeamInsightCardCreativePreviewResponse":{"properties":{"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Url"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"platform_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform Key"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"headlines":{"items":{"type":"string"},"type":"array","title":"Headlines"},"descriptions":{"items":{"type":"string"},"type":"array","title":"Descriptions"},"destination_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Destination Url"},"recommended":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Recommended"},"review_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Review Note"},"image_qa_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Qa Status"},"image_qa_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Qa Note"}},"type":"object","title":"AgentTeamInsightCardCreativePreviewResponse","description":"One staged creative riding the card's approval, as the page draws it:\nits media (or none — a search ad is text by design), its copy and where\nthe click goes."},"AgentTeamInsightCardCtaResponse":{"properties":{"kind":{"type":"string","enum":["review_launch","review_schedule","review_optimization","run_test","open_press","open_influencer","review_growth","acknowledge","view"],"title":"Kind"},"label":{"type":"string","title":"Label"}},"type":"object","required":["kind","label"],"title":"AgentTeamInsightCardCtaResponse"},"AgentTeamInsightCardDataCoverageFacetResponse":{"properties":{"facet":{"type":"string","title":"Facet","default":""},"reason":{"type":"string","title":"Reason","default":""}},"type":"object","title":"AgentTeamInsightCardDataCoverageFacetResponse","description":"One unavailable facet inside a combined evidence source."},"AgentTeamInsightCardDataCoverageResponse":{"properties":{"domain":{"type":"string","title":"Domain","default":""},"source_agent_key":{"type":"string","title":"Source Agent Key","default":""},"reason":{"type":"string","title":"Reason","default":""},"reading_supplied":{"type":"boolean","title":"Reading Supplied","default":false},"connected":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Connected"},"excluded_facets":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardDataCoverageFacetResponse"},"type":"array","title":"Excluded Facets"}},"type":"object","title":"AgentTeamInsightCardDataCoverageResponse","description":"One row of the latest run's evidence exclusion ledger — a source the\nDirector could not see this run, and why. Read verbatim from the persisted\nevidence packet, never inferred."},"AgentTeamInsightCardDecisionDetailResponse":{"properties":{"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"priority_rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority Rationale"},"expected_impact":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Impact"},"measurement_plan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Measurement Plan"},"readout_kind":{"anyOf":[{"type":"string","enum":["number","check","none"]},{"type":"null"}],"title":"Readout Kind"},"measurement_status":{"anyOf":[{"type":"string","enum":["ready","verification_only","not_applicable","not_configured"]},{"type":"null"}],"title":"Measurement Status"},"confidence_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence Label"},"claim_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Type"},"quantification_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quantification Note"},"supporting_points":{"items":{"type":"string"},"type":"array","title":"Supporting Points"},"citations":{"items":{"type":"string"},"type":"array","title":"Citations"},"measurement_contract":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardMeasurementContractResponse"},{"type":"null"}]},"claim_boundaries":{"items":{"type":"string"},"type":"array","title":"Claim Boundaries"}},"type":"object","title":"AgentTeamInsightCardDecisionDetailResponse","description":"The Director's full authored record for this decision — prose passed\nthrough verbatim; absent fields are omitted upstream."},"AgentTeamInsightCardDetailCardResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"insight_key":{"type":"string","title":"Insight Key"},"native_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Native Version"},"title":{"type":"string","title":"Title"},"state":{"anyOf":[{"type":"string","enum":["waiting","in_flight","watching","measuring","resolved","dismissed","retracted","removed"]},{"type":"string"}],"title":"State"},"stance":{"$ref":"#/components/schemas/AgentTeamInsightCardStanceResponse"},"stance_reason":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardStanceReasonResponse"},{"type":"null"}]},"exploratory":{"type":"boolean","title":"Exploratory","default":false},"is_new":{"type":"boolean","title":"Is New","default":false},"stalled_since":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Stalled Since"},"resolution":{"anyOf":[{"type":"string","enum":["approved","modified","dismissed","auto","retracted","interrupted","removed"]},{"type":"string"},{"type":"null"}],"title":"Resolution"},"outcome":{"anyOf":[{"type":"string","enum":["won","neutral","lost","unmeasured"]},{"type":"string"},{"type":"null"}],"title":"Outcome"},"retraction":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardRetractionResponse"},{"type":"null"}]},"measurement_interruption":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardMeasurementInterruptionResponse"},{"type":"null"}]},"recommendation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recommendation"},"why_now":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Why Now"},"so_what":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"So What"},"presentation":{"anyOf":[{"$ref":"#/components/schemas/InsightPresentation"},{"type":"null"}]},"sources":{"items":{"$ref":"#/components/schemas/InsightSource"},"type":"array","title":"Sources"},"priority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority"},"change_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Scope"},"lane":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lane"},"approval_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Approval Id"},"review_approval_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Review Approval Id"},"key_metrics":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardMetricResponse"},"type":"array","title":"Key Metrics"},"timeline":{"$ref":"#/components/schemas/AgentTeamInsightCardTimelineResponse"},"results_state":{"anyOf":[{"type":"string","enum":["measuring","improved","regressed","neutral","unmeasured"]},{"type":"string"},{"type":"null"}],"title":"Results State"},"new_update_count":{"type":"integer","title":"New Update Count","default":0},"resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Resolved At"},"source_run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Run Id"},"latest_run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Latest Run Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank"},"cta":{"$ref":"#/components/schemas/AgentTeamInsightCardCtaResponse"},"staged_lanes":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardStagedLaneResponse"},"type":"array","title":"Staged Lanes"},"creatives_preview":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardCreativePreviewResponse"},"type":"array","title":"Creatives Preview"},"paid_media_context":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardPaidMediaContextResponse"},{"type":"null"}]},"source_agents":{"items":{"type":"string"},"type":"array","title":"Source Agents"},"restore":{"$ref":"#/components/schemas/AgentTeamInsightCardRestoreResponse"},"evidence":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardEvidenceResponse"},"type":"array","title":"Evidence"},"measurement":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardMeasurementResponse"},{"type":"null"}]},"results":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Results"},"detail":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardDecisionDetailResponse"},{"type":"null"}]},"staged_work":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardStagedWorkResponse"},"type":"array","title":"Staged Work"},"competitor_movements":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardCompetitorMovementsResponse"},{"type":"null"}]}},"type":"object","required":["id","insight_key","title","state","stance","timeline","created_at","cta"],"title":"AgentTeamInsightCardDetailCardResponse"},"AgentTeamInsightCardDetailResponse":{"properties":{"markee_continuations":{"$ref":"#/components/schemas/InsightConversationContinuations"},"brand_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand Name"},"card":{"$ref":"#/components/schemas/AgentTeamInsightCardDetailCardResponse"},"sub_actions":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardSubActionResponse"},"type":"array","title":"Sub Actions"},"sub_actions_hidden_count":{"type":"integer","minimum":0.0,"title":"Sub Actions Hidden Count","default":0},"progress_log":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardProgressEntryResponse"},"type":"array","title":"Progress Log"},"claim_safety_notices":{"items":{"$ref":"#/components/schemas/AgentTeamClaimSafetyNoticeResponse"},"type":"array","title":"Claim Safety Notices"},"feedback":{"$ref":"#/components/schemas/AgentTeamInsightCardFeedbackResponse"},"guidance_considered":{"items":{"$ref":"#/components/schemas/AgentTeamConsideredGuidanceResponse"},"type":"array","title":"Guidance Considered"}},"type":"object","required":["card"],"title":"AgentTeamInsightCardDetailResponse"},"AgentTeamInsightCardEvidenceResponse":{"properties":{"evidence_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Id"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet"},"source_label":{"type":"string","title":"Source Label"},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"},"urls":{"items":{"type":"string"},"type":"array","title":"Urls"},"sources":{"items":{"$ref":"#/components/schemas/InsightSource"},"type":"array","title":"Sources"},"metrics":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardMetricResponse"},"type":"array","title":"Metrics"}},"type":"object","required":["source_label"],"title":"AgentTeamInsightCardEvidenceResponse","description":"snippet passes through null — never synthesized at read time."},"AgentTeamInsightCardFeedbackResponse":{"properties":{"resolution":{"anyOf":[{"type":"string","enum":["approved","modified","dismissed","auto","retracted","interrupted","removed"]},{"type":"string"},{"type":"null"}],"title":"Resolution"},"usefulness":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Usefulness"},"subject":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardFeedbackSubjectResponse"},{"type":"null"}]},"subjects":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardFeedbackSubjectResponse"},"type":"array","title":"Subjects"},"prior_report_feedback":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamReportFeedbackSubjectResponse"},{"type":"null"}]}},"type":"object","title":"AgentTeamInsightCardFeedbackResponse"},"AgentTeamInsightCardFeedbackSubjectResponse":{"properties":{"subject_type":{"type":"string","enum":["agent_team_action","agent_team_recommendation","agent_team_insight_card"],"title":"Subject Type"},"subject_id":{"type":"string","format":"uuid","title":"Subject Id"},"approval_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Approval Id"},"run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"},"section":{"type":"string","enum":["recommendation","plan","result"],"title":"Section"},"source_revision":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Source Revision"},"source_content_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Source Content Hash"},"current_event_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Current Event Id"},"current_sequence":{"type":"integer","minimum":0.0,"title":"Current Sequence","default":0},"feedback":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamReportFeedbackValueResponse"},{"type":"null"}]},"use_status":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamReportFeedbackUseStatusResponse"},{"type":"null"}]},"feedback_source_revision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Feedback Source Revision"},"source_changed":{"type":"boolean","title":"Source Changed","default":false},"can_set":{"type":"boolean","title":"Can Set","default":true},"can_remember":{"type":"boolean","title":"Can Remember","default":false},"guidance_only":{"type":"boolean","title":"Guidance Only","default":false}},"type":"object","required":["subject_type","subject_id","section","source_revision","source_content_hash"],"title":"AgentTeamInsightCardFeedbackSubjectResponse","description":"Current actor feedback on one exact versioned card section."},"AgentTeamInsightCardFeedbackWriteRequest":{"properties":{"operation":{"type":"string","enum":["set","retract"],"title":"Operation"},"subject_type":{"type":"string","const":"agent_team_insight_card","title":"Subject Type"},"subject_id":{"type":"string","format":"uuid","title":"Subject Id"},"reason_code":{"anyOf":[{"type":"string","enum":["more_like_this","not_relevant","incorrect","missing_context","unclear","not_actionable","other"]},{"type":"null"}],"title":"Reason Code"},"note":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Note"},"client_request_id":{"type":"string","format":"uuid","title":"Client Request Id"},"expected_current_event_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Expected Current Event Id"},"section":{"type":"string","enum":["recommendation","plan","result"],"title":"Section"},"source_revision":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Source Revision"},"source_content_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Source Content Hash"},"remember_for_brand":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Remember For Brand"},"guidance_only":{"type":"boolean","title":"Guidance Only","default":false}},"additionalProperties":false,"type":"object","required":["operation","subject_type","subject_id","client_request_id","section","source_revision","source_content_hash"],"title":"AgentTeamInsightCardFeedbackWriteRequest"},"AgentTeamInsightCardHistoryResponse":{"properties":{"cards":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardResponse"},"type":"array","title":"Cards"},"total":{"type":"integer","minimum":0.0,"title":"Total","default":0},"offset":{"type":"integer","minimum":0.0,"title":"Offset","default":0},"limit":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":25},"has_more":{"type":"boolean","title":"Has More","default":false},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["generated_at"],"title":"AgentTeamInsightCardHistoryResponse","description":"Paginated measurement history with the same live card states."},"AgentTeamInsightCardInterruptionActionResponse":{"properties":{"action_id":{"type":"string","format":"uuid","title":"Action Id"},"title":{"type":"string","title":"Title"},"campaign_ids":{"items":{"type":"string"},"type":"array","title":"Campaign Ids"}},"type":"object","required":["action_id","title"],"title":"AgentTeamInsightCardInterruptionActionResponse","description":"A campaign action that superseded an active measurement."},"AgentTeamInsightCardListResponse":{"properties":{"cards":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardResponse"},"type":"array","title":"Cards"},"featured_card_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Featured Card Id"},"rail":{"$ref":"#/components/schemas/AgentTeamInsightCardRailResponse"},"tiles":{"$ref":"#/components/schemas/AgentTeamInsightCardTilesResponse"},"data_coverage":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardDataCoverageResponse"},"type":"array","title":"Data Coverage"},"last_seen_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Seen At"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"report_run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Report Run Id"},"report_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Report Date"}},"type":"object","required":["rail","tiles","generated_at"],"title":"AgentTeamInsightCardListResponse","description":"One fetch serves the queue page AND the overview's card needs."},"AgentTeamInsightCardMeasurementContractResponse":{"properties":{"metric_key":{"type":"string","title":"Metric Key"},"metric_label":{"type":"string","title":"Metric Label"},"baseline_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Baseline Value"},"baseline_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baseline Unit"},"baseline_display":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baseline Display"},"baseline_metric_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baseline Metric Id"},"baseline_evidence_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baseline Evidence Id"},"baseline_source_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baseline Source Path"},"baseline_observed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baseline Observed At"},"baseline_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baseline Status"},"window_days":{"type":"integer","title":"Window Days","default":0},"expected_direction":{"type":"string","enum":["up","down"],"title":"Expected Direction","default":"up"},"minimum_meaningful_change":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Minimum Meaningful Change"}},"type":"object","required":["metric_key","metric_label"],"title":"AgentTeamInsightCardMeasurementContractResponse","description":"The decision's falsifiable measurement contract: which metric, from\nwhat baseline, expected to move which way, inside what window. Null when\nthe Director authored none — the UI then refuses the success sentence."},"AgentTeamInsightCardMeasurementInterruptionResponse":{"properties":{"kind":{"type":"string","const":"overlapping_campaign_change","title":"Kind"},"message":{"type":"string","title":"Message"},"interrupted_at":{"type":"string","format":"date-time","title":"Interrupted At"},"planned_readout_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Planned Readout At"},"campaign_ids":{"items":{"type":"string"},"type":"array","title":"Campaign Ids"},"triggering_approval_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Triggering Approval Id"},"triggering_action_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Triggering Action Id"},"triggering_actions":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardInterruptionActionResponse"},"type":"array","title":"Triggering Actions"}},"type":"object","required":["kind","message","interrupted_at"],"title":"AgentTeamInsightCardMeasurementInterruptionResponse","description":"Why a live window closed without attributing a result."},"AgentTeamInsightCardMeasurementResponse":{"properties":{"metric_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric Key"},"metric_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric Label"},"baseline_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Baseline Value"},"baseline_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baseline Unit"},"baseline_display":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baseline Display"},"baseline_metric_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baseline Metric Id"},"baseline_evidence_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baseline Evidence Id"},"baseline_source_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baseline Source Path"},"baseline_observed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baseline Observed At"},"baseline_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baseline Status"},"window_days":{"type":"integer","title":"Window Days","default":0},"expected_direction":{"type":"string","title":"Expected Direction","default":"up"},"minimum_meaningful_change":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Minimum Meaningful Change"},"source":{"type":"string","enum":["authored","estimated"],"title":"Source","default":"estimated"},"method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Method"},"activation":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardActivationResponse"},{"type":"null"}]}},"type":"object","title":"AgentTeamInsightCardMeasurementResponse"},"AgentTeamInsightCardMetricResponse":{"properties":{"metric_id":{"type":"string","title":"Metric Id"},"evidence_id":{"type":"string","title":"Evidence Id"},"source_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Path"},"label":{"type":"string","title":"Label","default":""},"value":{"type":"number","title":"Value"},"display_value":{"type":"string","title":"Display Value"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"},"window":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Window"},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"},"role":{"anyOf":[{"type":"string","enum":["decision","context"]},{"type":"null"}],"title":"Role"},"estimate":{"type":"boolean","title":"Estimate","default":false}},"type":"object","required":["metric_id","evidence_id","value","display_value"],"title":"AgentTeamInsightCardMetricResponse","description":"One rendered number, with the provenance that lets it be checked.\n\n``display_value`` is the number as its own source rendered it and is the\nonly string a reader may print — rebuilding one from ``value`` and\n``unit`` is how a stored 0.35 became \"0.35%\" on a card whose title said\n35%. ``value`` is for ordering and comparison, never for display.\n``metric_id``/``evidence_id``/``source_path`` address the exact numeric\nleaf this came from, and a row carries a period it can name: ``window``\nwhen the source measured an interval, ``observed_at`` when it read a\npoint in time. Rows that cannot say those things never reach here — the\npayload builder drops them, it does not pad them."},"AgentTeamInsightCardPaidMediaContextResponse":{"properties":{"kind":{"type":"string","const":"creative_analysis","title":"Kind"},"ads":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardCreativeAnalysisAdResponse"},"type":"array","title":"Ads"}},"type":"object","required":["kind"],"title":"AgentTeamInsightCardPaidMediaContextResponse"},"AgentTeamInsightCardProgressEntryResponse":{"properties":{"at":{"type":"string","format":"date-time","title":"At"},"actor":{"type":"string","enum":["pomo","you"],"title":"Actor"},"text":{"type":"string","title":"Text"}},"type":"object","required":["at","actor","text"],"title":"AgentTeamInsightCardProgressEntryResponse"},"AgentTeamInsightCardRailConfirmedResponse":{"properties":{"card_id":{"type":"string","format":"uuid","title":"Card Id"},"title":{"type":"string","title":"Title"},"delta_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delta Label"},"amount_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Amount Label"}},"type":"object","required":["card_id","title"],"title":"AgentTeamInsightCardRailConfirmedResponse"},"AgentTeamInsightCardRailInFlightResponse":{"properties":{"card_id":{"type":"string","format":"uuid","title":"Card Id"},"title":{"type":"string","title":"Title"},"state_line":{"type":"string","title":"State Line"}},"type":"object","required":["card_id","title","state_line"],"title":"AgentTeamInsightCardRailInFlightResponse"},"AgentTeamInsightCardRailNextStepResponse":{"properties":{"label":{"type":"string","title":"Label"},"kind":{"type":"string","enum":["review_launch","review_schedule","review_optimization","run_test","open_press","open_influencer","review_growth","acknowledge","view"],"title":"Kind"},"action_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Action Id"}},"type":"object","required":["label","kind"],"title":"AgentTeamInsightCardRailNextStepResponse"},"AgentTeamInsightCardRailResponse":{"properties":{"in_flight":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardRailInFlightResponse"},"type":"array","title":"In Flight"},"approved":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardRailInFlightResponse"},"type":"array","title":"Approved"},"confirmed":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardRailConfirmedResponse"},"type":"array","title":"Confirmed"},"stalled":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardRailStalledResponse"},"type":"array","title":"Stalled"},"confirmed_total_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confirmed Total Label"}},"type":"object","title":"AgentTeamInsightCardRailResponse"},"AgentTeamInsightCardRailStalledResponse":{"properties":{"card_id":{"type":"string","format":"uuid","title":"Card Id"},"title":{"type":"string","title":"Title"},"idle_label":{"type":"string","title":"Idle Label"},"next_step":{"$ref":"#/components/schemas/AgentTeamInsightCardRailNextStepResponse"}},"type":"object","required":["card_id","title","idle_label","next_step"],"title":"AgentTeamInsightCardRailStalledResponse"},"AgentTeamInsightCardResolvingTileResponse":{"properties":{"count":{"type":"integer","minimum":0.0,"title":"Count","default":0},"next_readout_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Readout At"}},"type":"object","title":"AgentTeamInsightCardResolvingTileResponse"},"AgentTeamInsightCardResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"insight_key":{"type":"string","title":"Insight Key"},"native_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Native Version"},"title":{"type":"string","title":"Title"},"state":{"anyOf":[{"type":"string","enum":["waiting","in_flight","watching","measuring","resolved","dismissed","retracted","removed"]},{"type":"string"}],"title":"State"},"stance":{"$ref":"#/components/schemas/AgentTeamInsightCardStanceResponse"},"stance_reason":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardStanceReasonResponse"},{"type":"null"}]},"exploratory":{"type":"boolean","title":"Exploratory","default":false},"is_new":{"type":"boolean","title":"Is New","default":false},"stalled_since":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Stalled Since"},"resolution":{"anyOf":[{"type":"string","enum":["approved","modified","dismissed","auto","retracted","interrupted","removed"]},{"type":"string"},{"type":"null"}],"title":"Resolution"},"outcome":{"anyOf":[{"type":"string","enum":["won","neutral","lost","unmeasured"]},{"type":"string"},{"type":"null"}],"title":"Outcome"},"retraction":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardRetractionResponse"},{"type":"null"}]},"measurement_interruption":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardMeasurementInterruptionResponse"},{"type":"null"}]},"recommendation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recommendation"},"why_now":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Why Now"},"so_what":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"So What"},"presentation":{"anyOf":[{"$ref":"#/components/schemas/InsightPresentation"},{"type":"null"}]},"sources":{"items":{"$ref":"#/components/schemas/InsightSource"},"type":"array","title":"Sources"},"priority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority"},"change_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Scope"},"lane":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lane"},"approval_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Approval Id"},"review_approval_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Review Approval Id"},"key_metrics":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardMetricResponse"},"type":"array","title":"Key Metrics"},"timeline":{"$ref":"#/components/schemas/AgentTeamInsightCardTimelineResponse"},"results_state":{"anyOf":[{"type":"string","enum":["measuring","improved","regressed","neutral","unmeasured"]},{"type":"string"},{"type":"null"}],"title":"Results State"},"new_update_count":{"type":"integer","title":"New Update Count","default":0},"resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Resolved At"},"source_run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Run Id"},"latest_run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Latest Run Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank"},"cta":{"$ref":"#/components/schemas/AgentTeamInsightCardCtaResponse"},"staged_lanes":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardStagedLaneResponse"},"type":"array","title":"Staged Lanes"},"creatives_preview":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardCreativePreviewResponse"},"type":"array","title":"Creatives Preview"},"paid_media_context":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardPaidMediaContextResponse"},{"type":"null"}]},"source_agents":{"items":{"type":"string"},"type":"array","title":"Source Agents"}},"type":"object","required":["id","insight_key","title","state","stance","timeline","created_at","cta"],"title":"AgentTeamInsightCardResponse","description":"List-level card summary (the detail card extends this shape)."},"AgentTeamInsightCardRestoreResponse":{"properties":{"available":{"type":"boolean","title":"Available"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"}},"type":"object","required":["available"],"title":"AgentTeamInsightCardRestoreResponse"},"AgentTeamInsightCardRetractionResponse":{"properties":{"why":{"type":"string","title":"Why"},"what_is_true_instead":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"What Is True Instead"},"retracted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Retracted At"}},"type":"object","required":["why"],"title":"AgentTeamInsightCardRetractionResponse","description":"A withdrawn claim, said in the reader's words.\n\nCarried on every card that has one, so no surface can render the original\nsentence without also rendering the correction."},"AgentTeamInsightCardRoiTileResponse":{"properties":{"amount_cents":{"type":"integer","title":"Amount Cents"},"delta_label":{"type":"string","title":"Delta Label"},"measured":{"type":"boolean","title":"Measured","default":true}},"type":"object","required":["amount_cents","delta_label"],"title":"AgentTeamInsightCardRoiTileResponse"},"AgentTeamInsightCardSeenResponse":{"properties":{"last_seen_at":{"type":"string","format":"date-time","title":"Last Seen At"}},"type":"object","required":["last_seen_at"],"title":"AgentTeamInsightCardSeenResponse","description":"The receipt a card surface wrote after painting: the moment this reader\nwas shown the cards, which the next read compares \"New\" against."},"AgentTeamInsightCardSpendAtRiskTileResponse":{"properties":{"amount_cents":{"type":"integer","title":"Amount Cents"},"campaign_count":{"type":"integer","minimum":0.0,"title":"Campaign Count","default":0}},"type":"object","required":["amount_cents"],"title":"AgentTeamInsightCardSpendAtRiskTileResponse"},"AgentTeamInsightCardStagedFaceResponse":{"properties":{"name":{"type":"string","title":"Name"},"avatar":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar"}},"type":"object","required":["name"],"title":"AgentTeamInsightCardStagedFaceResponse","description":"One shortlisted creator, as a row can show them: a name and a face."},"AgentTeamInsightCardStagedItemResponse":{"properties":{"item_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Id"},"title":{"type":"string","title":"Title"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"audience_tension":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience Tension"},"hypothesis":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hypothesis"},"execution_mandate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Mandate"},"measurement_plan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Measurement Plan"},"fit_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fit Reason"},"engagement_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Engagement Hint"},"creative":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardCreativePreviewResponse"},{"type":"null"}]}},"type":"object","required":["title"],"title":"AgentTeamInsightCardStagedItemResponse"},"AgentTeamInsightCardStagedLaneHoldResponse":{"properties":{"held":{"type":"boolean","title":"Held","default":true},"reason":{"type":"string","title":"Reason","default":""}},"type":"object","title":"AgentTeamInsightCardStagedLaneHoldResponse","description":"A lane's slate held back by the Director's creative review (verdict\n\"drop\"). ``reason`` is the review's revision note — plain text, internal\nids stripped, bounded 300 chars."},"AgentTeamInsightCardStagedLaneResponse":{"properties":{"approval_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approval State"},"lane":{"type":"string","title":"Lane"},"count":{"type":"integer","minimum":0.0,"title":"Count"},"approval_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Approval Id"},"creatives":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardCreativePreviewResponse"},"type":"array","title":"Creatives"},"faces":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardStagedFaceResponse"},"type":"array","title":"Faces"},"hold":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardStagedLaneHoldResponse"},{"type":"null"}]}},"type":"object","required":["lane","count"],"title":"AgentTeamInsightCardStagedLaneResponse"},"AgentTeamInsightCardStagedWorkResponse":{"properties":{"lane":{"type":"string","title":"Lane"},"approval_id":{"type":"string","format":"uuid","title":"Approval Id"},"approval_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approval State"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"items":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardStagedItemResponse"},"type":"array","title":"Items"},"item_count":{"type":"integer","minimum":0.0,"title":"Item Count","default":0},"review_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Review Path"}},"type":"object","required":["lane","approval_id"],"title":"AgentTeamInsightCardStagedWorkResponse","description":"Work another lane staged for this insight (press plan, creator\nshortlist, discovered leads), with its why carried along."},"AgentTeamInsightCardStanceReasonResponse":{"properties":{"code":{"type":"string","enum":["not_accurate","not_useful","already_handled","other"],"title":"Code"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"At"},"by_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"By User Id"}},"type":"object","required":["code"],"title":"AgentTeamInsightCardStanceReasonResponse","description":"Why the reader dismissed this card, in their words or one of ours.\n\nSeparate from the stance itself, whose four-field contract the page\nmirrors exactly; a reason is an optional follow-up to a dismissal."},"AgentTeamInsightCardStanceRequest":{"properties":{"kind":{"type":"string","enum":["approved","dismissed","removed"],"title":"Kind"},"reason_code":{"anyOf":[{"type":"string","enum":["not_accurate","not_useful","already_handled","other"]},{"type":"null"}],"title":"Reason Code"},"reason_text":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reason Text"}},"type":"object","required":["kind"],"title":"AgentTeamInsightCardStanceRequest","description":"Where the marketer says they stand, pressed on one of three controls.\n\n``kind`` is the whole body: a stance is a view, so there is nothing to\nselect, schedule or authorise alongside it."},"AgentTeamInsightCardStanceResponse":{"properties":{"kind":{"type":"string","enum":["none","approved","dismissed","removed"],"title":"Kind"},"source":{"anyOf":[{"type":"string","enum":["explicit","inferred"]},{"type":"null"}],"title":"Source"},"at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"At"},"by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"By User Id"}},"type":"object","required":["kind"],"title":"AgentTeamInsightCardStanceResponse","description":"What the reader has said about this insight, and how they said it.\n\nFour fields, and this is the whole contract — the reader's page declares\nthe same four and nothing else. It was two shapes once, this one and a\n``{value, basis, at}`` the page invented, and every card on screen said\n\"Removed from your insights\" while no thumb ever drew as pressed.\n\nApproving records that they accept the insight. It does not ask this\nsystem to carry out the work, and nothing is offered to a lane because of\nit. Dismissing records that they do not accept it. Removing takes the card\noff their queue without judging the claim at all. And a reader who starts\nacting under an insight has accepted it, so the approval is recorded with\n``source`` reading ``inferred`` rather than ``explicit``."},"AgentTeamInsightCardSubActionAttemptResponse":{"properties":{"run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"},"status":{"type":"string","title":"Status"},"rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rationale"},"at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"At"}},"type":"object","required":["status"],"title":"AgentTeamInsightCardSubActionAttemptResponse","description":"The most recent run's word on a step it looked at and did not carry.\n\nWritten by the lane that declined the step, so the row can say why nothing\nhappened, instead of claiming work is under way."},"AgentTeamInsightCardSubActionResponse":{"properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Id"},"title":{"type":"string","title":"Title"},"status":{"anyOf":[{"type":"string","enum":["proposed","needs_approval","approved","executing","in_progress","live","completed","failed","blocked","cancelled"]},{"type":"string"}],"title":"Status"},"mode":{"type":"string","enum":["pomo","offline","group"],"title":"Mode"},"target":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardSubActionTargetResponse"},{"type":"null"}]},"completes_by":{"type":"string","enum":["your_check","your_approval","pomo","finished","stopped","waiting_on_earlier_step"],"title":"Completes By"},"actor":{"anyOf":[{"type":"string","enum":["pomo","you"]},{"type":"null"}],"title":"Actor"},"lane":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lane"},"idle_days":{"type":"integer","minimum":0.0,"title":"Idle Days","default":0},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"completion_basis":{"anyOf":[{"type":"string","enum":["observed","claimed"]},{"type":"null"}],"title":"Completion Basis"},"starts_measurement":{"type":"boolean","title":"Starts Measurement","default":false},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"studio":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardSubActionStudioResponse"},{"type":"null"}]},"children":{"items":{"$ref":"#/components/schemas/AgentTeamInsightCardSubActionResponse"},"type":"array","title":"Children"},"blocked_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Blocked By"},"execution_status":{"type":"string","enum":["not_started","running","staged","done","skipped","blocked"],"title":"Execution Status","default":"not_started"},"last_attempt":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardSubActionAttemptResponse"},{"type":"null"}]}},"type":"object","required":["title","status","mode","completes_by"],"title":"AgentTeamInsightCardSubActionResponse"},"AgentTeamInsightCardSubActionStudioResponse":{"properties":{"path":{"type":"string","title":"Path"},"label":{"type":"string","title":"Label"},"topic":{"type":"string","title":"Topic","default":""},"evidence":{"type":"string","title":"Evidence","default":""},"article_type":{"type":"string","title":"Article Type","default":"answer_page"}},"type":"object","required":["path","label"],"title":"AgentTeamInsightCardSubActionStudioResponse","description":"Where a studio-carried step opens inside Pomo, with its brief."},"AgentTeamInsightCardSubActionTargetResponse":{"properties":{"kind":{"type":"string","enum":["review_launch","review_schedule","review_optimization","run_test","open_press","open_influencer","review_growth","acknowledge","view"],"title":"Kind"},"approval_id":{"type":"string","format":"uuid","title":"Approval Id"},"label":{"type":"string","title":"Label"}},"type":"object","required":["kind","approval_id","label"],"title":"AgentTeamInsightCardSubActionTargetResponse","description":"The artifact Pomo produced for one step, named in CTA vocabulary.\n\nThe frontend owns every href (SPEC §0.1), so this carries the kind and the\napproval that holds the work — the same pair the card's own CTA routes\nfrom — and never a path. Null on every row with no resolvable artifact: a\nstep Pomo handles invisibly must not claim otherwise."},"AgentTeamInsightCardTilesResponse":{"properties":{"top_mover":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardTopMoverTileResponse"},{"type":"null"}]},"resolving_this_week":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardResolvingTileResponse"},{"type":"null"}]},"spend_at_risk":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardSpendAtRiskTileResponse"},{"type":"null"}]},"roi_captured":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamInsightCardRoiTileResponse"},{"type":"null"}]}},"type":"object","title":"AgentTeamInsightCardTilesResponse","description":"Any tile may be null — the frontend hides it (never fabricated)."},"AgentTeamInsightCardTimelineResponse":{"properties":{"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"readout_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Readout At"},"window_days":{"type":"integer","title":"Window Days","default":0},"source":{"type":"string","enum":["authored","estimated"],"title":"Source","default":"estimated"},"days_elapsed":{"type":"integer","minimum":0.0,"title":"Days Elapsed","default":0},"days_left":{"type":"integer","minimum":0.0,"title":"Days Left","default":0}},"type":"object","title":"AgentTeamInsightCardTimelineResponse"},"AgentTeamInsightCardTopMoverTileResponse":{"properties":{"label":{"type":"string","title":"Label"},"delta_label":{"type":"string","title":"Delta Label"},"source":{"type":"string","title":"Source"}},"type":"object","required":["label","delta_label","source"],"title":"AgentTeamInsightCardTopMoverTileResponse"},"AgentTeamInteractionPolicyResponse":{"properties":{"phase":{"type":"integer","enum":[1,2,3],"title":"Phase"},"phase_label":{"type":"string","title":"Phase Label"},"manager_control_plane":{"type":"boolean","title":"Manager Control Plane","default":true},"manager_commit_required":{"type":"boolean","title":"Manager Commit Required","default":true},"commit_intents_enabled":{"type":"boolean","title":"Commit Intents Enabled","default":false},"non_manager_proposal_only":{"type":"boolean","title":"Non Manager Proposal Only","default":true},"phase1_specialist_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phase1 Specialist Key"},"allowed_non_manager_agent_keys":{"items":{"type":"string"},"type":"array","title":"Allowed Non Manager Agent Keys"},"allowed_agent_keys":{"items":{"type":"string"},"type":"array","title":"Allowed Agent Keys"},"active_agent_keys":{"items":{"type":"string"},"type":"array","title":"Active Agent Keys"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"updated_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated By User Id"}},"type":"object","required":["phase","phase_label"],"title":"AgentTeamInteractionPolicyResponse"},"AgentTeamInteractionPolicyUpdateRequest":{"properties":{"phase":{"type":"integer","enum":[1,2,3],"title":"Phase"},"phase1_specialist_key":{"anyOf":[{"type":"string","maxLength":64,"minLength":1},{"type":"null"}],"title":"Phase1 Specialist Key"}},"type":"object","required":["phase"],"title":"AgentTeamInteractionPolicyUpdateRequest"},"AgentTeamLaunchAccountOverrides":{"properties":{"google_account_id":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Google Account Id"},"login_customer_id":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Login Customer Id"},"ad_account_id":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Ad Account Id"},"meta_account_id":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Meta Account Id"},"page_id":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Page Id"},"instagram_account_id":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Instagram Account Id"},"advertiser_id":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Advertiser Id"},"tiktok_advertiser_id":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Tiktok Advertiser Id"}},"type":"object","title":"AgentTeamLaunchAccountOverrides"},"AgentTeamLearningNoteUpdateRequest":{"properties":{"markdown":{"type":"string","maxLength":20000,"minLength":1,"title":"Markdown"}},"type":"object","required":["markdown"],"title":"AgentTeamLearningNoteUpdateRequest"},"AgentTeamLearningSummaryResponse":{"properties":{"learning_notes":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Learning Notes"}},"type":"object","title":"AgentTeamLearningSummaryResponse"},"AgentTeamListResponse":{"properties":{"teams":{"items":{"$ref":"#/components/schemas/AgentTeamResponse"},"type":"array","title":"Teams"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["teams","total"],"title":"AgentTeamListResponse"},"AgentTeamMessageListResponse":{"properties":{"messages":{"items":{"$ref":"#/components/schemas/AgentTeamMessageResponse"},"type":"array","title":"Messages"},"total":{"type":"integer","title":"Total"},"has_more":{"type":"boolean","title":"Has More","default":false},"next_cursor_created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Cursor Created At"},"next_cursor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Next Cursor Id"}},"type":"object","required":["messages","total"],"title":"AgentTeamMessageListResponse"},"AgentTeamMessageResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"team_id":{"type":"string","format":"uuid","title":"Team Id"},"run_id":{"type":"string","format":"uuid","title":"Run Id"},"from_agent_key":{"type":"string","title":"From Agent Key"},"to_agent_key":{"type":"string","title":"To Agent Key"},"message_type":{"type":"string","title":"Message Type"},"content":{"type":"string","title":"Content"},"payload_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payload Json"},"correlation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Correlation Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","team_id","run_id","from_agent_key","to_agent_key","message_type","content","created_at"],"title":"AgentTeamMessageResponse"},"AgentTeamMissionFeedEntryResponse":{"properties":{"id":{"type":"string","title":"Id"},"team_id":{"type":"string","format":"uuid","title":"Team Id"},"run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"},"source_type":{"type":"string","title":"Source Type"},"event_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Type"},"actor":{"type":"string","title":"Actor"},"title":{"type":"string","title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"severity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Severity"},"payload_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payload Json"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","team_id","source_type","actor","title","created_at"],"title":"AgentTeamMissionFeedEntryResponse"},"AgentTeamMissionFeedListResponse":{"properties":{"entries":{"items":{"$ref":"#/components/schemas/AgentTeamMissionFeedEntryResponse"},"type":"array","title":"Entries"},"total":{"type":"integer","title":"Total"},"has_more":{"type":"boolean","title":"Has More","default":false},"next_cursor_created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Cursor Created At"},"next_cursor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor Id"}},"type":"object","required":["entries","total"],"title":"AgentTeamMissionFeedListResponse"},"AgentTeamModuleResponse":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"description":{"type":"string","title":"Description"},"enabled":{"type":"boolean","title":"Enabled"},"disableable":{"type":"boolean","title":"Disableable","default":true},"coordinator_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coordinator Key"},"member_agent_keys":{"items":{"type":"string"},"type":"array","title":"Member Agent Keys"},"member_display_names":{"items":{"type":"string"},"type":"array","title":"Member Display Names"},"disabled_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Disabled Reason"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"updated_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated By User Id"}},"type":"object","required":["key","label","description","enabled"],"title":"AgentTeamModuleResponse"},"AgentTeamModuleUpdate":{"properties":{"enabled":{"type":"boolean","title":"Enabled"}},"type":"object","required":["enabled"],"title":"AgentTeamModuleUpdate"},"AgentTeamOptimizationApplyRequest":{"properties":{"confirmed_measurement_card_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":50,"title":"Confirmed Measurement Card Ids"}},"type":"object","title":"AgentTeamOptimizationApplyRequest","description":"The exact live measurements the review surface warned about.\n\nThe server rechecks this list before any provider mutation. A new conflict\nthat was not visible in the review is a 409, not silent consent to discard\nanother result."},"AgentTeamOverviewResponse":{"properties":{"feature_enabled":{"type":"boolean","title":"Feature Enabled"},"feature_access":{"type":"boolean","title":"Feature Access"},"required_tier":{"type":"string","title":"Required Tier"},"current_tier":{"type":"string","title":"Current Tier"},"team_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"},"morning_brief":{"anyOf":[{"$ref":"#/components/schemas/MorningBriefResponse"},{"type":"null"}]},"timings_ms":{"additionalProperties":{"type":"number"},"type":"object","title":"Timings Ms"}},"type":"object","required":["feature_enabled","feature_access","required_tier","current_tier"],"title":"AgentTeamOverviewResponse","description":"Purpose-built read model for the overview morning brief.\n\nThe overview does not need the agent catalog, team settings, workspace\nactivity collections, or report payloads carried by ``workspace-init``.\nKeeping this contract intentionally small prevents those unrelated shapes\nfrom drifting back onto the critical navigation path."},"AgentTeamPendingRunGuidanceResponse":{"properties":{"team_id":{"type":"string","format":"uuid","title":"Team Id"},"run_guidance":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamRunGuidanceResponse"},{"type":"null"}]}},"type":"object","required":["team_id"],"title":"AgentTeamPendingRunGuidanceResponse"},"AgentTeamPolicyAgentResponse":{"properties":{"agent_key":{"type":"string","title":"Agent Key"},"label":{"type":"string","title":"Label"},"description":{"type":"string","title":"Description"},"default_display_name":{"type":"string","title":"Default Display Name"},"role":{"type":"string","title":"Role"},"required":{"type":"boolean","title":"Required"},"configurable":{"type":"boolean","title":"Configurable"},"enabled_by_default":{"type":"boolean","title":"Enabled By Default"}},"type":"object","required":["agent_key","label","description","default_display_name","role","required","configurable","enabled_by_default"],"title":"AgentTeamPolicyAgentResponse"},"AgentTeamPolicyModuleResponse":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"description":{"type":"string","title":"Description"},"coordinator_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coordinator Key"},"member_agent_keys":{"items":{"type":"string"},"type":"array","title":"Member Agent Keys"}},"type":"object","required":["key","label","description","member_agent_keys"],"title":"AgentTeamPolicyModuleResponse"},"AgentTeamPolicyResponse":{"properties":{"feature_enabled":{"type":"boolean","title":"Feature Enabled"},"feature_access":{"type":"boolean","title":"Feature Access"},"required_tier":{"type":"string","title":"Required Tier"},"current_tier":{"type":"string","title":"Current Tier"},"upgrade_url":{"type":"string","title":"Upgrade Url"},"required_agent_keys":{"items":{"type":"string"},"type":"array","title":"Required Agent Keys"},"optional_agent_keys":{"items":{"type":"string"},"type":"array","title":"Optional Agent Keys"},"available_agents":{"items":{"$ref":"#/components/schemas/AgentTeamPolicyAgentResponse"},"type":"array","title":"Available Agents"},"modules":{"items":{"$ref":"#/components/schemas/AgentTeamPolicyModuleResponse"},"type":"array","title":"Modules"},"default_schedule_minutes":{"type":"integer","title":"Default Schedule Minutes"},"schedule_options_minutes":{"items":{"type":"integer"},"type":"array","title":"Schedule Options Minutes"},"default_approval_mode":{"type":"string","enum":["approval_first","auto_low_risk","auto_all"],"title":"Default Approval Mode"},"startup_contract":{"additionalProperties":true,"type":"object","title":"Startup Contract"}},"type":"object","required":["feature_enabled","feature_access","required_tier","current_tier","upgrade_url","required_agent_keys","optional_agent_keys","available_agents","default_schedule_minutes","schedule_options_minutes","default_approval_mode","startup_contract"],"title":"AgentTeamPolicyResponse"},"AgentTeamRecommendationListResponse":{"properties":{"recommendations":{"items":{"$ref":"#/components/schemas/AgentTeamRecommendationResponse"},"type":"array","title":"Recommendations"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["recommendations","total"],"title":"AgentTeamRecommendationListResponse"},"AgentTeamRecommendationOutcomeRequest":{"properties":{"outcome":{"type":"string","enum":["improved","neutral","regressed","failed","unknown"],"title":"Outcome"},"summary":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Summary"},"kpi_delta_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Kpi Delta Json"},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"}},"type":"object","required":["outcome"],"title":"AgentTeamRecommendationOutcomeRequest"},"AgentTeamRecommendationOutcomeResponse":{"properties":{"recommendation":{"$ref":"#/components/schemas/AgentTeamRecommendationResponse"},"reliability":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamAgentReliabilityResponse"},{"type":"null"}]},"followup_run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Followup Run Id"},"followup_reused_inflight":{"type":"boolean","title":"Followup Reused Inflight","default":false}},"type":"object","required":["recommendation"],"title":"AgentTeamRecommendationOutcomeResponse"},"AgentTeamRecommendationResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"team_id":{"type":"string","format":"uuid","title":"Team Id"},"run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"},"recommendation_key":{"type":"string","title":"Recommendation Key"},"recommendation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recommendation Id"},"owner_agent_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner Agent Key"},"title":{"type":"string","title":"Title"},"priority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority"},"risk":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Risk"},"rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rationale"},"approval_state":{"type":"string","title":"Approval State"},"lifecycle_state":{"anyOf":[{"type":"string","enum":["proposed","needs_approval","approved","rejected","ready_for_execution","observing","completed","cancelled"]},{"type":"string"}],"title":"Lifecycle State"},"status_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Note"},"approval_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Approval Id"},"approved_by_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Approved By User Id"},"rejected_by_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Rejected By User Id"},"first_seen_at":{"type":"string","format":"date-time","title":"First Seen At"},"last_seen_at":{"type":"string","format":"date-time","title":"Last Seen At"},"approved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Approved At"},"rejected_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Rejected At"},"kpi_snapshot_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Kpi Snapshot Json"},"kpi_delta_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Kpi Delta Json"},"metadata_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata Json"},"latest_outcome_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Latest Outcome Json"},"outcome_history_json":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Outcome History Json"},"goal_alignment_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Goal Alignment Score"},"goal_alignment_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Goal Alignment Level"},"goal_alignment_notes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Goal Alignment Notes"},"evidence_json":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Evidence Json"},"citation_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Citation Urls"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","team_id","recommendation_key","title","approval_state","lifecycle_state","first_seen_at","last_seen_at","created_at","updated_at"],"title":"AgentTeamRecommendationResponse"},"AgentTeamReportFeedbackCueClaimRequest":{"properties":{"approval_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Approval Id"},"subject_type":{"type":"string","enum":["agent_team_action","agent_team_recommendation","agent_team_insight_card"],"title":"Subject Type"},"subject_id":{"type":"string","format":"uuid","title":"Subject Id"},"surface":{"type":"string","const":"reports","title":"Surface"},"client_request_id":{"type":"string","format":"uuid","title":"Client Request Id"},"card_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Card Id"},"section":{"anyOf":[{"type":"string","enum":["recommendation","plan","result"]},{"type":"null"}],"title":"Section"},"source_revision":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}],"title":"Source Revision"},"source_content_hash":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}],"title":"Source Content Hash"}},"additionalProperties":false,"type":"object","required":["subject_type","subject_id","surface","client_request_id"],"title":"AgentTeamReportFeedbackCueClaimRequest"},"AgentTeamReportFeedbackCueClaimResponse":{"properties":{"claimed":{"type":"boolean","title":"Claimed"},"reason":{"type":"string","enum":["claimed","already_shown","answered","subject_suppressed","profile_opted_out","organization_opted_out","cooldown_active","report_decision_pending","governance_review_pending"],"title":"Reason"},"exposure_event_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Exposure Event Id"},"shown_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Shown At"},"cooldown_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cooldown Until"}},"type":"object","required":["claimed","reason"],"title":"AgentTeamReportFeedbackCueClaimResponse"},"AgentTeamReportFeedbackCueDispositionRequest":{"properties":{"disposition":{"type":"string","enum":["dismissed","skipped","subject_suppressed","opted_out"],"title":"Disposition"},"client_request_id":{"type":"string","format":"uuid","title":"Client Request Id"},"preference_scope":{"anyOf":[{"type":"string","enum":["profile","organization"]},{"type":"null"}],"title":"Preference Scope"}},"additionalProperties":false,"type":"object","required":["disposition","client_request_id"],"title":"AgentTeamReportFeedbackCueDispositionRequest"},"AgentTeamReportFeedbackCueDispositionResponse":{"properties":{"event_id":{"type":"string","format":"uuid","title":"Event Id"},"disposition":{"type":"string","enum":["dismissed","skipped","subject_suppressed","opted_out"],"title":"Disposition"},"occurred_at":{"type":"string","format":"date-time","title":"Occurred At"}},"type":"object","required":["event_id","disposition","occurred_at"],"title":"AgentTeamReportFeedbackCueDispositionResponse"},"AgentTeamReportFeedbackSubjectResponse":{"properties":{"approval_id":{"type":"string","format":"uuid","title":"Approval Id"},"run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"},"subject_type":{"type":"string","enum":["agent_team_action","agent_team_recommendation"],"title":"Subject Type"},"subject_id":{"type":"string","format":"uuid","title":"Subject Id"},"current_event_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Current Event Id"},"current_sequence":{"type":"integer","minimum":0.0,"title":"Current Sequence","default":0},"feedback":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamReportFeedbackValueResponse"},{"type":"null"}]},"use_status":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamReportFeedbackUseStatusResponse"},{"type":"null"}]}},"type":"object","required":["approval_id","subject_type","subject_id"],"title":"AgentTeamReportFeedbackSubjectResponse"},"AgentTeamReportFeedbackUseStatusResponse":{"properties":{"status":{"type":"string","const":"included_as_context","title":"Status"},"run_id":{"type":"string","format":"uuid","title":"Run Id"},"applied_at":{"type":"string","format":"date-time","title":"Applied At"}},"type":"object","required":["status","run_id","applied_at"],"title":"AgentTeamReportFeedbackUseStatusResponse"},"AgentTeamReportFeedbackValueResponse":{"properties":{"reason_code":{"type":"string","enum":["more_like_this","not_relevant","incorrect","missing_context","unclear","not_actionable","other"],"title":"Reason Code"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"submitted_at":{"type":"string","format":"date-time","title":"Submitted At"},"remember_for_brand":{"type":"boolean","title":"Remember For Brand","default":false}},"type":"object","required":["reason_code","submitted_at"],"title":"AgentTeamReportFeedbackValueResponse"},"AgentTeamReportFeedbackWriteRequest":{"properties":{"operation":{"type":"string","enum":["set","retract"],"title":"Operation"},"subject_type":{"type":"string","enum":["agent_team_action","agent_team_recommendation"],"title":"Subject Type"},"subject_id":{"type":"string","format":"uuid","title":"Subject Id"},"reason_code":{"anyOf":[{"type":"string","enum":["more_like_this","not_relevant","incorrect","missing_context","unclear","not_actionable","other"]},{"type":"null"}],"title":"Reason Code"},"note":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Note"},"client_request_id":{"type":"string","format":"uuid","title":"Client Request Id"},"expected_current_event_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Expected Current Event Id"}},"type":"object","required":["operation","subject_type","subject_id","client_request_id"],"title":"AgentTeamReportFeedbackWriteRequest"},"AgentTeamReportHomeSummaryResponse":{"properties":{"decision_items":{"type":"integer","title":"Decision Items","default":0},"creative_assets":{"type":"integer","title":"Creative Assets","default":0},"latest_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Title"},"latest_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Latest At"},"run_guidance":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamRunGuidanceResponse"},{"type":"null"}]},"sections":{"additionalProperties":{"$ref":"#/components/schemas/AgentTeamReportSectionSummaryResponse"},"type":"object","title":"Sections"},"authored_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authored Summary"},"authored_summary_generated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Authored Summary Generated At"}},"type":"object","title":"AgentTeamReportHomeSummaryResponse"},"AgentTeamReportSectionEvidenceResponse":{"properties":{"label":{"type":"string","title":"Label"},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"},"tone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tone"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["label"],"title":"AgentTeamReportSectionEvidenceResponse"},"AgentTeamReportSectionSummaryResponse":{"properties":{"item_count":{"type":"integer","title":"Item Count","default":0},"asset_count":{"type":"integer","title":"Asset Count","default":0},"latest_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Title"},"latest_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Latest At"},"headline_metric":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline Metric"},"headline_delta":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline Delta"},"status_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Label"},"status_tone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Tone"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"attention_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Attention Count"},"evidence":{"items":{"$ref":"#/components/schemas/AgentTeamReportSectionEvidenceResponse"},"type":"array","title":"Evidence"}},"type":"object","title":"AgentTeamReportSectionSummaryResponse"},"AgentTeamReportSelectionResponse":{"properties":{"status":{"type":"string","enum":["latest","resolved","not_found"],"title":"Status"},"requested_run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Requested Run Id"},"resolved_run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Resolved Run Id"}},"type":"object","required":["status"],"title":"AgentTeamReportSelectionResponse","description":"Authoritative resolution of the report run requested by the client."},"AgentTeamReportWorkspaceResponse":{"properties":{"approvals":{"items":{"$ref":"#/components/schemas/AgentTeamApprovalResponse"},"type":"array","title":"Approvals"},"recommendations":{"items":{"$ref":"#/components/schemas/AgentTeamRecommendationResponse"},"type":"array","title":"Recommendations"},"actions":{"items":{"$ref":"#/components/schemas/AgentTeamActionResponse"},"type":"array","title":"Actions"},"ads_performance_reports":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Ads Performance Reports"},"claim_safety_notices":{"items":{"$ref":"#/components/schemas/AgentTeamClaimSafetyNoticeResponse"},"type":"array","title":"Claim Safety Notices"},"total":{"type":"integer","title":"Total","default":0},"has_more":{"type":"boolean","title":"Has More","default":false},"offset":{"type":"integer","title":"Offset","default":0},"limit":{"type":"integer","title":"Limit","default":0},"next_offset":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Next Offset"},"timings_ms":{"additionalProperties":{"type":"number"},"type":"object","title":"Timings Ms"}},"type":"object","title":"AgentTeamReportWorkspaceResponse"},"AgentTeamResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"created_by_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Created By User Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","enum":["active","paused","error","deleted"],"title":"Status"},"approval_mode":{"type":"string","title":"Approval Mode"},"template_version":{"type":"string","title":"Template Version"},"default_schedule_minutes":{"type":"integer","title":"Default Schedule Minutes"},"next_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Run At"},"last_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Run At"},"last_run_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Run Status"},"task_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Task Id"},"conversation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Conversation Id"},"settings_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Settings Json"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","organization_id","company_profile_id","name","status","approval_mode","template_version","default_schedule_minutes","created_at","updated_at"],"title":"AgentTeamResponse"},"AgentTeamRoutineStepResponse":{"properties":{"step_id":{"type":"string","title":"Step Id"},"label":{"type":"string","title":"Label"},"required_tool_packs":{"items":{"type":"string"},"type":"array","title":"Required Tool Packs"}},"type":"object","required":["step_id","label"],"title":"AgentTeamRoutineStepResponse"},"AgentTeamRunGraphResponse":{"properties":{"team_id":{"type":"string","format":"uuid","title":"Team Id"},"run_id":{"type":"string","format":"uuid","title":"Run Id"},"version":{"type":"integer","title":"Version","default":1},"template":{"type":"string","title":"Template","default":"team_graph_v1"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"meta":{"additionalProperties":true,"type":"object","title":"Meta"},"progress":{"additionalProperties":{"type":"integer"},"type":"object","title":"Progress"},"diagnostics":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Diagnostics"},"critical_path":{"additionalProperties":true,"type":"object","title":"Critical Path"},"nodes":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Nodes"},"edges":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Edges"}},"type":"object","required":["team_id","run_id"],"title":"AgentTeamRunGraphResponse"},"AgentTeamRunGuidanceResponse":{"properties":{"version":{"type":"integer","title":"Version","default":1},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"text":{"type":"string","title":"Text"},"created_by_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Created By User Id"},"created_by_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By Name"},"created_by_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By Email"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["text"],"title":"AgentTeamRunGuidanceResponse"},"AgentTeamRunGuidanceSaveRequest":{"properties":{"custom_instructions":{"anyOf":[{"type":"string","maxLength":600},{"type":"null"}],"title":"Custom Instructions","description":"Focus saved for the team's next run. Empty or null clears the saved focus."}},"type":"object","title":"AgentTeamRunGuidanceSaveRequest"},"AgentTeamRunListResponse":{"properties":{"runs":{"items":{"$ref":"#/components/schemas/AgentTeamRunResponse"},"type":"array","title":"Runs"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["runs","total"],"title":"AgentTeamRunListResponse"},"AgentTeamRunNodeInterventionRequest":{"properties":{"action":{"type":"string","enum":["retry","skip","reprioritize"],"title":"Action"},"node_id":{"type":"string","maxLength":255,"minLength":3,"title":"Node Id"},"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"},"backoff_seconds":{"anyOf":[{"type":"integer","maximum":900.0,"minimum":1.0},{"type":"null"}],"title":"Backoff Seconds"},"priority_boost":{"anyOf":[{"type":"number","maximum":5.0,"minimum":-5.0},{"type":"null"}],"title":"Priority Boost"}},"type":"object","required":["action","node_id"],"title":"AgentTeamRunNodeInterventionRequest"},"AgentTeamRunNodeInterventionResponse":{"properties":{"run":{"$ref":"#/components/schemas/AgentTeamRunResponse"},"graph":{"$ref":"#/components/schemas/AgentTeamRunGraphResponse"}},"type":"object","required":["run","graph"],"title":"AgentTeamRunNodeInterventionResponse"},"AgentTeamRunNowRequest":{"properties":{"custom_instructions":{"anyOf":[{"type":"string","maxLength":600},{"type":"null"}],"title":"Custom Instructions","description":"Optional one-run guidance used as an AI Team prioritization lens."},"ad_optimization_metric_mode":{"anyOf":[{"type":"string","const":"simulation"},{"type":"null"}],"title":"Ad Optimization Metric Mode","description":"Explicitly run the paid-media audit against isolated simulation facts. Omitted means production provider evidence. Simulation runs never poll providers and never execute recommendations."}},"type":"object","title":"AgentTeamRunNowRequest"},"AgentTeamRunNowResponse":{"properties":{"team":{"$ref":"#/components/schemas/AgentTeamResponse"},"run":{"$ref":"#/components/schemas/AgentTeamRunResponse"},"created_new":{"type":"boolean","title":"Created New","default":false},"reused_inflight":{"type":"boolean","title":"Reused Inflight","default":false}},"type":"object","required":["team","run"],"title":"AgentTeamRunNowResponse"},"AgentTeamRunResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"team_id":{"type":"string","format":"uuid","title":"Team Id"},"trigger_type":{"type":"string","title":"Trigger Type"},"status":{"type":"string","enum":["queued","running","cancelling","cancelled","completed","failed"],"title":"Status"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"summary_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary Text"},"summary_markdown":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary Markdown"},"report_headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Headline"},"run_guidance":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamRunGuidanceResponse"},{"type":"null"}]},"stats_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Stats Json"},"run_lifecycle":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Run Lifecycle"},"error_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Text"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","team_id","trigger_type","status","created_at","updated_at"],"title":"AgentTeamRunResponse"},"AgentTeamRunStopRequest":{"properties":{"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"}},"type":"object","title":"AgentTeamRunStopRequest"},"AgentTeamRuntimeControlsUpdate":{"properties":{"execution_mode":{"anyOf":[{"type":"string","enum":["prepare_only","approval_gated_execute"]},{"type":"null"}],"title":"Execution Mode"},"require_approval_for_external_actions":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Require Approval For External Actions"},"max_external_actions_per_run":{"anyOf":[{"type":"integer","maximum":10.0,"minimum":0.0},{"type":"null"}],"title":"Max External Actions Per Run"},"inbox_max_drafts_per_run":{"anyOf":[{"type":"integer","maximum":250.0,"minimum":0.0},{"type":"null"}],"title":"Inbox Max Drafts Per Run"},"allow_high_risk_execution":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Allow High Risk Execution"},"max_creative_generations_per_run":{"anyOf":[{"type":"integer","maximum":10.0,"minimum":0.0},{"type":"null"}],"title":"Max Creative Generations Per Run"},"auto_progress_approved_actions":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Auto Progress Approved Actions"},"max_auto_progress_per_run":{"anyOf":[{"type":"integer","maximum":10.0,"minimum":0.0},{"type":"null"}],"title":"Max Auto Progress Per Run"},"auto_progress_allow_high_risk":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Auto Progress Allow High Risk"},"slack_send_manager_reports":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Slack Send Manager Reports"},"slack_send_approval_alerts":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Slack Send Approval Alerts"},"slack_channel_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Slack Channel Id"}},"type":"object","title":"AgentTeamRuntimeControlsUpdate"},"AgentTeamScheduleSettingsUpdate":{"properties":{"jitter_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Jitter Enabled"},"jitter_seconds_max":{"anyOf":[{"type":"integer","maximum":600.0,"minimum":0.0},{"type":"null"}],"title":"Jitter Seconds Max"}},"type":"object","title":"AgentTeamScheduleSettingsUpdate"},"AgentTeamSnoozeCondition":{"properties":{"metric":{"type":"string","enum":["cpa","conversions","conversion_rate","ctr","cpc","spend"],"title":"Metric"},"comparator":{"type":"string","enum":["above","below"],"title":"Comparator"},"threshold":{"type":"number","title":"Threshold"},"consecutive_days":{"type":"integer","maximum":14.0,"minimum":1.0,"title":"Consecutive Days","default":1}},"additionalProperties":false,"type":"object","required":["metric","comparator","threshold"],"title":"AgentTeamSnoozeCondition","description":"Bring a snoozed recommendation back when a metric crosses a line.\n\n\"Remind me when cost per conversion is above $45 for 3 days\" -- the\ncondition is stored on the approval and evaluated by the paid-media\nservice against the campaign's completed-day metrics."},"AgentTeamStartFreshRequest":{"properties":{"clear_agent_memory":{"type":"boolean","title":"Clear Agent Memory","default":true},"clear_pending_commands":{"type":"boolean","title":"Clear Pending Commands","default":true},"clear_open_approvals":{"type":"boolean","title":"Clear Open Approvals","default":true},"clear_active_recommendations":{"type":"boolean","title":"Clear Active Recommendations","default":true},"clear_active_actions":{"type":"boolean","title":"Clear Active Actions","default":true},"clear_run_history":{"type":"boolean","title":"Clear Run History","default":true},"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"}},"type":"object","title":"AgentTeamStartFreshRequest"},"AgentTeamStartFreshResponse":{"properties":{"team":{"$ref":"#/components/schemas/AgentTeamResponse"},"started_fresh_at":{"type":"string","format":"date-time","title":"Started Fresh At"},"cleared_memory_items":{"type":"integer","minimum":0.0,"title":"Cleared Memory Items","default":0},"dismissed_commands":{"type":"integer","minimum":0.0,"title":"Dismissed Commands","default":0},"expired_approvals":{"type":"integer","minimum":0.0,"title":"Expired Approvals","default":0},"cancelled_recommendations":{"type":"integer","minimum":0.0,"title":"Cancelled Recommendations","default":0},"cancelled_actions":{"type":"integer","minimum":0.0,"title":"Cancelled Actions","default":0},"cleared_events":{"type":"integer","minimum":0.0,"title":"Cleared Events","default":0},"cleared_messages":{"type":"integer","minimum":0.0,"title":"Cleared Messages","default":0},"cleared_runs":{"type":"integer","minimum":0.0,"title":"Cleared Runs","default":0},"cleared_summaries":{"type":"integer","minimum":0.0,"title":"Cleared Summaries","default":0},"audit_run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Audit Run Id"}},"type":"object","required":["team","started_fresh_at"],"title":"AgentTeamStartFreshResponse"},"AgentTeamUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Name"},"schedule_minutes":{"anyOf":[{"type":"integer","maximum":10080.0,"minimum":1.0},{"type":"null"}],"title":"Schedule Minutes"},"approval_mode":{"anyOf":[{"type":"string","enum":["approval_first","auto_low_risk","auto_all"]},{"type":"null"}],"title":"Approval Mode"},"runtime_controls":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamRuntimeControlsUpdate"},{"type":"null"}]},"schedule_settings":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamScheduleSettingsUpdate"},{"type":"null"}]},"module_settings":{"anyOf":[{"additionalProperties":{"$ref":"#/components/schemas/AgentTeamModuleUpdate"},"type":"object"},{"type":"null"}],"title":"Module Settings"}},"type":"object","title":"AgentTeamUpdate"},"AgentTeamWorkspaceBootstrapResponse":{"properties":{"approvals":{"items":{"$ref":"#/components/schemas/AgentTeamApprovalResponse"},"type":"array","title":"Approvals"},"recommendations":{"items":{"$ref":"#/components/schemas/AgentTeamRecommendationResponse"},"type":"array","title":"Recommendations"},"actions":{"items":{"$ref":"#/components/schemas/AgentTeamActionResponse"},"type":"array","title":"Actions"},"runs":{"items":{"$ref":"#/components/schemas/AgentTeamRunResponse"},"type":"array","title":"Runs"},"mission_feed":{"items":{"$ref":"#/components/schemas/AgentTeamMissionFeedEntryResponse"},"type":"array","title":"Mission Feed"},"timings_ms":{"additionalProperties":{"type":"number"},"type":"object","title":"Timings Ms"}},"type":"object","required":["approvals","recommendations","actions","runs","mission_feed"],"title":"AgentTeamWorkspaceBootstrapResponse"},"AgentTeamWorkspaceInitResponse":{"properties":{"policy":{"$ref":"#/components/schemas/AgentTeamPolicyResponse"},"team":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamDetailResponse"},{"type":"null"}]},"approvals":{"items":{"$ref":"#/components/schemas/AgentTeamApprovalResponse"},"type":"array","title":"Approvals"},"recommendations":{"items":{"$ref":"#/components/schemas/AgentTeamRecommendationResponse"},"type":"array","title":"Recommendations"},"actions":{"items":{"$ref":"#/components/schemas/AgentTeamActionResponse"},"type":"array","title":"Actions"},"runs":{"items":{"$ref":"#/components/schemas/AgentTeamRunResponse"},"type":"array","title":"Runs"},"mission_feed":{"items":{"$ref":"#/components/schemas/AgentTeamMissionFeedEntryResponse"},"type":"array","title":"Mission Feed"},"report_summary":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamReportHomeSummaryResponse"},{"type":"null"}]},"presentation_daily_report":{"anyOf":[{"$ref":"#/components/schemas/PresentationDailyReportResponse"},{"type":"null"}]},"report_selection":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamReportSelectionResponse"},{"type":"null"}]},"director_insight_projection":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamDirectorInsightProjectionResponse"},{"type":"null"}]},"morning_brief":{"anyOf":[{"$ref":"#/components/schemas/MorningBriefResponse"},{"type":"null"}]},"ads_performance_reports":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Ads Performance Reports"},"report_feedback_subjects":{"items":{"$ref":"#/components/schemas/AgentTeamReportFeedbackSubjectResponse"},"type":"array","title":"Report Feedback Subjects"},"claim_safety_notices":{"items":{"$ref":"#/components/schemas/AgentTeamClaimSafetyNoticeResponse"},"type":"array","title":"Claim Safety Notices"},"timings_ms":{"additionalProperties":{"type":"number"},"type":"object","title":"Timings Ms"}},"type":"object","required":["policy"],"title":"AgentTeamWorkspaceInitResponse"},"AiPolicyActivateVersionRequest":{"properties":{"version_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version Id"},"version_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":20},{"type":"null"}],"title":"Version Ids"}},"type":"object","title":"AiPolicyActivateVersionRequest","description":"Backwards-compatible activation request.\n\n- `version_id`: activate a single version\n- `version_ids`: activate a policy set (multiple versions), in the provided order"},"AiPolicyContextWarningResponse":{"properties":{"found":{"type":"boolean","title":"Found","default":false},"evaluation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evaluation Id"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"ai_policy_eval":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Ai Policy Eval"}},"type":"object","title":"AiPolicyContextWarningResponse","description":"Lightweight lookup for the latest warn-only evaluation matching a UI context.\n\nThis is intended for inline warnings in campaign details pages (ads/social) and similar surfaces."},"AiPolicyDraft":{"properties":{"text":{"type":"string","title":"Text","description":"Editable draft policy text","default":""},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","description":"draft source: generated|manual"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At","description":"ISO timestamp"},"updated_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated By User Id","description":"User ID who last edited the draft"}},"type":"object","title":"AiPolicyDraft"},"AiPolicyDraftUpdateRequest":{"properties":{"text":{"type":"string","maxLength":64000,"title":"Text","description":"Updated draft policy text"}},"type":"object","required":["text"],"title":"AiPolicyDraftUpdateRequest"},"AiPolicyEnabledSurfaces":{"properties":{"chat":{"type":"boolean","title":"Chat","default":true},"ads":{"type":"boolean","title":"Ads","default":true},"social":{"type":"boolean","title":"Social","default":true},"images":{"type":"boolean","title":"Images","default":true}},"type":"object","title":"AiPolicyEnabledSurfaces"},"AiPolicyGenerateVersionNameRequest":{"properties":{"text":{"type":"string","maxLength":64000,"title":"Text","description":"Policy text used to generate a short version name"},"max_length":{"type":"integer","maximum":80.0,"minimum":16.0,"title":"Max Length","description":"Maximum output length for the generated version name","default":48}},"type":"object","required":["text"],"title":"AiPolicyGenerateVersionNameRequest"},"AiPolicyGenerateVersionNameResponse":{"properties":{"name":{"type":"string","title":"Name","description":"Generated policy version name"}},"type":"object","required":["name"],"title":"AiPolicyGenerateVersionNameResponse"},"AiPolicySaveVersionRequest":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"activate":{"type":"boolean","title":"Activate","default":false},"text":{"anyOf":[{"type":"string","maxLength":64000},{"type":"null"}],"title":"Text","description":"Optional editor text to save as a version without requiring a separate draft save first"}},"type":"object","title":"AiPolicySaveVersionRequest"},"AiPolicySettingsUpdateRequest":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"enabled_surfaces":{"anyOf":[{"$ref":"#/components/schemas/AiPolicyEnabledSurfaces"},{"type":"null"}]}},"type":"object","required":["enabled"],"title":"AiPolicySettingsUpdateRequest"},"AiPolicyStateResponse":{"properties":{"policy_purpose":{"anyOf":[{"type":"string","enum":["compliance","brand_guidelines"]},{"type":"null"}],"title":"Policy Purpose"},"enabled":{"type":"boolean","title":"Enabled"},"mode":{"type":"string","title":"Mode"},"enabled_surfaces":{"anyOf":[{"$ref":"#/components/schemas/AiPolicyEnabledSurfaces"},{"type":"null"}]},"active_version_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Active Version Id"},"active_version_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Active Version Ids"},"draft":{"anyOf":[{"$ref":"#/components/schemas/AiPolicyDraft"},{"type":"null"}]},"versions":{"items":{"$ref":"#/components/schemas/AiPolicyVersion"},"type":"array","title":"Versions"}},"type":"object","required":["enabled","mode"],"title":"AiPolicyStateResponse"},"AiPolicyVersion":{"properties":{"id":{"type":"string","title":"Id"},"policy_purpose":{"anyOf":[{"type":"string","enum":["compliance","brand_guidelines"]},{"type":"null"}],"title":"Policy Purpose"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"text":{"type":"string","title":"Text"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"created_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By User Id"}},"type":"object","required":["id","text"],"title":"AiPolicyVersion"},"AiPolicyViolationEvent":{"properties":{"id":{"type":"string","title":"Id"},"created_at":{"type":"string","title":"Created At"},"user_id":{"type":"string","title":"User Id"},"user_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Email"},"endpoint":{"type":"string","title":"Endpoint"},"event_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Name"},"event_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Event Metadata"}},"type":"object","required":["id","created_at","user_id","endpoint"],"title":"AiPolicyViolationEvent"},"AiTeamActivityCampaignScope":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign"}},"type":"object","required":["campaign_id"],"title":"AiTeamActivityCampaignScope","description":"The attempted campaign scope, independent of any confirmed field edits."},"AiTeamActivityCounts":{"properties":{"executed":{"type":"integer","title":"Executed","default":0},"approved":{"type":"integer","title":"Approved","default":0},"declined":{"type":"integer","title":"Declined","default":0},"failed":{"type":"integer","title":"Failed","default":0},"total":{"type":"integer","title":"Total","default":0}},"type":"object","title":"AiTeamActivityCounts"},"AiTeamActivityItem":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"stage":{"type":"string","title":"Stage"},"activity_type":{"type":"string","title":"Activity Type"},"activity_type_label":{"type":"string","title":"Activity Type Label"},"owner_agent_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner Agent Key"},"change_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Scope"},"actioned_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actioned At"},"outcome_state":{"type":"string","title":"Outcome State","default":"measuring"},"outcome_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Outcome Summary"},"execution_outcome":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Outcome"},"applied_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Applied Count"},"failed_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Failed Count"},"uncertain_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Uncertain Count"},"campaign_scope":{"items":{"$ref":"#/components/schemas/AiTeamActivityCampaignScope"},"type":"array","title":"Campaign Scope","default":[]},"optimization_details":{"anyOf":[{"$ref":"#/components/schemas/CampaignAppliedOptimization"},{"type":"null"}]}},"type":"object","required":["id","title","stage","activity_type","activity_type_label"],"title":"AiTeamActivityItem"},"AiTeamActivityResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/AiTeamActivityItem"},"type":"array","title":"Items"},"counts":{"$ref":"#/components/schemas/AiTeamActivityCounts"},"total":{"type":"integer","title":"Total"},"has_more":{"type":"boolean","title":"Has More"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["items","counts","total","has_more"],"title":"AiTeamActivityResponse"},"AmazonAccountsResponseModel":{"properties":{"accounts":{"items":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"object"},"type":"array","title":"Accounts"}},"type":"object","required":["accounts"],"title":"AmazonAccountsResponseModel"},"AmazonAdGroupRequest":{"properties":{"profile_id":{"type":"string","title":"Profile Id"},"campaign_id":{"type":"string","title":"Campaign Id"},"name":{"type":"string","title":"Name"},"default_bid":{"type":"number","title":"Default Bid","default":1.0}},"type":"object","required":["profile_id","campaign_id","name"],"title":"AmazonAdGroupRequest"},"AmazonAuthResponseModel":{"properties":{"auth_url":{"type":"string","title":"Auth Url"}},"type":"object","required":["auth_url"],"title":"AmazonAuthResponseModel"},"AmazonCampaignActionRequest":{"properties":{"platform_type":{"type":"string","title":"Platform Type","description":"Type of ad platform: amazon_sponsored_products, amazon_sponsored_brands, or amazon_sponsored_display"},"ad_id":{"type":"string","title":"Ad Id","description":"ID of the specific ad to act on"},"profile_id":{"type":"string","title":"Profile Id","description":"Amazon advertising profile ID"},"action":{"type":"string","title":"Action","description":"Action to perform: pause or delete"}},"type":"object","required":["platform_type","ad_id","profile_id","action"],"title":"AmazonCampaignActionRequest","description":"Request model for pausing/deleting an Amazon campaign."},"AmazonCampaignRequest":{"properties":{"profile_id":{"type":"string","title":"Profile Id"},"name":{"type":"string","title":"Name"},"campaign_type":{"type":"string","title":"Campaign Type","default":"sponsoredProducts"},"targeting_type":{"type":"string","title":"Targeting Type","default":"manual"},"daily_budget":{"type":"number","title":"Daily Budget","default":10.0},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},"type":"object","required":["profile_id","name"],"title":"AmazonCampaignRequest"},"AmazonKeywordsRequest":{"properties":{"profile_id":{"type":"string","title":"Profile Id"},"ad_group_id":{"type":"string","title":"Ad Group Id"},"keywords":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Keywords"}},"type":"object","required":["profile_id","ad_group_id","keywords"],"title":"AmazonKeywordsRequest"},"AmazonProductAdRequest":{"properties":{"profile_id":{"type":"string","title":"Profile Id"},"ad_group_id":{"type":"string","title":"Ad Group Id"},"asin":{"type":"string","title":"Asin"}},"type":"object","required":["profile_id","ad_group_id","asin"],"title":"AmazonProductAdRequest"},"AmazonSponsoredBrandsAdRequest":{"properties":{"product_description":{"type":"string","title":"Product Description","description":"Description of the product or service"},"target_audience":{"type":"string","title":"Target Audience","description":"Target audience description"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id","description":"Company profile ID (required)"},"campaign_goals":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Campaign Goals","description":"List of campaign goals"},"key_selling_points":{"type":"string","title":"Key Selling Points","description":"Key selling points","default":""},"num_ads":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Num Ads","description":"Number of ad variations to generate","default":3},"bid_strategy":{"type":"string","title":"Bid Strategy","description":"Bidding strategy","default":"maximize_conversions"},"budget_range":{"type":"string","title":"Budget Range","description":"Budget range (low, medium, high, custom)","default":"medium"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Target country"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province","description":"Target state/province"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"Target city"},"locations":{"anyOf":[{"items":{"$ref":"#/components/schemas/LocationItem"},"type":"array"},{"type":"null"}],"title":"Locations","description":"List of locations to target (countries/regions/states/cities/postal codes/proximities). This does not split budget per location; all locations share the campaign budget."},"reference_images":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":3},{"type":"null"}],"title":"Reference Images","description":"List of reference image base64 data URLs (max 3)"},"max_cpc":{"anyOf":[{"type":"number","minimum":0.01},{"type":"null"}],"title":"Max Cpc","description":"Maximum cost per click in dollars (e.g., 1.50 for $1.50). Required when bid_strategy is 'MANUAL_CPC'"},"experiment_package_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Experiment Package Id","description":"Test package id; created campaigns are stamped with this linkage"},"launch_strategy_mode":{"anyOf":[{"type":"string","pattern":"^(test_learn_pilot|direct_campaign)$"},{"type":"null"}],"title":"Launch Strategy Mode","description":"test_learn_pilot or direct_campaign"},"dayparting_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dayparting Enabled","description":"Whether dayparting/ad scheduling is enabled for this campaign","default":false},"dayparting_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Dayparting Config","description":"Dayparting configuration including schedule, timezone, and platform-specific settings"},"brand_name":{"type":"string","title":"Brand Name","description":"Brand name"},"num_images_per_ad":{"type":"integer","maximum":3.0,"minimum":1.0,"title":"Num Images Per Ad","description":"Number of images per ad","default":1},"showcase_products":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Showcase Products","description":"Products to showcase"},"ad_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Format","description":"Selected ad format (product_collection, store_spotlight, or video)"},"video_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Video Length","description":"Video duration in seconds (for video format)"}},"type":"object","required":["product_description","target_audience","company_profile_id","brand_name"],"title":"AmazonSponsoredBrandsAdRequest","description":"Request model for Amazon Sponsored Brands ads"},"AmazonSponsoredDisplayAdRequest":{"properties":{"product_description":{"type":"string","title":"Product Description","description":"Description of the product or service"},"target_audience":{"type":"string","title":"Target Audience","description":"Target audience description"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id","description":"Company profile ID (required)"},"campaign_goals":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Campaign Goals","description":"List of campaign goals"},"key_selling_points":{"type":"string","title":"Key Selling Points","description":"Key selling points","default":""},"num_ads":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Num Ads","description":"Number of ad variations to generate","default":3},"bid_strategy":{"type":"string","title":"Bid Strategy","description":"Bidding strategy","default":"maximize_conversions"},"budget_range":{"type":"string","title":"Budget Range","description":"Budget range (low, medium, high, custom)","default":"medium"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Target country"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province","description":"Target state/province"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"Target city"},"locations":{"anyOf":[{"items":{"$ref":"#/components/schemas/LocationItem"},"type":"array"},{"type":"null"}],"title":"Locations","description":"List of locations to target (countries/regions/states/cities/postal codes/proximities). This does not split budget per location; all locations share the campaign budget."},"reference_images":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":3},{"type":"null"}],"title":"Reference Images","description":"List of reference image base64 data URLs (max 3)"},"max_cpc":{"anyOf":[{"type":"number","minimum":0.01},{"type":"null"}],"title":"Max Cpc","description":"Maximum cost per click in dollars (e.g., 1.50 for $1.50). Required when bid_strategy is 'MANUAL_CPC'"},"experiment_package_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Experiment Package Id","description":"Test package id; created campaigns are stamped with this linkage"},"launch_strategy_mode":{"anyOf":[{"type":"string","pattern":"^(test_learn_pilot|direct_campaign)$"},{"type":"null"}],"title":"Launch Strategy Mode","description":"test_learn_pilot or direct_campaign"},"dayparting_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dayparting Enabled","description":"Whether dayparting/ad scheduling is enabled for this campaign","default":false},"dayparting_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Dayparting Config","description":"Dayparting configuration including schedule, timezone, and platform-specific settings"},"ad_format":{"type":"string","title":"Ad Format","description":"Ad format (image or video)","default":"image"},"num_images_per_ad":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Num Images Per Ad","description":"Number of images per ad (for image format)","default":2},"video_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Video Length","description":"Video duration in seconds (for video format)"}},"type":"object","required":["product_description","target_audience","company_profile_id"],"title":"AmazonSponsoredDisplayAdRequest","description":"Request model for Amazon Sponsored Display ads"},"AmazonSponsoredProductsAdRequest":{"properties":{"product_description":{"type":"string","title":"Product Description","description":"Description of the product or service"},"target_audience":{"type":"string","title":"Target Audience","description":"Target audience description"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id","description":"Company profile ID (required)"},"campaign_goals":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Campaign Goals","description":"List of campaign goals"},"key_selling_points":{"type":"string","title":"Key Selling Points","description":"Key selling points","default":""},"num_ads":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Num Ads","description":"Number of ad variations to generate","default":3},"bid_strategy":{"type":"string","title":"Bid Strategy","description":"Bidding strategy","default":"maximize_conversions"},"budget_range":{"type":"string","title":"Budget Range","description":"Budget range (low, medium, high, custom)","default":"medium"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Target country"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province","description":"Target state/province"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"Target city"},"locations":{"anyOf":[{"items":{"$ref":"#/components/schemas/LocationItem"},"type":"array"},{"type":"null"}],"title":"Locations","description":"List of locations to target (countries/regions/states/cities/postal codes/proximities). This does not split budget per location; all locations share the campaign budget."},"reference_images":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":3},{"type":"null"}],"title":"Reference Images","description":"List of reference image base64 data URLs (max 3)"},"max_cpc":{"anyOf":[{"type":"number","minimum":0.01},{"type":"null"}],"title":"Max Cpc","description":"Maximum cost per click in dollars (e.g., 1.50 for $1.50). Required when bid_strategy is 'MANUAL_CPC'"},"experiment_package_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Experiment Package Id","description":"Test package id; created campaigns are stamped with this linkage"},"launch_strategy_mode":{"anyOf":[{"type":"string","pattern":"^(test_learn_pilot|direct_campaign)$"},{"type":"null"}],"title":"Launch Strategy Mode","description":"test_learn_pilot or direct_campaign"},"dayparting_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dayparting Enabled","description":"Whether dayparting/ad scheduling is enabled for this campaign","default":false},"dayparting_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Dayparting Config","description":"Dayparting configuration including schedule, timezone, and platform-specific settings"},"asin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asin","description":"Amazon Standard Identification Number"},"sku":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sku","description":"Stock Keeping Unit"}},"type":"object","required":["product_description","target_audience","company_profile_id"],"title":"AmazonSponsoredProductsAdRequest","description":"Request model for Amazon Sponsored Products ads"},"AnswerContribution":{"type":"string","enum":["supported","authoritative_empty","model_derived","none"],"title":"AnswerContribution","description":"Basis of customer-visible content retained for one requirement."},"AnswersRequest":{"properties":{"marketing_goal":{"anyOf":[{"type":"string","maxLength":400},{"type":"null"}],"title":"Marketing Goal"},"marketing_campaign_goal":{"anyOf":[{"type":"string","maxLength":400},{"type":"null"}],"title":"Marketing Campaign Goal"},"monthly_budget":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Monthly Budget"},"monthly_budget_min":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Monthly Budget Min"},"monthly_budget_max":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Monthly Budget Max"},"budget_currency":{"anyOf":[{"type":"string","maxLength":8},{"type":"null"}],"title":"Budget Currency"},"operating_regions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Operating Regions"}},"type":"object","title":"AnswersRequest"},"ApiKeyCreateRequest":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"scopes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Scopes"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["name"],"title":"ApiKeyCreateRequest"},"ApiKeyCreateResponse":{"properties":{"api_key":{"type":"string","title":"Api Key"},"key":{"$ref":"#/components/schemas/ApiKeyListItem"}},"type":"object","required":["api_key","key"],"title":"ApiKeyCreateResponse"},"ApiKeyListItem":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"key_prefix":{"type":"string","title":"Key Prefix"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"status":{"type":"string","title":"Status"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","name","key_prefix","scopes","status","created_at"],"title":"ApiKeyListItem"},"ApiKeyListResponse":{"properties":{"keys":{"items":{"$ref":"#/components/schemas/ApiKeyListItem"},"type":"array","title":"Keys"}},"type":"object","required":["keys"],"title":"ApiKeyListResponse"},"ApiKeyRevokeResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"key":{"$ref":"#/components/schemas/ApiKeyListItem"}},"type":"object","required":["success","key"],"title":"ApiKeyRevokeResponse"},"ApiKeyUsageEvent":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"action":{"type":"string","title":"Action"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip"},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["id","action","timestamp"],"title":"ApiKeyUsageEvent"},"ApiKeyUsageResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/ApiKeyUsageEvent"},"type":"array","title":"Events"}},"type":"object","required":["events"],"title":"ApiKeyUsageResponse"},"AppHomeBeginInstallResponse":{"properties":{"continuation_url":{"type":"string","title":"Continuation Url","description":"Short-lived top-level URL for Clerk/workspace linking"}},"type":"object","required":["continuation_url"],"title":"AppHomeBeginInstallResponse","description":"Top-level Pomo continuation created after managed token exchange."},"AppHomeStatusResponse":{"properties":{"bound":{"type":"boolean","title":"Bound","description":"Whether the shop is bound to an active Pomo profile"},"shop_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shop Domain","description":"The shop's myshopify.com domain from the session token"},"shop_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shop Name","description":"Human-readable shop name, if known"},"company_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Id","description":"Bound company profile id (string UUID, sanitized)"},"company_profile_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Name","description":"Bound company profile name"},"connection_health":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Connection Health","description":"'healthy' | 'warning' | 'critical' | 'unknown' | null"},"initial_sync_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Initial Sync Status","description":"'not_started' | 'pending' | 'running' | 'completed' | 'failed' | 'skipped' | null"},"last_sync_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Sync At","description":"Matching successful catalog extraction job finalized_at, only with saved Shopify result provenance"},"onboarding_complete":{"type":"boolean","title":"Onboarding Complete","description":"Whether the bound profile has finished onboarding","default":false},"setup_status":{"type":"string","enum":["unknown","pending","running","needs_attention","failed","completed"],"title":"Setup Status","description":"Whole setup state, independent of catalog extraction","default":"unknown"},"setup_stage":{"anyOf":[{"type":"string","enum":["catalog","products","competitors","research","complete"]},{"type":"null"}],"title":"Setup Stage","description":"Persisted setup stage requiring progress or attention"},"setup_attention":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Setup Attention","description":"Fixed public-safe recovery guidance; never raw workflow errors"},"shopify_products_imported":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Shopify Products Imported","description":"Distinct Shopify product IDs in the matching shop-qualified saved extraction; null when provenance is unavailable"},"active_product_offerings":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Active Product Offerings","description":"Active Pomo product offerings in the bound profile, including manual products"},"product_limit":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Product Limit","description":"Current effective Shopify product allowance; null when entitlement is unavailable"},"catalog_retry_allowed":{"type":"boolean","title":"Catalog Retry Allowed","description":"Whether failed initial extraction can be retried under the existing onboarding dispatch guards","default":false},"catalog_import_capped":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Catalog Import Capped","description":"Whether saved evidence proves truncation; null when unknown, never inferred from count equal to allowance"},"billing_status":{"type":"string","title":"Billing Status","description":"none | trialing | active | unknown | verification_unavailable | unbound","default":"unbound"},"entitled":{"type":"boolean","title":"Entitled","description":"Whether Shopify currently grants product access","default":false},"plan_handle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Handle","description":"Active Shopify App Pricing plan handle"},"plan_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Name","description":"Public name of the active supported plan"},"billing_interval":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Interval","description":"monthly | annual"},"cancel_at_period_end":{"type":"boolean","title":"Cancel At Period End","description":"Whether cancellation is scheduled","default":false},"trial_ends_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Trial Ends At","description":"Shopify trial end, if active"},"current_period_ends_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Current Period Ends At","description":"Current billing-cycle end"},"pricing_url":{"type":"string","title":"Pricing Url","description":"Shopify-owned plan selection URL"},"pomo_url":{"type":"string","title":"Pomo Url","description":"Deep-link into the full Pomo app"}},"type":"object","required":["bound","pricing_url","pomo_url"],"title":"AppHomeStatusResponse","description":"Status of an embedded shop as seen from the App Home.\n\n``bound`` is the primary discriminator: when false the shop has no active\nPomo binding and every profile-related field is null, but ``shop_domain`` is\nstill populated from the verified session token so the UI can address the\nstore."},"AppHomeSyncResponse":{"properties":{"sync_status":{"type":"string","title":"Sync Status","description":"Persisted catalog onboarding worker status"},"message":{"type":"string","title":"Message","description":"Human-readable status message"}},"type":"object","required":["sync_status","message"],"title":"AppHomeSyncResponse","description":"Result of a catalog re-sync triggered from the App Home."},"ApprovalGroupCreateRequest":{"properties":{"name":{"type":"string","maxLength":100,"minLength":1,"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description"}},"type":"object","required":["name"],"title":"ApprovalGroupCreateRequest"},"ApprovalGroupMemberResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["user_id","created_at"],"title":"ApprovalGroupMemberResponse"},"ApprovalGroupResponse":{"properties":{"id":{"type":"string","title":"Id"},"organization_id":{"type":"string","title":"Organization Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"members":{"items":{"$ref":"#/components/schemas/ApprovalGroupMemberResponse"},"type":"array","title":"Members"}},"type":"object","required":["id","organization_id","name","created_at","updated_at"],"title":"ApprovalGroupResponse"},"ApprovalGroupSetMembersRequest":{"properties":{"user_ids":{"items":{"type":"string"},"type":"array","title":"User Ids"}},"type":"object","title":"ApprovalGroupSetMembersRequest"},"ApprovalGroupUpdateRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":100,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Description"}},"type":"object","title":"ApprovalGroupUpdateRequest"},"ApprovalRequest":{"properties":{"idempotency_key":{"type":"string","maxLength":255,"minLength":8,"title":"Idempotency Key"},"expected_target_version":{"type":"integer","minimum":1.0,"title":"Expected Target Version"},"expected_context_hash":{"type":"string","maxLength":64,"minLength":64,"title":"Expected Context Hash"},"expected_text_hash":{"type":"string","maxLength":64,"minLength":64,"title":"Expected Text Hash"}},"type":"object","required":["idempotency_key","expected_target_version","expected_context_hash","expected_text_hash"],"title":"ApprovalRequest"},"ApprovalSubject":{"properties":{"kind":{"type":"string","const":"approval","title":"Kind","default":"approval"},"approval_id":{"type":"string","format":"uuid","title":"Approval Id"},"observed_version":{"anyOf":[{"type":"string","maxLength":64,"minLength":64},{"type":"null"}],"title":"Observed Version"},"linked_work_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Linked Work Id"},"report_integration_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Report Integration Id"},"selected_campaign_id":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Selected Campaign Id"},"selected_option_id":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Selected Option Id"}},"additionalProperties":false,"type":"object","required":["approval_id"],"title":"ApprovalSubject","description":"Untrusted pointer to one native team approval/review."},"ArrangementCounts":{"properties":{"needs_you":{"type":"integer","minimum":0.0,"title":"Needs You"},"running":{"type":"integer","minimum":0.0,"title":"Running"},"paused":{"type":"integer","minimum":0.0,"title":"Paused"}},"additionalProperties":false,"type":"object","required":["needs_you","running","paused"],"title":"ArrangementCounts"},"ArrangementListResponse":{"properties":{"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"actor_user_id":{"type":"string","format":"uuid","title":"Actor User Id"},"observed_at":{"type":"string","format":"date-time","title":"Observed At"},"counts":{"$ref":"#/components/schemas/ArrangementCounts"},"coverage":{"type":"string","enum":["complete","partial"],"title":"Coverage"},"items":{"items":{"$ref":"#/components/schemas/FrontDoorCheck"},"type":"array","title":"Items"},"total":{"type":"integer","minimum":0.0,"title":"Total"},"next_offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Next Offset"},"finished":{"items":{"$ref":"#/components/schemas/FrontDoorCheck"},"type":"array","title":"Finished","default":[]},"finished_total":{"type":"integer","minimum":0.0,"title":"Finished Total","default":0},"finished_next_offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Finished Next Offset"}},"additionalProperties":false,"type":"object","required":["organization_id","company_profile_id","actor_user_id","observed_at","counts","coverage","items","total"],"title":"ArrangementListResponse","description":"Every standing arrangement for this person and brand, not a preview.\n\nThe front door shows the first few and states a total. A person who has\naccepted a recurring commitment needs somewhere to read all of them, so\nthis shares the front door's query rather than describing a second one."},"AsyncJobRequest":{"properties":{"job_type":{"type":"string","title":"Job Type","description":"Type of job to execute"},"job_data":{"additionalProperties":true,"type":"object","title":"Job Data","description":"Job-specific parameters"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id","description":"Organization context"},"company_profile_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Profile Id","description":"Optional company profile context"}},"type":"object","required":["job_type","job_data","organization_id"],"title":"AsyncJobRequest","description":"Request to start an async job","example":{"company_profile_id":"123e4567-e89b-12d3-a456-426614174001","job_data":{"campaign_name":"Summer Sale 2025","copy_prompt":"50% off all products","creative_prompt":"Beach vacation theme","platform":"facebook"},"job_type":"ad_creation","organization_id":"123e4567-e89b-12d3-a456-426614174000"}},"AttachedDisplayContext":{"properties":{"kind":{"type":"string","enum":["trend-discuss-context","page-context"],"title":"Kind"},"source_label":{"type":"string","maxLength":500,"title":"Source Label"},"item_id":{"type":"string","maxLength":500,"title":"Item Id"},"item_title":{"type":"string","maxLength":500,"title":"Item Title"},"item_type":{"type":"string","maxLength":500,"title":"Item Type"},"tab":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Tab"},"summary":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Summary"},"insights":{"items":{"type":"string","maxLength":4000},"type":"array","maxItems":20,"title":"Insights"},"recommendations":{"items":{"type":"string","maxLength":4000},"type":"array","maxItems":20,"title":"Recommendations"},"sources":{"items":{"$ref":"#/components/schemas/DisplaySource"},"type":"array","maxItems":20,"title":"Sources"},"metadata":{"anyOf":[{"$ref":"#/components/schemas/DisplayMetadata"},{"type":"null"}]},"draft_message":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Draft Message"}},"additionalProperties":false,"type":"object","required":["kind","source_label","item_id","item_title","item_type"],"title":"AttachedDisplayContext"},"AudienceEstimateRequest":{"properties":{"audiences":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Audiences"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country code (e.g., US)"},"state":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"State","description":"State/region names or codes"},"city":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"City","description":"City names"}},"type":"object","title":"AudienceEstimateRequest"},"AudienceSyncReview":{"properties":{"kind":{"type":"string","const":"audience_sync","title":"Kind","default":"audience_sync"},"audience_id":{"type":"string","format":"uuid","title":"Audience Id"},"audience_name":{"type":"string","maxLength":400,"minLength":1,"title":"Audience Name"},"platform":{"type":"string","enum":["meta","tiktok"],"title":"Platform"},"account_id":{"type":"string","maxLength":128,"minLength":1,"title":"Account Id"},"account_name":{"type":"string","maxLength":320,"minLength":1,"title":"Account Name"},"members_count":{"type":"integer","minimum":1.0,"title":"Members Count"},"contacts_to_sync":{"type":"integer","minimum":1.0,"title":"Contacts To Sync"},"excluded_count":{"type":"integer","minimum":0.0,"title":"Excluded Count"},"matching_fields":{"items":{"type":"string","enum":["email","phone","first_name","last_name"]},"type":"array","maxItems":4,"minItems":1,"title":"Matching Fields"},"remote_audience_id":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Remote Audience Id"},"remote_audience_name":{"type":"string","maxLength":128,"minLength":1,"title":"Remote Audience Name"},"targeting_minimum":{"type":"integer","minimum":1.0,"title":"Targeting Minimum"}},"additionalProperties":false,"type":"object","required":["audience_id","audience_name","platform","account_id","account_name","members_count","contacts_to_sync","excluded_count","matching_fields","remote_audience_name","targeting_minimum"],"title":"AudienceSyncReview","description":"Exact audience membership scope and provider destination before upload."},"B2BAccountContactsRequest":{"properties":{"limit":{"type":"integer","maximum":3.0,"minimum":1.0,"title":"Limit","default":3},"force_refresh":{"type":"boolean","title":"Force Refresh","default":false}},"type":"object","title":"B2BAccountContactsRequest"},"B2BAccountContactsResponse":{"properties":{"search":{"$ref":"#/components/schemas/B2BLeadSearchResponse"},"account_key":{"type":"string","title":"Account Key"},"added_count":{"type":"integer","maximum":3.0,"minimum":0.0,"title":"Added Count"},"replaced_count":{"type":"integer","maximum":3.0,"minimum":0.0,"title":"Replaced Count"}},"type":"object","required":["search","account_key","added_count","replaced_count"],"title":"B2BAccountContactsResponse"},"B2BActiveLeadSearchSummary":{"properties":{"search_id":{"type":"string","title":"Search Id"},"query":{"type":"string","title":"Query"},"started_at":{"type":"string","title":"Started At"}},"type":"object","required":["search_id","query","started_at"],"title":"B2BActiveLeadSearchSummary","description":"A durable search that should resume polling after a page reload."},"B2BCompanyContactRoute":{"properties":{"email":{"type":"string","title":"Email"},"source_url":{"type":"string","title":"Source Url"},"evidence_text":{"type":"string","title":"Evidence Text"}},"type":"object","required":["email","source_url","evidence_text"],"title":"B2BCompanyContactRoute","description":"A company-level public inbox, never a named person's email."},"B2BDraftRequest":{"properties":{"force_refresh":{"type":"boolean","title":"Force Refresh","default":false}},"type":"object","title":"B2BDraftRequest"},"B2BDraftResponse":{"properties":{"candidate":{"$ref":"#/components/schemas/B2BLeadCandidate"}},"type":"object","required":["candidate"],"title":"B2BDraftResponse"},"B2BEditableDraft":{"properties":{"subject":{"type":"string","maxLength":160,"minLength":1,"title":"Subject"},"body":{"type":"string","maxLength":1200,"minLength":1,"title":"Body"}},"type":"object","required":["subject","body"],"title":"B2BEditableDraft"},"B2BFitEvidence":{"properties":{"kind":{"type":"string","enum":["company","person"],"title":"Kind","default":"person"},"claim":{"type":"string","title":"Claim"},"source_url":{"type":"string","title":"Source Url"},"evidence_text":{"type":"string","title":"Evidence Text"},"verification_method":{"type":"string","enum":["page_exact","openai_web_search","openai_web_search_ai_critic"],"title":"Verification Method","default":"openai_web_search"}},"type":"object","required":["claim","source_url","evidence_text"],"title":"B2BFitEvidence"},"B2BHydrateEmailsRequest":{"properties":{"candidate_ids":{"items":{"type":"string"},"type":"array","maxItems":15,"title":"Candidate Ids"},"retry_not_found":{"type":"boolean","title":"Retry Not Found","default":false}},"type":"object","title":"B2BHydrateEmailsRequest"},"B2BHydrateEmailsResponse":{"properties":{"search":{"$ref":"#/components/schemas/B2BLeadSearchResponse"},"attempted_count":{"type":"integer","maximum":15.0,"minimum":0.0,"title":"Attempted Count"},"found_count":{"type":"integer","maximum":15.0,"minimum":0.0,"title":"Found Count"},"direct_email_found_count":{"type":"integer","maximum":15.0,"minimum":0.0,"title":"Direct Email Found Count","default":0},"company_contact_found_count":{"type":"integer","maximum":15.0,"minimum":0.0,"title":"Company Contact Found Count","default":0},"provider_attempted_count":{"type":"integer","maximum":15.0,"minimum":0.0,"title":"Provider Attempted Count","default":0},"provider_verified_count":{"type":"integer","maximum":15.0,"minimum":0.0,"title":"Provider Verified Count","default":0},"provider_failure_count":{"type":"integer","maximum":15.0,"minimum":0.0,"title":"Provider Failure Count","default":0},"remaining_count":{"type":"integer","maximum":15.0,"minimum":0.0,"title":"Remaining Count"}},"type":"object","required":["search","attempted_count","found_count","remaining_count"],"title":"B2BHydrateEmailsResponse"},"B2BLeadCandidate":{"properties":{"candidate_id":{"type":"string","title":"Candidate Id"},"account_key":{"type":"string","title":"Account Key","default":""},"full_name":{"type":"string","title":"Full Name"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"company_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Url"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Url"},"linkedin_status":{"anyOf":[{"type":"string","enum":["found","not_found","unavailable"]},{"type":"null"}],"title":"Linkedin Status"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Url"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"fit_reason":{"type":"string","title":"Fit Reason"},"company_fit_reason":{"type":"string","title":"Company Fit Reason","default":""},"person_fit_reason":{"type":"string","title":"Person Fit Reason","default":""},"outreach_angle":{"type":"string","title":"Outreach Angle","default":""},"fit_evidence":{"items":{"$ref":"#/components/schemas/B2BFitEvidence"},"type":"array","title":"Fit Evidence"},"sources":{"items":{"$ref":"#/components/schemas/B2BLeadSource"},"type":"array","title":"Sources"},"contact":{"$ref":"#/components/schemas/B2BLeadContact"},"company_contact":{"anyOf":[{"$ref":"#/components/schemas/B2BCompanyContactRoute"},{"type":"null"}]},"draft":{"anyOf":[{"$ref":"#/components/schemas/B2BLeadDraft"},{"type":"null"}]},"crm":{"$ref":"#/components/schemas/B2BLeadCrmState"}},"type":"object","required":["candidate_id","full_name","fit_reason","contact"],"title":"B2BLeadCandidate"},"B2BLeadContact":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"status":{"type":"string","enum":["publicly_listed","provider_verified","not_hydrated","not_found"],"title":"Status"},"kind":{"anyOf":[{"type":"string","enum":["person_business","company_contact"]},{"type":"null"}],"title":"Kind"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"evidence_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Text"},"provider_status":{"anyOf":[{"type":"string","const":"valid"},{"type":"null"}],"title":"Provider Status"},"confidence_score":{"anyOf":[{"type":"integer","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Confidence Score"},"verified_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verified At"}},"type":"object","required":["status"],"title":"B2BLeadContact"},"B2BLeadCrmState":{"properties":{"saved":{"type":"boolean","title":"Saved","default":false},"prospect_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prospect Id"},"person_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Person Ref"}},"type":"object","title":"B2BLeadCrmState"},"B2BLeadDraft":{"properties":{"subject":{"type":"string","title":"Subject"},"body":{"type":"string","title":"Body"},"status":{"type":"string","enum":["generated","edited"],"title":"Status","default":"generated"}},"type":"object","required":["subject","body"],"title":"B2BLeadDraft"},"B2BLeadSearchExpansionResponse":{"properties":{"requested_additional_company_count":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Requested Additional Company Count"},"base_company_count":{"type":"integer","maximum":4.0,"minimum":0.0,"title":"Base Company Count"},"added_company_count":{"type":"integer","maximum":5.0,"minimum":0.0,"title":"Added Company Count"},"current_company_count":{"type":"integer","maximum":5.0,"minimum":0.0,"title":"Current Company Count"}},"type":"object","required":["requested_additional_company_count","base_company_count","added_company_count","current_company_count"],"title":"B2BLeadSearchExpansionResponse"},"B2BLeadSearchHistoryResponse":{"properties":{"searches":{"items":{"$ref":"#/components/schemas/B2BLeadSearchSummary"},"type":"array","title":"Searches"},"active_searches":{"items":{"$ref":"#/components/schemas/B2BActiveLeadSearchSummary"},"type":"array","title":"Active Searches"},"sales_grounding":{"anyOf":[{"$ref":"#/components/schemas/B2BSalesGrounding"},{"type":"null"}]}},"type":"object","title":"B2BLeadSearchHistoryResponse"},"B2BLeadSearchJobResponse":{"properties":{"search_id":{"type":"string","title":"Search Id"},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id"},"status":{"type":"string","enum":["processing","completed","failed","cancelled"],"title":"Status"},"poll_url":{"type":"string","title":"Poll Url"},"search":{"anyOf":[{"$ref":"#/components/schemas/B2BLeadSearchResponse"},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"expansion":{"anyOf":[{"$ref":"#/components/schemas/B2BLeadSearchExpansionResponse"},{"type":"null"}]}},"type":"object","required":["search_id","status","poll_url"],"title":"B2BLeadSearchJobResponse","description":"Durable discovery submission and polling envelope.\n\nA completed cache hit can return its search immediately. Queued work keeps\nthe same small contract and exposes the completed snapshot only after the\nworker has committed it atomically."},"B2BLeadSearchRequest":{"properties":{"query":{"type":"string","maxLength":500,"minLength":2,"title":"Query"},"limit":{"type":"integer","maximum":5.0,"minimum":3.0,"title":"Limit","default":5},"force_refresh":{"type":"boolean","title":"Force Refresh","default":false}},"type":"object","required":["query"],"title":"B2BLeadSearchRequest"},"B2BLeadSearchResponse":{"properties":{"search_id":{"type":"string","title":"Search Id"},"version":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"type":"null"}],"title":"Version"},"query":{"type":"string","title":"Query"},"interpreted_query":{"type":"string","title":"Interpreted Query"},"status":{"type":"string","const":"completed","title":"Status","default":"completed"},"cache_hit":{"type":"boolean","title":"Cache Hit","default":false},"generated_at":{"type":"string","title":"Generated At"},"expires_at":{"type":"string","title":"Expires At"},"email_hydration_status":{"type":"string","enum":["not_started","completed"],"title":"Email Hydration Status"},"result_count":{"type":"integer","maximum":15.0,"minimum":0.0,"title":"Result Count"},"candidates":{"items":{"$ref":"#/components/schemas/B2BLeadCandidate"},"type":"array","maxItems":15,"title":"Candidates"},"sources":{"items":{"$ref":"#/components/schemas/B2BLeadSource"},"type":"array","title":"Sources"}},"type":"object","required":["search_id","query","interpreted_query","generated_at","expires_at","email_hydration_status","result_count"],"title":"B2BLeadSearchResponse"},"B2BLeadSearchSummary":{"properties":{"search_id":{"type":"string","title":"Search Id"},"query":{"type":"string","title":"Query"},"interpreted_query":{"type":"string","title":"Interpreted Query"},"result_count":{"type":"integer","maximum":15.0,"minimum":0.0,"title":"Result Count"},"company_count":{"type":"integer","maximum":5.0,"minimum":0.0,"title":"Company Count"},"contact_count":{"type":"integer","maximum":15.0,"minimum":0.0,"title":"Contact Count"},"generated_at":{"type":"string","title":"Generated At"},"expires_at":{"type":"string","title":"Expires At"},"email_hydration_status":{"type":"string","enum":["not_started","completed"],"title":"Email Hydration Status"}},"type":"object","required":["search_id","query","interpreted_query","result_count","company_count","contact_count","generated_at","expires_at","email_hydration_status"],"title":"B2BLeadSearchSummary"},"B2BLeadSource":{"properties":{"url":{"type":"string","title":"Url"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},"type":"object","required":["url"],"title":"B2BLeadSource"},"B2BSalesGrounding":{"properties":{"workspace_label":{"type":"string","title":"Workspace Label"},"date_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Start"},"date_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date End"},"dataset_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Category"},"selling_stores":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Selling Stores"},"total_stores":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Stores"},"units_per_selling_store_week":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Units Per Selling Store Week"},"silent_market_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Silent Market Count"},"top_overstock_product":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Top Overstock Product"},"top_overstock_weeks_of_supply":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Top Overstock Weeks Of Supply"}},"type":"object","required":["workspace_label"],"title":"B2BSalesGrounding","description":"Bounded first-party sales aggregates that ground this profile's discovery.\n\nCounted facts only, computed server-side from the latest insights-ready\nupload — never store-level rows and never a client-side guess. Optional\nfields stay ``None`` whenever the underlying file did not carry the\ncounted signal, so the UI can drop a claim instead of rendering blanks."},"B2BSaveCandidateRequest":{"properties":{"idempotency_key":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Idempotency Key"},"draft":{"anyOf":[{"$ref":"#/components/schemas/B2BEditableDraft"},{"type":"null"}]}},"type":"object","title":"B2BSaveCandidateRequest"},"B2BSaveCandidateResponse":{"properties":{"prospect_id":{"type":"string","title":"Prospect Id"},"person_ref":{"type":"string","title":"Person Ref"},"created":{"type":"boolean","title":"Created"},"candidate":{"$ref":"#/components/schemas/B2BLeadCandidate"}},"type":"object","required":["prospect_id","person_ref","created","candidate"],"title":"B2BSaveCandidateResponse"},"B2BUpdateDraftRequest":{"properties":{"subject":{"type":"string","maxLength":160,"minLength":1,"title":"Subject"},"body":{"type":"string","maxLength":1200,"minLength":1,"title":"Body"}},"type":"object","required":["subject","body"],"title":"B2BUpdateDraftRequest"},"B2BUpdateDraftResponse":{"properties":{"prospect_id":{"type":"string","title":"Prospect Id"},"person_ref":{"type":"string","title":"Person Ref"},"draft":{"$ref":"#/components/schemas/B2BLeadDraft"}},"type":"object","required":["prospect_id","person_ref","draft"],"title":"B2BUpdateDraftResponse"},"BaseAdsCampaignRequest":{"properties":{"product_description":{"type":"string","title":"Product Description","description":"Description of the product or service"},"target_audience":{"type":"string","title":"Target Audience","description":"Target audience description"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id","description":"Company profile ID (required)"},"campaign_goals":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Campaign Goals","description":"List of campaign goals"},"key_selling_points":{"type":"string","title":"Key Selling Points","description":"Key selling points","default":""},"num_ads":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Num Ads","description":"Number of ad variations to generate","default":3},"bid_strategy":{"type":"string","title":"Bid Strategy","description":"Bidding strategy","default":"maximize_conversions"},"budget_range":{"type":"string","title":"Budget Range","description":"Budget range (low, medium, high, custom)","default":"medium"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Target country"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province","description":"Target state/province"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"Target city"},"locations":{"anyOf":[{"items":{"$ref":"#/components/schemas/LocationItem"},"type":"array"},{"type":"null"}],"title":"Locations","description":"List of locations to target (countries/regions/states/cities/postal codes/proximities). This does not split budget per location; all locations share the campaign budget."},"reference_images":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":3},{"type":"null"}],"title":"Reference Images","description":"List of reference image base64 data URLs (max 3)"},"max_cpc":{"anyOf":[{"type":"number","minimum":0.01},{"type":"null"}],"title":"Max Cpc","description":"Maximum cost per click in dollars (e.g., 1.50 for $1.50). Required when bid_strategy is 'MANUAL_CPC'"},"experiment_package_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Experiment Package Id","description":"Test package id; created campaigns are stamped with this linkage"},"launch_strategy_mode":{"anyOf":[{"type":"string","pattern":"^(test_learn_pilot|direct_campaign)$"},{"type":"null"}],"title":"Launch Strategy Mode","description":"test_learn_pilot or direct_campaign"},"dayparting_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dayparting Enabled","description":"Whether dayparting/ad scheduling is enabled for this campaign","default":false},"dayparting_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Dayparting Config","description":"Dayparting configuration including schedule, timezone, and platform-specific settings"}},"type":"object","required":["product_description","target_audience","company_profile_id"],"title":"BaseAdsCampaignRequest","description":"Base request model for creating ad campaigns."},"BatchGenerateRequest":{"properties":{"product_description":{"type":"string","title":"Product Description"},"target_audience":{"type":"string","title":"Target Audience"},"platforms":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Platforms","description":"List of platform configurations"},"campaign_goals":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Campaign Goals"},"key_selling_points":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key Selling Points","default":""},"reference_images":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reference Images"},"use_brand_style":{"type":"boolean","title":"Use Brand Style","default":true},"num_posts":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Num Posts","default":1}},"type":"object","required":["product_description","target_audience","platforms"],"title":"BatchGenerateRequest","description":"Request model for batch generation across multiple platforms."},"BatchPostMetricsRequest":{"properties":{"instagram_account_id":{"type":"string","title":"Instagram Account Id"},"post_ids":{"items":{"type":"string"},"type":"array","title":"Post Ids"}},"type":"object","required":["instagram_account_id","post_ids"],"title":"BatchPostMetricsRequest","description":"Request model for getting metrics for multiple Instagram posts."},"BillingModel":{"type":"string","enum":["stripe","shopify"],"title":"BillingModel","description":"Server-owned commercial provider for an organization."},"BillingPortalSessionRequest":{"properties":{"organization_id":{"type":"string","title":"Organization Id"},"return_path":{"type":"string","title":"Return Path","default":"/settings?section=subscription"}},"type":"object","required":["organization_id"],"title":"BillingPortalSessionRequest","description":"Safe application-relative return target for a state-creating portal call."},"BillingPortalSessionResponse":{"properties":{"status":{"type":"string","title":"Status"},"portal_url":{"type":"string","title":"Portal Url"}},"type":"object","required":["status","portal_url"],"title":"BillingPortalSessionResponse","description":"Response model for a Stripe billing portal session."},"BlendedROASResponse":{"properties":{"total_spend_cents":{"type":"integer","title":"Total Spend Cents"},"total_revenue_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Revenue Cents"},"total_impressions":{"type":"integer","title":"Total Impressions"},"total_clicks":{"type":"integer","title":"Total Clicks"},"total_conversions":{"type":"integer","title":"Total Conversions"},"blended_roas":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Blended Roas"},"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"}},"type":"object","required":["total_spend_cents","total_revenue_cents","total_impressions","total_clicks","total_conversions","blended_roas","start_date","end_date"],"title":"BlendedROASResponse","description":"Commerce net revenue over ad spend; missing revenue or ROAS remains null."},"Body_create_ads_campaign_endpoint_api_guided_workflow_create_ads_campaign_post":{"properties":{"user_prompt":{"type":"string","title":"User Prompt","description":"User's description of what they want to do"},"target_audience":{"type":"string","title":"Target Audience","description":"Description of the target audience"},"custom_instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Instructions","description":"Free-text user instructions/preferences to respect across idea and creative generation"},"selected_target_audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Target Audience","description":"JSON object for the selected audience"},"selected_campaign_idea":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Campaign Idea","description":"JSON object for the selected campaign idea"},"execution_settings_job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Settings Job Id"},"execution_settings_draft_identity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Settings Draft Identity"},"campaign_template":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Template","description":"Zero or one template selected by id"},"creative_references":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creative References","description":"Versioned image roles and confirmed campaign brand name"},"reference_selection_confirmed":{"type":"boolean","title":"Reference Selection Confirmed","description":"The current automatic reference disclosure completed before this selection was submitted","default":false},"campaign_timing":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Timing","description":"JSON object for structured campaign timing"},"campaign_budget":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Budget","description":"JSON object for structured campaign budget"},"campaign_budget_constraints":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Budget Constraints","description":"JSON object for reviewed campaign budget constraints"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id","description":"Company profile ID (required)"},"target_platforms":{"type":"string","title":"Target Platforms","description":"JSON array of target platforms"},"num_ads":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Ads","description":"Number of ads to generate (max 3)","default":3},"num_images_per_ad":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Images Per Ad","description":"Number of images per ad (max 3)","default":2},"experiment_package_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Experiment Package Id","description":"Test package id for A/B linkage"},"launch_strategy_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Launch Strategy Mode","description":"test_learn_pilot or direct_campaign"},"experiment_variants":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Experiment Variants","description":"JSON array of A/B creative versions for per-version campaign fan-out"},"video_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Video Length","description":"Video duration is fixed at 10 seconds for video ads","default":10},"video_lengths":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Lengths","description":"JSON object mapping video platforms to video duration; values are normalized to 10 seconds"},"video_quality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Quality","description":"Fallback video quality for video ads","default":"1080p"},"video_qualities":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Qualities","description":"JSON object mapping video platforms to requested video quality"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Target country"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province","description":"Target state/province"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"Target city"},"lead_forms_by_platform_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lead Forms By Platform Type","description":"Lead form settings keyed by exact platform type JSON"},"lead_form_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Lead Form Enabled","description":"Legacy Meta/LinkedIn lead-form enablement"},"lead_forms_by_ad_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lead Forms By Ad Type","description":"Legacy Meta/LinkedIn lead forms keyed by exact ad type JSON"},"google_lead_form_config":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Google Lead Form Config","description":"Removed Google lead-form configuration authority"},"reference_image_urls":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference Image Urls","description":"JSON array of reference image URLs"},"platform_sub_formats":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform Sub Formats","description":"JSON object with platform-specific sub-formats"},"product_offering_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id","description":"Product offering ID if campaign is for a specific product"},"objective":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Objective","description":"Campaign objective (for TikTok, only TRAFFIC is currently supported)"},"ad_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Format","description":"Ad format (e.g., for TikTok: SINGLE_IMAGE, VIDEO)"},"locations":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locations","description":"JSON array of multi-geo locations (LocationItem[])"},"dayparting_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dayparting Enabled","description":"Whether dayparting is enabled for this campaign","default":false},"dayparting_config":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dayparting Config","description":"JSON object with dayparting configuration"},"ugc_style_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ugc Style Enabled","description":"Whether requested video creatives should use creator-led UGC style","default":false},"provided_media_assets":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provided Media Assets","description":"JSON array of user-provided media assets to use as ad creative"},"files":{"anyOf":[{},{"type":"null"}],"title":"Files","description":"Optional reference images (max 5)"},"youtube_logo_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Youtube Logo Image Url","description":"Optional square logo URL for YouTube/Google Video"},"campaign_opportunity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Campaign Opportunity Id","description":"Trusted competitor campaign opportunity ID"},"campaign_page_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Campaign Page Id","description":"Published campaign page to promote"}},"type":"object","required":["user_prompt","target_audience","company_profile_id","target_platforms"],"title":"Body_create_ads_campaign_endpoint_api_guided_workflow_create_ads_campaign_post"},"Body_create_bug_report_api_feedback_bug_report_post":{"properties":{"report_json":{"type":"string","title":"Report Json"},"screenshot":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"null"}],"title":"Screenshot"}},"type":"object","required":["report_json"],"title":"Body_create_bug_report_api_feedback_bug_report_post"},"Body_create_email_campaign_api_guided_workflow_create_email_campaign_post":{"properties":{"user_prompt":{"type":"string","title":"User Prompt","description":"User's description of what they want to do"},"target_audience":{"type":"string","title":"Target Audience","description":"Description of the target audience"},"custom_instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Instructions","description":"Free-text user instructions/preferences to respect across idea and creative generation"},"reference_image_urls":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference Image Urls","description":"JSON array of reference image URLs"},"files":{"anyOf":[{},{"type":"null"}],"title":"Files","description":"Optional reference images (max 5)"},"num_samples":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Samples","description":"Number of email samples to generate (max 5)","default":3},"num_images_per_sample":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Images Per Sample","description":"Number of images per email sample (max 5)","default":2},"product_offering_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id","description":"Product offering ID if campaign is for a specific product"}},"type":"object","required":["user_prompt","target_audience"],"title":"Body_create_email_campaign_api_guided_workflow_create_email_campaign_post"},"Body_create_first_party_data_upload_api_first_party_data_uploads_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"mapping_overrides":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mapping Overrides"},"product_mapping":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Mapping"},"analysis_layer_preferences":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Analysis Layer Preferences"},"workspace_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workspace Name"},"retailer_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Retailer Label"},"import_upload_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Import Upload Id"},"allow_duplicate":{"type":"boolean","title":"Allow Duplicate","default":false}},"type":"object","required":["file"],"title":"Body_create_first_party_data_upload_api_first_party_data_uploads_post"},"Body_create_first_party_data_upload_async_job_api_first_party_data_uploads_async_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"mapping_overrides":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mapping Overrides"},"product_mapping":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Mapping"},"analysis_layer_preferences":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Analysis Layer Preferences"},"workspace_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workspace Name"},"retailer_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Retailer Label"},"import_upload_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Import Upload Id"},"allow_duplicate":{"type":"boolean","title":"Allow Duplicate","default":false}},"type":"object","required":["file"],"title":"Body_create_first_party_data_upload_async_job_api_first_party_data_uploads_async_post"},"Body_create_gallery_image_with_ai_api_gallery_create_with_ai_post":{"properties":{"prompt":{"type":"string","title":"Prompt"},"size":{"type":"string","title":"Size","default":"1024x1024"},"aspect_ratio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aspect Ratio"},"num_images":{"type":"integer","title":"Num Images","default":1},"use_company_style":{"type":"boolean","title":"Use Company Style","default":true},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"tags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tags"},"reference_gallery_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Reference Gallery Ids"},"reference_images":{"anyOf":[{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array"},{"type":"null"}],"title":"Reference Images"}},"type":"object","required":["prompt"],"title":"Body_create_gallery_image_with_ai_api_gallery_create_with_ai_post"},"Body_create_gallery_image_with_ai_job_api_gallery_create_with_ai_job_post":{"properties":{"prompt":{"type":"string","title":"Prompt"},"size":{"type":"string","title":"Size","default":"1024x1024"},"aspect_ratio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aspect Ratio"},"num_images":{"type":"integer","title":"Num Images","default":1},"use_company_style":{"type":"boolean","title":"Use Company Style","default":true},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"tags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tags"},"reference_gallery_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Reference Gallery Ids"},"gallery_media":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gallery Media"},"reference_document_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Reference Document Ids"},"purpose":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Purpose"},"request_identity":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Request Identity"},"requested_image_size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Requested Image Size"},"required_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Required Text"}},"type":"object","required":["prompt"],"title":"Body_create_gallery_image_with_ai_job_api_gallery_create_with_ai_job_post"},"Body_create_gallery_video_with_ai_job_api_gallery_create_video_with_ai_job_post":{"properties":{"prompt":{"type":"string","title":"Prompt"},"aspect_ratio":{"type":"string","title":"Aspect Ratio","default":"16:9"},"use_company_style":{"type":"boolean","title":"Use Company Style","default":true},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"tags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tags"},"reference_gallery_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Reference Gallery Ids"},"reference_document_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Reference Document Ids"},"first_frame_gallery_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Frame Gallery Id"}},"type":"object","required":["prompt"],"title":"Body_create_gallery_video_with_ai_job_api_gallery_create_video_with_ai_job_post"},"Body_create_social_post_campaign_api_guided_workflow_create_social_post_campaign_post":{"properties":{"user_prompt":{"type":"string","title":"User Prompt","description":"User's description of what they want to do"},"target_audience":{"type":"string","title":"Target Audience","description":"Description of the target audience"},"custom_instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Custom Instructions","description":"Free-text user instructions/preferences to respect across idea and creative generation"},"experiment_package_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Experiment Package Id","description":"Test package id for A/B linkage"},"launch_strategy_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Launch Strategy Mode","description":"test_learn_pilot or direct_campaign"},"selected_target_audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Target Audience","description":"JSON object for the selected audience"},"selected_campaign_idea":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Campaign Idea","description":"JSON object for the selected campaign idea"},"execution_settings_job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Settings Job Id"},"execution_settings_draft_identity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Settings Draft Identity"},"campaign_template":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Template","description":"Zero or one template selected by id"},"creative_references":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creative References","description":"Versioned image roles and confirmed campaign brand name"},"reference_selection_confirmed":{"type":"boolean","title":"Reference Selection Confirmed","description":"The current automatic reference disclosure completed before this selection was submitted","default":false},"campaign_timing":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Timing","description":"JSON object for structured campaign timing"},"campaign_budget":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Budget","description":"JSON object for structured campaign budget"},"campaign_budget_constraints":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Budget Constraints","description":"JSON object for reviewed campaign budget constraints"},"reference_image_urls":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference Image Urls","description":"JSON array of reference image URLs"},"files":{"anyOf":[{},{"type":"null"}],"title":"Files","description":"Optional reference images (max 5)"},"num_posts":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Posts","description":"Number of posts to generate: 1, or a 3/5-post series","default":1},"num_images_per_post":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Images Per Post","description":"Number of images per post (max 5)","default":2},"platforms":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platforms","description":"JSON array of platforms to generate posts for"},"post_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Post Type","description":"Type of post (for single platform)"},"media_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Media Type","description":"Media type (for single platform)"},"video_duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Video Duration","description":"Video duration is fixed at 10 seconds for video posts","default":10},"video_quality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Quality","description":"Fallback video quality for video posts","default":"1080p"},"use_batch_endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Use Batch Endpoint","description":"Flag to use batch endpoint for multi-platform"},"product_offering_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id","description":"Product offering ID if campaign is for a specific product"},"ugc_style_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ugc Style Enabled","description":"Whether requested social video creatives should use creator-led UGC style","default":false},"provided_media_assets":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provided Media Assets","description":"JSON array of user-provided media assets to use as social post creative"},"campaign_opportunity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Campaign Opportunity Id","description":"Trusted competitor campaign opportunity ID"}},"type":"object","required":["user_prompt","target_audience"],"title":"Body_create_social_post_campaign_api_guided_workflow_create_social_post_campaign_post"},"Body_direct_edit_social_post_api_campaigns_social_post_direct_edit_social_post_post":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id","description":"Campaign ID of the social post to edit"},"idea_number":{"type":"integer","title":"Idea Number","description":"Social post idea number"},"variation":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Variation","description":"Social post variation being edited"},"updated_post":{"$ref":"#/components/schemas/SocialPostDirectEditPatch","description":"Typed patch for social post content and media."},"expected_creative_state_token":{"anyOf":[{"type":"string","maxLength":64,"minLength":64,"pattern":"^[0-9a-fA-F]{64}$"},{"type":"null"}],"title":"Expected Creative State Token","description":"Creative fingerprint shown when the edit was confirmed."}},"type":"object","required":["campaign_id","idea_number","updated_post"],"title":"Body_direct_edit_social_post_api_campaigns_social_post_direct_edit_social_post_post"},"Body_edit_campaign_image_api_campaigns_email_edit_image_post":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id","description":"Campaign ID of the image to edit"},"idea_number":{"type":"integer","title":"Idea Number","description":"Campaign idea number"},"image_url":{"type":"string","title":"Image Url","description":"URL of the image to edit"},"edit_prompt":{"type":"string","title":"Edit Prompt","description":"Instructions for editing the image"}},"type":"object","required":["campaign_id","idea_number","image_url","edit_prompt"],"title":"Body_edit_campaign_image_api_campaigns_email_edit_image_post"},"Body_edit_image_api_content_editing_edit_image_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"},"prompt":{"type":"string","title":"Prompt"},"use_company_style":{"type":"boolean","title":"Use Company Style","default":false},"product_image":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"null"}],"title":"Product Image"},"logo_image":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"null"}],"title":"Logo Image"},"num_variations":{"type":"integer","title":"Num Variations","default":3}},"type":"object","required":["image","prompt"],"title":"Body_edit_image_api_content_editing_edit_image_post"},"Body_edit_social_post_image_api_campaigns_social_post_edit_social_post_image_post":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"idea_number":{"type":"integer","title":"Idea Number"},"variation":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Variation","description":"Exact social post variation. May be omitted only when the idea has one variation."},"image_url":{"type":"string","title":"Image Url"},"edit_prompt":{"type":"string","title":"Edit Prompt"}},"type":"object","required":["campaign_id","idea_number","image_url","edit_prompt"],"title":"Body_edit_social_post_image_api_campaigns_social_post_edit_social_post_image_post"},"Body_extract_product_offerings_from_document_route_api_workflow_brand_generation_product_offerings_extract_document_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"}},"type":"object","required":["file","company_profile_id"],"title":"Body_extract_product_offerings_from_document_route_api_workflow_brand_generation_product_offerings_extract_document_post"},"Body_generate_image_api_content_editing_generate_image_post":{"properties":{"prompt":{"type":"string","title":"Prompt"},"size":{"type":"string","title":"Size","default":"1024x1024"},"aspect_ratio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aspect Ratio"},"num_images":{"type":"integer","title":"Num Images","default":1},"reference_images":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Reference Images"},"use_company_style":{"type":"boolean","title":"Use Company Style","default":false}},"type":"object","required":["prompt"],"title":"Body_generate_image_api_content_editing_generate_image_post"},"Body_generate_market_opportunity_document_api_marketing_docs_market_opportunity_generate_post":{"properties":{"request":{"type":"string","title":"Request"},"files":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Files","default":[]}},"type":"object","required":["request"],"title":"Body_generate_market_opportunity_document_api_marketing_docs_market_opportunity_generate_post"},"Body_profile_first_party_data_file_api_first_party_data_profile_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_profile_first_party_data_file_api_first_party_data_profile_post"},"Body_replace_image_upload_api_images_replace_upload_post":{"properties":{"url":{"type":"string","title":"Url"},"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"}},"type":"object","required":["url","file"],"title":"Body_replace_image_upload_api_images_replace_upload_post"},"Body_start_manual_campaign_video_render_api_campaigns_video_editor_manual_render_job_post":{"properties":{"source_asset_id":{"type":"string","format":"uuid","title":"Source Asset Id"},"manifest_json":{"type":"string","title":"Manifest Json"},"request_identity":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Request Identity"},"overlay_image":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"null"}],"title":"Overlay Image"},"overlay_layer_ids_json":{"type":"string","title":"Overlay Layer Ids Json","default":"[]"},"overlay_images":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Overlay Images","default":[]}},"type":"object","required":["source_asset_id","manifest_json"],"title":"Body_start_manual_campaign_video_render_api_campaigns_video_editor_manual_render_job_post"},"Body_upload_analysis_files_api_workflow_brand_generation_step1_upload_files_post":{"properties":{"files":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Files"},"company_url":{"type":"string","title":"Company Url"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"}},"type":"object","required":["files","company_url","company_profile_id"],"title":"Body_upload_analysis_files_api_workflow_brand_generation_step1_upload_files_post"},"Body_upload_attachments_api_conversations__conversation_id__attachments_post":{"properties":{"files":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Files"}},"type":"object","required":["files"],"title":"Body_upload_attachments_api_conversations__conversation_id__attachments_post"},"Body_upload_brand_article_reference_api_brand_articles_references_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"Reference document or image for the writer to read"},"replaces":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Replaces","description":"Id of the reference this upload replaces, retired on success"}},"type":"object","required":["file"],"title":"Body_upload_brand_article_reference_api_brand_articles_references_post"},"Body_upload_campaign_brief_api_campaign_ideas__company_profile_id__brief_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"Campaign brief (.txt, .pdf or .docx)"},"campaign_idea_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Idea Mode"},"replaces":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Replaces","description":"Id of the brief this upload replaces, retired on success"}},"type":"object","required":["file"],"title":"Body_upload_campaign_brief_api_campaign_ideas__company_profile_id__brief_post"},"Body_upload_campaign_image_api_campaigns_email_upload_campaign_image_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"New image file to upload"},"campaign_id":{"type":"string","title":"Campaign Id","description":"Campaign ID"},"idea_number":{"type":"integer","title":"Idea Number","description":"Campaign idea number"},"image_type":{"type":"string","title":"Image Type","description":"Type of image (EMAIL_BANNER, EMAIL_IMAGE, etc.)","default":"EMAIL_IMAGE"}},"type":"object","required":["file","campaign_id","idea_number"],"title":"Body_upload_campaign_image_api_campaigns_email_upload_campaign_image_post"},"Body_upload_campaign_images_api_campaigns_email_upload_campaign_images_post":{"properties":{"files":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Files","description":"List of image files to upload (max 15)"},"campaign_id":{"type":"string","title":"Campaign Id","description":"Campaign ID"},"idea_number":{"type":"integer","title":"Idea Number","description":"Campaign idea number"},"image_type":{"type":"string","title":"Image Type","description":"Type of image (EMAIL_BANNER, EMAIL_IMAGE, etc.)","default":"EMAIL_IMAGE"}},"type":"object","required":["files","campaign_id","idea_number"],"title":"Body_upload_campaign_images_api_campaigns_email_upload_campaign_images_post"},"Body_upload_campaign_video_replacement_api_campaigns_video_editor_replacement_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_campaign_video_replacement_api_campaigns_video_editor_replacement_post"},"Body_upload_company_logo_api_company_profile__profile_id__upload_logo_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_company_logo_api_company_profile__profile_id__upload_logo_post"},"Body_upload_consumers_to_group_api_consumer_group_upload_consumers__group_id__post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_consumers_to_group_api_consumer_group_upload_consumers__group_id__post"},"Body_upload_email_campaign_image_general_api_campaigns_email_upload_image_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"New image file to upload"},"campaign_id":{"type":"string","title":"Campaign Id","description":"Campaign ID"},"idea_number":{"type":"integer","title":"Idea Number","description":"Campaign idea number"},"image_type":{"type":"string","title":"Image Type","description":"Type of image (EMAIL_BANNER, EMAIL_IMAGE, etc.)","default":"EMAIL_IMAGE"}},"type":"object","required":["file","campaign_id","idea_number"],"title":"Body_upload_email_campaign_image_general_api_campaigns_email_upload_image_post"},"Body_upload_first_look_document_api_workflow_first_look_documents_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"}},"type":"object","required":["file","company_profile_id"],"title":"Body_upload_first_look_document_api_workflow_first_look_documents_post"},"Body_upload_gallery_image_api_gallery_upload_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"category":{"type":"string","title":"Category","default":"uploaded"},"tags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tags"},"source_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Type"}},"type":"object","required":["file"],"title":"Body_upload_gallery_image_api_gallery_upload_post"},"Body_upload_gallery_images_bulk_api_gallery_upload_bulk_post":{"properties":{"files":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Files"},"titles":{"items":{"type":"string"},"type":"array","title":"Titles"},"descriptions":{"items":{"type":"string"},"type":"array","title":"Descriptions"},"category":{"type":"string","title":"Category","default":"uploaded"},"tags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tags"}},"type":"object","required":["files"],"title":"Body_upload_gallery_images_bulk_api_gallery_upload_bulk_post"},"Body_upload_image_api_company_profile__profile_id__upload_image_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_image_api_company_profile__profile_id__upload_image_post"},"Body_upload_influencer_search_brief_api_influencer_inventory_search_brief_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_influencer_search_brief_api_influencer_inventory_search_brief_post"},"Body_upload_product_offering_images_api_product_offerings__product_offering_id__images_upload_post":{"properties":{"files":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Files"},"titles":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Titles"},"descriptions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Descriptions"},"tags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tags"}},"type":"object","required":["files"],"title":"Body_upload_product_offering_images_api_product_offerings__product_offering_id__images_upload_post"},"Body_upload_screenshot_api_feedback_screenshot_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_screenshot_api_feedback_screenshot_post"},"Body_upload_social_post_image_api_campaigns_social_post_upload_social_post_image_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"Image file to upload"},"campaign_id":{"type":"string","title":"Campaign Id","description":"Campaign ID"},"idea_number":{"type":"integer","title":"Idea Number","description":"Campaign idea number"},"variation":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Variation","description":"Exact social post variation. May be omitted only when the idea has one variation."},"current_image_url":{"type":"string","title":"Current Image Url","description":"URL of the current image (required if replace is True)"},"replace":{"type":"boolean","title":"Replace","description":"Whether to replace existing image (True) or append as new image (False)","default":true}},"type":"object","required":["file","campaign_id","idea_number"],"title":"Body_upload_social_post_image_api_campaigns_social_post_upload_social_post_image_post"},"Body_upload_to_knowledge_base_api_chat_knowledge_base_upload_post":{"properties":{"files":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Files"}},"type":"object","required":["files"],"title":"Body_upload_to_knowledge_base_api_chat_knowledge_base_upload_post"},"Body_validate_competitor_url_api_workflow_brand_generation_step3_validate_competitor_post":{"properties":{"url":{"type":"string","title":"Url"}},"type":"object","required":["url"],"title":"Body_validate_competitor_url_api_workflow_brand_generation_step3_validate_competitor_post"},"BookingConfigResponse":{"properties":{"booking_url":{"type":"string","title":"Booking Url"}},"type":"object","required":["booking_url"],"title":"BookingConfigResponse"},"BrandArticleCreateRequest":{"properties":{"prompt":{"type":"string","maxLength":2000,"minLength":10,"title":"Prompt"},"article_type":{"type":"string","maxLength":48,"title":"Article Type","default":"answer_page"},"product_ids":{"items":{"type":"string"},"type":"array","maxItems":6,"title":"Product Ids"},"reference_ids":{"items":{"type":"string"},"type":"array","maxItems":3,"title":"Reference Ids"},"source_context":{"anyOf":[{"$ref":"#/components/schemas/BrandArticleSourceContext"},{"type":"null"}]},"title":{"type":"string","maxLength":220,"title":"Title","default":""},"max_word_count":{"anyOf":[{"type":"integer","maximum":120000.0,"minimum":1.0},{"type":"null"}],"title":"Max Word Count"},"request_identity":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Request Identity"}},"type":"object","required":["prompt"],"title":"BrandArticleCreateRequest"},"BrandArticleSourceContext":{"properties":{"source":{"type":"string","maxLength":64,"title":"Source","default":"ai-search"},"buyer_question":{"type":"string","maxLength":500,"title":"Buyer Question","default":""},"evidence_note":{"type":"string","maxLength":800,"title":"Evidence Note","default":""},"action_key":{"type":"string","maxLength":64,"title":"Action Key","default":""},"team_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"},"step_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Step Id"}},"type":"object","title":"BrandArticleSourceContext","description":"Where a request came from, when it came from somewhere."},"BrandArticleUpdateRequest":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":220},{"type":"null"}],"title":"Title"},"dek":{"anyOf":[{"type":"string","maxLength":400},{"type":"null"}],"title":"Dek"},"body_markdown":{"anyOf":[{"type":"string","maxLength":120000},{"type":"null"}],"title":"Body Markdown"},"resolved_question_ids":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":32},{"type":"null"}],"title":"Resolved Question Ids"},"expected_content_version":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"type":"null"}],"title":"Expected Content Version"}},"type":"object","title":"BrandArticleUpdateRequest"},"BrandFacebookOfficialUrlResponse":{"properties":{"facebook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facebook Url"},"facebook_page_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facebook Page Id"},"facebook_page_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facebook Page Name"},"facebook_page_about":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Facebook Page About"},"facebook_ads_library":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Facebook Ads Library"},"message":{"type":"string","title":"Message"},"source":{"type":"string","title":"Source"},"updated":{"type":"boolean","title":"Updated","default":false}},"type":"object","required":["message","source"],"title":"BrandFacebookOfficialUrlResponse","description":"Facebook official URL resolution status for the active brand profile."},"BrandResearchSettings":{"properties":{"auto_refresh_enabled":{"type":"boolean","title":"Auto Refresh Enabled"},"auto_apply_enabled":{"type":"boolean","title":"Auto Apply Enabled"},"automatic_research_available":{"type":"boolean","title":"Automatic Research Available"},"paused_product_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Paused Product Ids"},"needs_authorization":{"type":"boolean","title":"Needs Authorization"}},"additionalProperties":false,"type":"object","required":["auto_refresh_enabled","auto_apply_enabled","automatic_research_available","paused_product_ids","needs_authorization"],"title":"BrandResearchSettings"},"BrandResearchSettingsRequest":{"properties":{"auto_refresh_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Auto Refresh Enabled"},"auto_apply_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Auto Apply Enabled"}},"additionalProperties":false,"type":"object","title":"BrandResearchSettingsRequest"},"BrandTimingReview":{"properties":{"kind":{"type":"string","const":"brand_timing","title":"Kind","default":"brand_timing"},"fact_id":{"type":"string","format":"uuid","title":"Fact Id"},"fact_revision":{"type":"integer","minimum":1.0,"title":"Fact Revision"},"content_hash":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Content Hash"},"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title"},"timing_label":{"type":"string","maxLength":500,"minLength":1,"title":"Timing Label"},"duration_label":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Duration Label"},"source_label":{"type":"string","maxLength":500,"minLength":1,"title":"Source Label"},"certainty_label":{"type":"string","maxLength":160,"minLength":1,"title":"Certainty Label"},"dependencies":{"items":{"type":"string","maxLength":300,"minLength":1},"type":"array","maxItems":8,"title":"Dependencies","default":[]},"effect":{"type":"string","maxLength":600,"minLength":1,"title":"Effect"}},"additionalProperties":false,"type":"object","required":["fact_id","fact_revision","content_hash","title","timing_label","source_label","certainty_label","effect"],"title":"BrandTimingReview","description":"A person's confirmation of exact native planning terms, never execution."},"BudgetEstimateRequest":{"properties":{"goal":{"type":"string","title":"Goal","description":"User's marketing goal"},"currency":{"type":"string","title":"Currency","description":"Currency code (e.g., USD)"},"locations":{"items":{"$ref":"#/components/schemas/LocationItem"},"type":"array","title":"Locations","description":"List of target locations"},"product_offering_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Offering Id","description":"Optional product offering identifier"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date","description":"Optional start date in ISO format (YYYY-MM-DD)"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date","description":"Optional end date in ISO format (YYYY-MM-DD)"}},"type":"object","required":["goal","currency"],"title":"BudgetEstimateRequest","description":"Input payload for budget estimation."},"BudgetEstimateResponse":{"properties":{"currency":{"type":"string","title":"Currency","description":"ISO currency code (e.g., TWD, USD)"},"budget_recommendation":{"$ref":"#/components/schemas/BudgetRecommendationRange","description":"Recommended budget range"},"duration_days":{"type":"integer","title":"Duration Days","description":"Recommended duration in days"},"reasoning":{"type":"string","title":"Reasoning","description":"Concise explanation for recommendation"}},"type":"object","required":["currency","budget_recommendation","duration_days","reasoning"],"title":"BudgetEstimateResponse","description":"Structured response for budget estimate."},"BudgetGuardrailConfig":{"properties":{"enabled":{"type":"boolean","title":"Enabled","default":false},"default_limit":{"anyOf":[{"$ref":"#/components/schemas/BudgetLimitConfig"},{"type":"null"}]},"brand_overrides":{"additionalProperties":{"$ref":"#/components/schemas/BudgetLimitConfig"},"type":"object","title":"Brand Overrides"}},"type":"object","title":"BudgetGuardrailConfig"},"BudgetLimitConfig":{"properties":{"amount":{"type":"number","exclusiveMinimum":0.0,"title":"Amount"},"currency":{"type":"string","maxLength":8,"minLength":3,"title":"Currency"}},"type":"object","required":["amount","currency"],"title":"BudgetLimitConfig"},"BudgetRecommendationRange":{"properties":{"min_value":{"type":"number","title":"Min Value","description":"Absolute minimum viable daily budget"},"max_value":{"type":"number","title":"Max Value","description":"Maximum efficient daily budget before diminishing returns"},"suggested_value":{"type":"number","title":"Suggested Value","description":"Recommended starting daily budget"}},"type":"object","required":["min_value","max_value","suggested_value"],"title":"BudgetRecommendationRange","description":"Recommended daily budget range."},"BulkArchiveCompetitorsRequest":{"properties":{"competitor_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":500,"minItems":1,"title":"Competitor Ids"}},"type":"object","required":["competitor_ids"],"title":"BulkArchiveCompetitorsRequest"},"BulkArchiveProductsRequest":{"properties":{"product_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":500,"minItems":1,"title":"Product Ids"}},"type":"object","required":["product_ids"],"title":"BulkArchiveProductsRequest"},"BulkCampaignDeletionResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/BulkCampaignDeletionResult"},"type":"array","title":"Results"},"deleted_count":{"type":"integer","title":"Deleted Count"},"blocked_count":{"type":"integer","title":"Blocked Count"},"not_found_count":{"type":"integer","title":"Not Found Count"}},"type":"object","required":["results","deleted_count","blocked_count","not_found_count"],"title":"BulkCampaignDeletionResponse"},"BulkCampaignDeletionResult":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"idea_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Idea Number"},"variation":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Variation"},"outcome":{"type":"string","enum":["deleted","already_deleted","blocked","not_found"],"title":"Outcome"},"code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["campaign_id","outcome"],"title":"BulkCampaignDeletionResult"},"BulkCompanyProfileAccessRequest":{"properties":{"user_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"User Ids","description":"List of user IDs"},"role":{"$ref":"#/components/schemas/ProjectRoleEnum","description":"Role to assign to all users"}},"type":"object","required":["user_ids","role"],"title":"BulkCompanyProfileAccessRequest","description":"Request to grant company profile access to multiple users."},"BulkCompanyProfileAccessResponse":{"properties":{"successful":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Successful","description":"User IDs successfully granted access"},"failed":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Failed","description":"User IDs that failed with error messages"},"total_processed":{"type":"integer","title":"Total Processed"}},"type":"object","required":["total_processed"],"title":"BulkCompanyProfileAccessResponse","description":"Response for bulk company profile access operations."},"BulkResearchSettingsRequest":{"properties":{"product_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":500,"minItems":1,"title":"Product Ids"},"mode":{"type":"string","enum":["paused","inherit"],"title":"Mode"}},"additionalProperties":false,"type":"object","required":["product_ids","mode"],"title":"BulkResearchSettingsRequest"},"BusinessMemoryPage":{"properties":{"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"actor_user_id":{"type":"string","format":"uuid","title":"Actor User Id"},"work_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Work Id"},"items":{"items":{"$ref":"#/components/schemas/BusinessMemoryRecord"},"type":"array","title":"Items"},"total":{"type":"integer","minimum":0.0,"title":"Total"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"scope_revision":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Scope Revision"},"coverage":{"$ref":"#/components/schemas/MemoryCoverage"}},"additionalProperties":false,"type":"object","required":["organization_id","company_profile_id","actor_user_id","items","total","scope_revision","coverage"],"title":"BusinessMemoryPage"},"BusinessMemoryRecord":{"properties":{"id":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Id"},"event_id":{"type":"string","format":"uuid","title":"Event Id"},"revision":{"type":"integer","minimum":1.0,"title":"Revision"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"audience":{"type":"string","enum":["brand","personal","work"],"title":"Audience"},"owner_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Owner User Id"},"work_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Work Id"},"kind":{"type":"string","enum":["fact","preference","instruction","lesson"],"title":"Kind"},"statement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Statement"},"lifecycle":{"type":"string","enum":["candidate","active","contested","superseded","withdrawn"],"title":"Lifecycle"},"required":{"type":"boolean","title":"Required"},"valid_from":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Valid From"},"valid_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Valid Until"},"recorded_at":{"type":"string","format":"date-time","title":"Recorded At"},"source_observed_at":{"type":"string","format":"date-time","title":"Source Observed At"},"source":{"$ref":"#/components/schemas/MemorySource"},"can_correct":{"type":"boolean","title":"Can Correct"},"can_withdraw":{"type":"boolean","title":"Can Withdraw"},"can_accept":{"type":"boolean","title":"Can Accept"}},"additionalProperties":false,"type":"object","required":["id","event_id","revision","organization_id","company_profile_id","audience","kind","statement","lifecycle","required","recorded_at","source_observed_at","source","can_correct","can_withdraw","can_accept"],"title":"BusinessMemoryRecord"},"BusinessUnderstanding":{"properties":{"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"observed_at":{"type":"string","format":"date-time","title":"Observed At"},"brand_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"details":{"items":{"$ref":"#/components/schemas/UnderstandingDetail"},"type":"array","title":"Details","default":[]},"goals":{"items":{"type":"string"},"type":"array","title":"Goals","default":[]},"records":{"items":{"$ref":"#/components/schemas/UnderstandingGroup"},"type":"array","title":"Records","default":[]},"not_used":{"items":{"type":"string"},"type":"array","title":"Not Used","default":[]},"guidance_waiting":{"type":"integer","minimum":0.0,"title":"Guidance Waiting","default":0},"coverage":{"type":"string","enum":["complete","partial"],"title":"Coverage","default":"complete"}},"additionalProperties":false,"type":"object","required":["organization_id","company_profile_id","observed_at"],"title":"BusinessUnderstanding"},"BuyerQuestion":{"properties":{"id":{"type":"string","maxLength":80,"minLength":1,"title":"Id"},"question":{"type":"string","minLength":1,"title":"Question","description":"One concise buyer question."},"basis":{"type":"string","const":"inferred","title":"Basis"},"rationale":{"type":"string","minLength":1,"title":"Rationale","description":"Why this inferred question could matter; not a claim about observed customer behavior."},"suggested_answer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Suggested Answer","description":"A concise, source-supported answer, or null when evidence is missing."},"missing_proof":{"items":{"type":"string"},"type":"array","maxItems":4,"title":"Missing Proof"},"source_ids":{"items":{"type":"string"},"type":"array","maxItems":6,"minItems":1,"title":"Source Ids"}},"additionalProperties":false,"type":"object","required":["id","question","basis","rationale","source_ids"],"title":"BuyerQuestion"},"CalculateChargeRequest":{"properties":{"organization_id":{"type":"string","title":"Organization Id"},"daily_budget":{"type":"number","title":"Daily Budget"},"campaign_days":{"type":"integer","title":"Campaign Days"},"currency":{"type":"string","title":"Currency","description":"Currency code for display (e.g., USD, INR)"},"ad_account_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Account Currency","description":"Currency code used by the selected ad account"}},"type":"object","required":["organization_id","daily_budget","campaign_days","currency"],"title":"CalculateChargeRequest","description":"Request to calculate charge for ad campaign."},"CalculateChargeResponse":{"properties":{"ad_spend":{"type":"number","title":"Ad Spend"},"commission_rate":{"type":"number","title":"Commission Rate"},"commission_amount":{"type":"number","title":"Commission Amount"},"total_charge":{"type":"number","title":"Total Charge"},"tier_used":{"type":"string","title":"Tier Used"},"current_balance":{"type":"number","title":"Current Balance"},"has_sufficient_credits":{"type":"boolean","title":"Has Sufficient Credits"},"currency":{"type":"string","title":"Currency","default":"USD"},"billing_currency":{"type":"string","title":"Billing Currency","default":"USD"},"fx_rate_to_usd":{"type":"number","title":"Fx Rate To Usd"}},"type":"object","required":["ad_spend","commission_rate","commission_amount","total_charge","tier_used","current_balance","has_sufficient_credits","fx_rate_to_usd"],"title":"CalculateChargeResponse","description":"Response with calculated charges."},"CampaignAdKeyword":{"properties":{"text":{"type":"string","maxLength":1000,"minLength":1,"pattern":"\\S","title":"Text"},"match_type":{"anyOf":[{"type":"string","enum":["BROAD","PHRASE","EXACT"]},{"type":"null"}],"title":"Match Type"}},"additionalProperties":false,"type":"object","required":["text"],"title":"CampaignAdKeyword"},"CampaignAdLaunchReviewPreview":{"properties":{"ad_ref":{"$ref":"#/components/schemas/ResourceRef"},"platform":{"type":"string","enum":["google_search","google_display","google_video","meta_feed","meta_stories_reels","tiktok_video","linkedin_ads_image","linkedin_ads_video","chatgpt_chat_card"],"title":"Platform"},"source":{"type":"string","const":"launch_review","title":"Source"},"content_version":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Content Version"},"headlines":{"anyOf":[{"items":{"type":"string","maxLength":1000,"minLength":1},"type":"array","maxItems":15},{"type":"null"}],"title":"Headlines"},"descriptions":{"anyOf":[{"items":{"type":"string","maxLength":4000,"minLength":1},"type":"array","maxItems":4},{"type":"null"}],"title":"Descriptions"},"copy_fields":{"items":{"$ref":"#/components/schemas/PaidCampaignReviewField"},"type":"array","maxItems":30,"title":"Copy Fields","default":[]},"destination_urls":{"anyOf":[{"items":{"type":"string","maxLength":2048,"minLength":1},"type":"array","maxItems":10},{"type":"null"}],"title":"Destination Urls"},"keywords":{"anyOf":[{"items":{"$ref":"#/components/schemas/CampaignAdKeyword"},"type":"array","maxItems":50},{"type":"null"}],"title":"Keywords"},"negative_keywords":{"anyOf":[{"items":{"$ref":"#/components/schemas/CampaignAdKeyword"},"type":"array","maxItems":50},{"type":"null"}],"title":"Negative Keywords"},"planning_fields":{"items":{"$ref":"#/components/schemas/PaidCampaignReviewField"},"type":"array","maxItems":8,"title":"Planning Fields","default":[]},"media":{"anyOf":[{"items":{"$ref":"#/components/schemas/WorkReviewMedia"},"type":"array","maxItems":20},{"type":"null"}],"title":"Media"},"launch_terms":{"anyOf":[{"$ref":"#/components/schemas/CampaignAdLaunchTerms"},{"type":"null"}]},"omitted_fields":{"items":{"type":"string","enum":["headlines","descriptions","copy_fields","destination_urls","keywords","negative_keywords","planning_fields","media","launch_terms"]},"type":"array","maxItems":9,"title":"Omitted Fields","default":[]}},"additionalProperties":false,"type":"object","required":["ad_ref","platform","source","content_version"],"title":"CampaignAdLaunchReviewPreview","description":"Complete frozen launch creative, with the shared preview's exact bounds."},"CampaignAdLaunchTerms":{"properties":{"account_name":{"type":"string","maxLength":200,"minLength":1,"title":"Account Name"},"identity_name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Identity Name"},"budget_mode":{"type":"string","enum":["daily","lifetime"],"title":"Budget Mode"},"budget_amount":{"type":"string","pattern":"^\\d+(?:\\.\\d{1,6})?$","title":"Budget Amount"},"planned_spend":{"type":"string","pattern":"^\\d+(?:\\.\\d{1,6})?$","title":"Planned Spend"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","title":"Currency"},"starts_at":{"type":"string","format":"date-time","title":"Starts At"},"ends_at":{"type":"string","format":"date-time","title":"Ends At"},"timezone":{"type":"string","maxLength":100,"minLength":1,"title":"Timezone"},"commission_amount":{"type":"string","pattern":"^\\d+(?:\\.\\d{1,2})?$","title":"Commission Amount"},"commission_currency":{"type":"string","const":"USD","title":"Commission Currency","default":"USD"},"targeting":{"items":{"$ref":"#/components/schemas/PaidCampaignReviewField"},"type":"array","maxItems":12,"title":"Targeting","default":[]}},"additionalProperties":false,"type":"object","required":["account_name","budget_mode","budget_amount","planned_spend","currency","starts_at","ends_at","timezone","commission_amount"],"title":"CampaignAdLaunchTerms","description":"Original read-only review context; no confirmation or delivery authority."},"CampaignAdPreview":{"properties":{"ad_ref":{"$ref":"#/components/schemas/ResourceRef"},"platform":{"type":"string","enum":["google_search","google_display","google_video","meta_feed","meta_stories_reels","tiktok_video","linkedin_ads_image","linkedin_ads_video","chatgpt_chat_card"],"title":"Platform"},"source":{"type":"string","enum":["saved","launch_review"],"title":"Source"},"content_version":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Content Version"},"headlines":{"anyOf":[{"items":{"type":"string","maxLength":1000,"minLength":1},"type":"array","maxItems":15},{"type":"null"}],"title":"Headlines"},"descriptions":{"anyOf":[{"items":{"type":"string","maxLength":4000,"minLength":1},"type":"array","maxItems":4},{"type":"null"}],"title":"Descriptions"},"copy_fields":{"items":{"$ref":"#/components/schemas/PaidCampaignReviewField"},"type":"array","maxItems":30,"title":"Copy Fields","default":[]},"destination_urls":{"anyOf":[{"items":{"type":"string","maxLength":2048,"minLength":1},"type":"array","maxItems":10},{"type":"null"}],"title":"Destination Urls"},"keywords":{"anyOf":[{"items":{"$ref":"#/components/schemas/CampaignAdKeyword"},"type":"array","maxItems":50},{"type":"null"}],"title":"Keywords"},"negative_keywords":{"anyOf":[{"items":{"$ref":"#/components/schemas/CampaignAdKeyword"},"type":"array","maxItems":50},{"type":"null"}],"title":"Negative Keywords"},"planning_fields":{"items":{"$ref":"#/components/schemas/PaidCampaignReviewField"},"type":"array","maxItems":8,"title":"Planning Fields","default":[]},"media":{"anyOf":[{"items":{"$ref":"#/components/schemas/WorkReviewMedia"},"type":"array","maxItems":20},{"type":"null"}],"title":"Media"},"launch_terms":{"anyOf":[{"$ref":"#/components/schemas/CampaignAdLaunchTerms"},{"type":"null"}]},"omitted_fields":{"items":{"type":"string","enum":["headlines","descriptions","copy_fields","destination_urls","keywords","negative_keywords","planning_fields","media","launch_terms"]},"type":"array","maxItems":9,"title":"Omitted Fields","default":[]}},"additionalProperties":false,"type":"object","required":["ad_ref","platform","source","content_version"],"title":"CampaignAdPreview","description":"Exact native creative for reading; never launch or current-delivery authority.\n\nNull lists have no structured source; empty lists are explicitly recorded\nempty. Omitted fields are whole source fields that exceed preview bounds.\nExisting artifact/review media remains the authenticated media owner."},"CampaignAnalyticsImpact":{"properties":{"metric_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric Key"},"relative_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Relative Delta"},"outcome_state":{"type":"string","title":"Outcome State","default":"measuring"},"post_days_observed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Post Days Observed"},"optimization_executed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Optimization Executed At"},"pre_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pre Value"},"post_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Post Value"},"change_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Summary"}},"type":"object","title":"CampaignAnalyticsImpact","description":"One executed optimization move's measured after-effect on the campaign.\n\n``outcome_state`` is ``measuring`` until enough post-change days accrue, then the\nscored verdict (``improved`` | ``neutral`` | ``regressed``) from the AI team's\nsingle learning brain."},"CampaignAnalyticsResponse":{"properties":{"impressions":{"type":"integer","minimum":0.0,"title":"Impressions","default":0},"clicks":{"type":"integer","minimum":0.0,"title":"Clicks","default":0},"conversions":{"type":"integer","minimum":0.0,"title":"Conversions","default":0},"leads":{"type":"integer","minimum":0.0,"title":"Leads","default":0},"spend":{"type":"number","minimum":0.0,"title":"Spend","default":0.0},"revenue":{"type":"number","minimum":0.0,"title":"Revenue","default":0.0},"ctr":{"type":"number","minimum":0.0,"title":"Ctr","default":0.0},"conversion_rate":{"type":"number","minimum":0.0,"title":"Conversion Rate","default":0.0},"cpc":{"type":"number","minimum":0.0,"title":"Cpc","default":0.0},"cpa":{"type":"number","minimum":0.0,"title":"Cpa","default":0.0},"roas":{"type":"number","minimum":0.0,"title":"Roas","default":0.0},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"company_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Id"},"campaign_id":{"type":"string","title":"Campaign Id"},"campaign_type":{"type":"string","title":"Campaign Type"},"platform":{"type":"string","title":"Platform"},"platform_campaign_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform Campaign Id"},"platform_ad_set_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform Ad Set Id"},"platform_ad_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform Ad Id"},"additional_metrics":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Additional Metrics"},"last_synced_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Synced At"},"sync_status":{"type":"string","title":"Sync Status","default":"pending"},"sync_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sync Error"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","company_profile_id","campaign_id","campaign_type","platform","created_at","updated_at"],"title":"CampaignAnalyticsResponse","description":"Response schema for campaign analytics"},"CampaignAnalyticsStrip":{"properties":{"as_of_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of Date"},"currency_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency Code"},"spark":{"anyOf":[{"items":{"anyOf":[{"type":"number"},{"type":"null"}]},"type":"array"},{"type":"null"}],"title":"Spark"},"general":{"items":{"$ref":"#/components/schemas/CampaignAnalyticsWindow"},"type":"array","title":"General","default":[]},"post_optimization":{"items":{"$ref":"#/components/schemas/CampaignAnalyticsImpact"},"type":"array","title":"Post Optimization","default":[]},"has_big_movement":{"type":"boolean","title":"Has Big Movement","default":false},"conversion_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversion Status"},"sample_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sample Size"},"sample_unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sample Unit"}},"type":"object","title":"CampaignAnalyticsStrip","description":"The close-the-loop analytics shown under a campaign row: general DoD/WoW for\nthe headline metric, plus one entry per optimization move's after-effect."},"CampaignAnalyticsSummary":{"properties":{"total_impressions":{"type":"integer","title":"Total Impressions"},"total_clicks":{"type":"integer","title":"Total Clicks"},"total_conversions":{"type":"integer","title":"Total Conversions"},"total_spend":{"type":"number","title":"Total Spend"},"total_revenue":{"type":"number","title":"Total Revenue"},"overall_ctr":{"type":"number","title":"Overall Ctr"},"overall_conversion_rate":{"type":"number","title":"Overall Conversion Rate"},"overall_roas":{"type":"number","title":"Overall Roas"},"campaign_types":{"additionalProperties":{"$ref":"#/components/schemas/CampaignTypeMetrics"},"type":"object","title":"Campaign Types"},"trends":{"items":{"$ref":"#/components/schemas/TrendData"},"type":"array","title":"Trends"},"trends_by_channel":{"items":{"$ref":"#/components/schemas/ChannelTrendData"},"type":"array","title":"Trends By Channel","default":[]},"channel_labels":{"additionalProperties":{"type":"string"},"type":"object","title":"Channel Labels","default":{}},"last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Updated"}},"type":"object","required":["total_impressions","total_clicks","total_conversions","total_spend","total_revenue","overall_ctr","overall_conversion_rate","overall_roas","campaign_types","trends"],"title":"CampaignAnalyticsSummary","description":"Dashboard summary of all campaign analytics"},"CampaignAnalyticsWindow":{"properties":{"window_type":{"type":"string","title":"Window Type"},"metric_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric Key"},"current_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Current Value"},"baseline_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Baseline Value"},"relative_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Relative Delta"},"data_sufficiency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data Sufficiency"},"is_big_movement":{"type":"boolean","title":"Is Big Movement","default":false},"movement_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Movement Reason"}},"type":"object","required":["window_type"],"title":"CampaignAnalyticsWindow","description":"One general DoD/WoW movement for a campaign's headline metric.\n\n``relative_delta`` is null when the baseline is ~0 (an honest \"new/!comparable\",\nnever a fabricated %); ``data_sufficiency`` is ``ok`` once the window has enough\ndays, else ``insufficient`` (e.g. WoW with under a full prior week)."},"CampaignAppliedOptimization":{"properties":{"action_id":{"type":"string","title":"Action Id"},"approval_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approval Id"},"approval_ids":{"items":{"type":"string"},"type":"array","title":"Approval Ids","default":[]},"action_ids":{"items":{"type":"string"},"type":"array","title":"Action Ids","default":[]},"rollbackable_action_ids":{"items":{"type":"string"},"type":"array","title":"Rollbackable Action Ids","default":[]},"title":{"type":"string","title":"Title"},"executed_at":{"type":"string","title":"Executed At"},"change_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Scope"},"change_scope_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Scope Label"},"outcome_state":{"type":"string","title":"Outcome State","default":"measuring"},"execution_outcome":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Outcome"},"applied_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Applied Count"},"failed_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Failed Count"},"uncertain_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Uncertain Count"},"changes":{"items":{"$ref":"#/components/schemas/CampaignOptimizationChange"},"type":"array","title":"Changes","default":[]},"is_rollback":{"type":"boolean","title":"Is Rollback","default":false},"rollback_available":{"type":"boolean","title":"Rollback Available","default":false},"rollback_unavailable_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rollback Unavailable Reason"},"forecast":{"anyOf":[{"$ref":"#/components/schemas/CampaignOptimizationForecast"},{"type":"null"}]},"applied_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Applied By"}},"type":"object","required":["action_id","title","executed_at"],"title":"CampaignAppliedOptimization","description":"The most recent provider-executed optimization for one campaign.\n\nThis is the durable, read-only counterpart to ``pending_recommendation``:\nthe campaign row can keep showing exactly what changed after the approval\ndisappears from the open queue."},"CampaignDaypartingRequest":{"properties":{"campaign_id":{"type":"string","format":"uuid","title":"Campaign Id"},"platform_configs":{"additionalProperties":{"$ref":"#/components/schemas/PlatformDaypartingConfig"},"type":"object","title":"Platform Configs"}},"type":"object","required":["campaign_id","platform_configs"],"title":"CampaignDaypartingRequest"},"CampaignDeletableTargetsResponse":{"properties":{"targets":{"items":{"$ref":"#/components/schemas/CampaignDeletionTargetResponse"},"type":"array","title":"Targets"},"total":{"type":"integer","title":"Total"},"truncated":{"type":"boolean","title":"Truncated"}},"type":"object","required":["targets","total","truncated"],"title":"CampaignDeletableTargetsResponse"},"CampaignDeletionTargetRequest":{"properties":{"campaign_id":{"type":"string","maxLength":255,"minLength":1,"title":"Campaign Id"},"idea_number":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Idea Number"},"variation":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Variation"}},"type":"object","required":["campaign_id"],"title":"CampaignDeletionTargetRequest","description":"One removable unit: a paid root UUID, or a social list row."},"CampaignDeletionTargetResponse":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"idea_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Idea Number"},"variation":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Variation"}},"type":"object","required":["campaign_id"],"title":"CampaignDeletionTargetResponse"},"CampaignDeletionTargetsRequest":{"properties":{"targets":{"items":{"$ref":"#/components/schemas/CampaignDeletionTargetRequest"},"type":"array","maxItems":200,"minItems":1,"title":"Targets"}},"type":"object","required":["targets"],"title":"CampaignDeletionTargetsRequest"},"CampaignDraftReview":{"properties":{"kind":{"type":"string","const":"campaign_draft","title":"Kind","default":"campaign_draft"},"action":{"type":"string","const":"delete","title":"Action","default":"delete"},"campaign_id":{"type":"string","format":"uuid","title":"Campaign Id"},"campaign_name":{"type":"string","maxLength":200,"minLength":1,"title":"Campaign Name"},"platforms":{"items":{"type":"string","maxLength":64,"minLength":1},"type":"array","maxItems":8,"title":"Platforms","default":[]},"ad_count":{"type":"integer","minimum":0.0,"title":"Ad Count"},"effect":{"type":"string","maxLength":600,"minLength":1,"title":"Effect"}},"additionalProperties":false,"type":"object","required":["campaign_id","campaign_name","ad_count","effect"],"title":"CampaignDraftReview","description":"Exact private draft removal; provider-bound or running work is excluded."},"CampaignInfo":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"ad_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Type"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"ad_creative_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Creative Id"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"cta_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cta Text"},"ad_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Format"},"creative_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creative Type"},"ad_creative_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ad Creative Urls"},"cached_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cached Url"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Url"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"page_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Name"},"page_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Id"},"publisher_platforms":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Publisher Platforms"},"ad_snapshot_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Snapshot Url"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"duration_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Days"},"detected_at":{"type":"string","format":"date-time","title":"Detected At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Posted At"},"first_shown":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"First Shown"},"last_shown":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Shown"},"is_active":{"type":"boolean","title":"Is Active"},"confidence_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence Score"},"matched_product_offering_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Matched Product Offering Ids"},"matched_offerings":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Matched Offerings"},"competition_reasons":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Competition Reasons"},"ai_analysis":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Ai Analysis"},"detected_offers":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Detected Offers"},"detected_products":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Detected Products"},"advertiser_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Advertiser Name"},"has_native_headline":{"type":"boolean","title":"Has Native Headline","default":true},"cta_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cta Url"},"placement_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Placement Label"},"page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Url"},"page_position":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Position"},"offer_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offer Text"},"product_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Name"},"event_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Date"},"website_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website Kind"},"event_headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Headline"},"change_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Type"},"change_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Date"},"signal_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signal Kind"}},"type":"object","required":["id","detected_at","is_active"],"title":"CampaignInfo","description":"Competitor ad campaign (aligned to CompetitorAd fields)."},"CampaignKind":{"type":"string","enum":["digital_ads","social_media"],"title":"CampaignKind"},"CampaignMediaOperation":{"properties":{"action":{"type":"string","enum":["replace","add","add_and_set_primary"],"title":"Action"},"media_type":{"type":"string","enum":["image","video"],"title":"Media Type"},"selected_url":{"type":"string","title":"Selected Url"},"selected_gallery_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Gallery Id"},"previous_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Previous Url"},"source_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Source Index"}},"type":"object","required":["action","media_type","selected_url"],"title":"CampaignMediaOperation","description":"Campaign Edit Mode media change applied by the outer Save/Sync transaction."},"CampaignOptimizationAlternative":{"properties":{"alternative_id":{"type":"string","title":"Alternative Id"},"kind":{"type":"string","title":"Kind"},"title":{"type":"string","title":"Title"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"is_recommended":{"type":"boolean","title":"Is Recommended","default":false},"forecast":{"anyOf":[{"$ref":"#/components/schemas/CampaignOptimizationForecast"},{"type":"null"}]},"snooze_hours":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Snooze Hours"},"edits":{"items":{"$ref":"#/components/schemas/CampaignOptimizationFieldEdit"},"type":"array","title":"Edits","default":[]}},"type":"object","required":["alternative_id","kind","title"],"title":"CampaignOptimizationAlternative","description":"The same decision at another size, or \"wait\". Chosen at decision time.\n\n``alternative_id`` is what the decide endpoint accepts as\n``selected_alternative_id``. ``snooze_hours`` is set on the \"wait\" kind\nonly; ``edits`` shows the alternative's own before/after when it changes\na budget."},"CampaignOptimizationChange":{"properties":{"title":{"type":"string","title":"Title"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"},"rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rationale"},"campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign"},"campaign_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id"},"campaign_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Name"},"preview_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preview Image Url"},"option_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Option Id"},"selection_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selection Id"},"source_action_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Action Id"},"edits":{"items":{"$ref":"#/components/schemas/CampaignOptimizationFieldEdit"},"type":"array","title":"Edits","default":[]}},"type":"object","required":["title"],"title":"CampaignOptimizationChange","description":"One concrete change inside a pending optimization, for a before/after review.\n\nCarries the data-backed *why* (``rationale``) and the list of literal field/asset\n``edits`` (each a clean before -> after), so accepting a live-campaign change is\ninformed -- the reviewer sees exactly which fields/assets change and the reason."},"CampaignOptimizationCounterRange":{"properties":{"current_daily_budget":{"type":"number","title":"Current Daily Budget"},"min_daily_budget":{"type":"number","title":"Min Daily Budget"},"max_daily_budget":{"type":"number","title":"Max Daily Budget"},"currency_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency Code"},"suggested_daily_budget":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Suggested Daily Budget"}},"type":"object","required":["current_daily_budget","min_daily_budget","max_daily_budget"],"title":"CampaignOptimizationCounterRange","description":"The daily-budget window a person may counter inside, from the option's own governor bounds."},"CampaignOptimizationEvidencePoint":{"properties":{"claim":{"type":"string","title":"Claim"},"source":{"type":"string","title":"Source"},"source_label":{"type":"string","title":"Source Label"}},"type":"object","required":["claim","source","source_label"],"title":"CampaignOptimizationEvidencePoint","description":"One checkable why-now claim and where it was read from."},"CampaignOptimizationFieldEdit":{"properties":{"label":{"type":"string","title":"Label"},"kind":{"type":"string","title":"Kind"},"before":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Before"},"after":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"After"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"before_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Before Image Url"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"gloss":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gloss"},"match_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Match Type"}},"type":"object","required":["label","kind"],"title":"CampaignOptimizationFieldEdit","description":"One concrete field/asset edit, as a clean before -> after mapping.\n\nSourced from a single ``optimization_action`` (not the option-level prose), so\neach row is the literal thing changing: a copy field (headline/description) with\nits current vs proposed text, the new creative image, or a keyword operation\n(pause / add / add-negative) with the metric evidence behind it."},"CampaignOptimizationForecast":{"properties":{"metric":{"type":"string","title":"Metric"},"metric_label":{"type":"string","title":"Metric Label"},"unit":{"type":"string","title":"Unit"},"currency_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency Code"},"direction":{"type":"string","title":"Direction"},"is_improvement":{"type":"boolean","title":"Is Improvement","default":true},"magnitude_pct":{"type":"number","title":"Magnitude Pct"},"range_low_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Range Low Pct"},"range_high_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Range High Pct"},"readout_days":{"type":"integer","title":"Readout Days"},"baseline_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Baseline Value"},"projected_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Projected Value"},"projected_low_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Projected Low Value"},"projected_high_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Projected High Value"},"confidence":{"type":"string","title":"Confidence"},"confidence_basis":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence Basis"},"basis":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Basis"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"plain_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plain Summary"}},"type":"object","required":["metric","metric_label","unit","direction","magnitude_pct","readout_days","confidence"],"title":"CampaignOptimizationForecast","description":"What the AI team expects this change to do, pinned to the observed baseline.\n\nStated so a marketer reads \"Cost per conversion $41.20 -> about $37.50 in\n7 days\", not a bare percentage. ``is_improvement`` says whether the named\ndirection is the good one for that metric, so the surface can colour it\nwithout re-deriving metric semantics."},"CampaignOptimizationGoalContext":{"properties":{"statement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Statement"},"metric_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric Label"},"target_display":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Display"},"horizon_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Horizon Days"}},"type":"object","title":"CampaignOptimizationGoalContext","description":"The brand goal this change is working toward, for the review header."},"CampaignOptimizationGuardrailCheck":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"status":{"type":"string","title":"Status"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"}},"type":"object","required":["key","label","status"],"title":"CampaignOptimizationGuardrailCheck","description":"One thing verified before the change was offered, in plain language."},"CampaignOptimizationProposal":{"properties":{"option_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Option Id"},"campaign_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id"},"confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence"},"forecast":{"anyOf":[{"$ref":"#/components/schemas/CampaignOptimizationForecast"},{"type":"null"}]},"evidence_points":{"items":{"$ref":"#/components/schemas/CampaignOptimizationEvidencePoint"},"type":"array","title":"Evidence Points","default":[]},"alternatives":{"items":{"$ref":"#/components/schemas/CampaignOptimizationAlternative"},"type":"array","title":"Alternatives","default":[]},"guardrail_checks":{"items":{"$ref":"#/components/schemas/CampaignOptimizationGuardrailCheck"},"type":"array","title":"Guardrail Checks","default":[]},"counter_budget_range":{"anyOf":[{"$ref":"#/components/schemas/CampaignOptimizationCounterRange"},{"type":"null"}]}},"type":"object","title":"CampaignOptimizationProposal","description":"Proposal v2 for one campaign option inside a pending approval.\n\nA bundle can hold one option per campaign; the card for campaign X reads\nthe proposal whose ``campaign_id`` is X. Everything here is projected from\nthe option row the optimizer wrote, so the card, the review dialog and\nMarkee agree. ``counter_budget_range`` is the window the person's own\ndaily budget must sit inside; absent when the option moves no budget."},"CampaignOptimizationRollbackRequest":{"properties":{"action_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":50,"minItems":1,"title":"Action Ids"}},"type":"object","required":["action_ids"],"title":"CampaignOptimizationRollbackRequest"},"CampaignOptimizationRollbackResponse":{"properties":{"mutation_id":{"type":"string","title":"Mutation Id"},"rollback_action_id":{"type":"string","title":"Rollback Action Id"},"applied_fields":{"items":{"type":"string"},"type":"array","title":"Applied Fields"},"excluded_fields":{"items":{"type":"string"},"type":"array","title":"Excluded Fields"},"campaign":{"additionalProperties":true,"type":"object","title":"Campaign"}},"type":"object","required":["mutation_id","rollback_action_id","applied_fields","excluded_fields","campaign"],"title":"CampaignOptimizationRollbackResponse"},"CampaignOptimizationSummary":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"count":{"type":"integer","title":"Count"},"executed":{"type":"integer","title":"Executed"},"last_actioned_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Actioned At"},"last_activity_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Activity Type"},"last_activity_type_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Activity Type Label"},"outcome_state":{"type":"string","title":"Outcome State","default":"measuring"},"pending_recommendations":{"items":{"$ref":"#/components/schemas/CampaignPendingRecommendation"},"type":"array","title":"Pending Recommendations","default":[]},"pending_recommendation":{"anyOf":[{"$ref":"#/components/schemas/CampaignPendingRecommendation"},{"type":"null"}]},"latest_applied_optimization":{"anyOf":[{"$ref":"#/components/schemas/CampaignAppliedOptimization"},{"type":"null"}]},"analytics_strip":{"anyOf":[{"$ref":"#/components/schemas/CampaignAnalyticsStrip"},{"type":"null"}]}},"type":"object","required":["campaign_id","count","executed"],"title":"CampaignOptimizationSummary","description":"A per-campaign rollup of AI-team activity, keyed by the campaign's public id.\n\n``campaign_id`` is the same public id the dashboard exposes on each card\n(``ads_<hash>`` for paid, ``social_<hash>`` / ``batch_<hash>_<platform>`` for\nsocial), so the frontend can merge this onto a card with a direct lookup."},"CampaignOptimizationSummaryResponse":{"properties":{"summaries":{"items":{"$ref":"#/components/schemas/CampaignOptimizationSummary"},"type":"array","title":"Summaries"},"watching":{"items":{"$ref":"#/components/schemas/CampaignOptimizationWatching"},"type":"array","title":"Watching","default":[]}},"type":"object","required":["summaries"],"title":"CampaignOptimizationSummaryResponse"},"CampaignOptimizationWatching":{"properties":{"approval_id":{"type":"string","title":"Approval Id"},"title":{"type":"string","title":"Title"},"campaign_ids":{"items":{"type":"string"},"type":"array","title":"Campaign Ids","default":[]},"campaign_labels":{"items":{"type":"string"},"type":"array","title":"Campaign Labels","default":[]},"wakes_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wakes At"},"condition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Condition"},"forecast_headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Forecast Headline"},"snoozed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snoozed At"}},"type":"object","required":["approval_id","title"],"title":"CampaignOptimizationWatching","description":"A proposal the person snoozed: off the cards until it wakes.\n\nWakes on ``wakes_at``, or earlier when ``condition`` trips (the playbook\nservice checks it after every run). Shown on the desk as \"watching\" so the\nperson knows Pomo has not dropped it."},"CampaignPageDocument":{"properties":{"schema_version":{"type":"integer","enum":[1,2],"title":"Schema Version","default":1},"design":{"anyOf":[{"$ref":"#/components/schemas/PageDesign"},{"type":"null"}]},"brand":{"$ref":"#/components/schemas/PageBrand"},"offer":{"$ref":"#/components/schemas/PageOffer"},"references":{"$ref":"#/components/schemas/PageReferences"},"evidence":{"items":{"$ref":"#/components/schemas/PageEvidence"},"type":"array","maxItems":4,"title":"Evidence"},"action":{"$ref":"#/components/schemas/PageAction"},"hero_image_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Hero Image Url"},"hero_image_alt":{"type":"string","maxLength":300,"title":"Hero Image Alt","default":""},"layout":{"type":"string","enum":["editorial","centered","brand_story","product_spotlight"],"title":"Layout","default":"editorial"},"indexing":{"type":"string","enum":["index","noindex"],"title":"Indexing","default":"noindex"},"section_order":{"items":{"type":"string","enum":["benefits","proof","process","faqs"]},"type":"array","maxItems":4,"title":"Section Order"},"benefits":{"items":{"$ref":"#/components/schemas/PageSectionItem"},"type":"array","maxItems":6,"title":"Benefits"},"proof":{"anyOf":[{"$ref":"#/components/schemas/PageProof"},{"type":"null"}]},"company_credibility":{"anyOf":[{"$ref":"#/components/schemas/CompanyCredibility"},{"type":"null"}]},"process":{"items":{"$ref":"#/components/schemas/PageSectionItem"},"type":"array","maxItems":5,"title":"Process"},"faqs":{"items":{"$ref":"#/components/schemas/PageFAQ"},"type":"array","maxItems":6,"title":"Faqs"},"form":{"$ref":"#/components/schemas/PageForm"},"confirmation":{"$ref":"#/components/schemas/PageConfirmation"}},"additionalProperties":false,"type":"object","required":["brand","offer","form","confirmation"],"title":"CampaignPageDocument"},"CampaignPendingRecommendation":{"properties":{"approval_id":{"type":"string","title":"Approval Id"},"team_id":{"type":"string","title":"Team Id"},"title":{"type":"string","title":"Title"},"change_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Scope"},"change_scope_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Scope Label"},"priority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"},"option_ids":{"items":{"type":"string"},"type":"array","title":"Option Ids","default":[]},"action_ids":{"items":{"type":"string"},"type":"array","title":"Action Ids","default":[]},"changes":{"items":{"$ref":"#/components/schemas/CampaignOptimizationChange"},"type":"array","title":"Changes","default":[]},"proposals":{"items":{"$ref":"#/components/schemas/CampaignOptimizationProposal"},"type":"array","title":"Proposals","default":[]},"goal_context":{"anyOf":[{"$ref":"#/components/schemas/CampaignOptimizationGoalContext"},{"type":"null"}]},"requested_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Requested At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["approval_id","team_id","title"],"title":"CampaignPendingRecommendation","description":"A still-open AI-team optimization the user can Accept/Decline from the card.\n\nSourced from an ``AgentTeamApproval`` in an OPEN state (pending/deferred/\nescalated) whose decision payload references this campaign. ``approval_id`` +\n``team_id`` are what the frontend passes to the approvals decision endpoint,\nso the card never has to resolve the active team itself."},"CampaignPerfHistoryPoint":{"properties":{"date":{"type":"string","title":"Date"},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value"},"spend":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Spend"},"conversions":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Conversions"},"clicks":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Clicks"}},"type":"object","required":["date"],"title":"CampaignPerfHistoryPoint","description":"One day of the campaign's headline metric, for the expanded-row trend chart.\n``value`` is null on a day with no spend (an honest gap, not a fabricated zero)."},"CampaignPerfHistoryResponse":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"headline_metric":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline Metric"},"headline_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline Label"},"higher_is_better":{"type":"boolean","title":"Higher Is Better","default":true},"currency_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency Code"},"conversion_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversion Status"},"points":{"items":{"$ref":"#/components/schemas/CampaignPerfHistoryPoint"},"type":"array","title":"Points","default":[]},"optimizations":{"items":{"$ref":"#/components/schemas/CampaignPerfOptimizationMarker"},"type":"array","title":"Optimizations","default":[]},"revisions":{"items":{"$ref":"#/components/schemas/CampaignPerfRevision"},"type":"array","title":"Revisions","default":[]}},"type":"object","required":["campaign_id"],"title":"CampaignPerfHistoryResponse"},"CampaignPerfOptimizationMarker":{"properties":{"date":{"type":"string","title":"Date"},"label":{"type":"string","title":"Label"}},"type":"object","required":["date","label"],"title":"CampaignPerfOptimizationMarker","description":"An executed AI-team optimization, drawn on the chart so the before/after is visible."},"CampaignPerfRevision":{"properties":{"executed_at":{"type":"string","title":"Executed At"},"change_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Summary"},"change_from":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change From"},"change_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change To"},"change_scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Scope"},"metric_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric Key"},"pre_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pre Value"},"post_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Post Value"},"post_days_observed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Post Days Observed"},"outcome_state":{"type":"string","title":"Outcome State","default":"measuring"}},"type":"object","required":["executed_at"],"title":"CampaignPerfRevision","description":"One entry in the campaign's optimization/revision history: what the AI changed, when, and the\nmeasured before/after result. Built entirely from data we already store (the action's\nchange_from/change_to + the per-optimization metric snapshots) -- a real \"what was it, what did we\nchange, did it work\" trail without any new capture layer."},"CampaignPostsResponse":{"properties":{"posts":{"items":{"$ref":"#/components/schemas/PostModel"},"type":"array","title":"Posts"}},"type":"object","required":["posts"],"title":"CampaignPostsResponse"},"CampaignReferencePreviewRequest":{"properties":{"campaign_type":{"type":"string","enum":["ads_campaign","social_post_campaign"],"title":"Campaign Type"},"product_offering_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id"},"selected_campaign_idea":{"additionalProperties":true,"type":"object","title":"Selected Campaign Idea"},"user_prompt":{"type":"string","title":"User Prompt","default":""},"target_platforms":{"items":{"type":"string"},"type":"array","title":"Target Platforms"},"platform_sub_formats":{"additionalProperties":true,"type":"object","title":"Platform Sub Formats"},"platform_configs":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Platform Configs"},"creative_references":{"additionalProperties":true,"type":"object","title":"Creative References"}},"additionalProperties":false,"type":"object","required":["campaign_type","creative_references"],"title":"CampaignReferencePreviewRequest"},"CampaignResponse":{"properties":{"id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Id"},"campaign_id":{"type":"string","title":"Campaign Id"},"name":{"type":"string","title":"Name"},"target_platforms":{"items":{"type":"string"},"type":"array","title":"Target Platforms"},"target_audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Audience"},"user_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Prompt"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"creation_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creation Date"},"last_modified":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Modified"},"deployed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deployed At"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"},"creation_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creation Source"}},"type":"object","required":["campaign_id","name","target_platforms"],"title":"CampaignResponse","description":"Base class for campaign metadata response."},"CampaignRestoreResponse":{"properties":{"results":{"items":{"$ref":"#/components/schemas/CampaignRestoreResult"},"type":"array","title":"Results"},"restored_count":{"type":"integer","title":"Restored Count"}},"type":"object","required":["results","restored_count"],"title":"CampaignRestoreResponse"},"CampaignRestoreResult":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"idea_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Idea Number"},"variation":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Variation"},"outcome":{"type":"string","enum":["restored","not_removed","not_found","error"],"title":"Outcome"}},"type":"object","required":["campaign_id","outcome"],"title":"CampaignRestoreResult"},"CampaignReverseGeocodeResponse":{"properties":{"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"},"region_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region Code"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"},"country_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Name"},"display_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Label"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude"},"geojson":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Geojson"}},"type":"object","title":"CampaignReverseGeocodeResponse"},"CampaignTypeMetrics":{"properties":{"impressions":{"type":"integer","title":"Impressions","default":0},"clicks":{"type":"integer","title":"Clicks","default":0},"conversions":{"type":"integer","title":"Conversions","default":0},"spend":{"type":"number","title":"Spend","default":0.0},"revenue":{"type":"number","title":"Revenue","default":0.0},"campaigns":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Campaigns","default":[]}},"type":"object","title":"CampaignTypeMetrics","description":"Metrics aggregated by campaign type"},"CampaignVideoRenderFrame":{"properties":{"campaign_id":{"type":"string","format":"uuid","title":"Campaign Id"},"draft_ad_id":{"type":"string","maxLength":200,"minLength":1,"title":"Draft Ad Id"},"campaign_name":{"type":"string","maxLength":200,"minLength":1,"title":"Campaign Name"},"ad_name":{"type":"string","maxLength":200,"minLength":1,"title":"Ad Name"},"platform":{"type":"string","enum":["google_video","meta_feed","meta_stories_reels","linkedin_ads_video","tiktok_video"],"title":"Platform"},"prompt":{"type":"string","maxLength":8000,"minLength":1,"title":"Prompt"},"duration_seconds":{"type":"integer","const":10,"title":"Duration Seconds","default":10},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"title":"Aspect Ratio"},"frame":{"$ref":"#/components/schemas/WorkReviewMedia"},"quality_check":{"anyOf":[{"$ref":"#/components/schemas/GeneratedImageQualityReview"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["campaign_id","draft_ad_id","campaign_name","ad_name","platform","prompt","aspect_ratio","frame"],"title":"CampaignVideoRenderFrame","description":"One saved campaign creative and its exact reviewed render direction."},"CampaignVideoRenderReview":{"properties":{"kind":{"type":"string","const":"campaign_video_render","title":"Kind","default":"campaign_video_render"},"frames":{"items":{"$ref":"#/components/schemas/CampaignVideoRenderFrame"},"type":"array","maxItems":15,"minItems":1,"title":"Frames"},"video_count":{"type":"integer","maximum":15.0,"minimum":1.0,"title":"Video Count"},"usage_units":{"type":"integer","maximum":60.0,"minimum":1.0,"title":"Usage Units"},"usage_summary":{"type":"string","maxLength":500,"minLength":1,"title":"Usage Summary"},"deferred_platforms":{"items":{"type":"string","maxLength":64,"minLength":1},"type":"array","maxItems":8,"title":"Deferred Platforms","default":[]}},"additionalProperties":false,"type":"object","required":["frames","video_count","usage_units","usage_summary"],"title":"CampaignVideoRenderReview","description":"A bounded native continuation of the saved campaign opening frames."},"CancelSubscriptionRequest":{"properties":{"at_period_end":{"type":"boolean","title":"At Period End","description":"If True, cancellation occurs at period end (default).","default":true},"cancellation_reason_category":{"anyOf":[{"$ref":"#/components/schemas/CancellationReason"},{"type":"null"}],"description":"High-level reason the user is cancelling (for churn analysis)."},"cancellation_note":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Cancellation Note","description":"Optional free-text elaboration on why the user is cancelling."}},"type":"object","title":"CancelSubscriptionRequest","description":"Request model for cancelling a subscription."},"CancellationReason":{"type":"string","enum":["too_expensive","missing_features","not_using","switched_competitor","technical_issues","hard_to_use","temporary","other"],"title":"CancellationReason","description":"High-level reason a user selects when cancelling a subscription.\n\nKept in sync with the frontend cancellation reason form. The order here is\nnot significant; values are persisted verbatim for churn analysis."},"CapabilityArgumentIssue":{"properties":{"path":{"type":"string","maxLength":200,"minLength":1,"title":"Path"},"message":{"type":"string","maxLength":500,"minLength":1,"title":"Message"},"allowed_fields":{"items":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,79}$"},"type":"array","maxItems":40,"title":"Allowed Fields","default":[]}},"additionalProperties":false,"type":"object","required":["path","message"],"title":"CapabilityArgumentIssue","description":"Bounded schema guidance; never includes the rejected input value."},"CapabilityDescription":{"properties":{"key":{"type":"string","maxLength":120,"pattern":"^[a-z][a-z0-9_]*(?:\\.[a-z][a-z0-9_]*){1,3}$","title":"Key"},"version":{"type":"integer","const":1,"title":"Version","default":1},"domain":{"type":"string","maxLength":60,"pattern":"^[a-z][a-z0-9_]*$","title":"Domain"},"title":{"type":"string","maxLength":160,"minLength":1,"title":"Title"},"description":{"type":"string","maxLength":1000,"minLength":1,"title":"Description"},"intent":{"$ref":"#/components/schemas/CapabilityIntent"},"effect":{"$ref":"#/components/schemas/CapabilityEffect"},"readiness":{"$ref":"#/components/schemas/CapabilityReadiness"},"target_kind":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Target Kind"},"examples":{"items":{"type":"string"},"type":"array","maxItems":5,"title":"Examples","default":[]},"parameters":{"additionalProperties":{"$ref":"#/components/schemas/JsonValue"},"type":"object","title":"Parameters"},"result_kinds":{"items":{"type":"string"},"type":"array","maxItems":10,"title":"Result Kinds","default":[]},"costs_credits":{"type":"boolean","title":"Costs Credits","default":false},"requires_review":{"type":"boolean","title":"Requires Review","default":false},"execution":{"anyOf":[{"$ref":"#/components/schemas/CapabilityExecutionContract"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["key","domain","title","description","intent","effect","readiness","parameters"],"title":"CapabilityDescription"},"CapabilityEffect":{"type":"string","enum":["read","draft","update","external"],"title":"CapabilityEffect"},"CapabilityError":{"additionalProperties":true,"type":"object"},"CapabilityErrorCode":{"type":"string","enum":["unavailable","rate_limited","concurrency_limited","permission_denied","invalid_arguments","stale_work","not_found","in_progress","failed","precondition"],"title":"CapabilityErrorCode"},"CapabilityExecutionContract":{"additionalProperties":true,"type":"object"},"CapabilityIntent":{"type":"string","enum":["inspect","create","update","refine","execute","cancel"],"title":"CapabilityIntent"},"CapabilityReadReceipt":{"additionalProperties":true,"type":"object"},"CapabilityReadiness":{"properties":{"state":{"$ref":"#/components/schemas/CapabilityReadinessState"},"reason":{"anyOf":[{"type":"string","maxLength":500,"minLength":1},{"type":"null"}],"title":"Reason"},"recovery_href":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Recovery Href"}},"additionalProperties":false,"type":"object","required":["state"],"title":"CapabilityReadiness"},"CapabilityReadinessState":{"type":"string","enum":["ready","connection_required","permission_required","plan_required","setup_required","unavailable"],"title":"CapabilityReadinessState"},"CapabilityRemedy":{"properties":{"state":{"$ref":"#/components/schemas/CapabilityReadinessState"},"provider":{"anyOf":[{"type":"string","pattern":"^[a-z][a-z0-9_]{0,39}$"},{"type":"null"}],"title":"Provider"},"label":{"type":"string","maxLength":60,"minLength":1,"title":"Label"},"reason":{"type":"string","maxLength":500,"minLength":1,"title":"Reason"},"href":{"type":"string","maxLength":1000,"title":"Href"}},"additionalProperties":false,"type":"object","required":["state","label","reason","href"],"title":"CapabilityRemedy","description":"What a person must set up before this capability can do what was asked,\nand where. Never a way to run anything: ``href`` opens a Pomo page."},"CapabilityResponse":{"additionalProperties":true,"type":"object"},"CapabilitySummary":{"properties":{"key":{"type":"string","maxLength":120,"pattern":"^[a-z][a-z0-9_]*(?:\\.[a-z][a-z0-9_]*){1,3}$","title":"Key"},"version":{"type":"integer","const":1,"title":"Version","default":1},"domain":{"type":"string","maxLength":60,"pattern":"^[a-z][a-z0-9_]*$","title":"Domain"},"title":{"type":"string","maxLength":160,"minLength":1,"title":"Title"},"description":{"type":"string","maxLength":1000,"minLength":1,"title":"Description"},"intent":{"$ref":"#/components/schemas/CapabilityIntent"},"effect":{"$ref":"#/components/schemas/CapabilityEffect"},"readiness":{"$ref":"#/components/schemas/CapabilityReadiness"},"target_kind":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Target Kind"},"examples":{"items":{"type":"string"},"type":"array","maxItems":5,"title":"Examples","default":[]}},"additionalProperties":false,"type":"object","required":["key","domain","title","description","intent","effect","readiness"],"title":"CapabilitySummary"},"CapturedReadPresentation":{"properties":{"record_kind":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$","title":"Record Kind"},"ref":{"$ref":"#/components/schemas/ResourceRef"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Version"},"scope":{"$ref":"#/components/schemas/CapturedReadScope"},"data":{"additionalProperties":{"$ref":"#/components/schemas/JsonValue"},"type":"object","title":"Data"}},"additionalProperties":false,"type":"object","required":["record_kind","ref","version","scope","data"],"title":"CapturedReadPresentation","description":"One verified native read, shaped by its registered source contract.\n\nThe receipt owner proves provenance. This envelope checks the source's\nown data shape and identity; it grants no read or action authority."},"CapturedReadScope":{"properties":{"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"}},"additionalProperties":false,"type":"object","required":["organization_id","company_profile_id"],"title":"CapturedReadScope","description":"The closed tenant scope a native read was observed in."},"ChangeApprovalResponse":{"properties":{"id":{"type":"string","title":"Id"},"approver_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approver User Id"},"approver_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approver Name"},"approver_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approver Email"},"decision":{"type":"string","title":"Decision"},"rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rationale"},"requirement_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Requirement Key"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","decision","created_at"],"title":"ChangeApprovalResponse"},"ChangeManagementSettingsResponse":{"properties":{"enabled":{"type":"boolean","title":"Enabled","default":false},"enforce_writes":{"type":"boolean","title":"Enforce Writes","default":false},"budget_guardrail":{"$ref":"#/components/schemas/BudgetGuardrailConfig"}},"type":"object","title":"ChangeManagementSettingsResponse"},"ChangeManagementSettingsUpdateRequest":{"properties":{"enabled":{"type":"boolean","title":"Enabled","default":false},"enforce_writes":{"type":"boolean","title":"Enforce Writes","default":false},"budget_guardrail":{"anyOf":[{"$ref":"#/components/schemas/BudgetGuardrailConfig"},{"type":"null"}]}},"type":"object","title":"ChangeManagementSettingsUpdateRequest"},"ChangeOperationCreateRequest":{"properties":{"kind":{"type":"string","maxLength":50,"minLength":1,"title":"Kind"},"title":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Title"},"tool_name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Tool Name"},"tool_arguments":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Tool Arguments"},"job_type":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Job Type"},"job_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Job Data"},"diff":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Diff"}},"type":"object","required":["kind"],"title":"ChangeOperationCreateRequest"},"ChangeOperationExecuteOverride":{"properties":{"operation_id":{"type":"string","title":"Operation Id"},"job_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Job Data"}},"type":"object","required":["operation_id"],"title":"ChangeOperationExecuteOverride"},"ChangeOperationResponse":{"properties":{"id":{"type":"string","title":"Id"},"kind":{"type":"string","title":"Kind"},"operation_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Operation Key"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"tool_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tool Name"},"tool_arguments":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Tool Arguments"},"job_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Type"},"job_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Job Data"},"diff":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Diff"},"execution_status":{"type":"string","title":"Execution Status"},"execution_result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Execution Result"},"execution_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Error"},"execution_started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Execution Started At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","kind","execution_status","created_at","updated_at"],"title":"ChangeOperationResponse"},"ChangePlanRequest":{"properties":{"organization_id":{"type":"string","title":"Organization Id"},"target_plan":{"type":"string","title":"Target Plan"},"billing_interval":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Interval"},"trial_confirmation":{"anyOf":[{"$ref":"#/components/schemas/TrialPlanChangeConfirmation"},{"type":"null"}]}},"type":"object","required":["organization_id","target_plan"],"title":"ChangePlanRequest","description":"Request model for changing subscription plan."},"ChangeRequestApproveRequest":{"properties":{"decision":{"type":"string","pattern":"^(approved|rejected|changes_requested)$","title":"Decision"},"rationale":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}],"title":"Rationale"},"requirement_key":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Requirement Key"}},"type":"object","required":["decision"],"title":"ChangeRequestApproveRequest"},"ChangeRequestCommentResponse":{"properties":{"id":{"type":"string","title":"Id"},"author_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author User Id"},"author_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Name"},"author_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Email"},"kind":{"type":"string","title":"Kind"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"decision":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Decision"},"source_approval_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Approval Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","kind","created_at"],"title":"ChangeRequestCommentResponse"},"ChangeRequestCreateRequest":{"properties":{"company_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Id"},"source":{"type":"string","maxLength":50,"title":"Source","default":"manual"},"title":{"type":"string","maxLength":300,"minLength":1,"title":"Title"},"description":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}],"title":"Description"},"risk_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Risk Score","default":0},"risk_factors":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Risk Factors"},"policy_results":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Policy Results"},"required_approvals":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Required Approvals"},"operations":{"items":{"$ref":"#/components/schemas/ChangeOperationCreateRequest"},"type":"array","title":"Operations"}},"type":"object","required":["title"],"title":"ChangeRequestCreateRequest"},"ChangeRequestExecuteRequest":{"properties":{"operation_overrides":{"anyOf":[{"items":{"$ref":"#/components/schemas/ChangeOperationExecuteOverride"},"type":"array"},{"type":"null"}],"title":"Operation Overrides"},"accepted_acknowledgements":{"additionalProperties":{"items":{"type":"string","maxLength":1000,"minLength":1},"type":"array","maxItems":5},"type":"object","maxProperties":20,"title":"Accepted Acknowledgements"}},"additionalProperties":false,"type":"object","title":"ChangeRequestExecuteRequest"},"ChangeRequestPreviewResponse":{"properties":{"platform_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform Type"},"ad_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"},"ad":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Ad"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","title":"ChangeRequestPreviewResponse"},"ChangeRequestResponse":{"properties":{"id":{"type":"string","title":"Id"},"organization_id":{"type":"string","title":"Organization Id"},"company_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Id"},"created_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By User Id"},"source":{"type":"string","title":"Source"},"proposer_kind":{"type":"string","title":"Proposer Kind","default":"user"},"proposer_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Proposer Key"},"evidence_references":{"items":{"type":"string"},"type":"array","title":"Evidence References"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"status":{"type":"string","title":"Status"},"can_approve":{"type":"boolean","title":"Can Approve","default":false},"can_execute":{"type":"boolean","title":"Can Execute","default":false},"risk_score":{"type":"integer","title":"Risk Score"},"risk_factors":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Risk Factors"},"policy_results":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Policy Results"},"required_approvals":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Required Approvals"},"executed_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Executed By User Id"},"executed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Executed At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"},"operations":{"items":{"$ref":"#/components/schemas/ChangeOperationResponse"},"type":"array","title":"Operations"},"approvals":{"items":{"$ref":"#/components/schemas/ChangeApprovalResponse"},"type":"array","title":"Approvals"},"comments":{"items":{"$ref":"#/components/schemas/ChangeRequestCommentResponse"},"type":"array","title":"Comments"}},"type":"object","required":["id","organization_id","source","title","status","risk_score","created_at","updated_at"],"title":"ChangeRequestResponse"},"ChangeRequestSummaryResponse":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"enforce_writes":{"type":"boolean","title":"Enforce Writes"},"pending_total":{"type":"integer","title":"Pending Total"},"awaiting_my_review":{"type":"integer","title":"Awaiting My Review"},"is_approver":{"type":"boolean","title":"Is Approver"}},"type":"object","required":["enabled","enforce_writes","pending_total","awaiting_my_review","is_approver"],"title":"ChangeRequestSummaryResponse"},"ChannelTrendData":{"properties":{"date":{"type":"string","title":"Date"},"channel":{"type":"string","title":"Channel"},"impressions":{"type":"integer","title":"Impressions"},"clicks":{"type":"integer","title":"Clicks"}},"type":"object","required":["date","channel","impressions","clicks"],"title":"ChannelTrendData","description":"Daily trend data by channel/platform"},"ChatAttachmentHandle":{"properties":{"handle":{"type":"string","maxLength":500,"minLength":16,"title":"Handle"},"name":{"type":"string","maxLength":500,"minLength":1,"title":"Name"},"media_type":{"type":"string","maxLength":200,"minLength":1,"title":"Media Type"},"size_bytes":{"type":"integer","minimum":0.0,"title":"Size Bytes"}},"type":"object","required":["handle","name","media_type","size_bytes"],"title":"ChatAttachmentHandle","description":"Opaque Core-issued attachment metadata accepted by the async bridge."},"ChatFollowUpSelection":{"properties":{"source_message_id":{"type":"string","format":"uuid","title":"Source Message Id"},"option_ids":{"items":{"type":"string"},"type":"array","maxItems":5,"minItems":1,"title":"Option Ids"}},"additionalProperties":false,"type":"object","required":["source_message_id","option_ids"],"title":"ChatFollowUpSelection","description":"Untrusted identities for selecting a persisted v2 follow-up panel."},"ChatGptAdsAccountsResponseModel":{"properties":{"accounts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Accounts"},"activation_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activation State"},"active_account":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Active Account"}},"type":"object","required":["accounts"],"title":"ChatGptAdsAccountsResponseModel"},"ChatGptAdsActivateAccountRequest":{"properties":{"account_id":{"type":"string","title":"Account Id","description":"ChatGPT Ads ad account id to use for future launches"}},"type":"object","required":["account_id"],"title":"ChatGptAdsActivateAccountRequest"},"ChatGptAdsConnectRequest":{"properties":{"api_key":{"type":"string","minLength":8,"title":"Api Key","description":"Advertiser API key from OpenAI Ads Manager → Settings"}},"type":"object","required":["api_key"],"title":"ChatGptAdsConnectRequest"},"ChatGptCampaignActionRequest":{"properties":{"ad_id":{"type":"string","title":"Ad Id","description":"Pomo platform ad id for the chat card"},"ad_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Account Id","description":"Must match the activated ChatGPT ad account"}},"type":"object","required":["ad_id"],"title":"ChatGptCampaignActionRequest","description":"Pause/resume target; the route path names the action."},"ChatGptLaunchChatCardRequest":{"properties":{"ad_id":{"type":"string","title":"Ad Id","description":"Pomo platform ad id for the chat card"},"ad_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Account Id","description":"Must match the activated ChatGPT ad account"}},"type":"object","required":["ad_id"],"title":"ChatGptLaunchChatCardRequest"},"ChatGptSyncAdRequest":{"properties":{"ad_id":{"type":"string","title":"Ad Id","description":"Pomo platform ad id for the chat card"},"ad_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Account Id","description":"Must match the activated ChatGPT ad account"},"pending_update":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pending Update","description":"Pending Pomo edit payload to apply only after OpenAI accepts it."}},"type":"object","required":["ad_id"],"title":"ChatGptSyncAdRequest","description":"Queue a sync of saved Pomo edits to the launched chat card."},"ChatGptSyncPreviewRequest":{"properties":{"ad_id":{"type":"string","title":"Ad Id","description":"Pomo platform ad id for the chat card"},"ad_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Account Id","description":"Must match the activated ChatGPT ad account"},"pending_update":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pending Update","description":"Pending Pomo edit payload to preview without saving it."}},"type":"object","required":["ad_id"],"title":"ChatGptSyncPreviewRequest","description":"Preview saved (or still-pending) edits against the launched chat card."},"ChatRequest":{"properties":{"message":{"type":"string","minLength":1,"title":"Message","description":"User message"},"conversation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Conversation Id","description":"Existing conversation ID (creates new if omitted)"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id","description":"Company profile context for MCP tools"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id","description":"Organization context for multi-tenant scoping"},"workflow_stage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflow Stage","description":"Current workflow stage for context"},"page_context":{"anyOf":[{"$ref":"#/components/schemas/PageContext"},{"type":"null"}],"description":"Optional UI page context to ground the assistant"},"selected_subject":{"anyOf":[{"oneOf":[{"$ref":"#/components/schemas/SavedWorkSubject"},{"$ref":"#/components/schemas/SavedArtifactSubject"},{"$ref":"#/components/schemas/ReadArtifactSubject"},{"$ref":"#/components/schemas/AccountReportSubject"},{"$ref":"#/components/schemas/ApprovalSubject"},{"$ref":"#/components/schemas/InsightSubject"}],"discriminator":{"propertyName":"kind","mapping":{"account_report":"#/components/schemas/AccountReportSubject","approval":"#/components/schemas/ApprovalSubject","artifact":"#/components/schemas/SavedArtifactSubject","insight":"#/components/schemas/InsightSubject","read_artifact":"#/components/schemas/ReadArtifactSubject","work":"#/components/schemas/SavedWorkSubject"}}},{"type":"null"}],"title":"Selected Subject","description":"Typed saved-work/report/review pointer. Core revalidates it against the current actor, brand and native owner before runtime use."},"target_team_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Target Team Id","description":"Target team ID for @team or @agent routing (required when target_agent_key is set)"},"target_agent_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Agent Key","description":"Target agent key for @agent routing (requires target_team_id)"},"files":{"items":{"$ref":"#/components/schemas/ChatAttachmentHandle"},"type":"array","maxItems":20,"title":"Files","description":"Opaque conversation attachment handles issued by Pomo core"},"idempotency_key":{"anyOf":[{"type":"string","maxLength":200,"minLength":16},{"type":"null"}],"title":"Idempotency Key","description":"Opaque retry key for an existing-conversation asynchronous v2 turn"},"follow_up_selection":{"anyOf":[{"$ref":"#/components/schemas/ChatFollowUpSelection"},{"type":"null"}],"description":"Selected option identities from a persisted Markee v2 assistant panel"},"intervention_reply":{"anyOf":[{"$ref":"#/components/schemas/InterventionReplyLookup"},{"type":"null"}],"description":"Explicit source assistant message for a native proactive reply; Core validates its exact recipient and action."}},"type":"object","required":["message","company_profile_id","organization_id"],"title":"ChatRequest","description":"Request schema for sending a message to agentic chat.\n\nCan either:\n1. Continue existing conversation (provide conversation_id)\n2. Create new conversation (omit conversation_id)","example":{"company_profile_id":"123e4567-e89b-12d3-a456-426614174001","conversation_id":"123e4567-e89b-12d3-a456-426614174002","message":"What are my top performing campaigns?","organization_id":"123e4567-e89b-12d3-a456-426614174000","page_context":{"entity_id":"po_123","entity_name":"Pro Suite","source":"product-detail","tab":"marketing"},"workflow_stage":"campaign_analysis"}},"CollectionProgress":{"properties":{"phase":{"type":"string","enum":["queued","generating_styles","searching","checking","scoring","ranking","saving","complete","stopped"],"title":"Phase"},"completed_styles":{"type":"integer","maximum":5.0,"minimum":0.0,"title":"Completed Styles","default":0},"total_styles":{"type":"integer","enum":[3,5],"title":"Total Styles","default":3},"round_number":{"type":"integer","maximum":3.0,"minimum":1.0,"title":"Round Number","default":1},"current_style_id":{"anyOf":[{"type":"string","maxLength":1200,"minLength":1},{"type":"null"}],"title":"Current Style Id"},"current_style_name":{"anyOf":[{"type":"string","maxLength":1200,"minLength":1},{"type":"null"}],"title":"Current Style Name"},"completed_units":{"type":"integer","title":"Completed Units","readOnly":true}},"additionalProperties":false,"type":"object","required":["phase","completed_units"],"title":"CollectionProgress","description":"Work completed, independent of wall time and selected-image count."},"CommentPageResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CommentResponse"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items"],"title":"CommentPageResponse"},"CommentResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"item_type":{"type":"string","title":"Item Type"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"author_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Display Name"},"provider_created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Provider Created At"},"version":{"type":"integer","title":"Version"},"visibility":{"type":"string","title":"Visibility"},"provenance":{"type":"string","title":"Provenance"},"has_page_answer":{"type":"boolean","title":"Has Page Answer"},"needs_reply":{"type":"boolean","title":"Needs Reply"},"proposal_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Proposal Id"},"proposal_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Proposal State"},"draft_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Draft Text"},"proposal_target_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Proposal Target Version"},"proposal_context_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Proposal Context Hash"},"proposal_generation_attempt_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Proposal Generation Attempt Count"},"root_post_body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Root Post Body"},"parent_comment_body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Comment Body"},"delivery_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Delivery Id"},"delivery_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delivery Status"},"delivery_safe_error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delivery Safe Error Code"}},"type":"object","required":["id","item_type","body","author_display_name","provider_created_at","version","visibility","provenance","has_page_answer","needs_reply"],"title":"CommentResponse"},"CompanyCredibility":{"properties":{"text":{"type":"string","maxLength":400,"title":"Text"},"source_url":{"type":"string","maxLength":2048,"title":"Source Url"},"approved":{"type":"boolean","title":"Approved","default":false}},"additionalProperties":false,"type":"object","required":["text","source_url"],"title":"CompanyCredibility","description":"An editor-verified company fact, separate from a customer endorsement."},"CompanyImageResponse":{"properties":{"image_type":{"type":"string","title":"Image Type"},"image_url":{"type":"string","title":"Image Url"},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt Text"},"image_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Image Metadata"},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"company_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Id"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["image_type","image_url","id","company_profile_id","created_at"],"title":"CompanyImageResponse"},"CompanyInfo":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"industry":{"type":"string","title":"Industry"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"},"company_size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Size"},"target_market":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Target Market"},"unique_selling_proposition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unique Selling Proposition"},"primary_business_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Business Model"},"secondary_business_models":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Secondary Business Models"},"business_model_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Business Model Metadata"},"marketing_goal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Marketing Goal"},"average_monthly_campaign_budget":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Monthly Campaign Budget"},"average_monthly_campaign_budget_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Average Monthly Campaign Budget Currency"},"operating_cities":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Operating Cities"}},"additionalProperties":true,"type":"object","required":["name","description","industry"],"title":"CompanyInfo"},"CompanyMessageCreate":{"properties":{"message_type":{"type":"string","title":"Message Type"},"content":{"type":"string","title":"Content"},"message_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Message Metadata"}},"type":"object","required":["message_type","content"],"title":"CompanyMessageCreate"},"CompanyMessageResponse":{"properties":{"message_type":{"type":"string","title":"Message Type"},"content":{"type":"string","title":"Content"},"message_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Message Metadata"},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"company_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Id"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["message_type","content","id","company_profile_id","created_at"],"title":"CompanyMessageResponse"},"CompanyProfileAccessGrantRequest":{"properties":{"user_id":{"type":"string","format":"uuid","title":"User Id","description":"ID of the user to grant access"},"role":{"$ref":"#/components/schemas/ProjectRoleEnum","description":"Company profile role to assign"}},"type":"object","required":["user_id","role"],"title":"CompanyProfileAccessGrantRequest","description":"Request to grant company profile access to a user."},"CompanyProfileAccessListResponse":{"properties":{"access_list":{"items":{"$ref":"#/components/schemas/CompanyProfileAccessResponse"},"type":"array","title":"Access List"},"total_count":{"type":"integer","title":"Total Count"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"company_profile_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Name"}},"type":"object","required":["access_list","total_count","company_profile_id"],"title":"CompanyProfileAccessListResponse","description":"Response model for listing company profile access."},"CompanyProfileAccessResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"company_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Id"},"role":{"type":"string","title":"Role"},"user_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Name"},"user_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Email"},"granted_by":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Granted By"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"},"is_org_owner":{"type":"boolean","title":"Is Org Owner","default":false}},"type":"object","required":["id","user_id","company_profile_id","role","created_at","updated_at"],"title":"CompanyProfileAccessResponse","description":"Response model for company profile access information."},"CompanyProfileAccessUpdateRequest":{"properties":{"role":{"$ref":"#/components/schemas/ProjectRoleEnum","description":"New company profile role"}},"type":"object","required":["role"],"title":"CompanyProfileAccessUpdateRequest","description":"Request to update a user's company profile access."},"CompanyProfileCreate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"company_links":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Company Links"},"brand_attributes":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Brand Attributes"},"categories":{"anyOf":[{},{"type":"null"}],"title":"Categories"},"primary_business_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Business Model"},"secondary_business_models":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Secondary Business Models"},"business_model_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Business Model Metadata"},"additional_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Additional Metadata"},"competitive_analysis":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Competitive Analysis"},"recommended_marketing_strategy":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Recommended Marketing Strategy"},"marketing_goal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Marketing Goal"},"marketing_campaign_goal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Marketing Campaign Goal"},"campaign_custom_instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Custom Instructions"},"average_monthly_campaign_budget":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Monthly Campaign Budget"},"average_monthly_campaign_budget_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Average Monthly Campaign Budget Currency"},"document_summaries":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Document Summaries"},"operating_regions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Operating Regions"},"default_scheduling_timezone":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Default Scheduling Timezone","description":"Default IANA timezone used when creating a schedule."},"logo_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Image"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"is_completed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Completed","default":false},"status":{"anyOf":[{"$ref":"#/components/schemas/CompanyProfileStatus"},{"type":"null"}],"default":"active"}},"type":"object","title":"CompanyProfileCreate"},"CompanyProfileDailySpendSummaryResponse":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"company_profile_id":{"type":"string","title":"Company Profile Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"google_spend":{"type":"number","title":"Google Spend","default":0.0},"meta_spend":{"type":"number","title":"Meta Spend","default":0.0},"tiktok_spend":{"type":"number","title":"Tiktok Spend","default":0.0},"linkedin_spend":{"type":"number","title":"Linkedin Spend","default":0.0},"chatgpt_spend":{"type":"number","title":"Chatgpt Spend","default":0.0},"total_spend":{"type":"number","title":"Total Spend","default":0.0},"google_spend_pct":{"type":"number","title":"Google Spend Pct","default":0.0},"meta_spend_pct":{"type":"number","title":"Meta Spend Pct","default":0.0},"tiktok_spend_pct":{"type":"number","title":"Tiktok Spend Pct","default":0.0},"linkedin_spend_pct":{"type":"number","title":"Linkedin Spend Pct","default":0.0},"chatgpt_spend_pct":{"type":"number","title":"Chatgpt Spend Pct","default":0.0},"contains_shared_spend":{"type":"boolean","title":"Contains Shared Spend","default":false},"generated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Generated At"}},"type":"object","required":["metric_date","company_profile_id"],"title":"CompanyProfileDailySpendSummaryResponse"},"CompanyProfileListScope":{"type":"string","enum":["active_org","my_accessible"],"title":"CompanyProfileListScope"},"CompanyProfileResponse":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"company_links":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Company Links"},"brand_attributes":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Brand Attributes"},"categories":{"anyOf":[{},{"type":"null"}],"title":"Categories"},"primary_business_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Business Model"},"secondary_business_models":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Secondary Business Models"},"business_model_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Business Model Metadata"},"additional_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Additional Metadata"},"competitive_analysis":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Competitive Analysis"},"recommended_marketing_strategy":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Recommended Marketing Strategy"},"marketing_goal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Marketing Goal"},"marketing_campaign_goal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Marketing Campaign Goal"},"campaign_custom_instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Custom Instructions"},"average_monthly_campaign_budget":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Monthly Campaign Budget"},"average_monthly_campaign_budget_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Average Monthly Campaign Budget Currency"},"document_summaries":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Document Summaries"},"operating_regions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Operating Regions"},"default_scheduling_timezone":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Default Scheduling Timezone","description":"Default IANA timezone used when creating a schedule."},"logo_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Image"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"is_completed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Completed","default":false},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"creator_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creator Id"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"company_messages":{"items":{"$ref":"#/components/schemas/CompanyMessageResponse"},"type":"array","title":"Company Messages","default":[]},"company_images":{"items":{"$ref":"#/components/schemas/CompanyImageResponse"},"type":"array","title":"Company Images","default":[]},"category_attributes":{"anyOf":[{},{"type":"null"}],"title":"Category Attributes"},"marketing_profile_completed":{"type":"boolean","title":"Marketing Profile Completed","default":false},"onboarding_status":{"type":"string","enum":["not_started","queued","running","completed","incomplete","failed"],"title":"Onboarding Status","default":"not_started"}},"type":"object","required":["id","organization_id","creator_id","created_at","updated_at"],"title":"CompanyProfileResponse"},"CompanyProfileStatus":{"type":"string","enum":["active","archived","deleted"],"title":"CompanyProfileStatus","description":"Lifecycle status for a company profile."},"CompanyProfileStatusUpdateRequest":{"properties":{"status":{"$ref":"#/components/schemas/CompanyProfileStatus","description":"New status for the company profile (archived or deleted)"}},"type":"object","required":["status"],"title":"CompanyProfileStatusUpdateRequest"},"CompanyProfileStatusUpdateResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"profile":{"$ref":"#/components/schemas/CompanyProfileResponse"}},"type":"object","required":["success","message","profile"],"title":"CompanyProfileStatusUpdateResponse"},"CompanyProfileSummaryResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"company_links":{"items":{"type":"string"},"type":"array","title":"Company Links"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"status":{"type":"string"},"marketing_profile_completed":{"type":"boolean","title":"Marketing Profile Completed","default":false},"onboarding_status":{"type":"string","enum":["not_started","queued","running","completed","incomplete","failed"],"title":"Onboarding Status","default":"not_started"}},"type":"object","required":["id","organization_id","status"],"title":"CompanyProfileSummaryResponse","description":"Compact company-profile projection for workspace navigation."},"CompanyProfileUpdate":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":64,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"company_links":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Company Links"},"brand_attributes":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Brand Attributes"},"categories":{"anyOf":[{},{"type":"null"}],"title":"Categories"},"primary_business_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Business Model"},"secondary_business_models":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Secondary Business Models"},"business_model_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Business Model Metadata"},"additional_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Additional Metadata"},"competitive_analysis":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Competitive Analysis"},"recommended_marketing_strategy":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Recommended Marketing Strategy"},"marketing_goal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Marketing Goal"},"marketing_campaign_goal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Marketing Campaign Goal"},"campaign_custom_instructions":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Custom Instructions"},"average_monthly_campaign_budget":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Monthly Campaign Budget"},"average_monthly_campaign_budget_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Average Monthly Campaign Budget Currency"},"document_summaries":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Document Summaries"},"operating_regions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Operating Regions"},"default_scheduling_timezone":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Default Scheduling Timezone","description":"Default IANA timezone used when creating a schedule."},"logo_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Image"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"is_completed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Completed","default":false},"status":{"anyOf":[{"$ref":"#/components/schemas/CompanyProfileStatus"},{"type":"null"}],"default":"active"}},"type":"object","title":"CompanyProfileUpdate"},"CompanyStylebookBrandNuance":{"properties":{"implicit_brand_differentiators":{"items":{"type":"string"},"type":"array","title":"Implicit Brand Differentiators"},"distinctive_positioning":{"type":"string","title":"Distinctive Positioning","default":""},"generic_positioning_to_avoid":{"items":{"type":"string"},"type":"array","title":"Generic Positioning To Avoid"},"must_preserve_in_downstream_generation":{"items":{"type":"string"},"type":"array","title":"Must Preserve In Downstream Generation"},"value_propositions":{"items":{"type":"string"},"type":"array","title":"Value Propositions"},"messaging_pillars":{"items":{"type":"string"},"type":"array","title":"Messaging Pillars"}},"type":"object","title":"CompanyStylebookBrandNuance"},"CompanyStylebookBusinessModel":{"properties":{"summary":{"type":"string","title":"Summary"}},"type":"object","required":["summary"],"title":"CompanyStylebookBusinessModel"},"CompanyStylebookChipSection":{"properties":{"chips":{"items":{"type":"string"},"type":"array","title":"Chips"}},"type":"object","title":"CompanyStylebookChipSection"},"CompanyStylebookColors":{"properties":{"description":{"type":"string","title":"Description"},"swatches":{"items":{"$ref":"#/components/schemas/CompanyStylebookSwatch"},"type":"array","title":"Swatches"}},"type":"object","required":["description"],"title":"CompanyStylebookColors"},"CompanyStylebookGenerateRequest":{"properties":{"workflow_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Workflow Id"},"force":{"type":"boolean","title":"Force","default":false}},"type":"object","title":"CompanyStylebookGenerateRequest"},"CompanyStylebookHero":{"properties":{"company_name":{"type":"string","minLength":1,"title":"Company Name"},"summary":{"type":"string","title":"Summary"},"location_value":{"type":"string","title":"Location Value"},"company_size_value":{"type":"string","title":"Company Size Value"},"map_regions":{"items":{"type":"string"},"type":"array","title":"Map Regions"}},"type":"object","required":["company_name","summary","location_value","company_size_value"],"title":"CompanyStylebookHero"},"CompanyStylebookImageItem":{"properties":{"id":{"type":"string","title":"Id"},"image_url":{"type":"string","title":"Image Url"},"label":{"type":"string","title":"Label"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},"type":"object","required":["id","image_url","label"],"title":"CompanyStylebookImageItem"},"CompanyStylebookListSection":{"properties":{"items":{"items":{"type":"string"},"type":"array","title":"Items"}},"type":"object","title":"CompanyStylebookListSection"},"CompanyStylebookLogo":{"properties":{"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"description":{"type":"string","title":"Description"}},"type":"object","required":["description"],"title":"CompanyStylebookLogo"},"CompanyStylebookPage":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"summary":{"type":"string","title":"Summary","default":""},"sections":{"items":{"$ref":"#/components/schemas/CompanyStylebookPageSection"},"type":"array","title":"Sections"}},"type":"object","required":["id","title"],"title":"CompanyStylebookPage"},"CompanyStylebookPageSection":{"properties":{"title":{"type":"string","title":"Title"},"body":{"type":"string","title":"Body","default":""},"bullets":{"items":{"type":"string"},"type":"array","title":"Bullets"},"chips":{"items":{"type":"string"},"type":"array","title":"Chips"},"evidence_refs":{"items":{"type":"string"},"type":"array","title":"Evidence Refs"},"examples":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Examples"},"confidence":{"anyOf":[{"type":"string","enum":["high","medium","low"]},{"type":"null"}],"title":"Confidence"}},"type":"object","required":["title"],"title":"CompanyStylebookPageSection"},"CompanyStylebookPayload-Input":{"properties":{"hero":{"$ref":"#/components/schemas/CompanyStylebookHero"},"logo":{"$ref":"#/components/schemas/CompanyStylebookLogo"},"colors":{"$ref":"#/components/schemas/CompanyStylebookColors"},"promo_references":{"$ref":"#/components/schemas/CompanyStylebookPromoReferences"},"value_propositions":{"$ref":"#/components/schemas/CompanyStylebookListSection"},"target_audience":{"$ref":"#/components/schemas/CompanyStylebookChipSection"},"business_model":{"$ref":"#/components/schemas/CompanyStylebookBusinessModel"},"categories":{"$ref":"#/components/schemas/CompanyStylebookChipSection"},"available_reference_images":{"items":{"$ref":"#/components/schemas/CompanyStylebookImageItem"},"type":"array","title":"Available Reference Images"},"brand_nuance":{"$ref":"#/components/schemas/CompanyStylebookBrandNuance"},"brand_foundation":{"additionalProperties":true,"type":"object","title":"Brand Foundation"},"messaging_pillars":{"items":{"type":"string"},"type":"array","title":"Messaging Pillars"},"must_preserve":{"items":{"type":"string"},"type":"array","title":"Must Preserve"},"canonical_profile":{"additionalProperties":true,"type":"object","title":"Canonical Profile"},"design_tokens":{"additionalProperties":true,"type":"object","title":"Design Tokens"},"visual_system":{"additionalProperties":true,"type":"object","title":"Visual System"},"accessibility_system":{"additionalProperties":true,"type":"object","title":"Accessibility System"},"asset_usage_system":{"additionalProperties":true,"type":"object","title":"Asset Usage System"},"messaging_system":{"additionalProperties":true,"type":"object","title":"Messaging System"},"content_style_system":{"additionalProperties":true,"type":"object","title":"Content Style System"},"products_audiences":{"additionalProperties":true,"type":"object","title":"Products Audiences"},"campaign_playbook":{"additionalProperties":true,"type":"object","title":"Campaign Playbook"},"market_learning":{"additionalProperties":true,"type":"object","title":"Market Learning"},"brand_validation_system":{"additionalProperties":true,"type":"object","title":"Brand Validation System"},"source_inventory":{"additionalProperties":true,"type":"object","title":"Source Inventory"},"stylebook_governance":{"additionalProperties":true,"type":"object","title":"Stylebook Governance"},"pages":{"items":{"$ref":"#/components/schemas/CompanyStylebookPage"},"type":"array","title":"Pages"}},"type":"object","required":["hero","logo","colors","promo_references","value_propositions","target_audience","business_model","categories"],"title":"CompanyStylebookPayload"},"CompanyStylebookPayload-Output":{"properties":{"hero":{"$ref":"#/components/schemas/CompanyStylebookHero"},"logo":{"$ref":"#/components/schemas/CompanyStylebookLogo"},"colors":{"$ref":"#/components/schemas/CompanyStylebookColors"},"promo_references":{"$ref":"#/components/schemas/CompanyStylebookPromoReferences"},"value_propositions":{"$ref":"#/components/schemas/CompanyStylebookListSection"},"target_audience":{"$ref":"#/components/schemas/CompanyStylebookChipSection"},"business_model":{"$ref":"#/components/schemas/CompanyStylebookBusinessModel"},"categories":{"$ref":"#/components/schemas/CompanyStylebookChipSection"},"available_reference_images":{"items":{"$ref":"#/components/schemas/CompanyStylebookImageItem"},"type":"array","title":"Available Reference Images"},"brand_nuance":{"$ref":"#/components/schemas/CompanyStylebookBrandNuance"},"brand_foundation":{"additionalProperties":true,"type":"object","title":"Brand Foundation"},"messaging_pillars":{"items":{"type":"string"},"type":"array","title":"Messaging Pillars"},"must_preserve":{"items":{"type":"string"},"type":"array","title":"Must Preserve"},"canonical_profile":{"additionalProperties":true,"type":"object","title":"Canonical Profile"},"design_tokens":{"additionalProperties":true,"type":"object","title":"Design Tokens"},"visual_system":{"additionalProperties":true,"type":"object","title":"Visual System"},"accessibility_system":{"additionalProperties":true,"type":"object","title":"Accessibility System"},"asset_usage_system":{"additionalProperties":true,"type":"object","title":"Asset Usage System"},"messaging_system":{"additionalProperties":true,"type":"object","title":"Messaging System"},"content_style_system":{"additionalProperties":true,"type":"object","title":"Content Style System"},"products_audiences":{"additionalProperties":true,"type":"object","title":"Products Audiences"},"campaign_playbook":{"additionalProperties":true,"type":"object","title":"Campaign Playbook"},"market_learning":{"additionalProperties":true,"type":"object","title":"Market Learning"},"brand_validation_system":{"additionalProperties":true,"type":"object","title":"Brand Validation System"},"source_inventory":{"additionalProperties":true,"type":"object","title":"Source Inventory"},"stylebook_governance":{"additionalProperties":true,"type":"object","title":"Stylebook Governance"},"pages":{"items":{"$ref":"#/components/schemas/CompanyStylebookPage"},"type":"array","title":"Pages"}},"type":"object","required":["hero","logo","colors","promo_references","value_propositions","target_audience","business_model","categories"],"title":"CompanyStylebookPayload"},"CompanyStylebookPromoReferences":{"properties":{"subtitle":{"type":"string","title":"Subtitle"},"items":{"items":{"$ref":"#/components/schemas/CompanyStylebookImageItem"},"type":"array","title":"Items"}},"type":"object","required":["subtitle"],"title":"CompanyStylebookPromoReferences"},"CompanyStylebookResponse":{"properties":{"status":{"type":"string","enum":["pending","processing","ready","failed"],"title":"Status"},"schema_version":{"type":"integer","title":"Schema Version"},"generated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generated At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"manually_edited":{"type":"boolean","title":"Manually Edited","default":false},"retryable":{"type":"boolean","title":"Retryable","default":false},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"},"payload":{"anyOf":[{"$ref":"#/components/schemas/CompanyStylebookPayload-Output"},{"type":"null"}]}},"type":"object","required":["status","schema_version"],"title":"CompanyStylebookResponse"},"CompanyStylebookSwatch":{"properties":{"label":{"type":"string","title":"Label"},"hex":{"type":"string","title":"Hex"}},"type":"object","required":["label","hex"],"title":"CompanyStylebookSwatch"},"CompanyStylebookUpdateRequest":{"properties":{"payload":{"$ref":"#/components/schemas/CompanyStylebookPayload-Input"}},"type":"object","required":["payload"],"title":"CompanyStylebookUpdateRequest"},"CompanyUrlPreflightRequest":{"properties":{"company_url":{"type":"string","title":"Company Url"}},"type":"object","required":["company_url"],"title":"CompanyUrlPreflightRequest"},"CompetitiveIntelligenceAction":{"properties":{"action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action"},"priority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority"},"timeframe":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timeframe"},"evidence_refs":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Evidence Refs"},"expected_impact":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Impact"}},"type":"object","title":"CompetitiveIntelligenceAction"},"CompetitiveIntelligenceEvidence":{"properties":{"evidence_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence Id"},"signal_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signal Type"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"source_table":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Table"},"source_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Source Urls"}},"type":"object","title":"CompetitiveIntelligenceEvidence"},"CompetitiveIntelligenceRecord":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"company_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Id"},"company_profile_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Name"},"snapshot_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Snapshot Date"},"analysis":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Analysis"},"judgement":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Judgement"},"actions":{"anyOf":[{"items":{"$ref":"#/components/schemas/CompetitiveIntelligenceAction"},"type":"array"},{"type":"null"}],"title":"Actions"},"evidence":{"anyOf":[{"items":{"$ref":"#/components/schemas/CompetitiveIntelligenceEvidence"},"type":"array"},{"type":"null"}],"title":"Evidence"},"confidence_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence Score"},"model_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Name"},"created_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created Date"},"updated_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated Date"}},"type":"object","title":"CompetitiveIntelligenceRecord"},"CompetitorAdListResponse":{"properties":{"ads":{"items":{"$ref":"#/components/schemas/CompetitorAdResponse"},"type":"array","title":"Ads"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"limit":{"type":"integer","title":"Limit"},"total_pages":{"type":"integer","title":"Total Pages"},"filters_applied":{"additionalProperties":true,"type":"object","title":"Filters Applied"}},"type":"object","required":["ads","total","page","limit","total_pages"],"title":"CompetitorAdListResponse","description":"Response for competitor ad list endpoint"},"CompetitorAdResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"competitor_id":{"type":"string","format":"uuid","title":"Competitor Id"},"ad_type":{"type":"string","title":"Ad Type"},"source":{"type":"string","title":"Source"},"ad_creative_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Creative Id"},"signal_kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signal Kind"},"signal_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signal Key"},"detected_at":{"type":"string","format":"date-time","title":"Detected At"},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Posted At"},"is_active":{"type":"boolean","title":"Is Active","default":true},"confidence_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence Score"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"cta_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cta Text"},"ad_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Format"},"target_demographics":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Target Demographics"},"target_interests":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Target Interests"},"starts_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Starts At"},"ends_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ends At"},"first_shown":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"First Shown"},"last_shown":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Shown"},"duration_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Days"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"creative_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creative Type"},"ad_creative_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Ad Creative Urls"},"cached_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cached Url"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Url"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"matched_product_offering_ids":{"anyOf":[{"items":{"type":"string","format":"uuid"},"type":"array"},{"type":"null"}],"title":"Matched Product Offering Ids"},"competition_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Competition Type"},"competition_reasons":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Competition Reasons"},"analysis_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Analysis Metadata"},"ai_analysis":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Ai Analysis"},"matched_offerings":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Matched Offerings"}},"type":"object","required":["id","competitor_id","ad_type","source","detected_at"],"title":"CompetitorAdResponse","description":"Response schema for competitor ads with signed URL support"},"CompetitorCampaignOpportunityGenerateRequest":{"properties":{"source_ad_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":3,"title":"Source Ad Ids"},"preferred_mode":{"type":"string","enum":["auto","ads_campaign","social_post_campaign"],"title":"Preferred Mode","default":"auto"},"response_brief":{"anyOf":[{"type":"string","maxLength":400},{"type":"null"}],"title":"Response Brief"}},"type":"object","title":"CompetitorCampaignOpportunityGenerateRequest"},"CompetitorCampaignOpportunityListResponse":{"properties":{"opportunities":{"items":{"$ref":"#/components/schemas/CompetitorCampaignOpportunityView"},"type":"array","title":"Opportunities"}},"type":"object","required":["opportunities"],"title":"CompetitorCampaignOpportunityListResponse"},"CompetitorCampaignOpportunityPrepareResponse":{"properties":{"success":{"type":"boolean","const":true,"title":"Success","default":true},"prefill":{"additionalProperties":true,"type":"object","title":"Prefill"},"explanations":{"additionalProperties":true,"type":"object","title":"Explanations"},"generation_inputs":{"additionalProperties":true,"type":"object","title":"Generation Inputs"},"opportunity":{"$ref":"#/components/schemas/CompetitorCampaignOpportunityView"}},"type":"object","required":["prefill","explanations","generation_inputs","opportunity"],"title":"CompetitorCampaignOpportunityPrepareResponse"},"CompetitorCampaignOpportunityView":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"competitor_id":{"type":"string","format":"uuid","title":"Competitor Id"},"campaign_ideas_cache_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Campaign Ideas Cache Id"},"product_offering_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id"},"campaign_idea_id":{"type":"string","title":"Campaign Idea Id"},"status":{"type":"string","enum":["active","dismissed","superseded"],"title":"Status"},"rank":{"type":"integer","title":"Rank"},"generation_contract_version":{"type":"string","title":"Generation Contract Version"},"campaign_idea_snapshot":{"additionalProperties":true,"type":"object","title":"Campaign Idea Snapshot"},"target_audiences_snapshot":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Target Audiences Snapshot"},"source_snapshot":{"additionalProperties":true,"type":"object","title":"Source Snapshot"},"scope_snapshot":{"additionalProperties":true,"type":"object","title":"Scope Snapshot"},"explanations_snapshot":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Explanations Snapshot"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"last_prepared_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Prepared At"}},"type":"object","required":["id","competitor_id","campaign_idea_id","status","rank","generation_contract_version","campaign_idea_snapshot","target_audiences_snapshot","source_snapshot","scope_snapshot","generated_at","expires_at"],"title":"CompetitorCampaignOpportunityView"},"CompetitorDetailsResponse":{"properties":{"competitor":{"$ref":"#/components/schemas/CompetitorInfo"},"campaigns":{"items":{"$ref":"#/components/schemas/CampaignInfo"},"type":"array","title":"Campaigns"},"last_scan":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Last Scan"},"strategy_summary":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Strategy Summary"},"swot":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Swot"},"marketing_profile":{"anyOf":[{"$ref":"#/components/schemas/MarketingProfileResponse"},{"type":"null"}]},"movements":{"items":{"$ref":"#/components/schemas/CompetitorMovementResponse"},"type":"array","title":"Movements"}},"type":"object","required":["competitor","campaigns"],"title":"CompetitorDetailsResponse","description":"Detailed competitor information with campaigns."},"CompetitorInfo":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"domain":{"type":"string","title":"Domain"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"categories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Categories"},"subcategories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Subcategories"},"business_characteristics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Business Characteristics"},"target_market":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Target Market"},"status":{"type":"string","title":"Status"},"tracking_enabled":{"type":"boolean","title":"Tracking Enabled","default":true},"last_scanned_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Scanned At"},"active_campaigns_count":{"type":"integer","title":"Active Campaigns Count","default":0},"is_self":{"type":"boolean","title":"Is Self","default":false},"company_size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Size"},"operating_regions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Operating Regions"},"match_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Match Score"},"match_percentage":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Match Percentage"},"match_breakdown":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Match Breakdown"},"audience_overlap_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Audience Overlap Score"},"offer_overlap_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Offer Overlap Score"},"positioning_overlap_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Positioning Overlap Score"},"scoring_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Scoring Metadata"},"discovery_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Discovery Metadata"},"website_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website Url"},"contact_page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact Page Url"},"facebook_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facebook Url"},"instagram_handle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instagram Handle"},"linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Url"},"twitter_handle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Twitter Handle"},"tiktok_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tiktok Url"},"youtube_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Youtube Url"},"is_scanning":{"type":"boolean","title":"Is Scanning","default":false},"last_scan_started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Scan Started At"},"last_scan_completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Scan Completed At"},"setup_pending":{"type":"boolean","title":"Setup Pending","default":false},"restored":{"type":"boolean","title":"Restored","default":false}},"type":"object","required":["id","name","domain","status"],"title":"CompetitorInfo","description":"Basic competitor information."},"CompetitorInsightsResponse":{"properties":{"competitor_id":{"type":"string","format":"uuid","title":"Competitor Id"},"competitor_name":{"type":"string","title":"Competitor Name"},"headline":{"type":"string","title":"Headline"},"subline":{"type":"string","title":"Subline"},"summary":{"type":"string","title":"Summary"},"recommended_response":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recommended Response"},"key_takeaways":{"items":{"type":"string"},"type":"array","title":"Key Takeaways"},"supporting_evidence":{"items":{"type":"string"},"type":"array","title":"Supporting Evidence"},"generated_at":{"type":"string","title":"Generated At"},"expires_at":{"type":"string","title":"Expires At"},"is_cached":{"type":"boolean","title":"Is Cached"},"model_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Name"},"prompt_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt Version"}},"type":"object","required":["competitor_id","competitor_name","headline","subline","summary","generated_at","expires_at","is_cached"],"title":"CompetitorInsightsResponse"},"CompetitorLiveStatus":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"active_campaigns_count":{"type":"integer","title":"Active Campaigns Count","default":0},"is_scanning":{"type":"boolean","title":"Is Scanning","default":false},"last_scanned_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Scanned At"},"last_scan_started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Scan Started At"},"last_scan_completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Scan Completed At"},"setup_pending":{"type":"boolean","title":"Setup Pending","default":false}},"type":"object","required":["id"],"title":"CompetitorLiveStatus","description":"Lightweight persisted live state for competitors."},"CompetitorMovementOverlapResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"primary_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Image Url"},"display_price":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Price"}},"type":"object","required":["id"],"title":"CompetitorMovementOverlapResponse"},"CompetitorMovementResponse":{"properties":{"id":{"type":"string","title":"Id"},"kind":{"type":"string","title":"Kind"},"label":{"type":"string","title":"Label"},"source":{"type":"string","title":"Source"},"observed_at":{"type":"string","title":"Observed At"},"since":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Since"},"title":{"type":"string","title":"Title"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"},"cta_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cta Text"},"placement_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Placement Label"},"product_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Name"},"offer_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offer Text"},"link_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Link Url"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Url"},"advertiser_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Advertiser Name"},"ad_ids":{"items":{"type":"string"},"type":"array","title":"Ad Ids"},"ad_count":{"type":"integer","title":"Ad Count","default":1},"overlaps":{"items":{"$ref":"#/components/schemas/CompetitorMovementOverlapResponse"},"type":"array","title":"Overlaps"}},"type":"object","required":["id","kind","label","source","observed_at","title"],"title":"CompetitorMovementResponse","description":"A dated change the competitor made: a site placement or a batch of new paid ads."},"CompetitorRefreshReview":{"properties":{"kind":{"type":"string","const":"competitor_refresh","title":"Kind","default":"competitor_refresh"},"action":{"type":"string","enum":["add","replace"],"title":"Action"},"headline":{"type":"string","maxLength":160,"minLength":1,"title":"Headline"},"reason":{"type":"string","maxLength":600,"minLength":1,"title":"Reason"},"candidate":{"$ref":"#/components/schemas/CompetitorReviewCandidate"},"outgoing":{"anyOf":[{"$ref":"#/components/schemas/CompetitorReviewOutgoing"},{"type":"null"}]},"why_add":{"type":"string","maxLength":600,"minLength":1,"title":"Why Add"},"why_remove":{"type":"string","maxLength":600,"title":"Why Remove","default":""},"coverage":{"items":{"$ref":"#/components/schemas/CompetitorReviewCoverage"},"type":"array","maxItems":100,"title":"Coverage","default":[]},"evidence":{"items":{"$ref":"#/components/schemas/CompetitorReviewEvidence"},"type":"array","maxItems":10,"minItems":1,"title":"Evidence"},"uncertainties":{"items":{"type":"string","maxLength":1000,"minLength":1},"type":"array","maxItems":6,"title":"Uncertainties","default":[]},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"}},"additionalProperties":false,"type":"object","required":["action","headline","reason","candidate","why_add","evidence","created_at","expires_at"],"title":"CompetitorRefreshReview","description":"Exact persisted competitor recommendation accepted or dismissed by a human."},"CompetitorRegenerateRequest":{"properties":{"workflow_id":{"type":"string","format":"uuid","title":"Workflow Id"},"scope_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope Key"}},"type":"object","required":["workflow_id"],"title":"CompetitorRegenerateRequest"},"CompetitorReviewCandidate":{"properties":{"name":{"type":"string","maxLength":150,"minLength":1,"title":"Name"},"url":{"type":"string","maxLength":2000,"minLength":1,"title":"Url"},"description":{"type":"string","maxLength":1200,"minLength":1,"title":"Description"}},"additionalProperties":false,"type":"object","required":["name","url","description"],"title":"CompetitorReviewCandidate"},"CompetitorReviewCoverage":{"properties":{"product_id":{"type":"string","format":"uuid","title":"Product Id"},"product_name":{"type":"string","maxLength":300,"minLength":1,"title":"Product Name"},"gained":{"type":"string","maxLength":700,"minLength":1,"title":"Gained"},"lost":{"type":"string","maxLength":700,"minLength":1,"title":"Lost"}},"additionalProperties":false,"type":"object","required":["product_id","product_name","gained","lost"],"title":"CompetitorReviewCoverage"},"CompetitorReviewEvidence":{"properties":{"url":{"type":"string","maxLength":2000,"minLength":1,"title":"Url"},"quote":{"type":"string","maxLength":500,"minLength":1,"title":"Quote"}},"additionalProperties":false,"type":"object","required":["url","quote"],"title":"CompetitorReviewEvidence"},"CompetitorReviewOutgoing":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","maxLength":300,"minLength":1,"title":"Name"},"domain":{"type":"string","maxLength":2000,"minLength":1,"title":"Domain"}},"additionalProperties":false,"type":"object","required":["id","name","domain"],"title":"CompetitorReviewOutgoing"},"CompetitorSetupRequest":{"properties":{"competitor_urls":{"items":{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},"type":"array","maxItems":10,"title":"Competitor Urls","description":"List of competitor website URLs (max 10)"}},"type":"object","required":["competitor_urls"],"title":"CompetitorSetupRequest","description":"Request to set up competitor tracking."},"ConfirmCompetitorsRequest":{"properties":{"workflow_id":{"type":"string","format":"uuid","title":"Workflow Id"},"selected_competitors":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Selected Competitors"}},"type":"object","required":["workflow_id","selected_competitors"],"title":"ConfirmCompetitorsRequest"},"ConfirmExternalIdRequest":{"properties":{"idempotency_key":{"type":"string","maxLength":255,"minLength":8,"title":"Idempotency Key"},"external_reply_id":{"type":"string","maxLength":255,"minLength":1,"title":"External Reply Id"}},"type":"object","required":["idempotency_key","external_reply_id"],"title":"ConfirmExternalIdRequest"},"ContactSubmissionCreate":{"properties":{"first_name":{"type":"string","maxLength":255,"minLength":1,"title":"First Name"},"last_name":{"type":"string","maxLength":255,"minLength":1,"title":"Last Name"},"email":{"type":"string","maxLength":512,"title":"Email"},"company":{"type":"string","maxLength":512,"minLength":2,"title":"Company"},"title":{"type":"string","maxLength":512,"minLength":2,"title":"Title"},"industry":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Industry"},"phone":{"type":"string","maxLength":64,"title":"Phone"},"message":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}],"title":"Message"},"submission_type":{"$ref":"#/components/schemas/SubmissionType"},"recaptcha_token":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Recaptcha Token"}},"type":"object","required":["first_name","last_name","email","company","title","phone","submission_type"],"title":"ContactSubmissionCreate","description":"Request schema for creating a contact submission."},"ContentEditResponse":{"properties":{"edited_image_urls":{"items":{"type":"string"},"type":"array","title":"Edited Image Urls","default":[]},"original_image_url":{"type":"string","title":"Original Image Url"},"variations":{"anyOf":[{"items":{"$ref":"#/components/schemas/ImageVariation"},"type":"array"},{"type":"null"}],"title":"Variations"}},"type":"object","required":["original_image_url"],"title":"ContentEditResponse","description":"Response model for edited image content"},"ConversationPageResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ConversationResponse"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items"],"title":"ConversationPageResponse"},"ConversationPresentationContext":{"properties":{"route":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Route"},"page_context":{"anyOf":[{"$ref":"#/components/schemas/PageDisplayContext"},{"type":"null"}]},"attached_context":{"anyOf":[{"$ref":"#/components/schemas/AttachedDisplayContext"},{"type":"null"}]}},"additionalProperties":false,"type":"object","title":"ConversationPresentationContext"},"ConversationResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"latest_body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Body"},"participant_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Participant Display Name"},"participant_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Participant Count"},"folder_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Folder State"},"provider_updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Provider Updated At"},"version":{"type":"integer","title":"Version"},"visibility":{"type":"string","title":"Visibility"},"has_page_answer":{"type":"boolean","title":"Has Page Answer"},"needs_reply":{"type":"boolean","title":"Needs Reply"},"proposal_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Proposal Id"},"proposal_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Proposal State"},"draft_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Draft Text"},"proposal_target_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Proposal Target Version"},"proposal_context_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Proposal Context Hash"},"proposal_generation_attempt_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Proposal Generation Attempt Count"},"delivery_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Delivery Id"},"delivery_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delivery Status"},"delivery_safe_error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delivery Safe Error Code"},"messages":{"items":{"$ref":"#/components/schemas/MessageResponse"},"type":"array","title":"Messages"}},"type":"object","required":["id","latest_body","participant_display_name","participant_count","folder_state","provider_updated_at","version","visibility","has_page_answer","needs_reply"],"title":"ConversationResponse"},"ConversationSearchMatch":{"properties":{"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"title":{"type":"string","maxLength":255,"title":"Title"},"last_message_at":{"type":"string","format":"date-time","title":"Last Message At"},"message_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Message Id"},"sequence":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Sequence"},"turn_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Turn Id"},"match_kind":{"type":"string","enum":["title","message","saved_output"],"title":"Match Kind"},"excerpt":{"type":"string","maxLength":340,"minLength":1,"title":"Excerpt"}},"additionalProperties":false,"type":"object","required":["conversation_id","title","last_message_at","match_kind","excerpt"],"title":"ConversationSearchMatch"},"ConversationSearchResponse":{"properties":{"version":{"type":"integer","const":1,"title":"Version","default":1},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"query":{"type":"string","title":"Query"},"items":{"items":{"$ref":"#/components/schemas/ConversationSearchMatch"},"type":"array","maxItems":20,"title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"search_complete":{"type":"boolean","title":"Search Complete"}},"additionalProperties":false,"type":"object","required":["organization_id","company_profile_id","query","search_complete"],"title":"ConversationSearchResponse"},"CreateConversation":{"properties":{"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"title":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Title"},"presentation_context":{"anyOf":[{"$ref":"#/components/schemas/ConversationPresentationContext"},{"type":"null"}]},"visibility":{"type":"string","enum":["private","shared"],"title":"Visibility","default":"private"},"executor_key":{"type":"string","enum":["markee_v2","ai_team"],"title":"Executor Key","default":"markee_v2"}},"additionalProperties":false,"type":"object","required":["organization_id","company_profile_id"],"title":"CreateConversation"},"CreateCreatorListRequest":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"list_type":{"type":"string","title":"List Type","default":"manual"},"campaign_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id"},"campaign_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Type"},"metadata_json":{"additionalProperties":true,"type":"object","title":"Metadata Json"}},"type":"object","required":["name"],"title":"CreateCreatorListRequest"},"CreateOrganizationInvitesRequest":{"properties":{"emails":{"items":{"type":"string","format":"email"},"type":"array","title":"Emails"},"role":{"$ref":"#/components/schemas/OrganizationRoleEnum","default":"member"},"company_profile_access":{"anyOf":[{"items":{"$ref":"#/components/schemas/OrganizationInviteProfileAccessRequest"},"type":"array"},{"type":"null"}],"title":"Company Profile Access"},"expires_in_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expires In Days"}},"type":"object","required":["emails"],"title":"CreateOrganizationInvitesRequest","description":"Request payload for creating email-based invites."},"CreateOrganizationInvitesResponse":{"properties":{"invites":{"items":{"$ref":"#/components/schemas/OrganizationInviteResponse"},"type":"array","title":"Invites"},"failed":{"items":{"$ref":"#/components/schemas/OrganizationInviteFailure"},"type":"array","title":"Failed","default":[]}},"type":"object","required":["invites"],"title":"CreateOrganizationInvitesResponse","description":"Response payload for invite creation."},"CreatePostRequest":{"properties":{"instagram_account_id":{"type":"string","title":"Instagram Account Id"},"image_url":{"type":"string","title":"Image Url"},"caption":{"type":"string","title":"Caption"},"hashtags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Hashtags"}},"type":"object","required":["instagram_account_id","image_url","caption"],"title":"CreatePostRequest","description":"Request model for creating an Instagram post."},"CreateSubscriptionRequest":{"properties":{"organization_id":{"type":"string","title":"Organization Id"},"payment_method_id":{"type":"string","title":"Payment Method Id"},"plan_id":{"type":"string","title":"Plan Id","default":"silver"},"billing_interval":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Interval"}},"type":"object","required":["organization_id","payment_method_id"],"title":"CreateSubscriptionRequest","description":"Request model for creating a subscription."},"CreatorEvidenceEnvelope-Input":{"properties":{"schema_version":{"type":"integer","const":1,"title":"Schema Version","default":1},"snapshot_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Snapshot Id"},"purpose":{"type":"string","enum":["account","pricing"],"title":"Purpose","default":"account"},"account":{"$ref":"#/components/schemas/EvidenceAccount"},"visibility":{"type":"string","enum":["public","company_private","unclassified"],"title":"Visibility","default":"unclassified"},"sources":{"items":{"$ref":"#/components/schemas/EvidenceSource"},"type":"array","maxItems":50,"title":"Sources"},"metrics":{"items":{"$ref":"#/components/schemas/MetricEvidence"},"type":"array","maxItems":500,"title":"Metrics"}},"additionalProperties":false,"type":"object","required":["account"],"title":"CreatorEvidenceEnvelope"},"CreatorEvidenceEnvelope-Output":{"properties":{"schema_version":{"type":"integer","const":1,"title":"Schema Version","default":1},"snapshot_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Snapshot Id"},"purpose":{"type":"string","enum":["account","pricing"],"title":"Purpose","default":"account"},"account":{"$ref":"#/components/schemas/EvidenceAccount"},"visibility":{"type":"string","enum":["public","company_private","unclassified"],"title":"Visibility","default":"unclassified"},"sources":{"items":{"$ref":"#/components/schemas/EvidenceSource"},"type":"array","maxItems":50,"title":"Sources"},"metrics":{"items":{"$ref":"#/components/schemas/MetricEvidence"},"type":"array","maxItems":500,"title":"Metrics"}},"additionalProperties":false,"type":"object","required":["account"],"title":"CreatorEvidenceEnvelope"},"CreditBalanceResponse":{"properties":{"balance":{"type":"number","title":"Balance"},"currency":{"type":"string","title":"Currency","default":"USD"},"last_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Updated"}},"type":"object","required":["balance","last_updated"],"title":"CreditBalanceResponse","description":"Current credit balance response."},"CreditCaptureRequest":{"properties":{"hold_id":{"type":"string","title":"Hold Id"},"campaign_id":{"type":"string","title":"Campaign Id"}},"type":"object","required":["hold_id","campaign_id"],"title":"CreditCaptureRequest","description":"Request to capture a credit hold.\n\nDeliberately carries no final_charge: the amount is the one already held,\nand the launch flows that legitimately settle a different amount call\nCreditService.capture_hold directly with a server-computed value."},"CreditHoldRequest":{"properties":{"organization_id":{"type":"string","title":"Organization Id"},"amount":{"type":"number","title":"Amount"},"description":{"type":"string","title":"Description"},"platform_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform Type","description":"Platform type: google_search, google_display, etc"}},"type":"object","required":["organization_id","amount","description"],"title":"CreditHoldRequest","description":"Request to create a credit hold."},"CreditHoldResponse":{"properties":{"hold_id":{"type":"string","title":"Hold Id"},"amount":{"type":"number","title":"Amount"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"status":{"type":"string","title":"Status","default":"success"}},"type":"object","required":["hold_id","amount","expires_at"],"title":"CreditHoldResponse","description":"Response from credit hold creation."},"CreditPurchaseRequest":{"properties":{"organization_id":{"type":"string","title":"Organization Id"},"amount":{"type":"number","title":"Amount"}},"type":"object","required":["organization_id","amount"],"title":"CreditPurchaseRequest","description":"Request to purchase credits."},"CreditPurchaseResponse":{"properties":{"client_secret":{"type":"string","title":"Client Secret"},"payment_intent_id":{"type":"string","title":"Payment Intent Id"},"amount":{"type":"number","title":"Amount"},"currency":{"type":"string","title":"Currency","default":"USD"}},"type":"object","required":["client_secret","payment_intent_id","amount"],"title":"CreditPurchaseResponse","description":"Response with Stripe payment intent details."},"CreditReleaseRequest":{"properties":{"hold_id":{"type":"string","title":"Hold Id"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["hold_id","reason"],"title":"CreditReleaseRequest","description":"Request to release a credit hold."},"CriterionScore":{"properties":{"rating":{"type":"integer","maximum":5.0,"minimum":0.0,"title":"Rating"},"reason":{"type":"string","maxLength":1200,"minLength":1,"title":"Reason"}},"additionalProperties":false,"type":"object","required":["rating","reason"],"title":"CriterionScore"},"CrmApproverGroupResponse":{"properties":{"group_id":{"type":"string","title":"Group Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"members":{"items":{"$ref":"#/components/schemas/CrmApproverMember"},"type":"array","title":"Members"}},"type":"object","required":["group_id","name"],"title":"CrmApproverGroupResponse"},"CrmApproverMember":{"properties":{"user_id":{"type":"string","title":"User Id"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["user_id"],"title":"CrmApproverMember"},"CrmAudienceAddRequest":{"properties":{"person_refs":{"items":{"type":"string"},"type":"array","maxItems":500,"minItems":1,"title":"Person Refs"},"group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Group Id"},"new_group_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"New Group Name"}},"type":"object","required":["person_refs"],"title":"CrmAudienceAddRequest","description":"Body for POST /api/crm/audiences/add.\n\nEither `group_id` (existing group) or `new_group_name` (create one) must be set."},"CrmAudienceAddResponse":{"properties":{"group":{"$ref":"#/components/schemas/CrmAudienceSummary"},"added":{"type":"integer","title":"Added","default":0},"skipped_email_less":{"items":{"type":"string"},"type":"array","title":"Skipped Email Less"},"skipped_existing":{"type":"integer","title":"Skipped Existing","default":0},"skipped_no_marketing_consent":{"items":{"type":"string"},"type":"array","title":"Skipped No Marketing Consent"}},"type":"object","required":["group"],"title":"CrmAudienceAddResponse"},"CrmAudienceCreateRequest":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"}},"type":"object","required":["name"],"title":"CrmAudienceCreateRequest"},"CrmAudienceDetail":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"number_of_members":{"type":"integer","title":"Number Of Members","default":0},"matchable_members":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Matchable Members"},"creation_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creation Date"},"members_revision":{"type":"integer","title":"Members Revision","default":0},"syncs":{"items":{"$ref":"#/components/schemas/CrmAudienceSyncState"},"type":"array","title":"Syncs"}},"type":"object","required":["id","name"],"title":"CrmAudienceDetail"},"CrmAudienceDetailListResponse":{"properties":{"audiences":{"items":{"$ref":"#/components/schemas/CrmAudienceDetail"},"type":"array","title":"Audiences"},"connected_platforms":{"items":{"type":"string"},"type":"array","title":"Connected Platforms"},"platform_readiness":{"items":{"$ref":"#/components/schemas/CrmAudiencePlatformReadiness"},"type":"array","title":"Platform Readiness"}},"type":"object","title":"CrmAudienceDetailListResponse"},"CrmAudienceListResponse":{"properties":{"audiences":{"items":{"$ref":"#/components/schemas/CrmAudienceSummary"},"type":"array","title":"Audiences"}},"type":"object","title":"CrmAudienceListResponse"},"CrmAudienceMember":{"properties":{"id":{"type":"string","title":"Id"},"email":{"type":"string","title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone"}},"type":"object","required":["id","email"],"title":"CrmAudienceMember"},"CrmAudienceMemberInput":{"properties":{"email":{"type":"string","maxLength":320,"title":"Email"},"name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Name"},"phone":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Phone"}},"type":"object","required":["email"],"title":"CrmAudienceMemberInput"},"CrmAudienceMemberListResponse":{"properties":{"members":{"items":{"$ref":"#/components/schemas/CrmAudienceMember"},"type":"array","title":"Members"}},"type":"object","title":"CrmAudienceMemberListResponse"},"CrmAudienceMembersAddRequest":{"properties":{"members":{"items":{"$ref":"#/components/schemas/CrmAudienceMemberInput"},"type":"array","maxItems":5000,"minItems":1,"title":"Members"}},"type":"object","required":["members"],"title":"CrmAudienceMembersAddRequest"},"CrmAudienceMembersAddResponse":{"properties":{"added":{"type":"integer","title":"Added","default":0},"skipped_invalid":{"type":"integer","title":"Skipped Invalid","default":0},"skipped_duplicate":{"type":"integer","title":"Skipped Duplicate","default":0},"total_members":{"type":"integer","title":"Total Members","default":0}},"type":"object","title":"CrmAudienceMembersAddResponse"},"CrmAudiencePlatformReadiness":{"properties":{"platform":{"type":"string","title":"Platform"},"platform_label":{"type":"string","title":"Platform Label"},"connected":{"type":"boolean","title":"Connected","default":false},"ready":{"type":"boolean","title":"Ready","default":false},"blocker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Blocker"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"action_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Url"},"action_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Label"}},"type":"object","required":["platform","platform_label"],"title":"CrmAudiencePlatformReadiness","description":"Whether a platform can receive an audience, and what to do if not.\n\nSurfaced before any audience is built, so a blocker that needs a human step\non the platform is discovered up front rather than after the work is done."},"CrmAudienceRecheckRequest":{"properties":{"platform":{"type":"string","maxLength":32,"title":"Platform"}},"type":"object","required":["platform"],"title":"CrmAudienceRecheckRequest"},"CrmAudienceRenameRequest":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"}},"type":"object","required":["name"],"title":"CrmAudienceRenameRequest"},"CrmAudienceSummary":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"number_of_members":{"type":"integer","title":"Number Of Members","default":0},"matchable_members":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Matchable Members"},"creation_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creation Date"}},"type":"object","required":["id","name"],"title":"CrmAudienceSummary"},"CrmAudienceSyncRequest":{"properties":{"platform":{"type":"string","maxLength":32,"title":"Platform"}},"type":"object","required":["platform"],"title":"CrmAudienceSyncRequest"},"CrmAudienceSyncResponse":{"properties":{"sync":{"$ref":"#/components/schemas/CrmAudienceSyncState"}},"type":"object","required":["sync"],"title":"CrmAudienceSyncResponse"},"CrmAudienceSyncState":{"properties":{"platform":{"type":"string","title":"Platform"},"platform_label":{"type":"string","title":"Platform Label"},"status":{"type":"string","title":"Status"},"ad_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Account Id"},"remote_audience_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Remote Audience Id"},"uploaded_count":{"type":"integer","title":"Uploaded Count","default":0},"matched_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Matched Count"},"targeting_min_matched":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Targeting Min Matched"},"last_synced_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Synced At"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error"}},"type":"object","required":["platform","platform_label","status"],"title":"CrmAudienceSyncState","description":"One audience's state on one ad platform.\n\n``matched_count`` is deliberately optional and distinct from\n``uploaded_count``: platforms take hours to resolve an upload into matched\nusers and report nothing meanwhile, so a null here means \"not known yet\",\nnever zero."},"CrmMarkContactedRequest":{"properties":{"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"},"channel":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"Channel"}},"type":"object","title":"CrmMarkContactedRequest","description":"Body for ``POST /api/crm/people/{person_ref}/contacted``.\n\nBoth fields are optional — an empty body logs a manual touch with no note.\n``channel`` defaults to ``manual`` (I reached out myself, off-platform)."},"CrmPeopleFilters":{"properties":{"source_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Source Counts"},"stage_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Stage Counts"},"hubspot_counts":{"additionalProperties":{"type":"integer"},"type":"object","title":"Hubspot Counts"}},"type":"object","title":"CrmPeopleFilters"},"CrmPeopleListResponse":{"properties":{"access":{"additionalProperties":true,"type":"object","title":"Access"},"people":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"People"},"pagination":{"$ref":"#/components/schemas/CrmPeoplePagination"},"filters":{"$ref":"#/components/schemas/CrmPeopleFilters"},"summary":{"additionalProperties":true,"type":"object","title":"Summary"}},"type":"object","required":["access"],"title":"CrmPeopleListResponse"},"CrmPeoplePagination":{"properties":{"limit":{"type":"integer","title":"Limit","default":25},"offset":{"type":"integer","title":"Offset","default":0},"total":{"type":"integer","title":"Total","default":0},"page":{"type":"integer","title":"Page","default":1},"total_pages":{"type":"integer","title":"Total Pages","default":1},"has_next":{"type":"boolean","title":"Has Next","default":false},"has_previous":{"type":"boolean","title":"Has Previous","default":false}},"type":"object","title":"CrmPeoplePagination"},"CrmPersonDetailResponse":{"properties":{"access":{"additionalProperties":true,"type":"object","title":"Access"},"person":{"additionalProperties":true,"type":"object","title":"Person"},"sources":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Sources"},"timeline":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Timeline"},"engagement":{"additionalProperties":true,"type":"object","title":"Engagement"}},"type":"object","required":["access"],"title":"CrmPersonDetailResponse"},"CrmSetStageRequest":{"properties":{"stage":{"type":"string","enum":["prospect","engaged","replied","qualified","customer","archived"],"title":"Stage"}},"type":"object","required":["stage"],"title":"CrmSetStageRequest","description":"Body for ``PUT /api/crm/people/{person_ref}/stage`` — a manual override."},"CrmSettingsResponse":{"properties":{"company_profile_id":{"type":"string","title":"Company Profile Id"},"crm_sync_requires_approval":{"type":"boolean","title":"Crm Sync Requires Approval","default":false},"default_audience_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default Audience Group Id"}},"type":"object","required":["company_profile_id"],"title":"CrmSettingsResponse"},"CrmSettingsUpdateRequest":{"properties":{"crm_sync_requires_approval":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Crm Sync Requires Approval"},"default_audience_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default Audience Group Id"}},"type":"object","title":"CrmSettingsUpdateRequest"},"CrmSplitSourceRequest":{"properties":{"source_ref":{"type":"string","maxLength":255,"minLength":1,"title":"Source Ref"}},"type":"object","required":["source_ref"],"title":"CrmSplitSourceRequest","description":"Body for ``POST /api/crm/people/{person_ref}/split``.\n\n``source_ref`` is the contributing ``{source}:{id}`` to peel out of the merged\nperson into its own standalone record (a persistent do-not-merge override)."},"CrmSyncRequest":{"properties":{"person_refs":{"items":{"type":"string"},"type":"array","maxItems":200,"minItems":1,"title":"Person Refs"},"fields_overrides":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Fields Overrides"},"note":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}],"title":"Note"},"mode":{"type":"string","title":"Mode","default":"contact"}},"type":"object","required":["person_refs"],"title":"CrmSyncRequest","description":"Body for POST /api/crm/sync/hubspot.\n\n`person_refs` are the synthetic `{source}:{id}` keys from the People projection.\n`fields_overrides` lets the client patch the diff before staging (e.g. an\nemail typed into the email-less notice). `mode` switches identity handling."},"CrmSyncResponse":{"properties":{"status":{"type":"string","title":"Status"},"change_request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Request Id"},"results":{"items":{"$ref":"#/components/schemas/CrmSyncResultItem"},"type":"array","title":"Results"}},"type":"object","required":["status"],"title":"CrmSyncResponse","description":"Response for POST /api/crm/sync/hubspot.\n\n`status` is the overall request outcome:\n  - \"synced\"           — direct path, all upserts succeeded\n  - \"partial\"          — direct path, some upserts failed\n  - \"failed\"           — direct path, all upserts failed\n  - \"pending_approval\" — governed path, ChangeRequest created"},"CrmSyncResultItem":{"properties":{"person_ref":{"type":"string","title":"Person Ref"},"status":{"type":"string","title":"Status"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"identity_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identity Source"},"hubspot_record_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hubspot Record Id"},"hubspot_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hubspot Url"},"change_request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Request Id"},"diff":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Diff"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["person_ref","status"],"title":"CrmSyncResultItem","description":"Per-person outcome of a sync request (direct path) or staged op (governed)."},"CrossChannelMetricsResponse":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"total_revenue_cents":{"type":"integer","title":"Total Revenue Cents"},"total_ad_spend_cents":{"type":"integer","title":"Total Ad Spend Cents"},"blended_roas":{"type":"number","title":"Blended Roas"},"total_transactions":{"type":"integer","title":"Total Transactions"},"total_conversions":{"type":"integer","title":"Total Conversions"}},"type":"object","required":["metric_date","total_revenue_cents","total_ad_spend_cents","blended_roas","total_transactions","total_conversions"],"title":"CrossChannelMetricsResponse","description":"Response model for cross-channel metrics."},"CustomerSummaryResponse":{"properties":{"customer_key":{"type":"string","title":"Customer Key"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"acquisition_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Acquisition Date"},"total_orders":{"type":"integer","title":"Total Orders"},"total_spent_cents":{"type":"integer","title":"Total Spent Cents"},"ltv_cents":{"type":"integer","title":"Ltv Cents"},"rfm_segment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rfm Segment"},"days_since_last_order":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Days Since Last Order"},"warehouse_customer_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Warehouse Customer Key"}},"type":"object","required":["customer_key","email","first_name","last_name","acquisition_date","total_orders","total_spent_cents","ltv_cents","rfm_segment","days_since_last_order"],"title":"CustomerSummaryResponse","description":"Response model for customer summary."},"DailyReportBudgetScenarioResponse":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"allocations":{"items":{"$ref":"#/components/schemas/DailyReportMmmAllocationResponse"},"type":"array","title":"Allocations"},"total_display":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Total Display"},"basis_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Basis Note"}},"type":"object","title":"DailyReportBudgetScenarioResponse"},"DailyReportChannelMetricResponse":{"properties":{"channel_key":{"type":"string","title":"Channel Key"},"channel_display_name":{"type":"string","title":"Channel Display Name"},"spend_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Spend Cents"},"roas":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roas"},"cpa":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cpa"},"conversions":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Conversions"},"impressions":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Impressions"},"data_confidence":{"type":"string","enum":["measured","estimated","unavailable"],"title":"Data Confidence","default":"unavailable"}},"type":"object","required":["channel_key","channel_display_name"],"title":"DailyReportChannelMetricResponse"},"DailyReportChannelMetricsResponse":{"properties":{"availability":{"type":"string","enum":["connected","no_accounts","stale"],"title":"Availability","default":"no_accounts"},"as_of":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"As Of"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"channels":{"items":{"$ref":"#/components/schemas/DailyReportChannelMetricResponse"},"type":"array","title":"Channels"}},"type":"object","title":"DailyReportChannelMetricsResponse","description":"Channel performance — honest about availability; never fabricated."},"DailyReportCreativeResponse":{"properties":{"selection_id":{"type":"string","title":"Selection Id"},"approval_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approval Id"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"platform_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform Display Name"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Url"},"media_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Media Type"},"surface":{"type":"string","enum":["ads","social"],"title":"Surface","default":"ads"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"pending":{"type":"boolean","title":"Pending","default":false},"bundle_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bundle Title"},"bundle_rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bundle Rationale"},"bundle_expected":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bundle Expected"},"bundle_confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bundle Confidence"}},"type":"object","required":["selection_id"],"title":"DailyReportCreativeResponse","description":"One reviewable creative with a stable ``selection_id`` the approval\ndecision endpoint already consumes (``selected_creative_ids``)."},"DailyReportEntityResponse":{"properties":{"kind":{"type":"string","enum":["signal","competitor","creative","optimization","channel_metric","insight"],"title":"Kind","default":"insight"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"priority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority"},"ui_tone":{"type":"string","enum":["alert","ready","live","pending","neutral"],"title":"Ui Tone","default":"neutral"},"data_confidence":{"type":"string","enum":["measured","estimated","unavailable"],"title":"Data Confidence","default":"estimated"},"evidence":{"items":{"$ref":"#/components/schemas/DailyReportEvidenceResponse"},"type":"array","title":"Evidence"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["title"],"title":"DailyReportEntityResponse","description":"A typed, presentation-ready item the AI team authored for one section.\n\nCopy fields (``title``, ``description``) are clean owner-facing prose written\nby the AI; ``data_confidence`` lets the team label or omit anything the source\ndata does not support rather than fabricate it."},"DailyReportEvidenceResponse":{"properties":{"label":{"type":"string","title":"Label"},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},"type":"object","required":["label"],"title":"DailyReportEvidenceResponse","description":"One labeled supporting fact for a daily-report entity."},"DailyReportMarketingMixResponse":{"properties":{"readiness_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Readiness Tier"},"confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence"},"budget_scenario":{"anyOf":[{"$ref":"#/components/schemas/DailyReportBudgetScenarioResponse"},{"type":"null"}]},"data_gaps":{"items":{"type":"string"},"type":"array","title":"Data Gaps"},"planning_assumptions":{"items":{"type":"string"},"type":"array","title":"Planning Assumptions"}},"type":"object","title":"DailyReportMarketingMixResponse","description":"Budget / marketing-mix planning detail — honest about whether it is a\nmeasured allocation or an assumption-based scaffold."},"DailyReportMmmAllocationResponse":{"properties":{"channel_key":{"type":"string","title":"Channel Key"},"channel_display":{"type":"string","title":"Channel Display"},"current_share":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Current Share"},"recommended_share":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Recommended Share"},"current_display":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Display"},"recommended_display":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recommended Display"}},"type":"object","required":["channel_key","channel_display"],"title":"DailyReportMmmAllocationResponse","description":"One channel's assumption-only budget share (current vs recommended)."},"DailyReportSectionResponse":{"properties":{"section_key":{"type":"string","title":"Section Key"},"agent_id":{"type":"string","title":"Agent Id"},"agent_display_name":{"type":"string","title":"Agent Display Name"},"eyebrow":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Eyebrow"},"headline":{"type":"string","title":"Headline"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"status_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Label"},"status_tone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Tone"},"entities":{"items":{"$ref":"#/components/schemas/DailyReportEntityResponse"},"type":"array","title":"Entities"}},"type":"object","required":["section_key","agent_id","agent_display_name","headline"],"title":"DailyReportSectionResponse","description":"One agent's section of the daily report (AI-authored copy + typed items)."},"DataImportColumn":{"properties":{"role":{"type":"string","maxLength":100,"minLength":1,"title":"Role"},"label":{"type":"string","maxLength":200,"minLength":1,"title":"Label"},"column":{"type":"string","maxLength":300,"minLength":1,"title":"Column"}},"additionalProperties":false,"type":"object","required":["role","label","column"],"title":"DataImportColumn"},"DataImportProduct":{"properties":{"source_label":{"type":"string","maxLength":300,"minLength":1,"title":"Source Label"},"product_name":{"type":"string","maxLength":240,"minLength":1,"title":"Product Name"}},"additionalProperties":false,"type":"object","required":["source_label","product_name"],"title":"DataImportProduct"},"DataImportReview":{"properties":{"kind":{"type":"string","const":"data_import","title":"Kind","default":"data_import"},"file_name":{"type":"string","maxLength":255,"minLength":1,"title":"File Name"},"workspace_name":{"type":"string","maxLength":240,"minLength":1,"title":"Workspace Name"},"dataset_category":{"type":"string","enum":["consumption","shipments","inventory"],"title":"Dataset Category"},"row_count":{"type":"integer","minimum":0.0,"title":"Row Count"},"column_count":{"type":"integer","minimum":1.0,"title":"Column Count"},"columns":{"items":{"$ref":"#/components/schemas/DataImportColumn"},"type":"array","maxItems":50,"minItems":1,"title":"Columns"},"products":{"items":{"$ref":"#/components/schemas/DataImportProduct"},"type":"array","maxItems":20,"title":"Products","default":[]},"source_channel":{"anyOf":[{"type":"string","maxLength":240},{"type":"null"}],"title":"Source Channel"},"warnings":{"items":{"type":"string","maxLength":1000,"minLength":1},"type":"array","maxItems":8,"title":"Warnings","default":[]}},"additionalProperties":false,"type":"object","required":["file_name","workspace_name","dataset_category","row_count","column_count","columns"],"title":"DataImportReview","description":"Confirmed column interpretation; raw customer rows never enter chat."},"DataSourceAccountInfo":{"properties":{"id":{"type":"string","title":"Id","description":"Platform-specific account ID"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","description":"Account/business name"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","description":"Account email"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency","description":"Default currency (e.g., USD)"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country code (e.g., US)"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"Account timezone"}},"type":"object","required":["id"],"title":"DataSourceAccountInfo","description":"Standard account information model.\n\nUsed by: GET /{platform}/account or embedded in other responses"},"DataSourceAccountResponse":{"properties":{"connected":{"type":"boolean","title":"Connected","description":"Whether the platform is connected"},"account":{"anyOf":[{"$ref":"#/components/schemas/DataSourceAccountInfo"},{"type":"null"}],"description":"Account details if connected"}},"type":"object","required":["connected"],"title":"DataSourceAccountResponse","description":"Response for account information endpoint.\n\nUsed by: GET /{platform}/account"},"DataSourceAuthResponse":{"properties":{"auth_url":{"type":"string","title":"Auth Url","description":"OAuth authorization URL to redirect user to"}},"type":"object","required":["auth_url"],"title":"DataSourceAuthResponse","description":"Standard response for OAuth authorization URL endpoint.\n\nUsed by: GET /{platform}/auth"},"DataSourceDisconnectResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether disconnect was successful"},"message":{"type":"string","title":"Message","description":"Result message"}},"type":"object","required":["success","message"],"title":"DataSourceDisconnectResponse","description":"Standard response for disconnect endpoint.\n\nUsed by: DELETE /{platform}/disconnect or POST /{platform}/disconnect","example":{"message":"Shopify account disconnected successfully","success":true}},"DataSourceLocation":{"properties":{"id":{"type":"string","title":"Id","description":"Location ID"},"name":{"type":"string","title":"Name","description":"Location name"},"address":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Address","description":"Location address"},"status":{"type":"string","title":"Status","description":"Location status","default":"ACTIVE"},"currency":{"type":"string","title":"Currency","description":"Location currency","default":"USD"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone","description":"Location timezone"}},"type":"object","required":["id","name"],"title":"DataSourceLocation","description":"Location model for platforms with multiple locations.\n\nUsed by: Square, Shopify (locations)"},"DataSourceLocationsResponse":{"properties":{"accounts":{"items":{"$ref":"#/components/schemas/DataSourceLocation"},"type":"array","title":"Accounts","description":"List of locations/accounts"}},"type":"object","title":"DataSourceLocationsResponse","description":"Response for locations/accounts list endpoint.\n\nUsed by: GET /{platform}/accounts or GET /{platform}/locations"},"DataSourceTransactionsResponse":{"properties":{"transactions":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Transactions","description":"List of transactions"},"has_more":{"type":"boolean","title":"Has More","description":"Whether more transactions are available","default":false},"cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor","description":"Cursor for pagination"}},"type":"object","title":"DataSourceTransactionsResponse","description":"Response for transactions list endpoint.\n\nUsed by: GET /stripe/transactions, GET /square/payments"},"DaypartingHealthResponse":{"properties":{"ad_id":{"type":"string","title":"Ad Id"},"total_rules":{"type":"integer","title":"Total Rules"},"healthy_rules":{"items":{"type":"string"},"type":"array","title":"Healthy Rules"},"unhealthy_rules":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Unhealthy Rules"},"missing_rules":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Missing Rules"},"health_score":{"type":"number","title":"Health Score"}},"type":"object","required":["ad_id","total_rules","healthy_rules","unhealthy_rules","missing_rules","health_score"],"title":"DaypartingHealthResponse"},"DaypartingSlot":{"properties":{"day":{"type":"string","title":"Day","description":"Day of week (MONDAY, TUESDAY, etc.)"},"start_hour":{"type":"integer","maximum":23.0,"minimum":0.0,"title":"Start Hour"},"start_minute":{"type":"integer","maximum":59.0,"minimum":0.0,"title":"Start Minute"},"end_hour":{"type":"integer","maximum":23.0,"minimum":0.0,"title":"End Hour"},"end_minute":{"type":"integer","maximum":59.0,"minimum":0.0,"title":"End Minute"},"bid_modifier":{"anyOf":[{"type":"number","maximum":10.0,"minimum":0.1},{"type":"null"}],"title":"Bid Modifier","default":1.0}},"type":"object","required":["day","start_hour","start_minute","end_hour","end_minute"],"title":"DaypartingSlot"},"DeckExport":{"properties":{"pptx":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Pptx","default":false},"pdf":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Pdf","default":false}},"type":"object","title":"DeckExport"},"DeckFileDescriptor":{"properties":{"format":{"type":"string","title":"Format"},"filename":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filename"},"gcs_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gcs Url"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"},"signed_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signed Url"}},"type":"object","required":["format"],"title":"DeckFileDescriptor"},"DeckSection":{"properties":{"name":{"type":"string","title":"Name"},"target_slides":{"type":"integer","minimum":1.0,"title":"Target Slides","description":"Target slides in this section"},"must_include":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Must Include","default":false}},"type":"object","required":["name","target_slides"],"title":"DeckSection"},"DeckStatusResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"status":{"type":"string","title":"Status"},"ready":{"type":"boolean","title":"Ready"},"doc_id":{"type":"string","title":"Doc Id"},"doc_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Url"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"provider_response":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Provider Response"},"file_urls":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"File Urls"},"files":{"anyOf":[{"items":{"$ref":"#/components/schemas/DeckFileDescriptor"},"type":"array"},{"type":"null"}],"title":"Files"}},"type":"object","required":["success","status","ready","doc_id"],"title":"DeckStatusResponse"},"DeckStyle":{"properties":{"palette":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Palette"},"fonts":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Fonts"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"tone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tone"},"density":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Density"},"icon_style":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Icon Style"}},"type":"object","title":"DeckStyle"},"DeleteFileResponse":{"properties":{"id":{"type":"string","title":"Id"},"filename":{"type":"string","title":"Filename"},"message":{"type":"string","title":"Message"}},"type":"object","required":["id","filename","message"],"title":"DeleteFileResponse"},"DeletePostRequest":{"properties":{"post_id":{"type":"string","title":"Post Id"},"auth_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Auth Method","description":"Bound auth method: instagram or facebook"}},"type":"object","required":["post_id"],"title":"DeletePostRequest","description":"Request model for deleting an Instagram post."},"DeletePostResponseModel":{"properties":{"success":{"type":"boolean","title":"Success"}},"type":"object","required":["success"],"title":"DeletePostResponseModel","description":"Response model for Instagram post deletion."},"DeliveryResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"approved_proposal_id":{"type":"string","format":"uuid","title":"Approved Proposal Id"},"target_item_id":{"type":"string","format":"uuid","title":"Target Item Id"},"target_version":{"type":"integer","title":"Target Version"},"status":{"type":"string","title":"Status"},"definite_attempt_count":{"type":"integer","title":"Definite Attempt Count"},"external_reply_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Reply Id"},"safe_error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Safe Error Code"}},"type":"object","required":["id","approved_proposal_id","target_item_id","target_version","status","definite_attempt_count","external_reply_id","safe_error_code"],"title":"DeliveryResponse"},"DemoSchedulingConfirmation":{"properties":{"scheduled":{"type":"boolean","title":"Scheduled"}},"type":"object","required":["scheduled"],"title":"DemoSchedulingConfirmation"},"DirectorConsentRequest":{"properties":{"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"team_id":{"type":"string","format":"uuid","title":"Team Id"},"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"enabled":{"type":"boolean","title":"Enabled"},"conversation_mode":{"type":"string","enum":["selected_conversation","per_opportunity"],"title":"Conversation Mode","default":"selected_conversation"},"delivery":{"oneOf":[{"$ref":"#/components/schemas/DirectorWebDelivery"},{"$ref":"#/components/schemas/DirectorSlackDelivery"}],"title":"Delivery","discriminator":{"propertyName":"surface","mapping":{"both":"#/components/schemas/DirectorSlackDelivery","web":"#/components/schemas/DirectorWebDelivery"}}}},"additionalProperties":false,"type":"object","required":["organization_id","company_profile_id","team_id","conversation_id","enabled"],"title":"DirectorConsentRequest"},"DirectorInsightAlternativeResponse":{"properties":{"rival":{"type":"string","title":"Rival"},"would_show":{"type":"string","title":"Would Show"}},"type":"object","required":["rival","would_show"],"title":"DirectorInsightAlternativeResponse","description":"A rival explanation the evidence has not ruled out."},"DirectorInsightEvidenceResponse":{"properties":{"evidence_id":{"type":"string","title":"Evidence Id"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"source_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Agent"},"signal_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signal Type"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet"},"confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence"},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"},"freshness":{"additionalProperties":true,"type":"object","title":"Freshness"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"},"source_urls":{"items":{"type":"string"},"type":"array","title":"Source Urls"},"sources":{"items":{"$ref":"#/components/schemas/InsightSource"},"type":"array","title":"Sources"}},"type":"object","required":["evidence_id"],"title":"DirectorInsightEvidenceResponse"},"DirectorInsightExcludedFacetResponse":{"properties":{"facet":{"type":"string","maxLength":64,"title":"Facet"},"reason":{"type":"string","maxLength":160,"title":"Reason"},"availability":{"type":"string","const":"unavailable","title":"Availability","default":"unavailable"}},"type":"object","required":["facet","reason"],"title":"DirectorInsightExcludedFacetResponse"},"DirectorInsightMetricResponse":{"properties":{"metric_id":{"type":"string","title":"Metric Id"},"evidence_id":{"type":"string","title":"Evidence Id"},"label":{"type":"string","title":"Label"},"value":{"type":"number","maximum":1000000000000000.0,"minimum":-1000000000000000.0,"title":"Value"},"display_value":{"type":"string","title":"Display Value"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"},"window":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Window"},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"},"role":{"anyOf":[{"type":"string","enum":["decision","context"]},{"type":"null"}],"title":"Role"},"comparison_status":{"anyOf":[{"type":"string","enum":["absolute","comparative"]},{"type":"null"}],"title":"Comparison Status"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publisher"},"source_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Title"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"published_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Published Date"},"estimate":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Estimate"}},"type":"object","required":["metric_id","evidence_id","label","value","display_value"],"title":"DirectorInsightMetricResponse"},"DirectorInsightPackageResponse":{"properties":{"contract_version":{"type":"string","const":"director_insight_package_v1","title":"Contract Version"},"generated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Generated At"},"headline":{"type":"string","title":"Headline"},"executive_summary":{"type":"string","title":"Executive Summary"},"insight_yield":{"anyOf":[{"type":"string","const":"no_material_findings"},{"type":"null"}],"title":"Insight Yield"},"executive_summary_evidence_ids":{"items":{"type":"string"},"type":"array","title":"Executive Summary Evidence Ids"},"executive_summary_metric_ids":{"items":{"type":"string"},"type":"array","title":"Executive Summary Metric Ids"},"key_metrics":{"items":{"$ref":"#/components/schemas/DirectorInsightMetricResponse"},"type":"array","title":"Key Metrics"},"quantification_status":{"anyOf":[{"type":"string","enum":["quantified","qualitative","qualitative_no_decision_grade_metrics"]},{"type":"null"}],"title":"Quantification Status"},"quantification_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quantification Note"},"source_coverage":{"items":{"$ref":"#/components/schemas/DirectorInsightSourceCoverageResponse"},"type":"array","title":"Source Coverage"},"recommended_actions":{"items":{"$ref":"#/components/schemas/DirectorInsightRecommendedActionResponse"},"type":"array","title":"Recommended Actions"},"insights":{"items":{"$ref":"#/components/schemas/DirectorInsightResponse"},"type":"array","title":"Insights"},"synthesis_scope":{"anyOf":[{"type":"string","enum":["cross_source","multi_source_separate","single_source_only"]},{"type":"null"}],"title":"Synthesis Scope"},"structural_limitations":{"items":{"$ref":"#/components/schemas/DirectorInsightStructuralLimitationResponse"},"type":"array","maxItems":12,"title":"Structural Limitations"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"},"citations":{"items":{"type":"string"},"type":"array","title":"Citations"}},"type":"object","required":["contract_version","headline","executive_summary"],"title":"DirectorInsightPackageResponse"},"DirectorInsightRecommendedActionResponse":{"properties":{"insight_id":{"type":"string","title":"Insight Id"},"director_rank":{"anyOf":[{"type":"integer","maximum":5.0,"minimum":1.0},{"type":"null"}],"title":"Director Rank"},"title":{"type":"string","title":"Title"},"action":{"type":"string","title":"Action"},"action_type":{"anyOf":[{"type":"string","enum":["act_now","validate_next","monitor"]},{"type":"null"}],"title":"Action Type"},"priority":{"type":"string","title":"Priority"},"priority_rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority Rationale"},"why_now":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Why Now"},"measurement_plan":{"type":"string","title":"Measurement Plan"},"expected_kpi_impact":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Kpi Impact"},"evidence_ids":{"items":{"type":"string"},"type":"array","title":"Evidence Ids"}},"type":"object","required":["insight_id","title","action","priority","measurement_plan"],"title":"DirectorInsightRecommendedActionResponse"},"DirectorInsightResponse":{"properties":{"id":{"type":"string","title":"Id"},"director_rank":{"anyOf":[{"type":"integer","maximum":5.0,"minimum":1.0},{"type":"null"}],"title":"Director Rank"},"title":{"type":"string","title":"Title"},"summary":{"type":"string","title":"Summary"},"why_now":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Why Now"},"recommended_action":{"type":"string","title":"Recommended Action"},"action_type":{"anyOf":[{"type":"string","enum":["act_now","validate_next","monitor"]},{"type":"null"}],"title":"Action Type"},"measurement_plan":{"type":"string","title":"Measurement Plan"},"expected_kpi_impact":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Kpi Impact"},"priority":{"type":"string","title":"Priority"},"priority_rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority Rationale"},"priority_evidence_ids":{"items":{"type":"string"},"type":"array","title":"Priority Evidence Ids"},"confidence":{"anyOf":[{"type":"number"},{"type":"string","enum":["high","medium","low"]},{"type":"null"}],"title":"Confidence"},"confidence_label":{"anyOf":[{"type":"string","enum":["high","medium","low"]},{"type":"null"}],"title":"Confidence Label"},"confidence_rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence Rationale"},"overturned_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Overturned By"},"so_what":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"So What"},"presentation":{"anyOf":[{"$ref":"#/components/schemas/InsightPresentation"},{"type":"null"}]},"claim_type":{"anyOf":[{"type":"string","enum":["observation","inference"]},{"type":"null"}],"title":"Claim Type"},"alternatives":{"items":{"$ref":"#/components/schemas/DirectorInsightAlternativeResponse"},"type":"array","title":"Alternatives"},"belief_status":{"anyOf":[{"type":"string","enum":["read","hypothesis"]},{"type":"null"}],"title":"Belief Status"},"source_domains":{"items":{"type":"string"},"type":"array","title":"Source Domains"},"association_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Association Summary"},"action_evidence_ids":{"items":{"type":"string"},"type":"array","title":"Action Evidence Ids"},"supporting_points":{"items":{"type":"string"},"type":"array","title":"Supporting Points"},"supporting_point_evidence":{"items":{"$ref":"#/components/schemas/DirectorInsightSupportingPointResponse"},"type":"array","title":"Supporting Point Evidence"},"metric_ids":{"items":{"type":"string"},"type":"array","title":"Metric Ids"},"key_metrics":{"items":{"$ref":"#/components/schemas/DirectorInsightMetricResponse"},"type":"array","title":"Key Metrics"},"quantification_status":{"anyOf":[{"type":"string","enum":["quantified","qualitative","qualitative_no_decision_grade_metrics"]},{"type":"null"}],"title":"Quantification Status"},"quantification_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Quantification Note"},"evidence":{"items":{"$ref":"#/components/schemas/DirectorInsightEvidenceResponse"},"type":"array","title":"Evidence"},"citations":{"items":{"type":"string"},"type":"array","title":"Citations"}},"type":"object","required":["id","title","summary","recommended_action","measurement_plan","priority"],"title":"DirectorInsightResponse"},"DirectorInsightSourceCoverageResponse":{"properties":{"domain":{"type":"string","title":"Domain"},"evidence_count":{"type":"integer","title":"Evidence Count","default":0},"latest_observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Latest Observed At"}},"type":"object","required":["domain"],"title":"DirectorInsightSourceCoverageResponse"},"DirectorInsightStructuralLimitationResponse":{"properties":{"domain":{"type":"string","maxLength":80,"title":"Domain"},"source_agent_key":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Source Agent Key"},"availability":{"type":"string","enum":["unavailable","partially_unavailable"],"title":"Availability"},"reason":{"type":"string","maxLength":200,"title":"Reason"},"reading_supplied":{"type":"boolean","title":"Reading Supplied","default":false},"excluded_facets":{"items":{"$ref":"#/components/schemas/DirectorInsightExcludedFacetResponse"},"type":"array","maxItems":8,"title":"Excluded Facets"}},"type":"object","required":["domain","availability","reason"],"title":"DirectorInsightStructuralLimitationResponse","description":"One source surface that was not observable in this Director run."},"DirectorInsightSupportingPointResponse":{"properties":{"text":{"type":"string","title":"Text"},"evidence_ids":{"items":{"type":"string"},"type":"array","title":"Evidence Ids"}},"type":"object","required":["text"],"title":"DirectorInsightSupportingPointResponse"},"DirectorSlackDelivery":{"properties":{"surface":{"type":"string","const":"both","title":"Surface"},"slack_conversation_id":{"type":"string","format":"uuid","title":"Slack Conversation Id"}},"additionalProperties":false,"type":"object","required":["surface","slack_conversation_id"],"title":"DirectorSlackDelivery"},"DirectorWebDelivery":{"properties":{"surface":{"type":"string","const":"web","title":"Surface","default":"web"}},"additionalProperties":false,"type":"object","title":"DirectorWebDelivery"},"DisplayMetadata":{"properties":{"priority":{"anyOf":[{"type":"string","maxLength":500},{"type":"number"},{"type":"null"}],"title":"Priority"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"impact":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Impact"},"trend_direction":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Trend Direction"},"updated_at":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Updated At"},"relevant_product_id":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Relevant Product Id"},"relevant_product_name":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Relevant Product Name"},"relevant_product_image":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Relevant Product Image"}},"additionalProperties":false,"type":"object","title":"DisplayMetadata"},"DisplaySource":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Title"},"url":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Url"},"label":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Label"},"timestamp":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Timestamp"}},"additionalProperties":false,"type":"object","title":"DisplaySource"},"DmSourceCreateRequest":{"properties":{"social_media_integration_id":{"type":"string","format":"uuid","title":"Social Media Integration Id"},"page_id":{"type":"string","maxLength":255,"minLength":1,"title":"Page Id"},"page_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Page Name"},"idempotency_key":{"type":"string","maxLength":255,"minLength":8,"title":"Idempotency Key"},"activation_mode":{"type":"string","enum":["draft_only","active"],"title":"Activation Mode","default":"draft_only"}},"type":"object","required":["social_media_integration_id","page_id","idempotency_key"],"title":"DmSourceCreateRequest"},"DocumentJobDetailResponse":{"properties":{"id":{"type":"string","title":"Id"},"company_profile_id":{"type":"string","title":"Company Profile Id"},"doc_type":{"type":"string","title":"Doc Type"},"provider":{"type":"string","title":"Provider"},"provider_generation_id":{"type":"string","title":"Provider Generation Id"},"provider_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Status"},"provider_payload":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Provider Payload"},"inputs":{"additionalProperties":true,"type":"object","title":"Inputs"},"files":{"additionalProperties":true,"type":"object","title":"Files"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"ready_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ready At"}},"type":"object","required":["id","company_profile_id","doc_type","provider","provider_generation_id","provider_status","provider_payload","inputs","files","metadata","created_at","ready_at"],"title":"DocumentJobDetailResponse"},"DocumentJobListItem":{"properties":{"id":{"type":"string","title":"Id"},"doc_type":{"type":"string","title":"Doc Type"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"},"preset":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preset"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"provider_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Status"},"user_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Email"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"ready_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ready At"},"available_formats":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Available Formats"}},"type":"object","required":["id","doc_type","available_formats"],"title":"DocumentJobListItem"},"DocumentJobsResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/DocumentJobListItem"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["items","total"],"title":"DocumentJobsResponse"},"DomainConnectRequest":{"properties":{"hostname":{"type":"string","maxLength":253,"minLength":4,"title":"Hostname"}},"additionalProperties":false,"type":"object","required":["hostname"],"title":"DomainConnectRequest"},"DraftAuthoringRequirements":{"properties":{"min_word_count":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":30.0},{"type":"null"}],"title":"Min Word Count","description":"Inclusive hard minimum word count explicitly requested for this draft. Markdown-only markers are not words; Chinese, Japanese and Thai characters each count as one word."},"target_word_count":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":30.0},{"type":"null"}],"title":"Target Word Count","description":"Soft target chosen to interpret the requested length or qualitative brevity, within any explicitly supplied hard bounds. This does not invent a hard minimum or maximum."},"max_word_count":{"anyOf":[{"type":"integer","maximum":5000.0,"minimum":30.0},{"type":"null"}],"title":"Max Word Count","description":"Inclusive hard maximum word count explicitly requested for this draft. Markdown-only markers are not words; Chinese, Japanese and Thai characters each count as one word."}},"additionalProperties":false,"type":"object","title":"DraftAuthoringRequirements","description":"Explicit requested draft length; supplied bounds are authoring constraints."},"DraftCreatorOutreachMessageRequest":{"properties":{"channel":{"type":"string","enum":["email","platform_dm"],"title":"Channel"},"creator_name":{"type":"string","maxLength":255,"minLength":1,"title":"Creator Name"},"creator_handle":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Creator Handle"},"platform":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Platform"},"account_label":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Account Label"},"account_value":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Account Value"},"account_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Account Url"},"creator_bio":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Creator Bio"},"creator_category":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Creator Category"},"creator_location":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Creator Location"},"creator_audience":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Creator Audience"},"followers":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Followers"},"engagement":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Engagement"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified"},"product_offering_id":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Product Offering Id"},"campaign_theme":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Campaign Theme"},"campaign_idea":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Campaign Idea"},"instruction":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Instruction"},"current_subject":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Current Subject"},"current_message":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Current Message"}},"type":"object","required":["channel","creator_name"],"title":"DraftCreatorOutreachMessageRequest"},"DraftLeadFormEditRequest":{"properties":{"config_schema_version":{"type":"integer","const":1,"title":"Config Schema Version"},"config":{"$ref":"#/components/schemas/GoogleLeadFormConfigV1"},"expected_current_revision":{"type":"integer","minimum":0.0,"title":"Expected Current Revision"}},"additionalProperties":false,"type":"object","required":["config_schema_version","config","expected_current_revision"],"title":"DraftLeadFormEditRequest","description":"CAS-bound edit of canonical state before any provider application.\n\n``expected_current_revision`` is the caller's view of the canonical\nrevision: ``>= 1`` edits that exact draft revision, while ``0`` states\n\"no canonical form exists yet\" and attaches a fresh draft to the\ncampaign. A concurrent attach loses the CAS the same way a stale edit\ndoes."},"EarnedMediaContact":{"properties":{"name":{"type":"string","maxLength":220,"minLength":1,"title":"Name"},"title":{"anyOf":[{"type":"string","maxLength":220},{"type":"null"}],"title":"Title"},"email":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Phone"}},"additionalProperties":false,"type":"object","required":["name"],"title":"EarnedMediaContact"},"EarnedMediaCoverageUrlRequest":{"properties":{"url":{"type":"string","maxLength":2000,"minLength":8,"title":"Url"}},"additionalProperties":false,"type":"object","required":["url"],"title":"EarnedMediaCoverageUrlRequest","description":"One page a person already knows about."},"EarnedMediaDraftRewriteRequest":{"properties":{"base_version":{"type":"integer","minimum":1.0,"title":"Base Version"},"instruction":{"type":"string","maxLength":2500,"minLength":3,"title":"Instruction"},"scope":{"type":"string","enum":["full","section","selection"],"title":"Scope","default":"full"},"selected_text":{"anyOf":[{"type":"string","maxLength":12000},{"type":"null"}],"title":"Selected Text"},"section":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Section"},"additional_evidence_ids":{"items":{"type":"string","maxLength":200,"minLength":1},"type":"array","maxItems":40,"title":"Additional Evidence Ids"}},"additionalProperties":false,"type":"object","required":["base_version","instruction"],"title":"EarnedMediaDraftRewriteRequest"},"EarnedMediaDraftSaveRequest":{"properties":{"base_version":{"type":"integer","minimum":1.0,"title":"Base Version"},"headline":{"type":"string","maxLength":320,"minLength":1,"title":"Headline"},"dek":{"anyOf":[{"type":"string","maxLength":1200},{"type":"null"}],"title":"Dek"},"body_markdown":{"type":"string","maxLength":80000,"minLength":1,"title":"Body Markdown"},"locked_fields":{"additionalProperties":true,"type":"object","title":"Locked Fields"},"change_summary":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Change Summary"}},"additionalProperties":false,"type":"object","required":["base_version","headline","body_markdown"],"title":"EarnedMediaDraftSaveRequest"},"EarnedMediaGenerateRequest":{"properties":{"draft_count":{"type":"integer","enum":[1,2],"title":"Draft Count","default":2},"instruction":{"anyOf":[{"type":"string","maxLength":2500},{"type":"null"}],"title":"Instruction"},"authoring_requirements":{"anyOf":[{"$ref":"#/components/schemas/DraftAuthoringRequirements"},{"type":"null"}],"description":"Draft length belongs here: explicitly supplied numeric bounds or a soft target interpreting requested brevity. Instruction carries other editorial direction."}},"additionalProperties":false,"type":"object","title":"EarnedMediaGenerateRequest"},"EarnedMediaPressAsset":{"properties":{"label":{"type":"string","maxLength":220,"minLength":1,"title":"Label"},"url":{"type":"string","maxLength":2000,"minLength":8,"title":"Url"}},"additionalProperties":false,"type":"object","required":["label","url"],"title":"EarnedMediaPressAsset"},"EarnedMediaPressCoverageItem":{"properties":{"id":{"type":"string","maxLength":80,"minLength":1,"title":"Id"},"url":{"type":"string","maxLength":2000,"minLength":8,"title":"Url"},"title":{"type":"string","maxLength":320,"minLength":1,"title":"Title"},"outlet":{"type":"string","maxLength":220,"title":"Outlet","default":""},"summary":{"type":"string","maxLength":600,"title":"Summary","default":""},"published_on":{"type":"string","maxLength":40,"title":"Published On","default":""},"source_category":{"type":"string","maxLength":64,"title":"Source Category","default":"unknown"},"independence":{"type":"string","maxLength":32,"title":"Independence","default":"unknown"},"review_status":{"type":"string","enum":["suggested","verified","approved"],"title":"Review Status","default":"suggested"},"discovered_at":{"type":"string","maxLength":40,"title":"Discovered At","default":""},"added_by":{"type":"string","maxLength":16,"title":"Added By","default":""}},"additionalProperties":false,"type":"object","required":["id","url","title"],"title":"EarnedMediaPressCoverageItem","description":"A page that already exists about this brand."},"EarnedMediaPressQuote":{"properties":{"speaker_name":{"type":"string","maxLength":220,"minLength":1,"title":"Speaker Name"},"speaker_title":{"anyOf":[{"type":"string","maxLength":220},{"type":"null"}],"title":"Speaker Title"},"quote":{"type":"string","maxLength":2000,"minLength":20,"title":"Quote"},"approved_for_publication":{"type":"boolean","title":"Approved For Publication","default":true},"source_label":{"anyOf":[{"type":"string","maxLength":220},{"type":"null"}],"title":"Source Label"}},"additionalProperties":false,"type":"object","required":["speaker_name","quote"],"title":"EarnedMediaPressQuote","description":"A quote explicitly cleared by the brand for external publication."},"EarnedMediaPressRoom":{"properties":{"approved_for_publication":{"type":"boolean","title":"Approved For Publication","default":false},"announcement_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Announcement Date"},"dateline_city":{"anyOf":[{"type":"string","maxLength":220},{"type":"null"}],"title":"Dateline City"},"verified_facts":{"items":{"type":"string","maxLength":1200,"minLength":3},"type":"array","maxItems":20,"title":"Verified Facts"},"quotes":{"items":{"$ref":"#/components/schemas/EarnedMediaPressQuote"},"type":"array","maxItems":8,"title":"Quotes"},"boilerplate":{"anyOf":[{"type":"string","maxLength":2500},{"type":"null"}],"title":"Boilerplate"},"media_contact":{"anyOf":[{"$ref":"#/components/schemas/EarnedMediaContact"},{"type":"null"}]},"assets":{"items":{"$ref":"#/components/schemas/EarnedMediaPressAsset"},"type":"array","maxItems":12,"title":"Assets"},"verification_note":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Verification Note"}},"additionalProperties":false,"type":"object","title":"EarnedMediaPressRoom","description":"Brand-approved facts and assets kept out of public web search."},"EarnedMediaPressRoomAssetItem":{"properties":{"id":{"type":"string","maxLength":80,"minLength":1,"title":"Id"},"label":{"type":"string","maxLength":220,"minLength":1,"title":"Label"},"url":{"type":"string","maxLength":2000,"minLength":8,"title":"Url"},"review_status":{"type":"string","enum":["suggested","verified","approved"],"title":"Review Status","default":"suggested"},"source":{"anyOf":[{"$ref":"#/components/schemas/EarnedMediaPressRoomSource"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","label","url"],"title":"EarnedMediaPressRoomAssetItem"},"EarnedMediaPressRoomContactItem":{"properties":{"name":{"type":"string","maxLength":220,"minLength":1,"title":"Name"},"title":{"anyOf":[{"type":"string","maxLength":220},{"type":"null"}],"title":"Title"},"email":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Email"},"phone":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Phone"},"review_status":{"type":"string","enum":["suggested","verified","approved"],"title":"Review Status","default":"suggested"},"source":{"anyOf":[{"$ref":"#/components/schemas/EarnedMediaPressRoomSource"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["name"],"title":"EarnedMediaPressRoomContactItem"},"EarnedMediaPressRoomDateItem":{"properties":{"value":{"type":"string","format":"date","title":"Value"},"review_status":{"type":"string","enum":["suggested","verified","approved"],"title":"Review Status","default":"suggested"},"source":{"anyOf":[{"$ref":"#/components/schemas/EarnedMediaPressRoomSource"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["value"],"title":"EarnedMediaPressRoomDateItem"},"EarnedMediaPressRoomFactItem":{"properties":{"id":{"type":"string","maxLength":80,"minLength":1,"title":"Id"},"text":{"type":"string","maxLength":1200,"minLength":3,"title":"Text"},"review_status":{"type":"string","enum":["suggested","verified","approved"],"title":"Review Status","default":"suggested"},"source":{"anyOf":[{"$ref":"#/components/schemas/EarnedMediaPressRoomSource"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","text"],"title":"EarnedMediaPressRoomFactItem"},"EarnedMediaPressRoomGenerateRequest":{"properties":{"refresh":{"type":"boolean","title":"Refresh","default":false}},"additionalProperties":false,"type":"object","title":"EarnedMediaPressRoomGenerateRequest"},"EarnedMediaPressRoomProfileContent":{"properties":{"facts":{"items":{"$ref":"#/components/schemas/EarnedMediaPressRoomFactItem"},"type":"array","maxItems":20,"title":"Facts"},"quotes":{"items":{"$ref":"#/components/schemas/EarnedMediaPressRoomQuoteItem"},"type":"array","maxItems":8,"title":"Quotes"},"coverage":{"items":{"$ref":"#/components/schemas/EarnedMediaPressCoverageItem"},"type":"array","maxItems":24,"title":"Coverage"},"boilerplate":{"anyOf":[{"$ref":"#/components/schemas/EarnedMediaPressRoomTextItem"},{"type":"null"}]},"media_contact":{"anyOf":[{"$ref":"#/components/schemas/EarnedMediaPressRoomContactItem"},{"type":"null"}]},"assets":{"items":{"$ref":"#/components/schemas/EarnedMediaPressRoomAssetItem"},"type":"array","maxItems":12,"title":"Assets"},"announcement_date":{"anyOf":[{"$ref":"#/components/schemas/EarnedMediaPressRoomDateItem"},{"type":"null"}]},"dateline_city":{"anyOf":[{"$ref":"#/components/schemas/EarnedMediaPressRoomTextItem"},{"type":"null"}]},"verification_note":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Verification Note"}},"additionalProperties":false,"type":"object","title":"EarnedMediaPressRoomProfileContent","description":"Editable profile-level facts; only approved entries enter generated copy."},"EarnedMediaPressRoomQuoteItem":{"properties":{"id":{"type":"string","maxLength":80,"minLength":1,"title":"Id"},"speaker_name":{"type":"string","maxLength":220,"minLength":1,"title":"Speaker Name"},"speaker_title":{"anyOf":[{"type":"string","maxLength":220},{"type":"null"}],"title":"Speaker Title"},"quote":{"type":"string","maxLength":2000,"minLength":20,"title":"Quote"},"review_status":{"type":"string","enum":["suggested","verified","approved"],"title":"Review Status","default":"suggested"},"source":{"anyOf":[{"$ref":"#/components/schemas/EarnedMediaPressRoomSource"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["id","speaker_name","quote"],"title":"EarnedMediaPressRoomQuoteItem"},"EarnedMediaPressRoomSaveRequest":{"properties":{"content":{"$ref":"#/components/schemas/EarnedMediaPressRoomProfileContent"},"base_updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Base Updated At"}},"additionalProperties":false,"type":"object","required":["content"],"title":"EarnedMediaPressRoomSaveRequest"},"EarnedMediaPressRoomSource":{"properties":{"label":{"type":"string","maxLength":220,"minLength":1,"title":"Label"},"reference":{"type":"string","maxLength":300,"minLength":1,"title":"Reference"},"url":{"anyOf":[{"type":"string","maxLength":2000,"minLength":8},{"type":"null"}],"title":"Url"}},"additionalProperties":false,"type":"object","required":["label","reference"],"title":"EarnedMediaPressRoomSource"},"EarnedMediaPressRoomTextItem":{"properties":{"text":{"type":"string","maxLength":2500,"minLength":1,"title":"Text"},"review_status":{"type":"string","enum":["suggested","verified","approved"],"title":"Review Status","default":"suggested"},"source":{"anyOf":[{"$ref":"#/components/schemas/EarnedMediaPressRoomSource"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["text"],"title":"EarnedMediaPressRoomTextItem"},"EarnedMediaProjectCreateRequest":{"properties":{"title":{"type":"string","maxLength":220,"minLength":3,"title":"Title"},"story_format":{"type":"string","enum":["press_release","bylined_article","journalist_pitch","local_story"],"title":"Story Format","default":"bylined_article"},"objective":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Objective"},"audience":{"anyOf":[{"type":"string","maxLength":220},{"type":"null"}],"title":"Audience"},"market":{"anyOf":[{"type":"string","maxLength":220},{"type":"null"}],"title":"Market"},"primary_angle":{"anyOf":[{"type":"string","maxLength":2500},{"type":"null"}],"title":"Primary Angle"},"source_context":{"$ref":"#/components/schemas/EarnedMediaSourceContext"}},"additionalProperties":false,"type":"object","required":["title"],"title":"EarnedMediaProjectCreateRequest"},"EarnedMediaProjectUpdateRequest":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":220,"minLength":3},{"type":"null"}],"title":"Title"},"story_format":{"anyOf":[{"type":"string","enum":["press_release","bylined_article","journalist_pitch","local_story"]},{"type":"null"}],"title":"Story Format"},"objective":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Objective"},"audience":{"anyOf":[{"type":"string","maxLength":220},{"type":"null"}],"title":"Audience"},"market":{"anyOf":[{"type":"string","maxLength":220},{"type":"null"}],"title":"Market"},"primary_angle":{"anyOf":[{"type":"string","maxLength":2500},{"type":"null"}],"title":"Primary Angle"},"source_context":{"anyOf":[{"$ref":"#/components/schemas/EarnedMediaSourceContext"},{"type":"null"}]}},"additionalProperties":false,"type":"object","title":"EarnedMediaProjectUpdateRequest"},"EarnedMediaRefreshResearchRequest":{"properties":{"instruction":{"anyOf":[{"type":"string","maxLength":2500},{"type":"null"}],"title":"Instruction"},"operation":{"type":"string","enum":["research_refresh","outlet_discovery"],"title":"Operation","default":"research_refresh"},"outlet_focus":{"anyOf":[{"type":"string","enum":["general","trade","byline"]},{"type":"null"}],"title":"Outlet Focus"}},"additionalProperties":false,"type":"object","title":"EarnedMediaRefreshResearchRequest"},"EarnedMediaSelectedProduct":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","maxLength":220,"minLength":1,"title":"Name"}},"type":"object","required":["id","name"],"title":"EarnedMediaSelectedProduct","description":"Server-verified display snapshot for a selected product."},"EarnedMediaSourceContext":{"properties":{"public_research_topic":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Public Research Topic","description":"Optional public-safe topic for external journalist research. Do not include confidential launch plans or private story angles."},"article_scope":{"type":"string","enum":["company","single_product","product_portfolio"],"title":"Article Scope","default":"company"},"product_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":8,"title":"Product Ids"},"selected_products":{"items":{"$ref":"#/components/schemas/EarnedMediaSelectedProduct"},"type":"array","maxItems":8,"title":"Selected Products"},"press_room":{"anyOf":[{"$ref":"#/components/schemas/EarnedMediaPressRoom"},{"type":"null"}]}},"additionalProperties":true,"type":"object","title":"EarnedMediaSourceContext","description":"Typed article grounding while retaining existing workspace context keys."},"EarnedMediaTargetUpdateRequest":{"properties":{"status":{"anyOf":[{"type":"string","enum":["recommended","shortlisted","dismissed"]},{"type":"null"}],"title":"Status"},"outreach_status":{"anyOf":[{"type":"string","enum":["not_started","pitch_ready","contacted","follow_up_due","replied","interview","published","not_pursuing"]},{"type":"null"}],"title":"Outreach Status"},"last_contacted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Contacted At"},"next_follow_up_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Follow Up At"},"coverage_url":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Coverage Url"},"notes":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Notes"}},"additionalProperties":false,"type":"object","title":"EarnedMediaTargetUpdateRequest"},"EarnedMediaVersionRestoreRequest":{"properties":{"base_version":{"type":"integer","minimum":1.0,"title":"Base Version"}},"additionalProperties":false,"type":"object","required":["base_version"],"title":"EarnedMediaVersionRestoreRequest"},"EditApprovalRequest":{"properties":{"idempotency_key":{"type":"string","maxLength":255,"minLength":8,"title":"Idempotency Key"},"expected_target_version":{"type":"integer","minimum":1.0,"title":"Expected Target Version"},"expected_context_hash":{"type":"string","maxLength":64,"minLength":64,"title":"Expected Context Hash"},"expected_text_hash":{"type":"string","maxLength":64,"minLength":64,"title":"Expected Text Hash"},"text":{"type":"string","maxLength":1000,"minLength":1,"title":"Text"}},"type":"object","required":["idempotency_key","expected_target_version","expected_context_hash","expected_text_hash","text"],"title":"EditApprovalRequest"},"EditImageJobRequest":{"properties":{"image_url":{"type":"string","title":"Image Url"},"edit_prompt":{"type":"string","title":"Edit Prompt"},"num_variations":{"type":"integer","maximum":3.0,"minimum":1.0,"title":"Num Variations","default":3},"product_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Image Url"},"reference_image_urls":{"items":{"type":"string"},"type":"array","maxItems":6,"title":"Reference Image Urls"},"logo_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Image Url"},"campaign_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id"},"campaign_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Type"},"ad_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"},"idea_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Idea Number"},"variation":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Variation"},"use_company_style":{"type":"boolean","title":"Use Company Style","default":false},"request_identity":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Request Identity"},"requested_image_size":{"anyOf":[{"type":"string","enum":["1K","2K","4K"]},{"type":"null"}],"title":"Requested Image Size"},"required_text":{"anyOf":[{"items":{"type":"string","maxLength":1000,"minLength":1},"type":"array","maxItems":8},{"type":"null"}],"title":"Required Text"}},"type":"object","required":["image_url","edit_prompt"],"title":"EditImageJobRequest","description":"Request body for starting an async campaign image edit job"},"EmailCampaignCreate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"subject_line":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject Line"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"preview_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preview Text"},"call_to_action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Call To Action"},"target_audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Audience"},"key_selling_points":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key Selling Points"},"from_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From Name"},"reply_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reply To"},"product_offering_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id"},"workflow_status":{"anyOf":[{"$ref":"#/components/schemas/WorkflowStatus"},{"type":"null"}],"default":"draft"},"scheduled_send_time":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Scheduled Send Time"},"sent_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Sent At"},"personalization_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personalization Level","default":"medium"},"merge_variables":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Merge Variables"},"dynamic_blocks":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Dynamic Blocks"},"ab_test_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Ab Test Config"},"performance_metrics":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Performance Metrics"},"optimization_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Optimization Config"},"company_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Id"},"consumer_group_ids":{"anyOf":[{"items":{"type":"string","format":"uuid"},"type":"array"},{"type":"null"}],"title":"Consumer Group Ids"},"campaign_id":{"type":"string","title":"Campaign Id"},"idea_number":{"type":"integer","title":"Idea Number"},"variation":{"type":"integer","title":"Variation","default":0}},"type":"object","required":["campaign_id","idea_number"],"title":"EmailCampaignCreate"},"EmailCampaignImageCreate":{"properties":{"image_type":{"type":"string","title":"Image Type"},"image_url":{"type":"string","title":"Image Url"},"original_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Prompt"},"enhanced_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Enhanced Prompt"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"}},"type":"object","required":["image_type","image_url"],"title":"EmailCampaignImageCreate"},"EmailCampaignImageResponse":{"properties":{"image_type":{"type":"string","title":"Image Type"},"image_url":{"type":"string","title":"Image Url"},"original_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Prompt"},"enhanced_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Enhanced Prompt"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"email_campaign_id":{"type":"string","format":"uuid","title":"Email Campaign Id"},"creation_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creation Date"}},"type":"object","required":["image_type","image_url","id","email_campaign_id","creation_date"],"title":"EmailCampaignImageResponse"},"EmailCampaignResponse":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"subject_line":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject Line"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"preview_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preview Text"},"call_to_action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Call To Action"},"target_audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Audience"},"key_selling_points":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key Selling Points"},"from_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From Name"},"reply_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reply To"},"product_offering_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id"},"workflow_status":{"anyOf":[{"$ref":"#/components/schemas/WorkflowStatus"},{"type":"null"}],"default":"draft"},"scheduled_send_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scheduled Send Time"},"sent_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sent At"},"personalization_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personalization Level","default":"medium"},"merge_variables":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Merge Variables"},"dynamic_blocks":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Dynamic Blocks"},"ab_test_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Ab Test Config"},"performance_metrics":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Performance Metrics"},"optimization_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Optimization Config"},"company_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Id"},"consumer_group_ids":{"anyOf":[{"items":{"type":"string","format":"uuid"},"type":"array"},{"type":"null"}],"title":"Consumer Group Ids"},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"company_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Id"},"campaign_id":{"type":"string","title":"Campaign Id"},"idea_number":{"type":"integer","title":"Idea Number"},"variation":{"type":"integer","title":"Variation"},"total_recipients":{"type":"integer","title":"Total Recipients","default":0},"emails_sent":{"type":"integer","title":"Emails Sent","default":0},"emails_failed":{"type":"integer","title":"Emails Failed","default":0},"creation_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creation Date"},"last_modified":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Modified"},"images":{"items":{"$ref":"#/components/schemas/EmailCampaignImageResponse"},"type":"array","title":"Images","default":[]}},"type":"object","required":["id","company_profile_id","campaign_id","idea_number","variation","creation_date","last_modified"],"title":"EmailCampaignResponse"},"EmailSendReview":{"properties":{"kind":{"type":"string","const":"email_send","title":"Kind","default":"email_send"},"email_account_id":{"type":"string","format":"uuid","title":"Email Account Id"},"from_address":{"type":"string","maxLength":320,"minLength":3,"title":"From Address"},"from_display_name":{"type":"string","maxLength":255,"minLength":1,"title":"From Display Name"},"to_address":{"type":"string","maxLength":320,"minLength":3,"title":"To Address"},"recipient_name":{"type":"string","maxLength":240,"minLength":1,"title":"Recipient Name"},"person_ref":{"type":"string","pattern":"^b2b_prospect:[0-9a-f-]{36}$","title":"Person Ref"},"subject":{"type":"string","maxLength":160,"minLength":1,"title":"Subject"},"body_text":{"type":"string","maxLength":1200,"minLength":1,"title":"Body Text"}},"additionalProperties":false,"type":"object","required":["email_account_id","from_address","from_display_name","to_address","recipient_name","person_ref","subject","body_text"],"title":"EmailSendReview","description":"The complete immutable plain-text email a person is being asked to send."},"EngagementStatusResponse":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"can_manage":{"type":"boolean","title":"Can Manage","default":false},"can_respond":{"type":"boolean","title":"Can Respond","default":false},"provider":{"type":"string","title":"Provider","default":"facebook"},"surface":{"type":"string","title":"Surface","default":"public_comments"}},"type":"object","required":["enabled"],"title":"EngagementStatusResponse"},"EvidenceAccount":{"properties":{"platform":{"type":"string","enum":["instagram","tiktok","youtube","unknown"],"title":"Platform"},"account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Account Id"},"native_id":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Native Id"},"handle":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Handle"}},"additionalProperties":false,"type":"object","required":["platform"],"title":"EvidenceAccount"},"EvidenceSource":{"properties":{"key":{"type":"string","maxLength":120,"minLength":1,"title":"Key"},"status":{"type":"string","enum":["ok","partial","failed","unknown"],"title":"Status","default":"unknown"},"reference":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reference"},"fetched_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Fetched At"},"failure_code":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Failure Code"}},"additionalProperties":false,"type":"object","required":["key"],"title":"EvidenceSource"},"EvidenceWindow":{"properties":{"start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Start"},"end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"End"},"sample_size":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Sample Size"},"complete":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Complete"}},"additionalProperties":false,"type":"object","title":"EvidenceWindow"},"ExperimentArchiveRequest":{"properties":{"expected_revision":{"type":"integer","minimum":0.0,"title":"Expected Revision"},"archived":{"type":"boolean","title":"Archived"}},"additionalProperties":false,"type":"object","required":["expected_revision","archived"],"title":"ExperimentArchiveRequest"},"ExperimentDraft":{"properties":{"schema_version":{"type":"integer","const":1,"title":"Schema Version","default":1},"name":{"type":"string","maxLength":240,"title":"Name","default":""},"prompt":{"type":"string","maxLength":8000,"title":"Prompt","default":""},"question":{"type":"string","enum":["incremental_sales","compare_campaigns","compare_platforms","compare_locations"],"title":"Question","default":"incremental_sales"},"source_upload_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Upload Id"},"product_offering_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id"},"source_campaign_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Campaign Id"},"campaign_inputs":{"additionalProperties":{"$ref":"#/components/schemas/JsonValue"},"type":"object","title":"Campaign Inputs"}},"additionalProperties":false,"type":"object","title":"ExperimentDraft","description":"Full desired saved state, preserving normal campaign-builder inputs.\n\n``campaign_inputs`` is the builder's JSON snapshot, retained without a second\nlossy field projection. It is untrusted draft data and must never be replayed\nas provider arguments. Files must already have durable upload/gallery\nreferences; browser File objects and object URLs are not a durable draft."},"ExperimentDraftCreate":{"properties":{"request_id":{"type":"string","format":"uuid","title":"Request Id"},"draft":{"$ref":"#/components/schemas/ExperimentDraft"}},"additionalProperties":false,"type":"object","required":["request_id","draft"],"title":"ExperimentDraftCreate"},"ExperimentDraftSave":{"properties":{"expected_revision":{"type":"integer","minimum":1.0,"title":"Expected Revision"},"draft":{"$ref":"#/components/schemas/ExperimentDraft"}},"additionalProperties":false,"type":"object","required":["expected_revision","draft"],"title":"ExperimentDraftSave"},"ExperimentPackageCreateRequest":{"properties":{"opportunity_id":{"type":"string","maxLength":64,"minLength":1,"title":"Opportunity Id"},"budget_cap":{"anyOf":[{"type":"number","maximum":1000000.0,"minimum":50.0},{"type":"null"}],"title":"Budget Cap"},"duration_days":{"anyOf":[{"type":"integer","maximum":30.0,"minimum":7.0},{"type":"null"}],"title":"Duration Days"},"variant_count":{"anyOf":[{"type":"integer","maximum":3.0,"minimum":1.0},{"type":"null"}],"title":"Variant Count"},"gross_margin":{"anyOf":[{"type":"number","maximum":0.95,"minimum":0.1},{"type":"null"}],"title":"Gross Margin"},"variant_states":{"items":{"$ref":"#/components/schemas/FirstPartyExperimentVariantState"},"type":"array","maxItems":10,"title":"Variant States"},"removed_variant_ids":{"items":{"type":"string"},"type":"array","maxItems":10,"title":"Removed Variant Ids"},"variant_assets":{"items":{"$ref":"#/components/schemas/FirstPartyExperimentVariantAsset"},"type":"array","maxItems":10,"title":"Variant Assets"},"regenerate":{"type":"boolean","title":"Regenerate","default":false},"upload_id":{"type":"string","maxLength":64,"minLength":1,"title":"Upload Id"}},"type":"object","required":["opportunity_id","upload_id"],"title":"ExperimentPackageCreateRequest","description":"Persist a test package from a tuned preview."},"ExperimentReadoutFinancialInputs":{"properties":{"actual_spend":{"type":"number","minimum":0.0,"title":"Actual Spend"},"gross_margin":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Gross Margin"},"currency_code":{"type":"string","pattern":"^[A-Z]{3}$","title":"Currency Code"}},"additionalProperties":false,"type":"object","required":["actual_spend","gross_margin","currency_code"],"title":"ExperimentReadoutFinancialInputs","description":"Owner-reported costs for the same currency and window as the sales test."},"ExperimentReadoutRequest":{"properties":{"post_upload_id":{"type":"string","maxLength":64,"minLength":1,"title":"Post Upload Id"},"financial_inputs":{"anyOf":[{"$ref":"#/components/schemas/ExperimentReadoutFinancialInputs"},{"type":"null"}]}},"type":"object","required":["post_upload_id"],"title":"ExperimentReadoutRequest","description":"Pair a post-test sales upload to a package for the lift readout."},"ExternalAdMetadata":{"properties":{"platform":{"type":"string","title":"Platform"},"native_type":{"type":"string","title":"Native Type"},"performance_tier":{"type":"string","title":"Performance Tier"},"performance_reason":{"type":"string","title":"Performance Reason"},"attribution_scope":{"type":"string","title":"Attribution Scope"},"currency_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency Code"},"metrics":{"additionalProperties":true,"type":"object","title":"Metrics"},"benchmark":{"additionalProperties":true,"type":"object","title":"Benchmark"},"usage_count":{"type":"integer","title":"Usage Count"},"current_usage_count":{"type":"integer","title":"Current Usage Count","default":0},"historical_usage_count":{"type":"integer","title":"Historical Usage Count","default":0},"usages":{"items":{"$ref":"#/components/schemas/ExternalAdUsageMetadata"},"type":"array","title":"Usages"},"analysis":{"additionalProperties":true,"type":"object","title":"Analysis"}},"type":"object","required":["platform","native_type","performance_tier","performance_reason","attribution_scope","usage_count"],"title":"ExternalAdMetadata"},"ExternalAdUsageMetadata":{"properties":{"observation_id":{"type":"string","title":"Observation Id"},"platform":{"type":"string","title":"Platform"},"native_type":{"type":"string","title":"Native Type"},"account_id":{"type":"string","title":"Account Id"},"campaign_id":{"type":"string","title":"Campaign Id"},"campaign_name":{"type":"string","title":"Campaign Name"},"currency_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency Code"},"ad_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Group Id"},"ad_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"},"creative_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creative Id"},"creative_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creative Name"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"inventory_state":{"type":"string","title":"Inventory State","default":"current"},"media_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Media Role"},"provider_asset_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Asset Id"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"performance_tier":{"type":"string","title":"Performance Tier"},"performance_reason":{"type":"string","title":"Performance Reason"},"attribution_scope":{"type":"string","title":"Attribution Scope"},"metrics":{"additionalProperties":true,"type":"object","title":"Metrics"},"benchmark":{"additionalProperties":true,"type":"object","title":"Benchmark"},"metric_window":{"additionalProperties":true,"type":"object","title":"Metric Window"},"analysis":{"additionalProperties":true,"type":"object","title":"Analysis"}},"type":"object","required":["observation_id","platform","native_type","account_id","campaign_id","campaign_name","performance_tier","performance_reason","attribution_scope"],"title":"ExternalAdUsageMetadata"},"ExternalCampaignPatchRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":128,"minLength":1},{"type":"null"}],"title":"Name"},"status":{"anyOf":[{"type":"string","enum":["ACTIVE","PAUSED"]},{"type":"null"}],"title":"Status"},"daily_budget":{"anyOf":[{"type":"number","maximum":1000000.0,"exclusiveMinimum":0.0},{"type":"string"},{"type":"null"}],"title":"Daily Budget"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"dayparting_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Dayparting Config"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"long_headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Long Headline"},"long_headlines":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Long Headlines"},"headlines":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Headlines"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"descriptions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Descriptions"},"primary_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Text"},"business_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Name"},"call_to_action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Call To Action"},"final_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Final Url"},"destination_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Destination Url"},"ad_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Name"},"ad_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Text"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"landing_page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Landing Page Url"},"keywords":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Keywords"},"negative_keywords":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Negative Keywords"},"max_cpc":{"anyOf":[{"type":"number","maximum":1000000.0,"exclusiveMinimum":0.0},{"type":"string"},{"type":"null"}],"title":"Max Cpc"},"media":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Media"},"search_themes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Search Themes"},"targeting_optimization_mode":{"anyOf":[{"type":"string","enum":["AUTOMATIC","MANUAL"]},{"type":"null"}],"title":"Targeting Optimization Mode"},"suggestion_audience_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Suggestion Audience Enabled"},"targeting_spec":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Targeting Spec"},"advantage_audience_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Advantage Audience Enabled"},"advantage_creative_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Advantage Creative Enabled"},"meta_lead_form_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta Lead Form Config"},"resource_selection":{"anyOf":[{"$ref":"#/components/schemas/ExternalCampaignResourceSelection"},{"type":"null"}]},"expected_observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expected Observed At"}},"additionalProperties":false,"type":"object","title":"ExternalCampaignPatchRequest","description":"Sparse portable fields; native provider payloads are never replayed."},"ExternalCampaignResourceSelection":{"properties":{"ad_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Group Id"},"ad_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"},"ad_set_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Set Id"},"asset_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asset Group Id"},"creative_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creative Id"}},"additionalProperties":false,"type":"object","title":"ExternalCampaignResourceSelection","description":"Explicit provider resource targets for multi-entity campaign edits."},"ExternalCampaignSyncRequest":{"properties":{"platforms":{"items":{"type":"string","enum":["google","meta","tiktok","linkedin","chatgpt"]},"type":"array","minItems":1,"title":"Platforms"},"limit":{"type":"integer","maximum":200.0,"minimum":1.0,"title":"Limit","default":200},"metrics_lookback_days":{"type":"integer","maximum":90.0,"minimum":1.0,"title":"Metrics Lookback Days","default":30},"dry_run":{"type":"boolean","title":"Dry Run","default":false},"exhaustive":{"type":"boolean","title":"Exhaustive","default":false}},"additionalProperties":false,"type":"object","title":"ExternalCampaignSyncRequest","description":"Authenticated sync settings; profile scope only comes from auth context."},"ExternalCampaignSyncResponse":{"properties":{"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"metrics_lookback_days":{"type":"integer","title":"Metrics Lookback Days"},"dry_run":{"type":"boolean","title":"Dry Run"},"exhaustive":{"type":"boolean","title":"Exhaustive"},"results":{"items":{"$ref":"#/components/schemas/ExternalCampaignSyncResult"},"type":"array","title":"Results"}},"type":"object","required":["company_profile_id","metrics_lookback_days","dry_run","exhaustive","results"],"title":"ExternalCampaignSyncResponse"},"ExternalCampaignSyncResult":{"properties":{"platform":{"type":"string","title":"Platform"},"fetched":{"type":"integer","title":"Fetched"},"created":{"type":"integer","title":"Created"},"updated":{"type":"integer","title":"Updated"},"unchanged":{"type":"integer","title":"Unchanged"},"metric_facts":{"type":"integer","title":"Metric Facts"},"retired":{"type":"integer","title":"Retired"},"enumeration_complete":{"type":"boolean","title":"Enumeration Complete"},"enumeration_mode":{"type":"string","title":"Enumeration Mode"},"requested_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Requested Limit"},"status":{"type":"string","title":"Status","default":"succeeded"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["platform","fetched","created","updated","unchanged","metric_facts","retired","enumeration_complete","enumeration_mode","requested_limit"],"title":"ExternalCampaignSyncResult"},"FacebookPostCampaignRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id","description":"ID of campaign to publish"},"idea_number":{"type":"integer","title":"Idea Number","description":"Idea number for campaign row"},"page_id":{"type":"string","title":"Page Id","description":"Facebook page ID to publish to"},"page_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Name","description":"Facebook page name for posting identity display"},"variation":{"type":"integer","title":"Variation","description":"Variation number (default 0)","default":0},"expected_creative_state_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Creative State Token","description":"Server-issued creative fingerprint for approval-gated publication"}},"type":"object","required":["campaign_id","idea_number","page_id"],"title":"FacebookPostCampaignRequest"},"FacebookSocialActivateRequest":{"properties":{"page_id":{"type":"string","title":"Page Id","description":"Facebook Page ID to use for social publishing"}},"type":"object","required":["page_id"],"title":"FacebookSocialActivateRequest"},"Feedback":{"properties":{"feedback":{"anyOf":[{"type":"string","enum":["up","down"]},{"type":"null"}],"title":"Feedback"}},"additionalProperties":false,"type":"object","title":"Feedback"},"FeedbackArtifactResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"feedback_id":{"type":"string","title":"Feedback Id"},"artifact_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"gcs_url":{"type":"string","title":"Gcs Url"},"content_type":{"type":"string","title":"Content Type"},"byte_size":{"type":"integer","title":"Byte Size"},"sha256":{"type":"string","title":"Sha256"},"redaction_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Redaction Version"},"artifact_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Artifact Metadata"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["id","feedback_id","artifact_type","gcs_url","content_type","byte_size","sha256","created_at"],"title":"FeedbackArtifactResponse","description":"Response schema for metadata about a stored feedback artifact."},"FeedbackArtifactType":{"type":"string","enum":["screenshot","diagnostics_json"],"title":"FeedbackArtifactType","description":"Stored artifact types attached to a feedback submission."},"FeedbackBugReportResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"company_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Id"},"feedback_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"message":{"type":"string","title":"Message"},"page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Url"},"page_route":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Route"},"component_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Component Name"},"screenshot_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Screenshot Url"},"browser_info":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Browser Info"},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"severity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Severity"},"report_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Source"},"client_report_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Report Id"},"frontend_release":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Frontend Release"},"diagnostics_schema_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Diagnostics Schema Version"},"redaction_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Redaction Version"},"diagnostics_summary":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Diagnostics Summary"},"request_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Request Ids"},"console_error_count":{"type":"integer","title":"Console Error Count","default":0},"http_error_count":{"type":"integer","title":"Http Error Count","default":0},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"artifacts":{"items":{"$ref":"#/components/schemas/FeedbackArtifactResponse"},"type":"array","title":"Artifacts"}},"type":"object","required":["id","feedback_type","message","status","created_at"],"title":"FeedbackBugReportResponse","description":"Response schema for rich bug reports."},"FeedbackCreate":{"properties":{"feedback_type":{"$ref":"#/components/schemas/FeedbackType","description":"Type of feedback: bug, feature, or general"},"message":{"type":"string","maxLength":5000,"minLength":1,"title":"Message","description":"The feedback message content"},"page_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Page Url","description":"Full URL where feedback was submitted"},"page_route":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Page Route","description":"React route path where feedback was submitted"},"component_name":{"anyOf":[{"type":"string","maxLength":256},{"type":"null"}],"title":"Component Name","description":"Name of the component where feedback was triggered"},"screenshot_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Screenshot Url","description":"URL of the uploaded screenshot"},"browser_info":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Browser Info","description":"Browser and device metadata"}},"type":"object","required":["feedback_type","message"],"title":"FeedbackCreate","description":"Request schema for creating new feedback."},"FeedbackListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/FeedbackResponse"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["items","total","page","page_size","has_more"],"title":"FeedbackListResponse","description":"Response schema for listing feedback."},"FeedbackResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"company_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Id"},"feedback_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"message":{"type":"string","title":"Message"},"page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Url"},"page_route":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Route"},"component_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Component Name"},"screenshot_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Screenshot Url"},"browser_info":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Browser Info"},"status":{"anyOf":[{"type":"string"},{"type":"null"}]},"severity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Severity"},"report_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Source"},"client_report_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Report Id"},"frontend_release":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Frontend Release"},"diagnostics_schema_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Diagnostics Schema Version"},"redaction_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Redaction Version"},"diagnostics_summary":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Diagnostics Summary"},"request_ids":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Request Ids"},"console_error_count":{"type":"integer","title":"Console Error Count","default":0},"http_error_count":{"type":"integer","title":"Http Error Count","default":0},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","feedback_type","message","status","created_at"],"title":"FeedbackResponse","description":"Response schema for feedback data."},"FeedbackStatus":{"type":"string","enum":["new","reviewed","in_progress","resolved","closed"],"title":"FeedbackStatus","description":"Status of the feedback for internal tracking."},"FeedbackType":{"type":"string","enum":["bug","feature","general","churn"],"title":"FeedbackType","description":"Type of feedback submitted by the user."},"FinalizeRegistrationRequest":{"properties":{"selected_plan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Plan"},"billing_interval":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Interval"}},"type":"object","title":"FinalizeRegistrationRequest","description":"Finalize registration by marking status complete and recording selected plan."},"FinalizeSocialVideoCampaignItem":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id","description":"Draft social campaign ID to finalize"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform","description":"Platform key (instagram, facebook, linkedin)"},"post_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Post Type","description":"Social post type"},"media_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Media Type","description":"Media type for this finalize item","default":"video"},"video_duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Video Duration","description":"Requested video duration for this social draft"},"video_quality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Quality","description":"Requested video quality for this social draft"},"ugc_style_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ugc Style Enabled","description":"Whether this social draft campaign should use creator-led UGC-style video guidance"},"use_fast_model":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use Fast Model","description":"Whether this social draft campaign should use the Gemini fast video model (lite + 1080p)"},"draft_ads":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Draft Ads","description":"Client-provided social draft ads"},"modified_prompts":{"anyOf":[{"additionalProperties":{"$ref":"#/components/schemas/StructuredVideoPromptModel"},"type":"object"},{"type":"null"}],"title":"Modified Prompts","description":"Optional map of draft_ad_id to edited structured video prompt"}},"type":"object","required":["campaign_id"],"title":"FinalizeSocialVideoCampaignItem"},"FinalizeSocialVideosRequest":{"properties":{"video_campaigns":{"items":{"$ref":"#/components/schemas/FinalizeSocialVideoCampaignItem"},"type":"array","title":"Video Campaigns","description":"Draft social video campaigns to finalize"},"deferred_platform_configs":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Deferred Platform Configs","description":"Deferred non-video platform configs to generate after video finalize"},"provided_media_assets":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Provided Media Assets","description":"User-provided media assets to use for deferred social creative"},"num_posts":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Posts","description":"Number of posts per deferred platform","default":3},"reference_images":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reference Images","description":"Reference image data URLs"},"creative_references":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Creative References"},"campaign_template":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Campaign Template","description":"Zero or one template selected by id"},"use_brand_style":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use Brand Style","description":"Apply brand style constraints","default":true},"video_duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Video Duration","description":"Fallback video duration for social video finalize"},"video_quality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Quality","description":"Default video quality for social videos","default":"1080p"},"ugc_style_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ugc Style Enabled","description":"Whether to steer generated social videos and seed images toward creator-led UGC style","default":false},"use_fast_model":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use Fast Model","description":"Whether to use the Gemini fast video model (lite + 1080p) for finalized social videos","default":false},"batch_campaign_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Batch Campaign Id","description":"Optional batch campaign id"},"campaign_opportunity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Campaign Opportunity Id","description":"Trusted competitor campaign opportunity UUID returned by the draft job"},"execution_settings_job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Settings Job Id","description":"Accepted campaign-ideas job whose deferred fields this finalize must honor"},"execution_settings_draft_identity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Settings Draft Identity","description":"Builder draft identity bound to the accepted execution-settings receipt"},"user_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Prompt","description":"Original user prompt/product description"},"target_audience":{"anyOf":[{"type":"string"},{"additionalProperties":true,"type":"object"},{"items":{},"type":"array"},{"type":"null"}],"title":"Target Audience","description":"Target audience description"},"product_offering_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id","description":"Product offering ID"},"product_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Description","description":"Deprecated: use user_prompt"},"target_audience_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"items":{},"type":"array"},{"type":"null"}],"title":"Target Audience Json","description":"Deprecated: derive from target_audience"}},"type":"object","title":"FinalizeSocialVideosRequest"},"FinalizeVideoCampaignItem":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id","description":"Draft campaign ID to finalize"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform","description":"Target platform for this draft campaign"},"video_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Video Length","description":"Video duration is fixed at 10 seconds for this draft campaign"},"video_quality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Quality","description":"Requested video quality for this draft campaign"},"ugc_style_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ugc Style Enabled","description":"Whether this draft campaign should use creator-led UGC-style video guidance"},"use_fast_model":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use Fast Model","description":"Whether this draft campaign should use the Gemini fast video model (lite + 1080p)"},"draft_ads":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Draft Ads","description":"Client-provided draft ads for this campaign"},"modified_prompts":{"anyOf":[{"additionalProperties":{"$ref":"#/components/schemas/StructuredVideoPromptModel"},"type":"object"},{"type":"null"}],"title":"Modified Prompts","description":"Optional map of ad_id to edited structured video prompt"},"lead_form_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Lead Form Enabled","description":"Legacy non-Google item field retained only for scoped validation"},"lead_forms_by_ad_type":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Lead Forms By Ad Type","description":"Legacy non-Google item field retained only for scoped validation"}},"type":"object","required":["campaign_id"],"title":"FinalizeVideoCampaignItem"},"FinalizeVideoRequest":{"properties":{"modified_prompts":{"anyOf":[{"additionalProperties":{"$ref":"#/components/schemas/StructuredVideoPromptModel"},"type":"object"},{"type":"null"}],"title":"Modified Prompts","description":"Optional map of ad_id to edited structured video prompt"},"draft_ads":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Draft Ads","description":"Optional client-provided draft ads (images/prompts)"},"user_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Prompt","description":"Original user prompt/product description"},"target_audience":{"anyOf":[{"type":"string"},{"additionalProperties":true,"type":"object"},{"items":{},"type":"array"},{"type":"null"}],"title":"Target Audience","description":"Target audience description"},"locations":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Locations","description":"Structured target locations"},"product_offering_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id","description":"Product offering ID"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country for geo targeting"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province","description":"State/Province for geo targeting"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"City for geo targeting"},"campaign_goals":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Campaign Goals","description":"Optional campaign goals"},"key_selling_points":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key Selling Points","description":"Optional key selling points"},"bid_strategy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bid Strategy","description":"Optional bidding strategy"},"budget_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Budget Range","description":"Optional budget range"},"budget_allocation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Budget Allocation"},"budget_constraints":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Budget Constraints"},"campaign_timing":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Campaign Timing"},"dayparting_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dayparting Enabled","default":false},"dayparting_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Dayparting Config"},"target_platforms":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Target Platforms","description":"Requested platforms for this finalize action"},"lead_forms_by_platform_type":{"anyOf":[{"additionalProperties":{"$ref":"#/components/schemas/LeadFormRequestEntry"},"type":"object"},{"type":"null"}],"title":"Lead Forms By Platform Type","description":"Lead form settings keyed by exact platform type"},"lead_form_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Lead Form Enabled","description":"Legacy Meta/LinkedIn finalize flag; forbidden for Google Search"},"lead_forms_by_ad_type":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Lead Forms By Ad Type","description":"Legacy Meta/LinkedIn finalize config; forbidden for Google Search"},"video_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Video Length","description":"Video duration is fixed at 10 seconds"},"video_quality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Quality","description":"Requested video quality for this finalize action","default":"1080p"},"provided_media_assets":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Provided Media Assets","description":"User-provided media assets to use instead of generating primary video/image creative"},"campaign_opportunity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Campaign Opportunity Id","description":"Trusted competitor campaign opportunity UUID returned by the draft job"},"execution_settings_job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Settings Job Id","description":"Accepted campaign-ideas job whose deferred fields this finalize must honor"},"execution_settings_draft_identity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Settings Draft Identity","description":"Builder draft identity bound to the accepted execution-settings receipt"},"ugc_style_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ugc Style Enabled","description":"Whether to steer the generated video and seed image toward creator-led UGC style","default":false},"use_fast_model":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use Fast Model","description":"Whether to use the Gemini fast video model (lite + 1080p) for video generation","default":false},"product_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Description","description":"Deprecated: use user_prompt"},"target_locations":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Target Locations","description":"Deprecated: use locations"},"target_audience_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"items":{},"type":"array"},{"type":"null"}],"title":"Target Audience Json","description":"Deprecated: derive from target_audience"}},"additionalProperties":false,"type":"object","title":"FinalizeVideoRequest"},"FinalizeVideosRequest":{"properties":{"video_campaigns":{"items":{"$ref":"#/components/schemas/FinalizeVideoCampaignItem"},"type":"array","title":"Video Campaigns","description":"Draft video campaigns to finalize"},"non_video_platforms":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Non Video Platforms","description":"Non-video platforms to generate after video finalize"},"target_platforms":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Target Platforms","description":"Original requested platforms (used to derive non-video)"},"platform_sub_formats":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Platform Sub Formats","description":"Platform-specific creative mode selections from the original request"},"num_ads":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Ads","description":"Number of ads per non-video platform"},"num_images_per_ad":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Num Images Per Ad","description":"Images per non-video ad"},"reference_images":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reference Images","description":"Reference image data URLs"},"creative_references":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Creative References"},"campaign_template":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Campaign Template","description":"Zero or one template selected by id"},"provided_media_assets":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Provided Media Assets","description":"User-provided media assets to use instead of generating primary video/image creative"},"lead_forms_by_platform_type":{"anyOf":[{"additionalProperties":{"$ref":"#/components/schemas/LeadFormRequestEntry"},"type":"object"},{"type":"null"}],"title":"Lead Forms By Platform Type","description":"Lead form settings keyed by exact platform type"},"lead_form_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Lead Form Enabled","description":"Legacy Meta/LinkedIn finalize flag; forbidden for Google Search"},"lead_forms_by_ad_type":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Lead Forms By Ad Type","description":"Legacy Meta/LinkedIn finalize config; forbidden for Google Search"},"max_cpc":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Cpc","description":"Max CPC for manual bidding"},"objective":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Objective","description":"Campaign objective"},"ad_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Format","description":"Ad format"},"video_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Video Length","description":"Video duration is fixed at 10 seconds for video platforms"},"video_lengths":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Video Lengths","description":"Optional map of platform ids to video duration; values are normalized to 10 seconds"},"video_quality":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Quality","description":"Default video quality for video platforms","default":"1080p"},"video_qualities":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Video Qualities","description":"Optional map of platform ids to requested video quality"},"ugc_style_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ugc Style Enabled","description":"Whether to steer generated videos and seed images toward creator-led UGC style","default":false},"use_fast_model":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Use Fast Model","description":"Whether to use the Gemini fast video model (lite + 1080p) for finalized videos","default":false},"user_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Prompt","description":"Original user prompt/product description"},"target_audience":{"anyOf":[{"type":"string"},{"additionalProperties":true,"type":"object"},{"items":{},"type":"array"},{"type":"null"}],"title":"Target Audience","description":"Target audience description"},"locations":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Locations","description":"Structured target locations"},"product_offering_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id","description":"Product offering ID"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Country for geo targeting"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province","description":"State/Province for geo targeting"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"City for geo targeting"},"campaign_goals":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Campaign Goals","description":"Optional campaign goals"},"key_selling_points":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key Selling Points","description":"Optional key selling points"},"bid_strategy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bid Strategy","description":"Optional bidding strategy"},"budget_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Budget Range","description":"Optional budget range"},"budget_allocation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Budget Allocation"},"budget_constraints":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Budget Constraints"},"campaign_timing":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Campaign Timing"},"dayparting_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dayparting Enabled","default":false},"dayparting_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Dayparting Config"},"campaign_opportunity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Campaign Opportunity Id","description":"Trusted competitor campaign opportunity UUID returned by the draft job"},"execution_settings_job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Settings Job Id","description":"Accepted campaign-ideas job whose deferred fields this finalize must honor"},"execution_settings_draft_identity":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Execution Settings Draft Identity","description":"Builder draft identity bound to the accepted execution-settings receipt"},"product_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Description","description":"Deprecated: use user_prompt"},"target_locations":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Target Locations","description":"Deprecated: use locations"},"target_audience_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"items":{},"type":"array"},{"type":"null"}],"title":"Target Audience Json","description":"Deprecated: derive from target_audience"}},"additionalProperties":false,"type":"object","title":"FinalizeVideosRequest"},"FindingDismissRequest":{"properties":{"client_request_id":{"type":"string","format":"uuid","title":"Client Request Id"}},"additionalProperties":false,"type":"object","required":["client_request_id"],"title":"FindingDismissRequest"},"FirstPartyBuyerTargetRequest":{"properties":{"unit_per_store_per_week":{"anyOf":[{"type":"number","maximum":100000.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Unit Per Store Per Week"},"source":{"anyOf":[{"type":"string","maxLength":240,"minLength":2},{"type":"null"}],"title":"Source"},"as_of":{"anyOf":[{"type":"string","maxLength":32},{"type":"null"}],"title":"As Of"}},"type":"object","title":"FirstPartyBuyerTargetRequest","description":"The velocity a retail buyer actually expects, as stated by the marketer.\n\nThis is the one number on the sales surface that no file contains and no\nmodel can infer. A buyer's hurdle rate is a commercial term one retailer\nimposed on one brand in one review cycle, so it arrives by being typed, and\nevery figure downstream of it is only as good as its provenance.\n\n`source` is therefore REQUIRED and not defaulted. A target with no stated\norigin is indistinguishable, three months later, from a number somebody\nguessed, and it drives the gap and the size of the prize on a screen a\nmarketer quotes to that same buyer.\n\nSend `unit_per_store_per_week: null` to clear the target and fall back to\nthe modelled percentile."},"FirstPartyCoveragePolicyRequest":{"properties":{"minimum_weeks":{"type":"number","maximum":52.0,"minimum":0.5,"title":"Minimum Weeks","default":5.0},"reorder_trigger_weeks":{"type":"number","maximum":52.0,"minimum":0.5,"title":"Reorder Trigger Weeks","default":6.0},"target_weeks":{"type":"number","maximum":104.0,"minimum":0.5,"title":"Target Weeks","default":8.0},"run_rate_window_weeks":{"type":"integer","maximum":13.0,"minimum":1.0,"title":"Run Rate Window Weeks","default":4},"consumption_upload_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Consumption Upload Id"},"inventory_upload_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Inventory Upload Id"},"shipment_upload_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Shipment Upload Id"},"retailer_account":{"anyOf":[{"type":"string","maxLength":240},{"type":"null"}],"title":"Retailer Account"},"shipment_customer":{"anyOf":[{"type":"string","maxLength":240},{"type":"null"}],"title":"Shipment Customer"}},"type":"object","title":"FirstPartyCoveragePolicyRequest","description":"Retail coverage thresholds applied to a POS + inventory workspace."},"FirstPartyExperimentPackageRequest":{"properties":{"opportunity_id":{"type":"string","maxLength":64,"minLength":1,"title":"Opportunity Id"},"budget_cap":{"anyOf":[{"type":"number","maximum":1000000.0,"minimum":50.0},{"type":"null"}],"title":"Budget Cap"},"duration_days":{"anyOf":[{"type":"integer","maximum":30.0,"minimum":7.0},{"type":"null"}],"title":"Duration Days"},"variant_count":{"anyOf":[{"type":"integer","maximum":3.0,"minimum":1.0},{"type":"null"}],"title":"Variant Count"},"gross_margin":{"anyOf":[{"type":"number","maximum":0.95,"minimum":0.1},{"type":"null"}],"title":"Gross Margin"},"variant_states":{"items":{"$ref":"#/components/schemas/FirstPartyExperimentVariantState"},"type":"array","maxItems":10,"title":"Variant States"},"removed_variant_ids":{"items":{"type":"string"},"type":"array","maxItems":10,"title":"Removed Variant Ids"},"variant_assets":{"items":{"$ref":"#/components/schemas/FirstPartyExperimentVariantAsset"},"type":"array","maxItems":10,"title":"Variant Assets"},"regenerate":{"type":"boolean","title":"Regenerate","default":false}},"type":"object","required":["opportunity_id"],"title":"FirstPartyExperimentPackageRequest","description":"Full desired state for a stateless experiment-package recompute."},"FirstPartyExperimentVariantAsset":{"properties":{"id":{"type":"string","maxLength":64,"minLength":1,"title":"Id"},"image_url":{"type":"string","maxLength":2048,"minLength":1,"title":"Image Url"},"media_type":{"type":"string","maxLength":24,"title":"Media Type","default":"image"},"asset_source":{"type":"string","maxLength":24,"title":"Asset Source","default":"generated"},"width":{"anyOf":[{"type":"integer","maximum":20000.0,"minimum":1.0},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer","maximum":20000.0,"minimum":1.0},{"type":"null"}],"title":"Height"}},"type":"object","required":["id","image_url"],"title":"FirstPartyExperimentVariantAsset","description":"Client-chosen creative image for one preview variant.\n\nSent as a DELTA keyed by the stable variant id: the server rebuilds the plan\nfrom the stored upload on every recompute/persist, so the chosen (generated,\nuploaded, or edited) image must be merged back onto the matching variant."},"FirstPartyExperimentVariantState":{"properties":{"id":{"type":"string","maxLength":64,"minLength":1,"title":"Id"},"locked":{"type":"boolean","title":"Locked","default":false},"alternate_index":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Alternate Index","default":0}},"type":"object","required":["id"],"title":"FirstPartyExperimentVariantState","description":"Client-held state for one preview variant."},"FirstPartyGroundingPreferenceRequest":{"properties":{"use_sales_grounding":{"type":"boolean","title":"Use Sales Grounding"}},"type":"object","required":["use_sales_grounding"],"title":"FirstPartyGroundingPreferenceRequest","description":"Set whether cross-lane recommendations may ground in sales uploads."},"FirstPartyGroundingPreferenceResponse":{"properties":{"use_sales_grounding":{"type":"boolean","title":"Use Sales Grounding"}},"type":"object","required":["use_sales_grounding"],"title":"FirstPartyGroundingPreferenceResponse","description":"The profile's persisted grounding preference (missing row means on)."},"FirstPartyRetailerLabelRequest":{"properties":{"retailer_label":{"type":"string","maxLength":240,"minLength":1,"title":"Retailer Label"}},"type":"object","required":["retailer_label"],"title":"FirstPartyRetailerLabelRequest","description":"The sales channel a workspace belongs to, as filed by the marketer.\n\nFiling is a user assertion, so it overwrites whatever the filename\ndetection or an imported prior workspace claimed - the dialog that sends\nthis carries that warning. It is deliberately free text rather than an enum\nof known retailers: the alias table only names channels we can recognize in\na filename, and a marketer's channel list is longer than ours."},"FirstPartySkuBreakdownItem":{"properties":{"label":{"type":"string","title":"Label"},"total_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Revenue"},"sold_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sold Units"},"transactions":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Transactions"},"shipped_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Shipped Units"},"open_order_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Open Order Units"},"other_order_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Other Order Units"},"on_hand_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"On Hand Units"},"share_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Share Pct"}},"type":"object","required":["label"],"title":"FirstPartySkuBreakdownItem"},"FirstPartySkuDetailResponse":{"properties":{"upload_id":{"type":"string","title":"Upload Id"},"sku_key":{"type":"string","title":"Sku Key"},"sku":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sku"},"product_name":{"type":"string","title":"Product Name"},"offering_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offering Id"},"offering_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offering Name"},"source_types":{"items":{"type":"string"},"type":"array","title":"Source Types"},"available_metrics":{"items":{"type":"string"},"type":"array","title":"Available Metrics"},"total_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Revenue"},"sold_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sold Units"},"units_per_store_week":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Units Per Store Week"},"shipped_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Shipped Units"},"open_order_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Open Order Units"},"on_hand_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"On Hand Units"},"latest_period":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Latest Period"},"revenue_share_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Revenue Share Pct"},"units_share_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Units Share Pct"},"pos":{"anyOf":[{"$ref":"#/components/schemas/FirstPartySkuPosDetail"},{"type":"null"}]},"shipments":{"anyOf":[{"$ref":"#/components/schemas/FirstPartySkuShipmentDetail"},{"type":"null"}]},"inventory":{"anyOf":[{"$ref":"#/components/schemas/FirstPartySkuInventoryDetail"},{"type":"null"}]},"linked_sources":{"items":{"type":"string"},"type":"array","title":"Linked Sources"},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence"},"legacy_data_unavailable":{"type":"boolean","title":"Legacy Data Unavailable","default":false},"legacy_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legacy Reason"}},"type":"object","required":["upload_id","sku_key","product_name"],"title":"FirstPartySkuDetailResponse","description":"Evidence-labelled SKU 360 view assembled from eligible profile uploads."},"FirstPartySkuInventoryDetail":{"properties":{"on_hand_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"On Hand Units"},"weeks_of_supply":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Weeks Of Supply"},"as_of_start":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"As Of Start"},"as_of_end":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"As Of End"},"as_of_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"As Of Date"},"reorder_trigger_weeks":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Reorder Trigger Weeks"},"target_weeks":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Target Weeks"},"status":{"anyOf":[{"type":"string","enum":["inventory_needed","run_rate_needed","below_minimum","reorder_now","covered","above_target"]},{"type":"null"}],"title":"Status"},"coverage_policy_source":{"type":"string","enum":["configured","default_reference"],"title":"Coverage Policy Source"},"top_retailers":{"items":{"$ref":"#/components/schemas/FirstPartySkuBreakdownItem"},"type":"array","title":"Top Retailers"}},"type":"object","required":["coverage_policy_source"],"title":"FirstPartySkuInventoryDetail"},"FirstPartySkuListItem":{"properties":{"sku_key":{"type":"string","title":"Sku Key"},"sku":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sku"},"product_name":{"type":"string","title":"Product Name"},"offering_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offering Id"},"offering_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offering Name"},"source_types":{"items":{"type":"string"},"type":"array","title":"Source Types"},"available_metrics":{"items":{"type":"string"},"type":"array","title":"Available Metrics"},"total_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Revenue"},"sold_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sold Units"},"units_per_store_week":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Units Per Store Week"},"shipped_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Shipped Units"},"open_order_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Open Order Units"},"on_hand_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"On Hand Units"},"latest_period":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Latest Period"},"revenue_share_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Revenue Share Pct"},"units_share_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Units Share Pct"}},"type":"object","required":["sku_key","product_name"],"title":"FirstPartySkuListItem","description":"Compact SKU 360 row returned by the paginated workspace endpoint."},"FirstPartySkuListResponse":{"properties":{"upload_id":{"type":"string","title":"Upload Id"},"dataset_category":{"type":"string","title":"Dataset Category"},"page":{"type":"integer","title":"Page"},"page_size":{"type":"integer","title":"Page Size"},"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/FirstPartySkuListItem"},"type":"array","title":"Items"},"legacy_data_unavailable":{"type":"boolean","title":"Legacy Data Unavailable","default":false},"legacy_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legacy Reason"}},"type":"object","required":["upload_id","dataset_category","page","page_size","total"],"title":"FirstPartySkuListResponse","description":"Paginated SKU 360 directory for one workspace context."},"FirstPartySkuPosDetail":{"properties":{"total_revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Revenue"},"sold_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sold Units"},"transactions":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Transactions"},"average_units_per_week":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Average Units Per Week"},"units_per_store_week":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Units Per Store Week"},"revenue_share_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Revenue Share Pct"},"units_share_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Units Share Pct"},"weekly_trend":{"items":{"$ref":"#/components/schemas/FirstPartySkuTrendPoint"},"type":"array","title":"Weekly Trend"},"top_markets":{"items":{"$ref":"#/components/schemas/FirstPartySkuBreakdownItem"},"type":"array","title":"Top Markets"},"top_stores":{"items":{"$ref":"#/components/schemas/FirstPartySkuBreakdownItem"},"type":"array","title":"Top Stores"}},"type":"object","title":"FirstPartySkuPosDetail"},"FirstPartySkuShipmentDetail":{"properties":{"shipped_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Shipped Units"},"open_order_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Open Order Units"},"other_order_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Other Order Units"},"grain":{"type":"string","title":"Grain"},"period_flow":{"items":{"$ref":"#/components/schemas/FirstPartySkuShipmentPoint"},"type":"array","title":"Period Flow"},"top_customers":{"items":{"$ref":"#/components/schemas/FirstPartySkuBreakdownItem"},"type":"array","title":"Top Customers"}},"type":"object","required":["grain"],"title":"FirstPartySkuShipmentDetail"},"FirstPartySkuShipmentPoint":{"properties":{"period_start":{"type":"string","format":"date","title":"Period Start"},"period_end":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Period End"},"period_grain":{"type":"string","title":"Period Grain"},"period_label":{"type":"string","title":"Period Label"},"shipped_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Shipped Units"},"open_order_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Open Order Units"},"other_order_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Other Order Units"}},"type":"object","required":["period_start","period_grain","period_label"],"title":"FirstPartySkuShipmentPoint"},"FirstPartySkuTrendPoint":{"properties":{"period_start":{"type":"string","format":"date","title":"Period Start"},"period_end":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Period End"},"period_grain":{"type":"string","title":"Period Grain"},"period_label":{"type":"string","title":"Period Label"},"revenue":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Revenue"},"sold_units":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Sold Units"},"transactions":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Transactions"}},"type":"object","required":["period_start","period_grain","period_label"],"title":"FirstPartySkuTrendPoint"},"FollowUpAcceptRequest":{"properties":{"expected_revision":{"type":"integer","minimum":1.0,"title":"Expected Revision"},"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"schedule":{"$ref":"#/components/schemas/FollowUpScheduleTerms"}},"additionalProperties":false,"type":"object","required":["expected_revision","conversation_id","schedule"],"title":"FollowUpAcceptRequest"},"FollowUpCancelRequest":{"properties":{"expected_revision":{"type":"integer","minimum":1.0,"title":"Expected Revision"}},"additionalProperties":false,"type":"object","required":["expected_revision"],"title":"FollowUpCancelRequest"},"FollowUpDeferRequest":{"properties":{"expected_revision":{"type":"integer","minimum":1.0,"title":"Expected Revision"},"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"schedule":{"$ref":"#/components/schemas/FollowUpScheduleTerms"}},"additionalProperties":false,"type":"object","required":["expected_revision","conversation_id","schedule"],"title":"FollowUpDeferRequest"},"FollowUpDismissRequest":{"properties":{"expected_revision":{"type":"integer","minimum":1.0,"title":"Expected Revision"}},"additionalProperties":false,"type":"object","required":["expected_revision"],"title":"FollowUpDismissRequest"},"FollowUpEligibility":{"properties":{"eligible":{"type":"boolean","title":"Eligible"},"reason":{"$ref":"#/components/schemas/FollowUpEligibilityReason"}},"type":"object","required":["eligible","reason"],"title":"FollowUpEligibility","description":"Explicit server-owned eligibility for generated follow-up affordances."},"FollowUpEligibilityReason":{"type":"string","enum":["complete_answer","intentional_partial","forced_partial","needs_input","no_supported_content","unsafe_terminal_cause","declined","security_refusal","security_blocked","cancelled","failed","unknown_terminal_outcome","action_proposal","evidence_receipt","capability_disabled"],"title":"FollowUpEligibilityReason","description":"Bounded reason for the server-authored generated-follow-up policy."},"FollowUpPreferenceRequest":{"properties":{"native_account_key":{"type":"string","maxLength":191,"minLength":1,"title":"Native Account Key"},"recipe_family":{"type":"string","maxLength":100,"minLength":1,"title":"Recipe Family"},"offers_enabled":{"type":"boolean","title":"Offers Enabled"},"policy_version":{"type":"string","maxLength":64,"minLength":1,"title":"Policy Version"}},"additionalProperties":false,"type":"object","required":["native_account_key","recipe_family","offers_enabled","policy_version"],"title":"FollowUpPreferenceRequest"},"FollowUpResumeRequest":{"properties":{"expected_revision":{"type":"integer","minimum":1.0,"title":"Expected Revision"},"request_id":{"type":"string","format":"uuid","title":"Request Id"}},"additionalProperties":false,"type":"object","required":["expected_revision"],"title":"FollowUpResumeRequest"},"FollowUpScheduleTerms":{"properties":{"scheduled_at_utc":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Scheduled At Utc"},"local_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","title":"Local Date"},"local_time":{"type":"string","pattern":"^\\d{2}:\\d{2}$","title":"Local Time"},"timezone":{"type":"string","maxLength":64,"minLength":1,"title":"Timezone"},"timezone_source":{"type":"string","enum":["explicit_instruction","accepted_offer","pomo_preference","slack_profile","brand_profile"],"title":"Timezone Source"}},"additionalProperties":false,"type":"object","required":["local_date","local_time","timezone","timezone_source"],"title":"FollowUpScheduleTerms","description":"One real civil time, captured alongside its normalized UTC instant."},"FrontDoorApproval":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"href":{"type":"string","title":"Href"}},"additionalProperties":false,"type":"object","required":["id","title","href"],"title":"FrontDoorApproval"},"FrontDoorCheck":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"title":{"type":"string","title":"Title"},"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"work_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Work Id"},"artifact_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Artifact Ref"},"message_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Message Id"},"href":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Href"},"preview":{"$ref":"#/components/schemas/WorkFollowUpPreview"},"ended_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ended At"},"checks_run":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Checks Run"},"failed_checks_in_a_row":{"anyOf":[{"type":"integer","minimum":2.0},{"type":"null"}],"title":"Failed Checks In A Row"}},"additionalProperties":false,"type":"object","required":["id","title","conversation_id","preview"],"title":"FrontDoorCheck","description":"One arrangement, plus the few facts only this reader can state.\n\nThe shared preview contract describes a live commitment. Two questions are\nspecific to reading arrangements back: what a finished one did over its\nwindow, and whether a wrong one has been failing repeatedly. Both are\ncounted from committed rows here rather than widening the public contract."},"FrontDoorCounts":{"properties":{"approvals":{"type":"integer","minimum":0.0,"title":"Approvals"},"work_needs_you":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Work Needs You"},"work_in_progress":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Work In Progress"},"drafts_ready":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Drafts Ready"},"active_checks":{"type":"integer","minimum":0.0,"title":"Active Checks"},"paused_checks":{"type":"integer","minimum":0.0,"title":"Paused Checks"},"checks_needs_you":{"type":"integer","minimum":0.0,"title":"Checks Needs You"}},"additionalProperties":false,"type":"object","required":["approvals","active_checks","paused_checks","checks_needs_you"],"title":"FrontDoorCounts"},"FrontDoorResponse":{"properties":{"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"actor_user_id":{"type":"string","format":"uuid","title":"Actor User Id"},"observed_at":{"type":"string","format":"date-time","title":"Observed At"},"counts":{"$ref":"#/components/schemas/FrontDoorCounts"},"coverage":{"type":"string","enum":["complete","partial"],"title":"Coverage"},"approvals":{"items":{"$ref":"#/components/schemas/FrontDoorApproval"},"type":"array","title":"Approvals"},"work":{"items":{"$ref":"#/components/schemas/WorkItemSnapshot"},"type":"array","title":"Work"},"ready_draft_work_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Ready Draft Work Ids","default":[]},"checks":{"items":{"$ref":"#/components/schemas/FrontDoorCheck"},"type":"array","title":"Checks"},"finished_checks":{"items":{"$ref":"#/components/schemas/FrontDoorCheck"},"type":"array","title":"Finished Checks","default":[]},"finished_checks_total":{"type":"integer","minimum":0.0,"title":"Finished Checks Total","default":0},"work_total":{"type":"integer","minimum":0.0,"title":"Work Total"},"checks_total":{"type":"integer","minimum":0.0,"title":"Checks Total"}},"additionalProperties":false,"type":"object","required":["organization_id","company_profile_id","actor_user_id","observed_at","counts","coverage","approvals","work","checks","work_total","checks_total"],"title":"FrontDoorResponse"},"GalleryCreateResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"images":{"items":{"$ref":"#/components/schemas/GalleryImageResponse"},"type":"array","title":"Images"},"total":{"type":"integer","title":"Total"},"ai_policy_eval":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Ai Policy Eval"}},"type":"object","required":["success","images","total"],"title":"GalleryCreateResponse","description":"Response for gallery image creation endpoints"},"GalleryImageIdsResponse":{"properties":{"image_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Image Ids"},"total":{"type":"integer","title":"Total"},"truncated":{"type":"boolean","title":"Truncated","default":false}},"type":"object","required":["image_ids","total"],"title":"GalleryImageIdsResponse","description":"Every asset id matching a library filter, for select-all."},"GalleryImageResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"company_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Id"},"media_url":{"type":"string","title":"Media Url"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"media_type":{"type":"string","title":"Media Type"},"file_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Format"},"category":{"type":"string","title":"Category"},"subcategory":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subcategory"},"source_type":{"type":"string","title":"Source Type"},"source_campaign_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Campaign Id"},"source_campaign_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Campaign Type"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration"},"file_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Size"},"generation_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generation Prompt"},"generation_model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generation Model"},"edit_history":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Edit History"},"is_visible":{"type":"boolean","title":"Is Visible","default":true},"is_favorite":{"type":"boolean","title":"Is Favorite","default":false},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"removed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Removed At"},"purge_after":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Purge After"},"external_ad_metadata":{"anyOf":[{"$ref":"#/components/schemas/ExternalAdMetadata"},{"type":"null"}]}},"type":"object","required":["id","company_profile_id","media_url","media_type","category","source_type"],"title":"GalleryImageResponse","description":"Response schema for gallery images with signed URL support"},"GalleryListResponse":{"properties":{"images":{"items":{"$ref":"#/components/schemas/GalleryImageResponse"},"type":"array","title":"Images"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"limit":{"type":"integer","title":"Limit"},"total_pages":{"type":"integer","title":"Total Pages"},"category_stats":{"additionalProperties":{"additionalProperties":{"type":"integer"},"type":"object"},"type":"object","title":"Category Stats"},"retention_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Retention Days"}},"type":"object","required":["images","total","page","limit","total_pages"],"title":"GalleryListResponse","description":"Response for gallery list endpoint"},"GalleryRemovedEmptyResponse":{"properties":{"deleted_count":{"type":"integer","title":"Deleted Count"}},"type":"object","required":["deleted_count"],"title":"GalleryRemovedEmptyResponse"},"GalleryRestoreRequest":{"properties":{"image_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":5000,"minItems":1,"title":"Image Ids"}},"type":"object","required":["image_ids"],"title":"GalleryRestoreRequest"},"GalleryRestoreResponse":{"properties":{"restored_count":{"type":"integer","title":"Restored Count"},"image_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Image Ids"}},"type":"object","required":["restored_count","image_ids"],"title":"GalleryRestoreResponse"},"GalleryUploadFailure":{"properties":{"filename":{"type":"string","title":"Filename"},"error":{"title":"Error"}},"type":"object","required":["filename","error"],"title":"GalleryUploadFailure","description":"One file rejected from an otherwise valid bulk upload request."},"GalleryUploadInputResult":{"properties":{"input_index":{"type":"integer","minimum":0.0,"title":"Input Index"},"status":{"type":"string","enum":["uploaded","failed"],"title":"Status"},"result_index":{"type":"integer","minimum":0.0,"title":"Result Index"}},"type":"object","required":["input_index","status","result_index"],"title":"GalleryUploadInputResult","description":"Exact multipart input position and its position in the outcome array."},"GalleryUploadResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"uploaded_images":{"items":{"$ref":"#/components/schemas/GalleryImageResponse"},"type":"array","title":"Uploaded Images"},"total":{"type":"integer","title":"Total"},"failed_uploads":{"items":{"$ref":"#/components/schemas/GalleryUploadFailure"},"type":"array","title":"Failed Uploads"},"input_results":{"anyOf":[{"items":{"$ref":"#/components/schemas/GalleryUploadInputResult"},"type":"array"},{"type":"null"}],"title":"Input Results"}},"type":"object","required":["success","uploaded_images","total"],"title":"GalleryUploadResponse","description":"Response for gallery upload endpoints"},"GeminiVideoEditRequest":{"properties":{"source_asset_id":{"type":"string","format":"uuid","title":"Source Asset Id"},"prompt":{"type":"string","maxLength":10000,"minLength":1,"title":"Prompt"},"reference_asset_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":6,"title":"Reference Asset Ids"},"request_identity":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Request Identity"},"use_company_style":{"type":"boolean","title":"Use Company Style","default":false}},"additionalProperties":false,"type":"object","required":["source_asset_id","prompt"],"title":"GeminiVideoEditRequest"},"GenerateAdVariationRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"variation_count":{"type":"integer","title":"Variation Count","description":"Number of variations to generate","default":1},"generate_new_images":{"type":"boolean","title":"Generate New Images","description":"Whether to generate new images for the variation","default":true}},"type":"object","required":["campaign_id"],"title":"GenerateAdVariationRequest"},"GenerateDeckRequest":{"properties":{"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"product_offering_ids":{"anyOf":[{"items":{"type":"string","format":"uuid"},"type":"array"},{"type":"null"}],"title":"Product Offering Ids"},"title":{"type":"string","title":"Title"},"audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience"},"goal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Goal"},"slides_total":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Slides Total"},"sections":{"items":{"$ref":"#/components/schemas/DeckSection"},"type":"array","title":"Sections"},"style":{"anyOf":[{"$ref":"#/components/schemas/DeckStyle"},{"type":"null"}]},"sample_reference_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sample Reference Url"},"export":{"anyOf":[{"$ref":"#/components/schemas/DeckExport"},{"type":"null"}]},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"attachments":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Attachments"}},"type":"object","required":["company_profile_id","title","slides_total","sections"],"title":"GenerateDeckRequest"},"GenerateGTMRequest":{"properties":{"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"product_offering_ids":{"anyOf":[{"items":{"type":"string","format":"uuid"},"type":"array"},{"type":"null"}],"title":"Product Offering Ids"},"audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience"},"goal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Goal"},"tone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tone","default":"professional"},"expected_length":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Length","default":"standard"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"attachments":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Attachments"}},"type":"object","required":["company_profile_id"],"title":"GenerateGTMRequest"},"GenerateInviteTokenResponse":{"properties":{"invite_token":{"type":"string","title":"Invite Token"}},"type":"object","required":["invite_token"],"title":"GenerateInviteTokenResponse","description":"Response model for invite token generation."},"GenerateRequest":{"properties":{"idempotency_key":{"type":"string","maxLength":255,"minLength":8,"title":"Idempotency Key"},"expected_target_version":{"type":"integer","minimum":1.0,"title":"Expected Target Version"}},"type":"object","required":["idempotency_key","expected_target_version"],"title":"GenerateRequest"},"GenerateVariationRequest":{"properties":{"post_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Post Id","description":"ID of the original post"},"variation_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variation Prompt","description":"Optional prompt for variation"}},"type":"object","title":"GenerateVariationRequest","description":"Request model for generating post variations."},"GeneratedImageQualityReview":{"properties":{"status":{"type":"string","enum":["passed","rejected","unverified"],"title":"Status"},"reasons":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":24,"title":"Reasons","default":[]},"omitted_reason_count":{"type":"integer","minimum":0.0,"title":"Omitted Reason Count","default":0},"attempt_count":{"anyOf":[{"type":"integer","maximum":3.0,"minimum":1.0},{"type":"null"}],"title":"Attempt Count"},"edit_count":{"anyOf":[{"type":"integer","maximum":2.0,"minimum":0.0},{"type":"null"}],"title":"Edit Count"}},"additionalProperties":false,"type":"object","required":["status"],"title":"GeneratedImageQualityReview","description":"The recorded check of the selected candidate, not publication approval."},"GmailDisconnectResponse":{"properties":{"success":{"type":"boolean","title":"Success"}},"type":"object","required":["success"],"title":"GmailDisconnectResponse"},"GmailOAuthStartResponse":{"properties":{"authorization_url":{"type":"string","title":"Authorization Url"}},"type":"object","required":["authorization_url"],"title":"GmailOAuthStartResponse"},"GmailStatusResponse":{"properties":{"available":{"type":"boolean","title":"Available"},"connected":{"type":"boolean","title":"Connected"},"connection_status":{"type":"string","title":"Connection Status"},"email_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Email Account Id"},"email_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Address"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"reauthorization_required":{"type":"boolean","title":"Reauthorization Required"}},"type":"object","required":["available","connected","connection_status","reauthorization_required"],"title":"GmailStatusResponse"},"GoogleAccountsResponseModel":{"properties":{"accounts":{"items":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"object"},"type":"array","title":"Accounts"},"activation_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activation State"},"active_account":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Active Account"}},"type":"object","required":["accounts"],"title":"GoogleAccountsResponseModel"},"GoogleActivateAccountRequest":{"properties":{"account_id":{"type":"string","title":"Account Id","description":"Google Ads account ID to activate for future launches"}},"additionalProperties":false,"type":"object","required":["account_id"],"title":"GoogleActivateAccountRequest"},"GoogleAdCampaignRequest":{"properties":{"account_id":{"type":"string","title":"Account Id"},"name":{"type":"string","title":"Name"},"budget_amount_micros":{"type":"integer","title":"Budget Amount Micros"},"start_date":{"type":"string","title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"}},"additionalProperties":false,"type":"object","required":["account_id","name","budget_amount_micros","start_date"],"title":"GoogleAdCampaignRequest"},"GoogleAdGroupRequest":{"properties":{"account_id":{"type":"string","title":"Account Id"},"campaign_id":{"type":"string","title":"Campaign Id"},"name":{"type":"string","title":"Name"}},"additionalProperties":false,"type":"object","required":["account_id","campaign_id","name"],"title":"GoogleAdGroupRequest"},"GoogleAnalyticsChannelInputResponse":{"properties":{"company_profile_id":{"type":"string","title":"Company Profile Id"},"metric_date":{"type":"string","format":"date","title":"Metric Date"},"channel_key":{"type":"string","title":"Channel Key"},"normalized_channel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Normalized Channel"},"source_platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Platform"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Medium"},"campaign_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Name"},"ga4_sessions":{"type":"integer","title":"Ga4 Sessions"},"ga4_engaged_sessions":{"type":"integer","title":"Ga4 Engaged Sessions"},"ga4_active_users":{"type":"integer","title":"Ga4 Active Users"},"ga4_key_events":{"type":"number","title":"Ga4 Key Events"},"ga4_transactions":{"type":"integer","title":"Ga4 Transactions"},"ga4_purchase_revenue_cents":{"type":"integer","title":"Ga4 Purchase Revenue Cents"},"observed_spend_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Observed Spend Cents"},"observed_revenue_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Observed Revenue Cents"},"data_quality_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Data Quality Score"},"ga4_currency_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ga4 Currency Code"},"observed_spend_currency_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observed Spend Currency Code"},"ga4_report_time_zone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ga4 Report Time Zone"},"ga4_property_resource_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ga4 Property Resource Name"},"ga4_property_metadata_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ga4 Property Metadata Source"},"ga4_property_metadata_refreshed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ga4 Property Metadata Refreshed At"},"ga4_property_sync_run_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ga4 Property Sync Run Id"},"ga4_property_sync_completed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ga4 Property Sync Completed At"}},"type":"object","required":["company_profile_id","metric_date","channel_key","normalized_channel","source_platform","source","medium","campaign_name","ga4_sessions","ga4_engaged_sessions","ga4_active_users","ga4_key_events","ga4_transactions","ga4_purchase_revenue_cents","observed_spend_cents","observed_revenue_cents","data_quality_score"],"title":"GoogleAnalyticsChannelInputResponse","description":"GA4 daily channel input row from the Gold MMM feature table."},"GoogleAnalyticsInitialSyncStatusResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Current sync status: pending, running, completed, failed, skipped, not_started"},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Id","description":"Databricks job run ID"},"triggered_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Triggered At","description":"When the sync was triggered (ISO format)"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message if sync failed"},"run_page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Page Url","description":"URL to view the Databricks job run"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code","description":"Stable machine-readable GA4 sync failure code"}},"type":"object","required":["status"],"title":"GoogleAnalyticsInitialSyncStatusResponse","description":"GA4 extension carrying a stable, UI-actionable failure code."},"GoogleAnalyticsPropertiesResponse":{"properties":{"connected":{"type":"boolean","title":"Connected"},"properties":{"items":{"$ref":"#/components/schemas/GoogleAnalyticsProperty"},"type":"array","title":"Properties"},"selected_property_resource_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Property Resource Name"},"selected_property_time_zone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Property Time Zone"},"selected_property_currency_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Property Currency Code"}},"type":"object","required":["connected"],"title":"GoogleAnalyticsPropertiesResponse"},"GoogleAnalyticsProperty":{"properties":{"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id","description":"Google Analytics account ID"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name","description":"Google Analytics account display name"},"property_id":{"type":"string","title":"Property Id","description":"GA4 numeric property ID"},"property_resource_name":{"type":"string","title":"Property Resource Name","description":"GA4 property resource name: properties/{id}"},"property_name":{"type":"string","title":"Property Name","description":"GA4 property display name"},"property_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Property Type","description":"GA4 property type"},"time_zone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Time Zone","description":"Authoritative GA4 property reporting timezone"},"currency_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency Code","description":"Authoritative GA4 property reporting currency"},"metadata_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metadata Source","description":"Provider source used to resolve reporting metadata"},"metadata_refreshed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metadata Refreshed At","description":"When reporting metadata was fetched from Google"}},"type":"object","required":["property_id","property_resource_name","property_name"],"title":"GoogleAnalyticsProperty"},"GoogleAnalyticsPropertySelectRequest":{"properties":{"property_resource_name":{"type":"string","title":"Property Resource Name","description":"GA4 property resource name, e.g. properties/123456"}},"type":"object","required":["property_resource_name"],"title":"GoogleAnalyticsPropertySelectRequest"},"GoogleAnalyticsPropertySelectResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"property":{"$ref":"#/components/schemas/GoogleAnalyticsProperty"},"initial_sync":{"type":"string","title":"Initial Sync"}},"type":"object","required":["success","property","initial_sync"],"title":"GoogleAnalyticsPropertySelectResponse"},"GoogleAnalyticsStatusResponseModel":{"properties":{"connected":{"type":"boolean","title":"Connected","description":"Whether the platform is connected"},"healthy":{"type":"boolean","title":"Healthy","description":"Whether the token is healthy (passed API check)","default":false},"health_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Health Message","description":"Health check result message"},"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id","description":"Platform-specific account identifier"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name","description":"Display name for the account"},"token_expires_soon":{"type":"boolean","title":"Token Expires Soon","description":"Whether token expires within buffer period","default":false},"last_health_check":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Health Check","description":"ISO timestamp of last health check"},"selected_property_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Property Id","description":"Selected GA4 property ID"},"selected_property_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Property Name","description":"Selected GA4 property name"},"selected_property_resource_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Property Resource Name","description":"Selected GA4 property resource name"},"selected_property_time_zone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Property Time Zone","description":"Selected GA4 property's reporting timezone"},"selected_property_currency_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Property Currency Code","description":"Selected GA4 property's reporting currency"},"property_count":{"type":"integer","title":"Property Count","description":"Number of accessible GA4 properties","default":0},"property_selection_required":{"type":"boolean","title":"Property Selection Required","description":"Whether the user must select a GA4 property","default":false},"granted_scopes":{"items":{"type":"string"},"type":"array","title":"Granted Scopes","description":"Granted Google OAuth scopes"},"missing_scopes":{"items":{"type":"string"},"type":"array","title":"Missing Scopes","description":"Configured scopes not granted by Google"},"refresh_token_expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Refresh Token Expires At","description":"Refresh token expiry if Google returned time-bound access"},"reconnect_required":{"type":"boolean","title":"Reconnect Required","description":"Whether the user must reconnect Google Analytics","default":false}},"type":"object","required":["connected"],"title":"GoogleAnalyticsStatusResponseModel","example":{"account_id":"shop_12345","account_name":"My Store","connected":true,"health_message":"Token is valid","healthy":true,"last_health_check":"2024-01-15T10:30:00Z","token_expires_soon":false}},"GoogleAnalyticsTrafficRow":{"properties":{"company_profile_id":{"type":"string","title":"Company Profile Id"},"metric_date":{"type":"string","format":"date","title":"Metric Date"},"channel_key":{"type":"string","title":"Channel Key"},"normalized_channel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Normalized Channel"},"source_platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Platform"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Medium"},"campaign_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Name"},"ga4_sessions":{"type":"integer","title":"Ga4 Sessions"},"ga4_engaged_sessions":{"type":"integer","title":"Ga4 Engaged Sessions"},"ga4_active_users":{"type":"integer","title":"Ga4 Active Users"},"ga4_key_events":{"type":"number","title":"Ga4 Key Events"},"ga4_transactions":{"type":"integer","title":"Ga4 Transactions"},"ga4_purchase_revenue_cents":{"type":"integer","title":"Ga4 Purchase Revenue Cents"},"observed_spend_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Observed Spend Cents"},"observed_revenue_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Observed Revenue Cents"},"data_quality_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Data Quality Score"},"ga4_currency_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ga4 Currency Code"},"observed_spend_currency_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observed Spend Currency Code"},"ga4_report_time_zone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ga4 Report Time Zone"},"ga4_property_resource_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ga4 Property Resource Name"},"ga4_property_metadata_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ga4 Property Metadata Source"},"ga4_property_metadata_refreshed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ga4 Property Metadata Refreshed At"}},"type":"object","required":["company_profile_id","metric_date","channel_key","ga4_sessions","ga4_engaged_sessions","ga4_active_users","ga4_key_events","ga4_transactions","ga4_purchase_revenue_cents"],"title":"GoogleAnalyticsTrafficRow"},"GoogleAuthResponseModel":{"properties":{"auth_url":{"type":"string","title":"Auth Url"}},"type":"object","required":["auth_url"],"title":"GoogleAuthResponseModel"},"GoogleCampaignActionRequest":{"properties":{"platform_type":{"type":"string","title":"Platform Type","description":"Type of ad platform: google_display or google_search"},"ad_id":{"type":"string","title":"Ad Id","description":"Normalized platform ad ID to act on"},"google_account_id":{"type":"string","title":"Google Account Id","description":"Google Ads account ID"},"action":{"type":"string","title":"Action","description":"Action to perform: pause or delete"}},"type":"object","required":["platform_type","ad_id","google_account_id","action"],"title":"GoogleCampaignActionRequest","description":"Request model for pausing/deleting a Google campaign."},"GoogleCreateAdFromCampaignRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id","description":"ID of the campaign to create ad from"},"idea_number":{"type":"integer","title":"Idea Number","description":"Idea number within the campaign"},"google_account_id":{"type":"string","title":"Google Account Id","description":"Google Ads account ID to create the ad in"},"variation":{"type":"integer","title":"Variation","description":"Variation number (0 for original, 1+ for variations)","default":0}},"additionalProperties":false,"type":"object","required":["campaign_id","idea_number","google_account_id"],"title":"GoogleCreateAdFromCampaignRequest"},"GoogleLaunchAdCampaignRequest":{"properties":{"platform_type":{"type":"string","title":"Platform Type","description":"Type of ad platform: google_display or google_search"},"ad_id":{"type":"string","title":"Ad Id","description":"Normalized platform ad ID to launch"},"google_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Google Account Id","description":"Legacy Google Ads account ID; launches use the active account"},"bid_only":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Bid Only","description":"Whether to use 'Observation' (True) or 'Targeting' (False) for audiences","default":true},"youtube_logo_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Youtube Logo Image Url","description":"Optional square logo GCS URL for YouTube/Google Video"}},"additionalProperties":false,"type":"object","required":["platform_type","ad_id"],"title":"GoogleLaunchAdCampaignRequest","description":"Request model for launching an online ad campaign to Google Ads."},"GoogleLeadFormConfigV1":{"properties":{"business_name":{"type":"string","maxLength":25,"minLength":1,"title":"Business Name"},"name":{"type":"string","maxLength":88,"minLength":1,"title":"Name"},"headline":{"type":"string","maxLength":30,"minLength":1,"title":"Headline","default":"Get more information"},"description":{"type":"string","maxLength":200,"minLength":1,"title":"Description","default":"Submit your details and we'll follow up."},"privacy_policy_url":{"type":"string","maxLength":2000,"minLength":1,"title":"Privacy Policy Url"},"call_to_action_type":{"type":"string","enum":["APPLY_NOW","BOOK_NOW","CONTACT_US","DOWNLOAD","GET_INFO","GET_OFFER","GET_QUOTE","GET_STARTED","JOIN_NOW","LEARN_MORE","REGISTER","REQUEST_DEMO","SIGN_UP","SUBSCRIBE"],"title":"Call To Action Type","default":"LEARN_MORE"},"call_to_action_description":{"type":"string","maxLength":30,"minLength":1,"title":"Call To Action Description","default":"Get started today"},"post_submit_headline":{"type":"string","maxLength":30,"minLength":1,"title":"Post Submit Headline","default":"Thanks for your interest"},"post_submit_description":{"type":"string","maxLength":200,"minLength":1,"title":"Post Submit Description","default":"We'll be in touch soon."},"post_submit_call_to_action_type":{"type":"string","enum":["VISIT_SITE","LEARN_MORE","DOWNLOAD","SHOP_NOW"],"title":"Post Submit Call To Action Type","default":"VISIT_SITE"},"desired_intent":{"type":"string","enum":["LOW_INTENT","HIGH_INTENT"],"title":"Desired Intent","default":"LOW_INTENT"},"fields":{"items":{"type":"string","enum":["FULL_NAME","EMAIL","PHONE_NUMBER","WORK_EMAIL","WORK_PHONE","COMPANY_NAME","JOB_TITLE","CITY","REGION","COUNTRY","POSTAL_CODE"]},"type":"array","maxItems":12,"minItems":1,"title":"Fields"}},"additionalProperties":false,"type":"object","required":["business_name","name","privacy_policy_url"],"title":"GoogleLeadFormConfigV1"},"GoogleSearchAdRequest":{"properties":{"product_description":{"type":"string","title":"Product Description","description":"Description of the product or service"},"target_audience":{"type":"string","title":"Target Audience","description":"Target audience description"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id","description":"Company profile ID (required)"},"campaign_goals":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Campaign Goals","description":"List of campaign goals"},"key_selling_points":{"type":"string","title":"Key Selling Points","description":"Key selling points","default":""},"num_ads":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Num Ads","description":"Number of ad variations to generate","default":3},"bid_strategy":{"type":"string","title":"Bid Strategy","description":"Bidding strategy","default":"maximize_conversions"},"budget_range":{"type":"string","title":"Budget Range","description":"Budget range (low, medium, high, custom)","default":"medium"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Target country"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province","description":"Target state/province"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"Target city"},"locations":{"anyOf":[{"items":{"$ref":"#/components/schemas/LocationItem"},"type":"array"},{"type":"null"}],"title":"Locations","description":"List of locations to target (countries/regions/states/cities/postal codes/proximities). This does not split budget per location; all locations share the campaign budget."},"reference_images":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":3},{"type":"null"}],"title":"Reference Images","description":"List of reference image base64 data URLs (max 3)"},"max_cpc":{"anyOf":[{"type":"number","minimum":0.01},{"type":"null"}],"title":"Max Cpc","description":"Maximum cost per click in dollars (e.g., 1.50 for $1.50). Required when bid_strategy is 'MANUAL_CPC'"},"experiment_package_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Experiment Package Id","description":"Test package id; created campaigns are stamped with this linkage"},"launch_strategy_mode":{"anyOf":[{"type":"string","pattern":"^(test_learn_pilot|direct_campaign)$"},{"type":"null"}],"title":"Launch Strategy Mode","description":"test_learn_pilot or direct_campaign"},"dayparting_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dayparting Enabled","description":"Whether dayparting/ad scheduling is enabled for this campaign","default":false},"dayparting_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Dayparting Config","description":"Dayparting configuration including schedule, timezone, and platform-specific settings"},"lead_forms_by_platform_type":{"anyOf":[{"additionalProperties":{"$ref":"#/components/schemas/LeadFormRequestEntry"},"type":"object"},{"type":"null"}],"title":"Lead Forms By Platform Type"}},"additionalProperties":false,"type":"object","required":["product_description","target_audience","company_profile_id"],"title":"GoogleSearchAdRequest","description":"Request model for Google Search ads"},"GoogleSearchCampaignUpdateRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"ad_id":{"type":"string","title":"Ad Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"headlines":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Headlines"},"descriptions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Descriptions"},"final_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Final Url"},"keywords":{"anyOf":[{"items":{"anyOf":[{"additionalProperties":true,"type":"object"},{"$ref":"#/components/schemas/KeywordWithCpc"},{"type":"string"}]},"type":"array"},{"type":"null"}],"title":"Keywords"},"negative_keywords":{"anyOf":[{"items":{"anyOf":[{"additionalProperties":true,"type":"object"},{"$ref":"#/components/schemas/KeywordWithCpc"},{"type":"string"}]},"type":"array"},{"type":"null"}],"title":"Negative Keywords"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"recommended_daily_budget":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Recommended Daily Budget"},"total_budget":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Budget"},"duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration"},"target_platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Platform"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"bid_strategy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bid Strategy"},"max_cpc":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Cpc"},"tracking_template":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tracking Template"},"final_url_suffix":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Final Url Suffix"},"dayparting_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"string"},{"type":"null"}],"title":"Dayparting Config"},"lead_form":{"anyOf":[{"$ref":"#/components/schemas/DraftLeadFormEditRequest"},{"type":"null"}]},"target_audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Audience"},"target_audience_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Target Audience Json"},"locations":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Locations"}},"additionalProperties":false,"type":"object","required":["campaign_id","ad_id"],"title":"GoogleSearchCampaignUpdateRequest","description":"Strict Google Search edit boundary; canonical forms use sync state only."},"GoogleSyncAdCampaignRequest":{"properties":{"platform_type":{"type":"string","title":"Platform Type","description":"google_search, google_display, or google_video"},"ad_id":{"type":"string","title":"Ad Id","description":"ID of the specific ad to sync"},"google_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Google Account Id","description":"Google Ads account ID (optional override)"},"force_sync_fields":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Force Sync Fields","description":"Optional fields to reconcile remotely even when the local diff is empty."},"strict_sync_fields":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Strict Sync Fields","description":"Exact reviewed fields; exclude other saved edits."},"pending_update":{"anyOf":[{"$ref":"#/components/schemas/GoogleSyncPendingUpdate"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["platform_type","ad_id"],"title":"GoogleSyncAdCampaignRequest","description":"Request model for syncing an online ad campaign to Google Ads."},"GoogleSyncPendingUpdate":{"properties":{"campaign_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Id"},"ad_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"},"target_platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Platform"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration"},"recommended_daily_budget":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Recommended Daily Budget"},"total_budget":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Budget"},"dayparting_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"string"},{"type":"null"}],"title":"Dayparting Config"},"headlines":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Headlines"},"descriptions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Descriptions"},"final_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Final Url"},"keywords":{"anyOf":[{"items":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"string"}]},"type":"array"},{"type":"null"}],"title":"Keywords"},"negative_keywords":{"anyOf":[{"items":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"string"}]},"type":"array"},{"type":"null"}],"title":"Negative Keywords"},"tracking_template":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tracking Template"},"final_url_suffix":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Final Url Suffix"},"bid_strategy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bid Strategy"},"max_cpc":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Cpc"},"business_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Name"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"long_headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Long Headline"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"call_to_action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Call To Action"},"format_setting":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Format Setting"},"video_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Video Length"},"media":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Media"},"media_operations":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Media Operations"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"lead_form":{"anyOf":[{"$ref":"#/components/schemas/ActiveLeadFormEditRequest"},{"type":"null"}]}},"additionalProperties":false,"type":"object","title":"GoogleSyncPendingUpdate","description":"Strict union of legitimate Google Search/Display/Video edit fields."},"GoogleSyncPreviewRequest":{"properties":{"platform_type":{"type":"string","title":"Platform Type","description":"google_search, google_display, or google_video"},"ad_id":{"type":"string","title":"Ad Id","description":"ID of the specific ad to sync"},"google_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Google Account Id","description":"Google Ads account ID (optional override)"},"force_sync_fields":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Force Sync Fields","description":"Optional fields to reconcile remotely even when the local diff is empty."},"strict_sync_fields":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Strict Sync Fields","description":"Exact reviewed fields; exclude other saved edits."},"pending_update":{"anyOf":[{"$ref":"#/components/schemas/GoogleSyncPendingUpdate"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["platform_type","ad_id"],"title":"GoogleSyncPreviewRequest","description":"Request model for previewing a sync and billing impact."},"GoogleVideoAdRequest":{"properties":{"product_description":{"type":"string","title":"Product Description","description":"Description of the product or service"},"target_audience":{"type":"string","title":"Target Audience","description":"Target audience description"},"campaign_goals":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Campaign Goals"},"key_selling_points":{"type":"string","title":"Key Selling Points","default":""},"num_ads":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Num Ads","default":3},"video_length":{"type":"integer","maximum":10.0,"minimum":10.0,"title":"Video Length","description":"Video duration is fixed at 10 seconds","default":10},"bid_strategy":{"type":"string","title":"Bid Strategy","default":"automatic"},"budget_range":{"type":"string","title":"Budget Range","default":"medium"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"locations":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Locations"},"reference_images":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":3},{"type":"null"}],"title":"Reference Images"}},"additionalProperties":false,"type":"object","required":["product_description","target_audience"],"title":"GoogleVideoAdRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HtmlPreviewResponse":{"properties":{"html":{"type":"string","title":"Html"}},"type":"object","required":["html"],"title":"HtmlPreviewResponse"},"HubSpotAuthResponse":{"properties":{"auth_url":{"type":"string","title":"Auth Url"}},"type":"object","required":["auth_url"],"title":"HubSpotAuthResponse","description":"Response model for the HubSpot auth URL."},"HubSpotHealthResponse":{"properties":{"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"HubSpotHealthResponse","description":"Response model for the HubSpot connection health status."},"HubSpotStatusResponse":{"properties":{"connected":{"type":"boolean","title":"Connected"},"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name"},"portal_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Portal Id"}},"type":"object","required":["connected"],"title":"HubSpotStatusResponse","description":"Response model for the HubSpot connection status."},"ImageGenerationResponse":{"properties":{"image_urls":{"items":{"type":"string"},"type":"array","title":"Image Urls"},"prompt":{"type":"string","title":"Prompt"},"enhanced_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Enhanced Prompt"},"ai_policy_eval":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Ai Policy Eval"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["image_urls","prompt","created_at"],"title":"ImageGenerationResponse","description":"Response model for generated images"},"ImageSelectionRequest":{"properties":{"campaign_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"string"}],"title":"Campaign Id","description":"Campaign ID (can be UUID database ID or string campaign_id)"},"campaign_type":{"type":"string","title":"Campaign Type","description":"Type of campaign (e.g., google_display, meta_feed, social_post)"},"selected_image_url":{"type":"string","title":"Selected Image Url","description":"URL of the selected image variation"},"selection_mode":{"type":"string","enum":["replace","add","add_and_set_primary"],"title":"Selection Mode","description":"How to apply the selected image: replace current, add to list, or add and set as primary","default":"replace"},"variation_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Variation Index","description":"Index of the selected variation (0-based)"},"total_variations":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Variations","description":"Total number of variations that were presented"},"selection_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Selection Metadata","description":"Additional metadata about the selection"},"ad_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id","description":"Specific ad ID for ad campaigns (when updating a specific ad variation)"}},"type":"object","required":["campaign_id","campaign_type","selected_image_url"],"title":"ImageSelectionRequest","description":"Request schema for selecting an image variation for a campaign"},"ImageSelectionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"campaign_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"string"}],"title":"Campaign Id"},"campaign_type":{"type":"string","title":"Campaign Type"},"selected_image_url":{"type":"string","title":"Selected Image Url"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","campaign_id","campaign_type","selected_image_url","message"],"title":"ImageSelectionResponse","description":"Response schema for image selection"},"ImageVariation":{"properties":{"url":{"type":"string","title":"Url"},"index":{"type":"integer","title":"Index"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["url","index"],"title":"ImageVariation","description":"Information about an image variation"},"InfluencerBriefUploadResponse":{"properties":{"file_name":{"type":"string","title":"File Name"},"characters":{"type":"integer","title":"Characters"},"truncated":{"type":"boolean","title":"Truncated"},"excerpt":{"type":"string","title":"Excerpt"},"text":{"type":"string","title":"Text"}},"type":"object","required":["file_name","characters","truncated","excerpt","text"],"title":"InfluencerBriefUploadResponse","description":"What we actually read, so the surface can say it rather than imply it."},"InfluencerCampaignActiveResponse":{"properties":{"campaign":{"anyOf":[{"$ref":"#/components/schemas/InfluencerCampaignPlanResponse"},{"type":"null"}]},"campaigns":{"items":{"$ref":"#/components/schemas/InfluencerCampaignPlanResponse"},"type":"array","title":"Campaigns"},"saved_curated_lists":{"items":{"$ref":"#/components/schemas/InfluencerCampaignCuratedListResponse"},"type":"array","title":"Saved Curated Lists"}},"type":"object","title":"InfluencerCampaignActiveResponse"},"InfluencerCampaignArchiveResponse":{"properties":{"archived":{"type":"boolean","title":"Archived"},"campaign":{"$ref":"#/components/schemas/InfluencerCampaignPlanResponse"}},"type":"object","required":["archived","campaign"],"title":"InfluencerCampaignArchiveResponse"},"InfluencerCampaignCollectionAddCreatorsRequest":{"properties":{"creator_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":50,"minItems":1,"title":"Creator Ids"},"refresh_ai":{"type":"boolean","title":"Refresh Ai","default":false}},"type":"object","required":["creator_ids"],"title":"InfluencerCampaignCollectionAddCreatorsRequest"},"InfluencerCampaignCollectionAddCreatorsResponse":{"properties":{"campaign":{"$ref":"#/components/schemas/InfluencerCampaignPlanResponse"},"added":{"type":"integer","title":"Added"},"unchanged":{"type":"integer","title":"Unchanged"},"source_creator_list_id":{"type":"string","title":"Source Creator List Id"},"plan_updated":{"type":"boolean","title":"Plan Updated"},"updated_plan_sections":{"items":{"type":"string"},"type":"array","title":"Updated Plan Sections"}},"type":"object","required":["campaign","added","unchanged","source_creator_list_id","plan_updated"],"title":"InfluencerCampaignCollectionAddCreatorsResponse"},"InfluencerCampaignCollectionUpdateRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Description"},"is_pinned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Pinned"}},"type":"object","title":"InfluencerCampaignCollectionUpdateRequest"},"InfluencerCampaignCreatorResponse":{"properties":{"id":{"type":"string","title":"Id"},"curated_list_id":{"type":"string","title":"Curated List Id"},"position":{"type":"integer","title":"Position"},"creator_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creator Id"},"creator_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creator Account Id"},"company_profile_creator_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Creator Id"},"source_list_membership_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source List Membership Id"},"role":{"type":"string","title":"Role"},"slate_status":{"type":"string","title":"Slate Status"},"target_market":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Market"},"platform":{"type":"string","title":"Platform"},"inventory_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inventory Account Id"},"platform_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform Account Id"},"handle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Handle"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Url"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"follower_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Follower Count"},"avg_views":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Views"},"engagement_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Engagement Rate"},"estimated_price_min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Estimated Price Min"},"estimated_price_max":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Estimated Price Max"},"reply_risk":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reply Risk"},"fit_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fit Summary"},"phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phase"},"contact_day_offset":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Contact Day Offset"},"post_day_offset":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Post Day Offset"},"budget_weight":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Budget Weight"},"allocated_budget_min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Allocated Budget Min"},"allocated_budget_max":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Allocated Budget Max"},"budget_fit_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Budget Fit Status"},"deliverables":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Deliverables"},"brand_fit_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Brand Fit Score"},"brand_fit_reasons":{"items":{"type":"string"},"type":"array","title":"Brand Fit Reasons"},"selection_rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selection Rationale"},"orchestra_slot_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Orchestra Slot Key"},"canonical_creator":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Canonical Creator"},"accounts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Accounts"},"contacts":{"additionalProperties":true,"type":"object","title":"Contacts"},"metrics":{"additionalProperties":true,"type":"object","title":"Metrics"},"source_payload":{"additionalProperties":true,"type":"object","title":"Source Payload"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","curated_list_id","position","role","slate_status","platform"],"title":"InfluencerCampaignCreatorResponse"},"InfluencerCampaignCuratedCreatorPreviewResponse":{"properties":{"id":{"type":"string","title":"Id"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"handle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Handle"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"}},"type":"object","required":["id"],"title":"InfluencerCampaignCuratedCreatorPreviewResponse","description":"A face for the campaign rail: identity and avatar, nothing else."},"InfluencerCampaignCuratedListMutationResponse":{"properties":{"curated_list":{"$ref":"#/components/schemas/InfluencerCampaignCuratedListResponse"}},"type":"object","required":["curated_list"],"title":"InfluencerCampaignCuratedListMutationResponse"},"InfluencerCampaignCuratedListResponse":{"properties":{"id":{"type":"string","title":"Id"},"campaign_id":{"type":"string","title":"Campaign Id"},"title":{"type":"string","title":"Title"},"persona":{"type":"string","title":"Persona"},"query":{"type":"string","title":"Query"},"rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rationale"},"position":{"type":"integer","title":"Position"},"weight":{"type":"number","title":"Weight"},"total_creator_count":{"type":"integer","title":"Total Creator Count"},"platforms":{"items":{"type":"string"},"type":"array","title":"Platforms"},"target_markets":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Target Markets"},"role_mix":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Role Mix"},"size_mix":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Size Mix"},"orchestra_timeline":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Orchestra Timeline"},"budget_allocation":{"additionalProperties":true,"type":"object","title":"Budget Allocation"},"deliverables":{"additionalProperties":true,"type":"object","title":"Deliverables"},"brand_context_snapshot":{"additionalProperties":true,"type":"object","title":"Brand Context Snapshot"},"planning_assumptions":{"additionalProperties":true,"type":"object","title":"Planning Assumptions"},"leadership_report":{"additionalProperties":true,"type":"object","title":"Leadership Report"},"generation_version":{"type":"integer","title":"Generation Version"},"source_creator_list_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Creator List Id"},"planning_status":{"type":"string","title":"Planning Status","default":"ready"},"roster_revision":{"type":"integer","title":"Roster Revision","default":1},"roster_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Roster Hash"},"is_saved":{"type":"boolean","title":"Is Saved"},"saved_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Saved At"},"saved_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Saved By User Id"},"snapshot":{"additionalProperties":true,"type":"object","title":"Snapshot"},"creators":{"items":{"$ref":"#/components/schemas/InfluencerCampaignCreatorResponse"},"type":"array","title":"Creators"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","campaign_id","title","persona","query","position","weight","total_creator_count","generation_version","is_saved"],"title":"InfluencerCampaignCuratedListResponse"},"InfluencerCampaignCuratedListSaveResponse":{"properties":{"curated_list":{"$ref":"#/components/schemas/InfluencerCampaignCuratedListResponse"}},"type":"object","required":["curated_list"],"title":"InfluencerCampaignCuratedListSaveResponse"},"InfluencerCampaignCuratedListSummaryResponse":{"properties":{"id":{"type":"string","title":"Id"},"campaign_id":{"type":"string","title":"Campaign Id"},"title":{"type":"string","title":"Title"},"persona":{"type":"string","title":"Persona"},"position":{"type":"integer","title":"Position"},"total_creator_count":{"type":"integer","title":"Total Creator Count"},"platforms":{"items":{"type":"string"},"type":"array","title":"Platforms"},"creator_preview":{"items":{"$ref":"#/components/schemas/InfluencerCampaignCuratedCreatorPreviewResponse"},"type":"array","title":"Creator Preview"},"generation_version":{"type":"integer","title":"Generation Version"},"source_creator_list_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Creator List Id"},"planning_status":{"type":"string","title":"Planning Status","default":"ready"},"roster_revision":{"type":"integer","title":"Roster Revision","default":1},"roster_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Roster Hash"},"is_saved":{"type":"boolean","title":"Is Saved"},"saved_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Saved At"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","campaign_id","title","persona","position","total_creator_count","generation_version","is_saved"],"title":"InfluencerCampaignCuratedListSummaryResponse"},"InfluencerCampaignDeleteResponse":{"properties":{"deleted":{"type":"boolean","title":"Deleted"},"campaign":{"$ref":"#/components/schemas/InfluencerCampaignPlanResponse"}},"type":"object","required":["deleted","campaign"],"title":"InfluencerCampaignDeleteResponse"},"InfluencerCampaignFromCreatorListRequest":{"properties":{"objective":{"anyOf":[{"type":"string","enum":["distribution","brand_recall","sales","launch","category_launch"]},{"type":"null"}],"title":"Objective","default":"launch"},"request_key":{"anyOf":[{"type":"string","maxLength":64,"minLength":8},{"type":"null"}],"title":"Request Key"},"objectives":{"items":{"type":"string","enum":["distribution","brand_recall","sales","launch","category_launch"]},"type":"array","maxItems":5,"title":"Objectives"},"campaign_name":{"anyOf":[{"type":"string","maxLength":180},{"type":"null"}],"title":"Campaign Name"},"campaign_goal":{"anyOf":[{"type":"string","maxLength":700},{"type":"null"}],"title":"Campaign Goal"},"budget_min":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Budget Min"},"budget_max":{"anyOf":[{"type":"number","minimum":1.0},{"type":"null"}],"title":"Budget Max","description":"Campaign planning ceiling. Leave null when the budget has not been decided."},"budget_currency":{"type":"string","enum":["USD","INR"],"title":"Budget Currency","default":"USD"},"budget_usd":{"anyOf":[{"type":"number","minimum":1.0},{"type":"null"}],"title":"Budget Usd"},"target_markets":{"anyOf":[{"items":{"$ref":"#/components/schemas/InfluencerCampaignTargetMarket"},"type":"array","maxItems":8},{"type":"null"}],"title":"Target Markets"},"platforms":{"anyOf":[{"items":{"type":"string","enum":["INST","YT","TT"]},"type":"array","maxItems":3},{"type":"null"}],"title":"Platforms"},"posting_time_mode":{"type":"string","enum":["pomo_optimizes","manual"],"title":"Posting Time Mode","default":"pomo_optimizes"},"posting_time":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Posting Time"},"launch_start":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Launch Start"},"launch_end":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Launch End"},"refresh_ai":{"type":"boolean","title":"Refresh Ai","default":true},"settings":{"additionalProperties":true,"type":"object","title":"Settings"}},"type":"object","title":"InfluencerCampaignFromCreatorListRequest"},"InfluencerCampaignPlanResponse":{"properties":{"id":{"type":"string","title":"Id"},"organization_id":{"type":"string","title":"Organization Id"},"company_profile_id":{"type":"string","title":"Company Profile Id"},"created_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created By User Id"},"updated_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated By User Id"},"objective":{"type":"string","title":"Objective"},"objectives":{"items":{"type":"string"},"type":"array","title":"Objectives"},"budget_min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Budget Min"},"budget_max":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Budget Max"},"budget_currency":{"type":"string","title":"Budget Currency","default":"USD"},"budget_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Budget Usd"},"target_markets":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Target Markets"},"platforms":{"items":{"type":"string"},"type":"array","title":"Platforms"},"posting_time_mode":{"type":"string","title":"Posting Time Mode"},"posting_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Posting Time"},"launch_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Launch Start"},"launch_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Launch End"},"status":{"type":"string","title":"Status"},"generation_version":{"type":"integer","title":"Generation Version"},"plan_origin":{"type":"string","title":"Plan Origin","default":"campaign_workflow"},"source_creator_list_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Creator List Id"},"planning_status":{"type":"string","title":"Planning Status","default":"ready"},"roster_revision":{"type":"integer","title":"Roster Revision","default":1},"roster_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Roster Hash"},"recommended_budget_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Recommended Budget Usd"},"collection_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Collection Name"},"collection_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Collection Description"},"is_pinned":{"type":"boolean","title":"Is Pinned","default":false},"pinned_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pinned By User Id"},"pinned_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pinned At"},"archived_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Archived By User Id"},"archived_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Archived At"},"deleted_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deleted By User Id"},"deleted_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deleted At"},"strategy_summary":{"additionalProperties":true,"type":"object","title":"Strategy Summary"},"settings":{"additionalProperties":true,"type":"object","title":"Settings"},"curated_lists":{"items":{"$ref":"#/components/schemas/InfluencerCampaignCuratedListResponse"},"type":"array","title":"Curated Lists"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","organization_id","company_profile_id","objective","posting_time_mode","status","generation_version"],"title":"InfluencerCampaignPlanResponse"},"InfluencerCampaignReplaceCreatorRequest":{"properties":{"candidate":{"additionalProperties":true,"type":"object","title":"Candidate"},"allow_over_budget":{"type":"boolean","title":"Allow Over Budget","default":false}},"type":"object","required":["candidate"],"title":"InfluencerCampaignReplaceCreatorRequest"},"InfluencerCampaignReplaceCreatorResponse":{"properties":{"curated_list":{"$ref":"#/components/schemas/InfluencerCampaignCuratedListResponse"},"replaced_creator":{"$ref":"#/components/schemas/InfluencerCampaignCreatorResponse"},"budget_warning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Budget Warning"}},"type":"object","required":["curated_list","replaced_creator"],"title":"InfluencerCampaignReplaceCreatorResponse"},"InfluencerCampaignReplacementCandidatesRequest":{"properties":{"query":{"type":"string","maxLength":500,"title":"Query","default":""},"limit":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Limit","default":8},"creator_type_includes":{"items":{"type":"string"},"type":"array","maxItems":12,"title":"Creator Type Includes"},"creator_type_excludes":{"items":{"type":"string"},"type":"array","maxItems":12,"title":"Creator Type Excludes"},"min_followers":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Min Followers"},"max_followers":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Max Followers"},"location_filters":{"items":{"type":"string"},"type":"array","maxItems":12,"title":"Location Filters"}},"type":"object","title":"InfluencerCampaignReplacementCandidatesRequest"},"InfluencerCampaignReplacementCandidatesResponse":{"properties":{"current_creator":{"$ref":"#/components/schemas/InfluencerCampaignCreatorResponse"},"candidates":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Candidates"},"applied_query":{"type":"string","title":"Applied Query"},"can_override_budget":{"type":"boolean","title":"Can Override Budget","default":false}},"type":"object","required":["current_creator","applied_query"],"title":"InfluencerCampaignReplacementCandidatesResponse"},"InfluencerCampaignReportBusinessInputs":{"properties":{"campaign_cost":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"null"}],"title":"Campaign Cost"},"selling_price":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"null"}],"title":"Selling Price"},"product_cost":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Product Cost"},"other_cost_per_sale":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Other Cost Per Sale","default":0},"profit_target_pct":{"type":"number","maximum":1000.0,"minimum":0.0,"title":"Profit Target Pct","default":20},"confirmed_creator_fees":{"additionalProperties":{"type":"number"},"type":"object","maxProperties":30,"title":"Confirmed Creator Fees"},"additional_context":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Additional Context"}},"type":"object","title":"InfluencerCampaignReportBusinessInputs"},"InfluencerCampaignReportUpdateRequest":{"properties":{"business_inputs":{"$ref":"#/components/schemas/InfluencerCampaignReportBusinessInputs"},"refresh_ai":{"type":"boolean","title":"Refresh Ai","default":true}},"type":"object","required":["business_inputs"],"title":"InfluencerCampaignReportUpdateRequest"},"InfluencerCampaignRoleEdit":{"properties":{"role":{"type":"string","maxLength":64,"minLength":1,"title":"Role"},"label":{"type":"string","maxLength":80,"minLength":1,"title":"Label"},"budget_share_pct":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Budget Share Pct"},"contact_day_offset":{"type":"integer","maximum":365.0,"minimum":-365.0,"title":"Contact Day Offset"},"post_day_offset":{"type":"integer","maximum":365.0,"minimum":-365.0,"title":"Post Day Offset"}},"type":"object","required":["role","label","budget_share_pct","contact_day_offset","post_day_offset"],"title":"InfluencerCampaignRoleEdit"},"InfluencerCampaignRoleEditsRequest":{"properties":{"roles":{"items":{"$ref":"#/components/schemas/InfluencerCampaignRoleEdit"},"type":"array","maxItems":8,"minItems":1,"title":"Roles"}},"type":"object","required":["roles"],"title":"InfluencerCampaignRoleEditsRequest"},"InfluencerCampaignSourceListSyncRequest":{"properties":{"refresh_ai":{"type":"boolean","title":"Refresh Ai","default":true}},"type":"object","title":"InfluencerCampaignSourceListSyncRequest"},"InfluencerCampaignSummaryPageResponse":{"properties":{"campaigns":{"items":{"$ref":"#/components/schemas/InfluencerCampaignSummaryResponse"},"type":"array","title":"Campaigns"},"count":{"type":"integer","title":"Count"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["count","limit","offset","has_more"],"title":"InfluencerCampaignSummaryPageResponse"},"InfluencerCampaignSummaryResponse":{"properties":{"id":{"type":"string","title":"Id"},"organization_id":{"type":"string","title":"Organization Id"},"company_profile_id":{"type":"string","title":"Company Profile Id"},"objective":{"type":"string","title":"Objective"},"objectives":{"items":{"type":"string"},"type":"array","title":"Objectives"},"budget_min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Budget Min"},"budget_max":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Budget Max"},"budget_currency":{"type":"string","title":"Budget Currency","default":"USD"},"budget_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Budget Usd"},"target_markets":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Target Markets"},"platforms":{"items":{"type":"string"},"type":"array","title":"Platforms"},"posting_time_mode":{"type":"string","title":"Posting Time Mode"},"posting_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Posting Time"},"launch_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Launch Start"},"launch_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Launch End"},"status":{"type":"string","title":"Status"},"generation_version":{"type":"integer","title":"Generation Version"},"plan_origin":{"type":"string","title":"Plan Origin","default":"campaign_workflow"},"source_creator_list_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Creator List Id"},"planning_status":{"type":"string","title":"Planning Status","default":"ready"},"roster_revision":{"type":"integer","title":"Roster Revision","default":1},"roster_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Roster Hash"},"recommended_budget_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Recommended Budget Usd"},"collection_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Collection Name"},"collection_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Collection Description"},"is_pinned":{"type":"boolean","title":"Is Pinned","default":false},"pinned_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pinned By User Id"},"pinned_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pinned At"},"archived_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Archived By User Id"},"archived_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Archived At"},"deleted_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deleted By User Id"},"deleted_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Deleted At"},"settings":{"additionalProperties":true,"type":"object","title":"Settings"},"curated_lists":{"items":{"$ref":"#/components/schemas/InfluencerCampaignCuratedListSummaryResponse"},"type":"array","title":"Curated Lists"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","organization_id","company_profile_id","objective","posting_time_mode","status","generation_version"],"title":"InfluencerCampaignSummaryResponse"},"InfluencerCampaignTargetMarket":{"properties":{"country_code":{"type":"string","maxLength":16,"minLength":2,"title":"Country Code"},"country_name":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Country Name"},"weight":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Weight"}},"type":"object","required":["country_code","weight"],"title":"InfluencerCampaignTargetMarket"},"InfluencerCampaignTargetMarketSeedResponse":{"properties":{"basis":{"type":"string","enum":["sales_data","operating_regions"],"title":"Basis"},"markets":{"items":{"$ref":"#/components/schemas/InfluencerCampaignTargetMarket"},"type":"array","title":"Markets"},"source_label":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Source Label"},"workspace_label":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Workspace Label"},"date_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Start"},"date_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date End"},"top_revenue_regions":{"items":{"type":"string"},"type":"array","maxItems":3,"title":"Top Revenue Regions"}},"type":"object","required":["basis"],"title":"InfluencerCampaignTargetMarketSeedResponse","description":"Backend-truth seed for the wizard's target-market card.\n\nbasis \"sales_data\" means the markets were weighted by first-party sales\nfile revenue; \"operating_regions\" means the client should keep its\nexisting operating-regions seeding (markets is empty in that case)."},"InfluencerCampaignUpdateRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Description"},"objective":{"anyOf":[{"type":"string","enum":["distribution","brand_recall","sales","launch","category_launch"]},{"type":"null"}],"title":"Objective"},"objectives":{"anyOf":[{"items":{"type":"string","enum":["distribution","brand_recall","sales","launch","category_launch"]},"type":"array","maxItems":5,"minItems":1},{"type":"null"}],"title":"Objectives"},"budget_min":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Budget Min"},"budget_max":{"anyOf":[{"type":"number","minimum":1.0},{"type":"null"}],"title":"Budget Max","description":"Planning ceiling. Explicit null clears the campaign budget; omission preserves it."},"budget_currency":{"anyOf":[{"type":"string","enum":["USD","INR"]},{"type":"null"}],"title":"Budget Currency"},"budget_usd":{"anyOf":[{"type":"number","minimum":1.0},{"type":"null"}],"title":"Budget Usd"},"target_markets":{"anyOf":[{"items":{"$ref":"#/components/schemas/InfluencerCampaignTargetMarket"},"type":"array","maxItems":8,"minItems":1},{"type":"null"}],"title":"Target Markets"},"platforms":{"anyOf":[{"items":{"type":"string","enum":["INST","YT","TT"]},"type":"array","maxItems":3,"minItems":1},{"type":"null"}],"title":"Platforms"},"posting_time_mode":{"anyOf":[{"type":"string","enum":["pomo_optimizes","manual"]},{"type":"null"}],"title":"Posting Time Mode"},"posting_time":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Posting Time"},"creator_type_includes":{"anyOf":[{"items":{"type":"string","enum":["individual","celebrity","brand","publisher","community","unknown"]},"type":"array","maxItems":6},{"type":"null"}],"title":"Creator Type Includes"},"creator_type_excludes":{"anyOf":[{"items":{"type":"string","enum":["individual","celebrity","brand","publisher","community","unknown"]},"type":"array","maxItems":6},{"type":"null"}],"title":"Creator Type Excludes"},"launch_start":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Launch Start"},"launch_end":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Launch End"},"settings":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Settings"},"refresh_cohort":{"type":"boolean","title":"Refresh Cohort","default":false},"expected_updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expected Updated At"}},"additionalProperties":false,"type":"object","title":"InfluencerCampaignUpdateRequest","description":"Sparse edits to an existing campaign; omitted values are preserved.\n\nNull clears nullable scalar fields. Settings merge by top-level key, with\nnull removing that key. Creator regeneration must be explicitly requested.\nCoupled inputs (dates, budget, posting time) are validated against stored\nstate by the service while holding the campaign lock."},"InfluencerCampaignUpsertRequest":{"properties":{"objective":{"anyOf":[{"type":"string","enum":["distribution","brand_recall","sales","launch","category_launch"]},{"type":"null"}],"title":"Objective"},"objectives":{"items":{"type":"string","enum":["distribution","brand_recall","sales","launch","category_launch"]},"type":"array","maxItems":5,"title":"Objectives"},"budget_min":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Budget Min"},"budget_max":{"anyOf":[{"type":"number","minimum":1.0},{"type":"null"}],"title":"Budget Max","description":"Campaign planning ceiling. Leave null when the budget has not been decided."},"budget_currency":{"type":"string","enum":["USD","INR"],"title":"Budget Currency","default":"USD"},"budget_usd":{"anyOf":[{"type":"number","minimum":1.0},{"type":"null"}],"title":"Budget Usd"},"target_markets":{"items":{"$ref":"#/components/schemas/InfluencerCampaignTargetMarket"},"type":"array","maxItems":8,"minItems":1,"title":"Target Markets"},"platforms":{"items":{"type":"string","enum":["INST","YT","TT"]},"type":"array","maxItems":3,"minItems":1,"title":"Platforms"},"posting_time_mode":{"type":"string","enum":["pomo_optimizes","manual"],"title":"Posting Time Mode","default":"pomo_optimizes"},"posting_time":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Posting Time"},"creator_type_includes":{"items":{"type":"string","enum":["individual","celebrity","brand","publisher","community","unknown"]},"type":"array","maxItems":6,"title":"Creator Type Includes"},"creator_type_excludes":{"items":{"type":"string","enum":["individual","celebrity","brand","publisher","community","unknown"]},"type":"array","maxItems":6,"title":"Creator Type Excludes"},"launch_start":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Launch Start"},"launch_end":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Launch End"},"settings":{"additionalProperties":true,"type":"object","title":"Settings"},"refresh_cohort":{"type":"boolean","title":"Refresh Cohort","default":true}},"type":"object","required":["target_markets","platforms"],"title":"InfluencerCampaignUpsertRequest"},"InfluencerDeliverablePricingEstimate":{"properties":{"deliverable_type":{"type":"string","title":"Deliverable Type"},"deliverable_label":{"type":"string","title":"Deliverable Label"},"deliverable_description":{"type":"string","title":"Deliverable Description"},"pricing_basis":{"type":"string","title":"Pricing Basis"},"confidence":{"type":"string","enum":["low","medium","high"],"title":"Confidence"},"expected_views":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Expected Views"},"expected_views_min":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Expected Views Min"},"expected_views_max":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Expected Views Max"},"expected_views_source":{"anyOf":[{"type":"string","enum":["recent_media_direct_views","provider_avg_video_views","avg_interactions_fallback","followers_fallback"]},{"type":"null"}],"title":"Expected Views Source"},"expected_views_confidence":{"anyOf":[{"type":"string","enum":["low","medium","high"]},{"type":"null"}],"title":"Expected Views Confidence"},"expected_views_basis":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Views Basis"},"cpm_min_usd":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Cpm Min Usd"},"cpm_max_usd":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Cpm Max Usd"},"cpm_suggested_usd":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Cpm Suggested Usd"},"canonical_range":{"$ref":"#/components/schemas/InfluencerPricingRange"},"local_range":{"anyOf":[{"$ref":"#/components/schemas/InfluencerPricingRange"},{"type":"null"}]},"display_ranges":{"items":{"$ref":"#/components/schemas/InfluencerPricingRange"},"type":"array","title":"Display Ranges"},"factors":{"items":{"type":"string"},"type":"array","title":"Factors"},"assumptions":{"items":{"type":"string"},"type":"array","title":"Assumptions"},"missing_data":{"items":{"type":"string"},"type":"array","title":"Missing Data"},"caveats":{"items":{"type":"string"},"type":"array","title":"Caveats"}},"type":"object","required":["deliverable_type","deliverable_label","deliverable_description","pricing_basis","confidence","canonical_range","display_ranges"],"title":"InfluencerDeliverablePricingEstimate","description":"Structured price estimate for one deliverable type."},"InfluencerInventoryBudgetMatch":{"properties":{"matched":{"type":"boolean","title":"Matched"},"budget_type":{"type":"string","title":"Budget Type"},"min_budget_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Budget Usd"},"max_budget_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Budget Usd"},"matched_deliverable":{"type":"string","title":"Matched Deliverable"},"suggested_amount":{"type":"number","title":"Suggested Amount"}},"type":"object","required":["matched","budget_type","matched_deliverable","suggested_amount"],"title":"InfluencerInventoryBudgetMatch"},"InfluencerInventoryCreatorIngestRequest":{"properties":{"inventory_account_id":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Inventory Account Id"},"platform":{"type":"string","enum":["INST","YT","TT","instagram","youtube","tiktok"],"title":"Platform"},"platform_account_id":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Platform Account Id"},"handle":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Handle"},"display_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Display Name"},"profile_url":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Profile Url"},"avatar_url":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Avatar Url"},"snippet":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Snippet"},"creator_type":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Creator Type"},"primary_niche":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Primary Niche"},"profile_description":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Profile Description"},"followers":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Followers"},"avg_er":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Avg Er"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified"},"account_country":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Account Country"},"audience_top_country_code":{"anyOf":[{"type":"string","maxLength":16},{"type":"null"}],"title":"Audience Top Country Code"},"quality_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quality Score"},"pct_fake_followers":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Fake Followers"},"provider_profile":{"additionalProperties":true,"type":"object","title":"Provider Profile"},"discovery_snapshot":{"anyOf":[{"$ref":"#/components/schemas/InfluencerInventorySearchResult-Input"},{"type":"null"}]},"bio_summary":{"anyOf":[{"type":"string","maxLength":220},{"type":"null"}],"title":"Bio Summary"},"public_contacts":{"items":{"$ref":"#/components/schemas/InfluencerPublicContact"},"type":"array","title":"Public Contacts"},"suggested_outreach_messages":{"anyOf":[{"$ref":"#/components/schemas/InfluencerSuggestedOutreachMessages"},{"type":"null"}]},"suggested_dm_message":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Suggested Dm Message"}},"type":"object","required":["platform"],"title":"InfluencerInventoryCreatorIngestRequest"},"InfluencerInventoryCuratedList":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"persona":{"type":"string","title":"Persona"},"query":{"type":"string","title":"Query"},"rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rationale"},"brand_fit_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand Fit Summary"},"brand_fit_points":{"items":{"type":"string"},"type":"array","maxItems":3,"title":"Brand Fit Points"},"platforms":{"items":{"type":"string","enum":["INST","YT","TT"]},"type":"array","title":"Platforms"},"total_returned":{"type":"integer","title":"Total Returned"},"results":{"items":{"$ref":"#/components/schemas/InfluencerInventorySearchResult-Output"},"type":"array","title":"Results"},"debug":{"additionalProperties":true,"type":"object","title":"Debug"}},"type":"object","required":["id","title","persona","query","platforms","total_returned","results"],"title":"InfluencerInventoryCuratedList"},"InfluencerInventoryCuratedListsFirstPartyGrounding":{"properties":{"source_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Label"},"workspace_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workspace Label"},"date_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Start"},"date_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date End"}},"type":"object","title":"InfluencerInventoryCuratedListsFirstPartyGrounding"},"InfluencerInventoryCuratedListsRequest":{"properties":{"platforms":{"items":{"type":"string","enum":["INST","YT","TT"]},"type":"array","maxItems":3,"minItems":1,"title":"Platforms"},"list_count":{"type":"integer","maximum":5.0,"minimum":4.0,"title":"List Count","default":5},"creators_per_list":{"anyOf":[{"type":"integer","maximum":50.0,"minimum":1.0},{"type":"null"}],"title":"Creators Per List"},"force_refresh":{"type":"boolean","title":"Force Refresh","default":false},"list_index":{"anyOf":[{"type":"integer","maximum":4.0,"minimum":0.0},{"type":"null"}],"title":"List Index"},"creator_type_includes":{"items":{"type":"string"},"type":"array","maxItems":6,"title":"Creator Type Includes"},"creator_type_excludes":{"items":{"type":"string"},"type":"array","maxItems":6,"title":"Creator Type Excludes"}},"type":"object","title":"InfluencerInventoryCuratedListsRequest"},"InfluencerInventoryCuratedListsResponse":{"properties":{"lists":{"items":{"$ref":"#/components/schemas/InfluencerInventoryCuratedList"},"type":"array","title":"Lists"},"first_party_grounding":{"anyOf":[{"$ref":"#/components/schemas/InfluencerInventoryCuratedListsFirstPartyGrounding"},{"type":"null"}]},"debug":{"additionalProperties":true,"type":"object","title":"Debug"}},"type":"object","required":["lists"],"title":"InfluencerInventoryCuratedListsResponse"},"InfluencerInventoryQueryFilterAnalysisRequest":{"properties":{"query":{"type":"string","maxLength":500,"minLength":2,"title":"Query"}},"type":"object","required":["query"],"title":"InfluencerInventoryQueryFilterAnalysisRequest"},"InfluencerInventoryQueryFilterAnalysisResponse":{"properties":{"min_followers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Followers"},"max_followers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Followers"},"follower_size_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Follower Size Label"},"location_filters":{"items":{"type":"string"},"type":"array","title":"Location Filters"},"creator_type_includes":{"items":{"type":"string"},"type":"array","title":"Creator Type Includes"},"creator_type_excludes":{"items":{"type":"string"},"type":"array","title":"Creator Type Excludes"},"matched_signals":{"items":{"type":"string"},"type":"array","title":"Matched Signals"},"source":{"type":"string","title":"Source","default":"fallback"}},"type":"object","title":"InfluencerInventoryQueryFilterAnalysisResponse"},"InfluencerInventorySearchRequest":{"properties":{"query":{"type":"string","maxLength":500,"minLength":2,"title":"Query"},"limit":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Limit","default":20},"query_type":{"type":"string","enum":["hybrid","ann","FULL_TEXT"],"title":"Query Type","default":"hybrid"},"platforms":{"items":{"type":"string","enum":["INST","YT","TT"]},"type":"array","title":"Platforms"},"creator_type":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Creator Type"},"creator_type_includes":{"items":{"type":"string"},"type":"array","maxItems":6,"title":"Creator Type Includes"},"creator_type_excludes":{"items":{"type":"string"},"type":"array","maxItems":6,"title":"Creator Type Excludes"},"min_followers":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Min Followers"},"max_followers":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Max Followers"},"location_filters":{"items":{"type":"string"},"type":"array","maxItems":8,"title":"Location Filters"}},"type":"object","required":["query"],"title":"InfluencerInventorySearchRequest"},"InfluencerInventorySearchResponse":{"properties":{"query":{"type":"string","title":"Query"},"query_type":{"type":"string","title":"Query Type"},"index_name":{"type":"string","title":"Index Name"},"total_returned":{"type":"integer","title":"Total Returned"},"results":{"items":{"$ref":"#/components/schemas/InfluencerInventorySearchResult-Output"},"type":"array","title":"Results"},"debug":{"additionalProperties":true,"type":"object","title":"Debug"}},"type":"object","required":["query","query_type","index_name","total_returned","results"],"title":"InfluencerInventorySearchResponse"},"InfluencerInventorySearchResult-Input":{"properties":{"evidence":{"anyOf":[{"$ref":"#/components/schemas/CreatorEvidenceEnvelope-Input"},{"type":"null"}]},"vector_record_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vector Record Id"},"inventory_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inventory Account Id"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"platform_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform Account Id"},"handle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Handle"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Url"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"document_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Type"},"document_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Version"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet"},"chunk_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chunk Text"},"creator_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creator Type"},"primary_niche":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Niche"},"profile_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Description"},"secondary_niches":{"items":{"type":"string"},"type":"array","title":"Secondary Niches"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"industry_verticals":{"items":{"type":"string"},"type":"array","title":"Industry Verticals"},"brand_fit_categories":{"items":{"type":"string"},"type":"array","title":"Brand Fit Categories"},"content_pillars":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Content Pillars"},"collaboration_ideas":{"items":{"type":"string"},"type":"array","title":"Collaboration Ideas"},"risk_flags":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Risk Flags"},"pricing_estimates":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Pricing Estimates"},"budget_match":{"anyOf":[{"$ref":"#/components/schemas/InfluencerInventoryBudgetMatch"},{"type":"null"}]},"provider_profile":{"additionalProperties":true,"type":"object","title":"Provider Profile"},"followers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Followers"},"avg_er":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Er"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified"},"account_country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Country"},"audience_top_country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience Top Country Code"},"quality_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quality Score"},"pct_fake_followers":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Fake Followers"},"bio_summary":{"anyOf":[{"type":"string","maxLength":220},{"type":"null"}],"title":"Bio Summary"},"public_contacts":{"items":{"$ref":"#/components/schemas/InfluencerPublicContact"},"type":"array","title":"Public Contacts"},"suggested_outreach_messages":{"anyOf":[{"$ref":"#/components/schemas/InfluencerSuggestedOutreachMessages"},{"type":"null"}]}},"type":"object","title":"InfluencerInventorySearchResult"},"InfluencerInventorySearchResult-Output":{"properties":{"evidence":{"anyOf":[{"$ref":"#/components/schemas/CreatorEvidenceEnvelope-Output"},{"type":"null"}]},"vector_record_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vector Record Id"},"inventory_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inventory Account Id"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"platform_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform Account Id"},"handle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Handle"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"profile_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Url"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"},"document_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Type"},"document_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Version"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet"},"chunk_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chunk Text"},"creator_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creator Type"},"primary_niche":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Niche"},"profile_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Description"},"secondary_niches":{"items":{"type":"string"},"type":"array","title":"Secondary Niches"},"keywords":{"items":{"type":"string"},"type":"array","title":"Keywords"},"industry_verticals":{"items":{"type":"string"},"type":"array","title":"Industry Verticals"},"brand_fit_categories":{"items":{"type":"string"},"type":"array","title":"Brand Fit Categories"},"content_pillars":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Content Pillars"},"collaboration_ideas":{"items":{"type":"string"},"type":"array","title":"Collaboration Ideas"},"risk_flags":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Risk Flags"},"pricing_estimates":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Pricing Estimates"},"budget_match":{"anyOf":[{"$ref":"#/components/schemas/InfluencerInventoryBudgetMatch"},{"type":"null"}]},"provider_profile":{"additionalProperties":true,"type":"object","title":"Provider Profile"},"followers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Followers"},"avg_er":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Avg Er"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified"},"account_country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Country"},"audience_top_country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience Top Country Code"},"quality_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quality Score"},"pct_fake_followers":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pct Fake Followers"},"bio_summary":{"anyOf":[{"type":"string","maxLength":220},{"type":"null"}],"title":"Bio Summary"},"public_contacts":{"items":{"$ref":"#/components/schemas/InfluencerPublicContact"},"type":"array","title":"Public Contacts"},"suggested_outreach_messages":{"anyOf":[{"$ref":"#/components/schemas/InfluencerSuggestedOutreachMessages"},{"type":"null"}]}},"type":"object","title":"InfluencerInventorySearchResult"},"InfluencerPricingEstimateRequest":{"properties":{"evidence_snapshot_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Evidence Snapshot Id"},"creator_id":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Creator Id"},"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"handle":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Handle"},"platform":{"type":"string","enum":["tiktok","instagram","youtube","unknown"],"title":"Platform","default":"unknown"},"source":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Source"},"category":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Category"},"bio":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Bio"},"audience":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Audience"},"followers":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Followers"},"followers_value":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Followers Value"},"engagement":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Engagement"},"engagement_rate":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Engagement Rate"},"likes_value":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Likes Value"},"videos_value":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Videos Value"},"views_value":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Views Value"},"avg_video_views_value":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Avg Video Views Value"},"avg_interactions_value":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Avg Interactions Value"},"recent_media_view_counts":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Recent Media View Counts"},"verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Verified"},"private_account":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Private Account"},"location_label":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Location Label"},"country_code":{"anyOf":[{"type":"string","maxLength":2},{"type":"null"}],"title":"Country Code"},"country_name":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Country Name"},"subdivision_code":{"anyOf":[{"type":"string","maxLength":24},{"type":"null"}],"title":"Subdivision Code"},"subdivision_name":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Subdivision Name"}},"type":"object","required":["name"],"title":"InfluencerPricingEstimateRequest","description":"Creator profile snapshot used to estimate a collaboration price range."},"InfluencerPricingEstimateResponse":{"properties":{"evidence":{"anyOf":[{"$ref":"#/components/schemas/CreatorEvidenceEnvelope-Output"},{"type":"null"}]},"market_country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Country Code"},"market_country_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Country Name"},"estimates":{"items":{"$ref":"#/components/schemas/InfluencerDeliverablePricingEstimate"},"type":"array","title":"Estimates"}},"type":"object","required":["estimates"],"title":"InfluencerPricingEstimateResponse","description":"Structured influencer price estimates grouped by deliverable type."},"InfluencerPricingRange":{"properties":{"currency":{"type":"string","maxLength":3,"minLength":3,"title":"Currency"},"min_amount":{"type":"number","minimum":0.0,"title":"Min Amount"},"max_amount":{"type":"number","minimum":0.0,"title":"Max Amount"},"suggested_amount":{"type":"number","minimum":0.0,"title":"Suggested Amount"},"label":{"type":"string","title":"Label"},"is_local":{"type":"boolean","title":"Is Local","default":false},"exchange_rate_per_usd":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"null"}],"title":"Exchange Rate Per Usd"}},"type":"object","required":["currency","min_amount","max_amount","suggested_amount","label"],"title":"InfluencerPricingRange","description":"Price range in one display currency."},"InfluencerPublicContact":{"properties":{"type":{"type":"string","enum":["email","phone","social","messaging","link_hub","website","contact_form","booking","address","company","other"],"title":"Type"},"purpose":{"type":"string","enum":["creator","business","management","agency","press","general"],"title":"Purpose"},"label":{"type":"string","maxLength":120,"minLength":1,"title":"Label"},"value":{"type":"string","maxLength":2000,"minLength":1,"title":"Value"}},"type":"object","required":["type","purpose","label","value"],"title":"InfluencerPublicContact"},"InfluencerRelatedAccountsDiscoveryInput":{"properties":{"profile_url":{"type":"string","maxLength":1000,"minLength":1,"title":"Profile Url"}},"type":"object","required":["profile_url"],"title":"InfluencerRelatedAccountsDiscoveryInput"},"InfluencerRelatedAccountsDiscoveryRequest":{"properties":{"result":{"$ref":"#/components/schemas/InfluencerRelatedAccountsDiscoveryInput"}},"type":"object","required":["result"],"title":"InfluencerRelatedAccountsDiscoveryRequest"},"InfluencerRelatedAccountsDiscoveryResponse":{"properties":{"profile_url":{"type":"string","title":"Profile Url"},"public_contacts":{"items":{"$ref":"#/components/schemas/InfluencerPublicContact"},"type":"array","title":"Public Contacts"},"contacts_json":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Contacts Json"},"debug":{"additionalProperties":true,"type":"object","title":"Debug"}},"type":"object","required":["profile_url"],"title":"InfluencerRelatedAccountsDiscoveryResponse"},"InfluencerSuggestedEmailMessage":{"properties":{"subject":{"type":"string","maxLength":160,"minLength":1,"title":"Subject"},"message":{"type":"string","maxLength":800,"minLength":1,"title":"Message"}},"type":"object","required":["subject","message"],"title":"InfluencerSuggestedEmailMessage"},"InfluencerSuggestedOutreachMessages":{"properties":{"email":{"$ref":"#/components/schemas/InfluencerSuggestedEmailMessage"},"platform_dm":{"$ref":"#/components/schemas/InfluencerSuggestedPlatformDmMessage"}},"type":"object","required":["email","platform_dm"],"title":"InfluencerSuggestedOutreachMessages"},"InfluencerSuggestedPlatformDmMessage":{"properties":{"message":{"type":"string","maxLength":500,"minLength":1,"title":"Message"}},"type":"object","required":["message"],"title":"InfluencerSuggestedPlatformDmMessage"},"InfluencerWebDiscoveryFiltersRequest":{"properties":{"platforms":{"items":{"type":"string","enum":["INST","YT","TT"]},"type":"array","maxItems":3,"minItems":1,"title":"Platforms"},"account_locations":{"items":{"type":"string","maxLength":120,"minLength":1},"type":"array","maxItems":8,"title":"Account Locations"},"min_followers":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Min Followers"},"max_followers":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Max Followers"},"languages":{"items":{"type":"string","maxLength":120,"minLength":1},"type":"array","maxItems":8,"title":"Languages"},"verified_only":{"type":"boolean","title":"Verified Only","default":false},"creator_type_includes":{"items":{"type":"string"},"type":"array","maxItems":6,"title":"Creator Type Includes"},"creator_type_excludes":{"items":{"type":"string"},"type":"array","maxItems":6,"title":"Creator Type Excludes"}},"type":"object","title":"InfluencerWebDiscoveryFiltersRequest"},"InfluencerWebDiscoveryJobProgress":{"properties":{"stage":{"type":"string","enum":["queued","discovering","validating","ready"],"title":"Stage","default":"queued"},"message":{"type":"string","title":"Message","default":"Your creator search is queued..."},"progress":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Progress","default":0.0},"candidate_count":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Candidate Count"},"validated_count":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Validated Count"}},"type":"object","title":"InfluencerWebDiscoveryJobProgress"},"InfluencerWebDiscoveryJobStatusResponse":{"properties":{"job_id":{"type":"string","title":"Job Id"},"status":{"type":"string","enum":["queued","running","completed","completed_empty","failed","cancelled"],"title":"Status"},"progress":{"anyOf":[{"$ref":"#/components/schemas/InfluencerWebDiscoveryJobProgress"},{"type":"null"}]},"result":{"anyOf":[{"$ref":"#/components/schemas/InfluencerInventorySearchResponse"},{"type":"null"}]},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"poll_after_ms":{"type":"integer","title":"Poll After Ms","default":2000}},"type":"object","required":["job_id","status"],"title":"InfluencerWebDiscoveryJobStatusResponse"},"InfluencerWebDiscoveryJobSubmissionResponse":{"properties":{"job_id":{"type":"string","title":"Job Id"},"status":{"type":"string","const":"queued","title":"Status","default":"queued"},"poll_url":{"type":"string","title":"Poll Url"},"cancel_url":{"type":"string","title":"Cancel Url"},"poll_after_ms":{"type":"integer","title":"Poll After Ms","default":2000}},"type":"object","required":["job_id","poll_url","cancel_url"],"title":"InfluencerWebDiscoveryJobSubmissionResponse"},"InfluencerWebDiscoveryRequest":{"properties":{"query":{"type":"string","maxLength":500,"minLength":2,"title":"Query"},"filters":{"$ref":"#/components/schemas/InfluencerWebDiscoveryFiltersRequest"},"source_brief":{"type":"string","maxLength":6000,"title":"Source Brief","default":""},"reference_image_urls":{"items":{"type":"string"},"type":"array","maxItems":4,"title":"Reference Image Urls"},"selected_product_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":8,"title":"Selected Product Ids"}},"type":"object","required":["query"],"title":"InfluencerWebDiscoveryRequest"},"InitialSyncStatusResponse":{"properties":{"status":{"type":"string","title":"Status","description":"Current sync status: pending, running, completed, failed, skipped, not_started"},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Id","description":"Databricks job run ID"},"triggered_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Triggered At","description":"When the sync was triggered (ISO format)"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message if sync failed"},"run_page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Page Url","description":"URL to view the Databricks job run"}},"type":"object","required":["status"],"title":"InitialSyncStatusResponse","description":"Standard response for initial data-source sync status.\n\nUsed by: GET /{platform}/initial-sync-status"},"InquiryDecisionRequest":{"properties":{"decision":{"type":"string","enum":["accepted","review","needs_information"],"title":"Decision"},"note":{"type":"string","maxLength":1000,"title":"Note","default":""},"owner_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Owner User Id"}},"additionalProperties":false,"type":"object","required":["decision"],"title":"InquiryDecisionRequest"},"InquiryEraseRequest":{"properties":{"confirm":{"type":"string","const":"delete_inquiry_data","title":"Confirm"}},"additionalProperties":false,"type":"object","required":["confirm"],"title":"InquiryEraseRequest"},"InquiryQualificationRequest":{"properties":{"qualification":{"type":"string","enum":["matched","review"],"title":"Qualification"},"note":{"type":"string","maxLength":1000,"minLength":1,"title":"Note"}},"additionalProperties":false,"type":"object","required":["qualification","note"],"title":"InquiryQualificationRequest"},"InquirySource":{"properties":{"utm_source":{"type":"string","maxLength":200,"title":"Utm Source","default":""},"utm_medium":{"type":"string","maxLength":200,"title":"Utm Medium","default":""},"utm_campaign":{"type":"string","maxLength":200,"title":"Utm Campaign","default":""},"utm_content":{"type":"string","maxLength":200,"title":"Utm Content","default":""},"utm_term":{"type":"string","maxLength":200,"title":"Utm Term","default":""}},"additionalProperties":false,"type":"object","title":"InquirySource"},"InquirySubmission":{"properties":{"release_id":{"type":"string","format":"uuid","title":"Release Id"},"submission_token":{"type":"string","maxLength":2000,"minLength":20,"title":"Submission Token"},"idempotency_key":{"type":"string","format":"uuid","title":"Idempotency Key"},"full_name":{"type":"string","maxLength":160,"minLength":1,"title":"Full Name"},"email":{"type":"string","maxLength":254,"minLength":3,"title":"Email"},"company":{"type":"string","maxLength":240,"minLength":1,"title":"Company"},"answers":{"additionalProperties":{"type":"string"},"type":"object","maxProperties":2,"title":"Answers"},"marketing_opt_in":{"type":"boolean","title":"Marketing Opt In","default":false},"hp_website":{"type":"string","maxLength":500,"title":"Hp Website","default":""},"source":{"$ref":"#/components/schemas/InquirySource"}},"additionalProperties":false,"type":"object","required":["release_id","submission_token","idempotency_key","full_name","email","company"],"title":"InquirySubmission"},"InsightConversationContinuations":{"properties":{"choices":{"items":{"$ref":"#/components/schemas/InsightWorkConversation"},"type":"array","title":"Choices","default":[]},"complete":{"type":"boolean","title":"Complete","default":true}},"additionalProperties":false,"type":"object","title":"InsightConversationContinuations"},"InsightMeasurementReview":{"properties":{"kind":{"type":"string","const":"insight_measurement","title":"Kind","default":"insight_measurement"},"action":{"type":"string","const":"close_early","title":"Action"},"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title"},"team_name":{"type":"string","maxLength":200,"minLength":1,"title":"Team Name"},"metric_label":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Metric Label"},"baseline_summary":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Baseline Summary"},"window_summary":{"type":"string","maxLength":300,"minLength":1,"title":"Window Summary"},"effect":{"type":"string","maxLength":600,"minLength":1,"title":"Effect"}},"additionalProperties":false,"type":"object","required":["action","title","team_name","window_summary","effect"],"title":"InsightMeasurementReview","description":"Closing an insight's measurement window before its planned readout.\n\nThe reading taken at confirmation becomes the insight's result and the\nwindow cannot be reopened, so the review names the insight, the metric\nbeing judged, where the window stands and what closing it does."},"InsightPresentation":{"properties":{"version":{"type":"string","const":"insight_presentation_v1","title":"Version","default":"insight_presentation_v1"},"proof":{"anyOf":[{"$ref":"#/components/schemas/InsightPresentationFact"},{"type":"null"}]},"visualization":{"anyOf":[{"$ref":"#/components/schemas/InsightPresentationVisual"},{"type":"null"}]},"snapshot_items":{"items":{"$ref":"#/components/schemas/InsightPresentationFact"},"type":"array","title":"Snapshot Items"},"sources":{"items":{"$ref":"#/components/schemas/InsightSourcePreview"},"type":"array","title":"Sources"}},"type":"object","title":"InsightPresentation"},"InsightPresentationFact":{"properties":{"kind":{"type":"string","enum":["metric","ratio","plan_count"],"title":"Kind"},"label":{"type":"string","title":"Label"},"value":{"type":"number","title":"Value"},"display_value":{"type":"string","title":"Display Value"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"denominator":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Denominator"},"metric_ids":{"items":{"type":"string"},"type":"array","title":"Metric Ids"},"evidence_ids":{"items":{"type":"string"},"type":"array","title":"Evidence Ids"},"plan_refs":{"items":{"type":"string"},"type":"array","title":"Plan Refs"},"estimate":{"type":"boolean","title":"Estimate","default":false},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"},"window":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Window"},"observed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observed At"},"sources":{"items":{"$ref":"#/components/schemas/InsightSource"},"type":"array","title":"Sources"}},"type":"object","required":["kind","label","value","display_value"],"title":"InsightPresentationFact"},"InsightPresentationPoint":{"properties":{"label":{"type":"string","title":"Label"},"value":{"type":"number","title":"Value"},"display_value":{"type":"string","title":"Display Value"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"metric_id":{"type":"string","title":"Metric Id"},"evidence_id":{"type":"string","title":"Evidence Id"},"observed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observed At"},"estimate":{"type":"boolean","title":"Estimate","default":false},"sources":{"items":{"$ref":"#/components/schemas/InsightSource"},"type":"array","title":"Sources"}},"type":"object","required":["label","value","display_value","metric_id","evidence_id"],"title":"InsightPresentationPoint"},"InsightPresentationStep":{"properties":{"ref":{"type":"string","title":"Ref"},"label":{"type":"string","title":"Label"},"carried_by":{"anyOf":[{"type":"string","enum":["system","you"]},{"type":"null"}],"title":"Carried By"}},"type":"object","required":["ref","label"],"title":"InsightPresentationStep"},"InsightPresentationVisual":{"properties":{"kind":{"type":"string","enum":["proportion","comparison","trend","steps"],"title":"Kind"},"label":{"type":"string","title":"Label"},"points":{"items":{"$ref":"#/components/schemas/InsightPresentationPoint"},"type":"array","title":"Points"},"steps":{"items":{"$ref":"#/components/schemas/InsightPresentationStep"},"type":"array","title":"Steps"},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"},"window":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Window"}},"type":"object","required":["kind","label"],"title":"InsightPresentationVisual"},"InsightSource":{"properties":{"source_id":{"type":"string","title":"Source Id"},"evidence_id":{"type":"string","title":"Evidence Id"},"kind":{"type":"string","enum":["web_page","saved_product","analysis","uploaded_data"],"title":"Kind"},"title":{"type":"string","maxLength":320,"minLength":1,"title":"Title"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"target":{"anyOf":[{"$ref":"#/components/schemas/InsightSourceTarget"},{"type":"null"}]},"observed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observed At"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publisher"},"excerpt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Excerpt"},"subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject"},"method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Method"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"}},"additionalProperties":false,"type":"object","required":["source_id","evidence_id","kind","title"],"title":"InsightSource"},"InsightSourcePreview":{"properties":{"source":{"$ref":"#/components/schemas/InsightSource"},"caption":{"type":"string","title":"Caption"},"metric_ids":{"items":{"type":"string"},"type":"array","title":"Metric Ids"},"facts":{"items":{"$ref":"#/components/schemas/InsightSourceValue"},"type":"array","title":"Facts"}},"type":"object","required":["source","caption"],"title":"InsightSourcePreview"},"InsightSourceTarget":{"properties":{"kind":{"type":"string","enum":["product","aeo_report","upload"],"title":"Kind"},"id":{"type":"string","format":"uuid","title":"Id"}},"additionalProperties":false,"type":"object","required":["kind","id"],"title":"InsightSourceTarget"},"InsightSourceValue":{"properties":{"metric_id":{"type":"string","title":"Metric Id"},"label":{"type":"string","title":"Label"},"value":{"type":"number","title":"Value"},"display_value":{"type":"string","title":"Display Value"},"estimate":{"type":"boolean","title":"Estimate","default":false}},"type":"object","required":["metric_id","label","value","display_value"],"title":"InsightSourceValue"},"InsightSubject":{"properties":{"kind":{"type":"string","const":"insight","title":"Kind","default":"insight"},"insight_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Insight Id"},"insight_key":{"anyOf":[{"type":"string","maxLength":191,"minLength":1},{"type":"null"}],"title":"Insight Key"},"team_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"},"observed_version":{"anyOf":[{"type":"string","maxLength":64,"minLength":64},{"type":"null"}],"title":"Observed Version"},"selected_step_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Selected Step Id"}},"additionalProperties":false,"type":"object","title":"InsightSubject","description":"Untrusted pointer to one Director-owned native insight card.\n\nCore rereads the card through ``InsightWorkService`` and binds its current\nversion, tenant, explanation context, and next native continuation before\nthe subject reaches the runtime."},"InsightWorkConversation":{"properties":{"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"kind":{"type":"string","enum":["work","discussion"],"title":"Kind","default":"work"},"title":{"type":"string","title":"Title"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"work_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Work Ids","default":[]},"work_titles":{"items":{"type":"string"},"type":"array","title":"Work Titles","default":[]}},"additionalProperties":false,"type":"object","required":["conversation_id","title"],"title":"InsightWorkConversation"},"InspirationBrowseContext":{"properties":{"industry":{"type":"string","maxLength":160,"title":"Industry"},"category":{"type":"string","maxLength":160,"title":"Category"},"search_terms":{"type":"string","maxLength":500,"title":"Search Terms"}},"type":"object","required":["industry","category","search_terms"],"title":"InspirationBrowseContext"},"InspirationCatalogResponse":{"properties":{"status":{"type":"string","enum":["ready","partial","needs_context","not_collected"],"title":"Status"},"context":{"$ref":"#/components/schemas/InspirationBrowseContext"},"groups":{"items":{"$ref":"#/components/schemas/InspirationPublicGroup"},"type":"array","maxItems":5,"title":"Groups"},"collected_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Collected At"},"job_status":{"anyOf":[{"type":"string","enum":["queued","building","failed","complete"]},{"type":"null"}],"title":"Job Status"},"job_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Id"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"progress":{"anyOf":[{"$ref":"#/components/schemas/CollectionProgress"},{"type":"null"}]},"has_previous":{"type":"boolean","title":"Has Previous","default":false},"showing_previous":{"type":"boolean","title":"Showing Previous","default":false}},"type":"object","required":["status","context","groups"],"title":"InspirationCatalogResponse"},"InspirationPublicGroup":{"properties":{"style":{"$ref":"#/components/schemas/StyleDefinition"},"target_count":{"type":"integer","const":10,"title":"Target Count","default":10},"actual_count":{"type":"integer","title":"Actual Count","default":0},"templates":{"items":{"$ref":"#/components/schemas/InspirationPublicTemplate"},"type":"array","title":"Templates"}},"type":"object","required":["style"],"title":"InspirationPublicGroup"},"InspirationPublicScores":{"properties":{"style_fit":{"$ref":"#/components/schemas/CriterionScore"},"industry_relevance":{"$ref":"#/components/schemas/CriterionScore"},"design_quality":{"$ref":"#/components/schemas/CriterionScore"},"reference_usefulness":{"$ref":"#/components/schemas/CriterionScore"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["style_fit","industry_relevance","design_quality","reference_usefulness","total"],"title":"InspirationPublicScores"},"InspirationPublicTemplate":{"properties":{"id":{"type":"string","title":"Id"},"rank":{"type":"integer","title":"Rank"},"title":{"type":"string","title":"Title"},"image_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Image Url"},"thumbnail_url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Thumbnail Url"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"source_page_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Source Page Url"},"source_name":{"type":"string","title":"Source Name"},"source_use":{"type":"string","enum":["supported","reference_only"],"title":"Source Use"},"ai_reference":{"type":"string","enum":["supported","unsupported","unknown"],"title":"Ai Reference"},"scores":{"$ref":"#/components/schemas/InspirationPublicScores"}},"type":"object","required":["id","rank","title","image_url","thumbnail_url","width","height","source_page_url","source_name","source_use","ai_reference","scores"],"title":"InspirationPublicTemplate"},"InstagramActivateIdentityRequest":{"properties":{"instagram_account_id":{"type":"string","title":"Instagram Account Id","description":"Instagram account ID to use for social publishing"},"auth_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Auth Method","description":"Selected auth method: instagram or facebook"}},"type":"object","required":["instagram_account_id"],"title":"InstagramActivateIdentityRequest"},"InstagramAuthResponseModel":{"properties":{"auth_url":{"type":"string","title":"Auth Url"}},"type":"object","required":["auth_url"],"title":"InstagramAuthResponseModel","description":"Response model for Instagram authorization URL."},"InstagramAvatarRefreshRequest":{"properties":{"url":{"type":"string","maxLength":4096,"minLength":1,"title":"Url"},"username":{"type":"string","maxLength":200,"minLength":1,"title":"Username"}},"type":"object","required":["url","username"],"title":"InstagramAvatarRefreshRequest"},"InstagramDmSourceCreateRequest":{"properties":{"social_media_integration_id":{"type":"string","format":"uuid","title":"Social Media Integration Id"},"account_id":{"type":"string","maxLength":255,"minLength":1,"title":"Account Id"},"account_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Account Name"},"idempotency_key":{"type":"string","maxLength":255,"minLength":8,"title":"Idempotency Key"},"activation_mode":{"type":"string","enum":["draft_only","active"],"title":"Activation Mode","default":"draft_only"}},"type":"object","required":["social_media_integration_id","account_id","idempotency_key"],"title":"InstagramDmSourceCreateRequest"},"InstagramPostCampaignRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id","description":"ID of the campaign to post"},"idea_number":{"type":"integer","title":"Idea Number","description":"Idea number within the campaign"},"instagram_account_id":{"type":"string","title":"Instagram Account Id","description":"Instagram business account ID to post to"},"instagram_account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instagram Account Name","description":"Instagram account display name"},"instagram_username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instagram Username","description":"Instagram username without @"},"auth_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Auth Method","description":"Selected auth method: instagram or facebook"},"variation":{"type":"integer","title":"Variation","description":"Variation number (0 for original, 1+ for variations)","default":0},"expected_creative_state_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Creative State Token","description":"Server-issued creative fingerprint for approval-gated publication"}},"type":"object","required":["campaign_id","idea_number","instagram_account_id"],"title":"InstagramPostCampaignRequest"},"InstagramSourceCreateRequest":{"properties":{"social_media_integration_id":{"type":"string","format":"uuid","title":"Social Media Integration Id"},"account_id":{"type":"string","maxLength":255,"minLength":1,"title":"Account Id"},"account_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Account Name"},"idempotency_key":{"type":"string","maxLength":255,"minLength":8,"title":"Idempotency Key"}},"type":"object","required":["social_media_integration_id","account_id","idempotency_key"],"title":"InstagramSourceCreateRequest"},"InterventionObservationRequest":{"properties":{"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"event_kind":{"type":"string","enum":["shown","opened"],"title":"Event Kind"},"observed_at":{"type":"string","format":"date-time","title":"Observed At"},"exposure_policy":{"type":"string","const":"web.proactive-region.v1","title":"Exposure Policy"},"target":{"type":"string","enum":["card","evidence","native_subject"],"title":"Target"},"action_reference":{"anyOf":[{"type":"string","maxLength":191,"minLength":1},{"type":"null"}],"title":"Action Reference"}},"additionalProperties":false,"type":"object","required":["organization_id","company_profile_id","conversation_id","event_kind","observed_at","exposure_policy","target"],"title":"InterventionObservationRequest","description":"Client-observed exposure only; identities are lookup keys, not authority."},"InterventionObservationResponse":{"properties":{"receipt_id":{"type":"string","format":"uuid","title":"Receipt Id"},"event_kind":{"type":"string","enum":["shown","opened"],"title":"Event Kind"},"occurred_at":{"type":"string","format":"date-time","title":"Occurred At"},"recorded_at":{"type":"string","format":"date-time","title":"Recorded At"}},"additionalProperties":false,"type":"object","required":["receipt_id","event_kind","occurred_at","recorded_at"],"title":"InterventionObservationResponse"},"InterventionReplyLookup":{"properties":{"source_message_id":{"type":"string","format":"uuid","title":"Source Message Id"},"action_reference":{"anyOf":[{"type":"string","maxLength":191,"minLength":1,"pattern":"^[a-z][a-z0-9_.:-]{0,190}$"},{"type":"null"}],"title":"Action Reference"}},"additionalProperties":false,"type":"object","required":["source_message_id"],"title":"InterventionReplyLookup"},"InvitationInfoResponse":{"properties":{"invitation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Invitation Id"},"organization_name":{"type":"string","title":"Organization Name"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"invited_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invited By"},"role":{"type":"string","title":"Role"},"valid":{"type":"boolean","title":"Valid"},"already_member":{"type":"boolean","title":"Already Member"},"invite_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invite Type"},"invited_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invited Email"},"email_matches":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Email Matches"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"company_profile_access":{"anyOf":[{"items":{"$ref":"#/components/schemas/InvitationProfileAccess"},"type":"array"},{"type":"null"}],"title":"Company Profile Access"},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Message"}},"type":"object","required":["organization_name","organization_id","role","valid","already_member"],"title":"InvitationInfoResponse","description":"Response from invitation preview endpoint."},"InvitationProfileAccess":{"properties":{"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"company_profile_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Name"},"role":{"type":"string","title":"Role"}},"type":"object","required":["company_profile_id","role"],"title":"InvitationProfileAccess","description":"Profile access details attached to an invite."},"InviteDomainRestrictionRequest":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"allowed_domains":{"items":{"type":"string"},"type":"array","title":"Allowed Domains","default":[]}},"type":"object","required":["enabled"],"title":"InviteDomainRestrictionRequest","description":"Request payload for invite domain restrictions."},"InviteDomainRestrictionResponse":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"allowed_domains":{"items":{"type":"string"},"type":"array","title":"Allowed Domains","default":[]},"non_matching_member_count":{"type":"integer","title":"Non Matching Member Count","default":0},"total_members":{"type":"integer","title":"Total Members","default":0}},"type":"object","required":["enabled"],"title":"InviteDomainRestrictionResponse","description":"Response payload for invite domain restrictions."},"JobListItem":{"properties":{"job_id":{"type":"string","title":"Job Id"},"type":{"type":"string","title":"Type"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"}},"type":"object","required":["job_id","type","status","created_at"],"title":"JobListItem","description":"Summary info for a job in a list","example":{"completed_at":"2025-01-15T10:32:15Z","created_at":"2025-01-15T10:30:00Z","job_id":"987fcdeb-51a2-43f7-9876-543210987654","status":"completed","type":"ad_creation"}},"JobListResponse":{"properties":{"jobs":{"items":{"$ref":"#/components/schemas/JobListItem"},"type":"array","title":"Jobs","description":"List of jobs"},"total":{"type":"integer","title":"Total","description":"Total number of jobs matching filter"}},"type":"object","required":["jobs","total"],"title":"JobListResponse","description":"Response for listing jobs","example":{"jobs":[{"completed_at":"2025-01-15T10:32:15Z","created_at":"2025-01-15T10:30:00Z","job_id":"987fcdeb-51a2-43f7-9876-543210987654","status":"completed","type":"ad_creation"},{"created_at":"2025-01-15T10:25:00Z","job_id":"123e4567-e89b-12d3-a456-426614174002","status":"running","type":"pdf_processing"}],"total":2}},"JobResponse":{"properties":{"job_id":{"type":"string","title":"Job Id","description":"Unique job identifier"},"status":{"type":"string","title":"Status","description":"Initial job status (typically 'running')"},"stream_url":{"type":"string","title":"Stream Url","description":"SSE endpoint for real-time progress"},"poll_url":{"type":"string","title":"Poll Url","description":"HTTP endpoint for polling status"}},"type":"object","required":["job_id","status","stream_url","poll_url"],"title":"JobResponse","description":"Response after submitting a job","example":{"job_id":"987fcdeb-51a2-43f7-9876-543210987654","poll_url":"/api/chat/agentic/jobs/987fcdeb-51a2-43f7-9876-543210987654","status":"running","stream_url":"/api/chat/agentic/jobs/987fcdeb-51a2-43f7-9876-543210987654/stream"}},"JobStatusResponse":{"properties":{"job_id":{"type":"string","title":"Job Id","description":"Job identifier"},"type":{"type":"string","title":"Type","description":"Job type"},"status":{"type":"string","title":"Status","description":"Current status: pending, running, completed, failed, cancelled"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result","description":"Job result (only when completed)"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message (only when failed)"},"error_detail":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Error Detail","description":"Structured plan-gate answer ({status_code, detail}) when the job failed on a usage limit, feature gate or subscription gate"},"progress":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Progress","description":"Current progress data"},"public_execution":{"anyOf":[{"$ref":"#/components/schemas/PublicExecutionSummary"},{"type":"null"}],"description":"Bounded, engine-neutral execution summary. A higher revision replaces the complete previous snapshot."},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Job creation timestamp"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At","description":"Job start timestamp"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At","description":"Job completion timestamp"}},"type":"object","required":["job_id","type","status","created_at"],"title":"JobStatusResponse","description":"Response for job status query","example":{"created_at":"2025-01-15T10:30:00Z","job_id":"987fcdeb-51a2-43f7-9876-543210987654","progress":{"message":"Generating ad creative...","progress":0.25,"step":"generate_creative"},"started_at":"2025-01-15T10:30:01Z","status":"running","type":"ad_creation"}},"JoinOrganizationRequest":{"properties":{"token":{"type":"string","title":"Token"},"tos_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tos Hash"},"tos_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tos Version"}},"type":"object","required":["token"],"title":"JoinOrganizationRequest","description":"Request model for joining an organization."},"JoinOrganizationResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"}},"type":"object","required":["success","message","organization_id"],"title":"JoinOrganizationResponse","description":"Response model for organization join operation."},"JsonValue":{},"KLCampaignPerformanceResponse":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"campaign_name":{"type":"string","title":"Campaign Name"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"send_time":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Send Time"},"total_sent":{"type":"integer","title":"Total Sent"},"opens":{"type":"integer","title":"Opens"},"clicks":{"type":"integer","title":"Clicks"},"bounces":{"type":"integer","title":"Bounces"},"unsubscribes":{"type":"integer","title":"Unsubscribes"},"revenue_cents":{"type":"integer","title":"Revenue Cents"},"open_rate":{"type":"number","title":"Open Rate"},"click_rate":{"type":"number","title":"Click Rate"},"bounce_rate":{"type":"number","title":"Bounce Rate"},"unsub_rate":{"type":"number","title":"Unsub Rate"}},"type":"object","required":["campaign_id","campaign_name","total_sent","opens","clicks","bounces","unsubscribes","revenue_cents","open_rate","click_rate","bounce_rate","unsub_rate"],"title":"KLCampaignPerformanceResponse","description":"Klaviyo campaign performance response."},"KLDailyEmailPerformanceResponse":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"email_sends":{"type":"integer","title":"Email Sends"},"opens":{"type":"integer","title":"Opens"},"clicks":{"type":"integer","title":"Clicks"},"bounces":{"type":"integer","title":"Bounces"},"unsubscribes":{"type":"integer","title":"Unsubscribes"},"spam_complaints":{"type":"integer","title":"Spam Complaints"},"revenue_cents":{"type":"integer","title":"Revenue Cents"},"open_rate":{"type":"number","title":"Open Rate"},"click_rate":{"type":"number","title":"Click Rate"}},"type":"object","required":["metric_date","email_sends","opens","clicks","bounces","unsubscribes","spam_complaints","revenue_cents","open_rate","click_rate"],"title":"KLDailyEmailPerformanceResponse","description":"Daily Klaviyo email performance response."},"KLFlowPerformanceResponse":{"properties":{"flow_id":{"type":"string","title":"Flow Id"},"flow_name":{"type":"string","title":"Flow Name"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"trigger_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trigger Type"},"total_sent":{"type":"integer","title":"Total Sent"},"opens":{"type":"integer","title":"Opens"},"clicks":{"type":"integer","title":"Clicks"},"conversions":{"type":"integer","title":"Conversions"},"revenue_cents":{"type":"integer","title":"Revenue Cents"},"open_rate":{"type":"number","title":"Open Rate"},"click_rate":{"type":"number","title":"Click Rate"},"conversion_rate":{"type":"number","title":"Conversion Rate"}},"type":"object","required":["flow_id","flow_name","total_sent","opens","clicks","conversions","revenue_cents","open_rate","click_rate","conversion_rate"],"title":"KLFlowPerformanceResponse","description":"Klaviyo flow performance response."},"KLListGrowthResponse":{"properties":{"list_id":{"type":"string","title":"List Id"},"list_name":{"type":"string","title":"List Name"},"metric_date":{"type":"string","format":"date","title":"Metric Date"},"profile_count":{"type":"integer","title":"Profile Count"},"new_subscribers":{"type":"integer","title":"New Subscribers"},"unsubscribes":{"type":"integer","title":"Unsubscribes"},"net_growth":{"type":"integer","title":"Net Growth"}},"type":"object","required":["list_id","list_name","metric_date","profile_count","new_subscribers","unsubscribes","net_growth"],"title":"KLListGrowthResponse","description":"Klaviyo list growth response."},"KLRangeSummaryResponse":{"properties":{"total_sends":{"type":"integer","title":"Total Sends"},"total_opens":{"type":"integer","title":"Total Opens"},"total_clicks":{"type":"integer","title":"Total Clicks"},"avg_open_rate":{"type":"number","title":"Avg Open Rate"},"avg_click_rate":{"type":"number","title":"Avg Click Rate"},"total_revenue_cents":{"type":"integer","title":"Total Revenue Cents"},"active_campaigns":{"type":"integer","title":"Active Campaigns"},"active_flows":{"type":"integer","title":"Active Flows"},"total_subscribers":{"type":"integer","title":"Total Subscribers"}},"type":"object","required":["total_sends","total_opens","total_clicks","avg_open_rate","avg_click_rate","total_revenue_cents","active_campaigns","active_flows","total_subscribers"],"title":"KLRangeSummaryResponse","description":"Klaviyo summary for a date range response."},"KLTransactionRowResponse":{"properties":{"kl_token":{"type":"string","title":"Kl Token"},"entity_type":{"type":"string","title":"Entity Type"},"event_id":{"type":"string","title":"Event Id"},"metric_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metric Name"},"profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Id"},"value_cents":{"type":"integer","title":"Value Cents"},"event_date":{"type":"string","title":"Event Date"}},"type":"object","required":["kl_token","entity_type","event_id","value_cents","event_date"],"title":"KLTransactionRowResponse","description":"Single Klaviyo event from Silver tables."},"KeywordWithCpc":{"properties":{"keyword":{"type":"string","title":"Keyword"},"estimated_cpc":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Estimated Cpc"}},"type":"object","required":["keyword"],"title":"KeywordWithCpc","description":"Model for keyword with CPC data"},"KlaviyoAccountsResponse":{"properties":{"accounts":{"items":{"$ref":"#/components/schemas/KlaviyoList"},"type":"array","title":"Accounts"}},"type":"object","required":["accounts"],"title":"KlaviyoAccountsResponse","description":"Response model for Klaviyo lists/segments."},"KlaviyoAuthResponse":{"properties":{"auth_url":{"type":"string","title":"Auth Url"}},"type":"object","required":["auth_url"],"title":"KlaviyoAuthResponse","description":"Response model for Klaviyo auth URL."},"KlaviyoHealthResponse":{"properties":{"status":{"type":"string","title":"Status"}},"type":"object","required":["status"],"title":"KlaviyoHealthResponse","description":"Response model for connection health status."},"KlaviyoList":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"created":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created"},"updated":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated"},"profile_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Profile Count"},"list_type":{"type":"string","title":"List Type","default":"list"}},"type":"object","required":["id","name"],"title":"KlaviyoList","description":"Klaviyo list/segment model."},"KlaviyoStatusResponse":{"properties":{"connected":{"type":"boolean","title":"Connected"},"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name"},"lists_count":{"type":"integer","title":"Lists Count","default":0},"segments_count":{"type":"integer","title":"Segments Count","default":0}},"type":"object","required":["connected"],"title":"KlaviyoStatusResponse","description":"Response model for Klaviyo connection status."},"KnowledgeBaseUploadResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"files":{"items":{"$ref":"#/components/schemas/SharedFileItem"},"type":"array","title":"Files"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","files","message"],"title":"KnowledgeBaseUploadResponse","description":"Response for knowledge base file upload"},"LandingPagePreflightRequest":{"properties":{"url":{"type":"string","title":"Url"},"expected_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Expected Urls"},"use_firecrawl":{"type":"boolean","title":"Use Firecrawl","default":true}},"type":"object","required":["url"],"title":"LandingPagePreflightRequest"},"LeadFinderEmailOrigin":{"properties":{"surface":{"type":"string","const":"lead_finder","title":"Surface"}},"type":"object","required":["surface"],"title":"LeadFinderEmailOrigin"},"LeadFinderEmailTarget":{"properties":{"kind":{"type":"string","const":"lead_finder_candidate","title":"Kind"},"search_id":{"type":"string","format":"uuid","title":"Search Id"},"candidate_id":{"type":"string","maxLength":128,"minLength":1,"title":"Candidate Id"}},"type":"object","required":["kind","search_id","candidate_id"],"title":"LeadFinderEmailTarget"},"LeadFormDraftCopyRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"ad_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id"},"target_platform":{"type":"string","title":"Target Platform"}},"additionalProperties":false,"type":"object","required":["campaign_id","target_platform"],"title":"LeadFormDraftCopyRequest"},"LeadFormDraftCopyResponse":{"properties":{"platform_type":{"type":"string","title":"Platform Type"},"family":{"type":"string","title":"Family"},"draft":{"additionalProperties":true,"type":"object","title":"Draft"}},"type":"object","required":["platform_type","family","draft"],"title":"LeadFormDraftCopyResponse"},"LeadFormRequestEntry":{"properties":{"config_schema_version":{"type":"integer","const":1,"title":"Config Schema Version"},"config":{"$ref":"#/components/schemas/GoogleLeadFormConfigV1"}},"additionalProperties":false,"type":"object","required":["config_schema_version","config"],"title":"LeadFormRequestEntry"},"LinkedInActivateAccountRequest":{"properties":{"account_id":{"type":"string","title":"Account Id"},"organization_urn":{"type":"string","title":"Organization Urn"}},"type":"object","required":["account_id","organization_urn"],"title":"LinkedInActivateAccountRequest"},"LinkedInCampaignActionRequest":{"properties":{"platform_type":{"type":"string","title":"Platform Type"},"ad_id":{"type":"string","title":"Ad Id"},"ad_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Account Id"},"action":{"type":"string","title":"Action"}},"type":"object","required":["platform_type","ad_id","action"],"title":"LinkedInCampaignActionRequest"},"LinkedInCampaignPostRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id","description":"ID of the campaign post"},"idea_number":{"type":"integer","title":"Idea Number","description":"Idea number within the campaign"},"variation":{"type":"integer","title":"Variation","description":"Variation number (0 for original, 1+ for variations)","default":0}},"type":"object","required":["campaign_id","idea_number"],"title":"LinkedInCampaignPostRequest"},"LinkedInCampaignResumeRequest":{"properties":{"platform_type":{"type":"string","title":"Platform Type"},"ad_id":{"type":"string","title":"Ad Id"},"ad_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Account Id"}},"type":"object","required":["platform_type","ad_id"],"title":"LinkedInCampaignResumeRequest"},"LinkedInLaunchImageAdRequest":{"properties":{"ad_id":{"type":"string","title":"Ad Id"},"ad_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Account Id"},"organization_urn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Urn"},"targeting_discrimination_notice_acknowledged":{"type":"boolean","title":"Targeting Discrimination Notice Acknowledged","default":false},"political_intent_confirmed":{"type":"boolean","title":"Political Intent Confirmed","default":false},"linkedin_lead_form_config":{"anyOf":[{"$ref":"#/components/schemas/LinkedInLeadFormConfig"},{"type":"null"}]}},"type":"object","required":["ad_id"],"title":"LinkedInLaunchImageAdRequest"},"LinkedInLaunchVideoAdRequest":{"properties":{"ad_id":{"type":"string","title":"Ad Id"},"ad_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Account Id"},"organization_urn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Urn"},"targeting_discrimination_notice_acknowledged":{"type":"boolean","title":"Targeting Discrimination Notice Acknowledged","default":false},"political_intent_confirmed":{"type":"boolean","title":"Political Intent Confirmed","default":false},"linkedin_lead_form_config":{"anyOf":[{"$ref":"#/components/schemas/LinkedInLeadFormConfig"},{"type":"null"}]}},"type":"object","required":["ad_id"],"title":"LinkedInLaunchVideoAdRequest"},"LinkedInLeadFormConfig":{"properties":{"name":{"type":"string","maxLength":256,"title":"Name"},"headline":{"type":"string","maxLength":60,"title":"Headline"},"description":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Description","default":""},"privacy_policy_url":{"type":"string","maxLength":2000,"title":"Privacy Policy Url"},"thank_you_message":{"type":"string","maxLength":300,"title":"Thank You Message"},"fields":{"items":{"type":"string","enum":["FIRST_NAME","LAST_NAME","EMAIL","WORK_EMAIL","PHONE_NUMBER","WORK_PHONE_NUMBER","JOB_TITLE","COMPANY_NAME","COMPANY_SIZE","INDUSTRY","CITY","STATE","COUNTRY"]},"type":"array","title":"Fields"}},"type":"object","required":["name","headline","privacy_policy_url","thank_you_message","fields"],"title":"LinkedInLeadFormConfig"},"LinkedInPostCampaignRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id","description":"ID of the campaign to post"},"idea_number":{"type":"integer","title":"Idea Number","description":"Idea number within the campaign"},"author_urn":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Urn","description":"Selected LinkedIn author URN"},"variation":{"type":"integer","title":"Variation","description":"Variation number (0 for original, 1+ for variations)","default":0},"expected_creative_state_token":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","title":"Expected Creative State Token","description":"Server-issued fingerprint for the exact creative the user reviewed"}},"type":"object","required":["campaign_id","idea_number","expected_creative_state_token"],"title":"LinkedInPostCampaignRequest"},"LinkedInSocialActivateRequest":{"properties":{"author_urn":{"type":"string","maxLength":256,"minLength":1,"title":"Author Urn","description":"Selected administered LinkedIn Page author URN"}},"type":"object","required":["author_urn"],"title":"LinkedInSocialActivateRequest"},"LinkedInSyncAdCampaignRequest":{"properties":{"platform_type":{"type":"string","title":"Platform Type"},"ad_id":{"type":"string","title":"Ad Id"},"ad_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Account Id"},"pending_update":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pending Update"}},"type":"object","required":["platform_type","ad_id"],"title":"LinkedInSyncAdCampaignRequest"},"LinkedInSyncPreviewRequest":{"properties":{"platform_type":{"type":"string","title":"Platform Type"},"ad_id":{"type":"string","title":"Ad Id"},"ad_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Account Id"},"pending_update":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pending Update"}},"type":"object","required":["platform_type","ad_id"],"title":"LinkedInSyncPreviewRequest"},"LocalEmailConversationListResponse":{"properties":{"conversations":{"items":{"$ref":"#/components/schemas/LocalEmailConversationSummaryResponse"},"type":"array","title":"Conversations"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor_recorded_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Cursor Recorded At"},"next_cursor_conversation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Next Cursor Conversation Id"},"next_cursor_message_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Next Cursor Message Id"}},"type":"object","required":["conversations","has_more"],"title":"LocalEmailConversationListResponse"},"LocalEmailConversationSummaryResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"message_id":{"type":"string","format":"uuid","title":"Message Id"},"participant_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Participant Name"},"participant_address":{"type":"string","title":"Participant Address"},"mailbox_address":{"type":"string","title":"Mailbox Address"},"subject":{"type":"string","title":"Subject"},"preview_text":{"type":"string","title":"Preview Text"},"recorded_at":{"type":"string","format":"date-time","title":"Recorded At"},"origin_label":{"type":"string","title":"Origin Label"},"status":{"type":"string","enum":["sent_through_pomo","unconfirmed"],"title":"Status"}},"type":"object","required":["id","message_id","participant_address","mailbox_address","subject","preview_text","recorded_at","origin_label","status"],"title":"LocalEmailConversationSummaryResponse"},"LocalEmailConversationThreadResponse":{"properties":{"conversation":{"$ref":"#/components/schemas/LocalEmailConversationSummaryResponse"},"message":{"$ref":"#/components/schemas/LocalEmailMessageResponse"}},"type":"object","required":["conversation","message"],"title":"LocalEmailConversationThreadResponse"},"LocalEmailMessageResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"from_address":{"type":"string","title":"From Address"},"from_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From Display Name"},"to_addresses":{"items":{"type":"string"},"type":"array","title":"To Addresses"},"subject":{"type":"string","title":"Subject"},"body_text":{"type":"string","title":"Body Text"},"recorded_at":{"type":"string","format":"date-time","title":"Recorded At"}},"type":"object","required":["id","from_address","to_addresses","subject","body_text","recorded_at"],"title":"LocalEmailMessageResponse"},"LocalEmailPersonHistoryResponse":{"properties":{"records":{"items":{"$ref":"#/components/schemas/LocalEmailRecordResponse"},"type":"array","title":"Records"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor_recorded_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Cursor Recorded At"},"next_cursor_conversation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Next Cursor Conversation Id"},"next_cursor_message_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Next Cursor Message Id"}},"type":"object","required":["records","has_more"],"title":"LocalEmailPersonHistoryResponse"},"LocalEmailRecordResponse":{"properties":{"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"origin_label":{"type":"string","title":"Origin Label"},"status":{"type":"string","enum":["sent_through_pomo","unconfirmed"],"title":"Status"},"message":{"$ref":"#/components/schemas/LocalEmailMessageResponse"}},"type":"object","required":["conversation_id","origin_label","status","message"],"title":"LocalEmailRecordResponse"},"LocationInfo":{"properties":{"country":{"type":"string","title":"Country"},"country_code":{"type":"string","title":"Country Code"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"state_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Code"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"}},"type":"object","required":["country","country_code"],"title":"LocationInfo"},"LocationItem":{"properties":{"level":{"type":"string","enum":["country","region","state","province","city","postal_code","proximity"],"title":"Level","description":"Granularity level"},"name":{"type":"string","title":"Name","description":"Display name of the location, such as California, San Francisco, or 10001 + 10 mi"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code","description":"ISO 3166-1 alpha-2 country code, such as US"},"country_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Name","description":"Display country name from reverse geocoding, if available"},"code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code","description":"Platform or ISO subdivision code if known, such as US-CA"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"Nearest city/town from reverse geocoding, if available"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region","description":"Nearest state/region/province from reverse geocoding, if available"},"region_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region Code","description":"State/region code from reverse geocoding, if available"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code","description":"Postal or ZIP code for exact postal-code targeting"},"included_postal_codes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Included Postal Codes","description":"Postal/PIN codes represented by a proximity pin when available"},"expanded_postal_codes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Expanded Postal Codes","description":"Expanded postal/PIN codes for a radius, if available"},"latitude":{"anyOf":[{"type":"number","maximum":90.0,"minimum":-90.0},{"type":"null"}],"title":"Latitude","description":"Latitude for map-pin or radius targeting"},"longitude":{"anyOf":[{"type":"number","maximum":180.0,"minimum":-180.0},{"type":"null"}],"title":"Longitude","description":"Longitude for map-pin or radius targeting"},"radius_miles":{"anyOf":[{"type":"number","maximum":250.0,"minimum":1.0},{"type":"null"}],"title":"Radius Miles","description":"Radius in miles for proximity targeting"},"radius_km":{"anyOf":[{"type":"number","maximum":400.0,"minimum":1.0},{"type":"null"}],"title":"Radius Km","description":"Radius in kilometers for proximity targeting"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","description":"How the location was selected, such as zip, address, map_pin, city, or state"},"platform_ids":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Platform Ids","description":"Resolved platform-specific geo identifiers"},"resolution_status":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Resolution Status","description":"Per-platform resolution or support status"}},"type":"object","required":["level","name"],"title":"LocationItem","description":"Canonical location input for multi-geo campaigns with one shared budget."},"ManualEmailSendRequest":{"properties":{"email_account_id":{"type":"string","format":"uuid","title":"Email Account Id"},"to_address":{"type":"string","maxLength":320,"minLength":3,"title":"To Address"},"subject":{"type":"string","maxLength":998,"title":"Subject"},"body_text":{"type":"string","maxLength":100000,"minLength":1,"title":"Body Text"},"signature_text":{"type":"string","maxLength":100000,"title":"Signature Text","default":""},"idempotency_key":{"type":"string","maxLength":128,"minLength":8,"title":"Idempotency Key"}},"type":"object","required":["email_account_id","to_address","subject","body_text","idempotency_key"],"title":"ManualEmailSendRequest"},"ManualEmailSendResponse":{"properties":{"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"message_id":{"type":"string","format":"uuid","title":"Message Id"},"delivery_status":{"type":"string","enum":["pending","sent","failed","unknown"],"title":"Delivery Status"},"from_address":{"type":"string","title":"From Address"},"to_address":{"type":"string","title":"To Address"},"subject":{"type":"string","title":"Subject"},"provider_message_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Message Id"},"provider_thread_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Thread Id"},"safe_message":{"type":"string","title":"Safe Message"},"reauthorization_required":{"type":"boolean","title":"Reauthorization Required"}},"type":"object","required":["conversation_id","message_id","delivery_status","from_address","to_address","subject","safe_message","reauthorization_required"],"title":"ManualEmailSendResponse"},"ManualEmailSendStatusResponse":{"properties":{"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"message_id":{"type":"string","format":"uuid","title":"Message Id"},"delivery_status":{"type":"string","enum":["pending","sent","failed","unknown"],"title":"Delivery Status"},"to_address":{"type":"string","title":"To Address"},"safe_message":{"type":"string","title":"Safe Message"},"reauthorization_required":{"type":"boolean","title":"Reauthorization Required"},"person_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Person Ref"}},"type":"object","required":["conversation_id","message_id","delivery_status","to_address","safe_message","reauthorization_required"],"title":"ManualEmailSendStatusResponse"},"MarketIntelligenceResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"intelligence_type":{"type":"string","title":"Intelligence Type"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"insights":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Insights"},"metrics":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metrics"},"recommendations":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Recommendations"},"data_sources":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data Sources"},"confidence_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence Score"},"impact_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Impact Level"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"is_active":{"type":"boolean","title":"Is Active"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","intelligence_type","title","description","insights","metrics","recommendations","data_sources","confidence_score","impact_level","category","tags","is_active","expires_at","created_at","updated_at"],"title":"MarketIntelligenceResponse"},"MarketIntelligenceUpdate":{"properties":{"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","title":"MarketIntelligenceUpdate"},"MarketingProfileAxisResponse":{"properties":{"id":{"type":"string","title":"Id"},"label":{"type":"string","title":"Label"},"self_score":{"type":"integer","title":"Self Score"},"competitor_score":{"type":"integer","title":"Competitor Score"},"similarity":{"type":"integer","title":"Similarity"},"gap":{"type":"integer","title":"Gap"},"leader":{"type":"string","title":"Leader"}},"type":"object","required":["id","label","self_score","competitor_score","similarity","gap","leader"],"title":"MarketingProfileAxisResponse","description":"Single radar axis for the persisted marketing profile."},"MarketingProfileGenerationRequest":{"properties":{"scope_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope Key"}},"type":"object","title":"MarketingProfileGenerationRequest"},"MarketingProfileResponse":{"properties":{"algorithm_version":{"type":"string","title":"Algorithm Version"},"calculated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Calculated At"},"source_updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Updated At"},"can_render":{"type":"boolean","title":"Can Render"},"profile_similarity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Profile Similarity"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"axes":{"items":{"$ref":"#/components/schemas/MarketingProfileAxisResponse"},"type":"array","title":"Axes"}},"type":"object","required":["algorithm_version","can_render"],"title":"MarketingProfileResponse","description":"Persisted marketing-profile snapshot returned with competitor details."},"McpActivityCounts":{"properties":{"total":{"type":"integer","title":"Total"},"needs_attention":{"type":"integer","title":"Needs Attention"}},"type":"object","required":["total","needs_attention"],"title":"McpActivityCounts"},"McpActivityDetail":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"actor_name":{"type":"string","title":"Actor Name"},"actor_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Actor User Id"},"client_name":{"type":"string","title":"Client Name"},"summary":{"type":"string","title":"Summary"},"outcome":{"type":"string","title":"Outcome"},"action":{"type":"string","title":"Action"},"resource_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Name"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"},"request_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Request Id"},"work_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Work Id"},"review_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Review Url"},"awaiting_review":{"type":"boolean","title":"Awaiting Review","default":false},"cost_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cost Summary"},"change_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Summary"},"timeline":{"items":{"$ref":"#/components/schemas/McpActivityEvent"},"type":"array","title":"Timeline"},"timeline_truncated":{"type":"boolean","title":"Timeline Truncated","default":false},"links":{"items":{"$ref":"#/components/schemas/McpActivityLink"},"type":"array","title":"Links"}},"type":"object","required":["id","created_at","actor_name","client_name","summary","outcome","action"],"title":"McpActivityDetail"},"McpActivityEvent":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"actor_name":{"type":"string","title":"Actor Name"},"actor_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Actor User Id"},"client_name":{"type":"string","title":"Client Name"},"summary":{"type":"string","title":"Summary"},"outcome":{"type":"string","title":"Outcome"},"action":{"type":"string","title":"Action"},"resource_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resource Name"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"},"request_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Request Id"},"work_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Work Id"},"review_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Review Url"},"awaiting_review":{"type":"boolean","title":"Awaiting Review","default":false},"cost_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cost Summary"},"change_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Change Summary"}},"type":"object","required":["id","created_at","actor_name","client_name","summary","outcome","action"],"title":"McpActivityEvent"},"McpActivityExport":{"properties":{"filename":{"type":"string","title":"Filename"},"content_type":{"type":"string","title":"Content Type"},"content":{"type":"string","title":"Content"},"exported_count":{"type":"integer","title":"Exported Count"},"truncated":{"type":"boolean","title":"Truncated"}},"type":"object","required":["filename","content_type","content","exported_count","truncated"],"title":"McpActivityExport"},"McpActivityFilters":{"properties":{"scope":{"type":"string","enum":["mine","profile"],"title":"Scope","default":"mine"},"outcome":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Outcome"},"from":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"From"},"to":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"To"},"client_id":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Client Id"},"actor_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Actor User Id"},"action":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Action"},"target":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Target"}},"additionalProperties":false,"type":"object","title":"McpActivityFilters"},"McpActivityLink":{"properties":{"label":{"type":"string","title":"Label"},"href":{"type":"string","title":"Href"}},"type":"object","required":["label","href"],"title":"McpActivityLink"},"McpActivityPage":{"properties":{"events":{"items":{"$ref":"#/components/schemas/McpActivityEvent"},"type":"array","title":"Events"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"counts":{"$ref":"#/components/schemas/McpActivityCounts"}},"type":"object","required":["events","next_cursor","counts"],"title":"McpActivityPage"},"McpConnectionSummary":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"client_name":{"type":"string","title":"Client Name"},"client_id":{"type":"string","title":"Client Id"},"actor_name":{"type":"string","title":"Actor Name"},"actor_user_id":{"type":"string","format":"uuid","title":"Actor User Id"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"status":{"type":"string","title":"Status"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"revoked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Revoked At"},"disconnect_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Disconnect Reason"},"requires_reconsent":{"type":"boolean","title":"Requires Reconsent","default":false},"client_access_available":{"type":"boolean","title":"Client Access Available","default":true},"setup_state":{"type":"string","enum":["complete","waiting","abandoned"],"title":"Setup State","default":"complete"}},"type":"object","required":["id","client_name","client_id","actor_name","actor_user_id","scopes","status","created_at","last_used_at","revoked_at"],"title":"McpConnectionSummary"},"McpConnections":{"properties":{"connections":{"items":{"$ref":"#/components/schemas/McpConnectionSummary"},"type":"array","title":"Connections"}},"type":"object","required":["connections"],"title":"McpConnections"},"McpMutationResult":{"properties":{"success":{"type":"boolean","title":"Success"}},"type":"object","required":["success"],"title":"McpMutationResult"},"McpProfilePolicyUpdate":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"expected_revision":{"type":"integer","minimum":1.0,"title":"Expected Revision"}},"additionalProperties":false,"type":"object","required":["enabled","expected_revision"],"title":"McpProfilePolicyUpdate"},"McpProfileSummary":{"properties":{"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"profile_name":{"type":"string","title":"Profile Name"},"can_manage":{"type":"boolean","title":"Can Manage"},"can_connect":{"type":"boolean","title":"Can Connect"},"can_view_profile_activity":{"type":"boolean","title":"Can View Profile Activity"},"mcp_enabled":{"type":"boolean","title":"Mcp Enabled"},"policy_revision":{"type":"integer","title":"Policy Revision"},"endpoint_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Url"},"dcr_available":{"type":"boolean","title":"Dcr Available","default":false},"connection_count":{"type":"integer","title":"Connection Count"}},"type":"object","required":["company_profile_id","profile_name","can_manage","can_connect","can_view_profile_activity","mcp_enabled","policy_revision","endpoint_url","connection_count"],"title":"McpProfileSummary"},"MemberPreferences":{"properties":{"hidden":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Hidden"},"muted":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Muted"}},"additionalProperties":false,"type":"object","title":"MemberPreferences"},"MemberStatusUpdateRequest":{"properties":{"status":{"type":"string","title":"Status","description":"New status: 'active' or 'suspended'"}},"type":"object","required":["status"],"title":"MemberStatusUpdateRequest","description":"Request to update a member's status (suspend/activate)."},"MemoryCorrection":{"properties":{"expected_revision":{"type":"integer","minimum":1.0,"title":"Expected Revision"},"statement":{"type":"string","maxLength":4000,"minLength":1,"pattern":"\\S","title":"Statement"},"valid_from":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Valid From"},"valid_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Valid Until"},"request_id":{"type":"string","format":"uuid","title":"Request Id"}},"additionalProperties":false,"type":"object","required":["expected_revision","statement","request_id"],"title":"MemoryCorrection"},"MemoryCoverage":{"properties":{"status":{"type":"string","enum":["complete","unavailable"],"title":"Status","default":"complete"},"included":{"type":"integer","minimum":0.0,"title":"Included"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"}},"additionalProperties":false,"type":"object","required":["included"],"title":"MemoryCoverage"},"MemoryCreate":{"properties":{"statement":{"type":"string","maxLength":4000,"minLength":1,"pattern":"\\S","title":"Statement"},"kind":{"type":"string","enum":["fact","preference","instruction","lesson"],"title":"Kind","default":"instruction"},"audience":{"type":"string","enum":["brand","personal","work"],"title":"Audience","default":"brand"},"work_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Work Id"},"valid_from":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Valid From"},"valid_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Valid Until"},"request_id":{"type":"string","format":"uuid","title":"Request Id"}},"additionalProperties":false,"type":"object","required":["statement","request_id"],"title":"MemoryCreate"},"MemoryDecision":{"properties":{"expected_revision":{"type":"integer","minimum":1.0,"title":"Expected Revision"},"request_id":{"type":"string","format":"uuid","title":"Request Id"}},"additionalProperties":false,"type":"object","required":["expected_revision","request_id"],"title":"MemoryDecision"},"MemorySource":{"properties":{"kind":{"type":"string","enum":["user_command","conversation_message","insight_card_feedback"],"title":"Kind"},"id":{"type":"string","maxLength":191,"minLength":1,"title":"Id"},"revision":{"type":"string","maxLength":191,"minLength":1,"title":"Revision"},"label":{"type":"string","maxLength":240,"minLength":1,"title":"Label"},"href":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Href"},"observed_at":{"type":"string","format":"date-time","title":"Observed At"},"actor_user_id":{"type":"string","format":"uuid","title":"Actor User Id"},"conversation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Conversation Id"},"team_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Team Id"},"card_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Card Id"}},"additionalProperties":false,"type":"object","required":["kind","id","revision","label","observed_at","actor_user_id"],"title":"MemorySource"},"MentionTarget":{"properties":{"key":{"type":"string","title":"Key","description":"Team ID (as string) or agent_key"},"label":{"type":"string","title":"Label","description":"Display name"},"type":{"type":"string","title":"Type","description":"'team' or 'agent'"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role","description":"Agent role (manager/strategist/specialist)"},"team_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id","description":"Parent team ID (for agents)"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Brief agent description"},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id","description":"The team's own thread (for teams). A plain message there is addressed to this team, so the composer does not require a mention the reader is already past."}},"type":"object","required":["key","label","type"],"title":"MentionTarget"},"MentionTargetsResponse":{"properties":{"teams":{"items":{"$ref":"#/components/schemas/MentionTarget"},"type":"array","title":"Teams"},"agents":{"items":{"$ref":"#/components/schemas/MentionTarget"},"type":"array","title":"Agents"}},"type":"object","title":"MentionTargetsResponse"},"MessagePageResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/MessageResponse"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items"],"title":"MessagePageResponse"},"MessageResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"author_display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Display Name"},"provider_created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Provider Created At"},"is_page_authored":{"type":"boolean","title":"Is Page Authored"},"version":{"type":"integer","title":"Version"},"message_type":{"type":"string","title":"Message Type"},"attachments":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Attachments"},"reply_to_external_message_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reply To External Message Id"}},"type":"object","required":["id","body","author_display_name","provider_created_at","is_page_authored","version","message_type","attachments"],"title":"MessageResponse"},"MetaAccountsResponseModel":{"properties":{"accounts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Accounts"},"pages":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Pages"},"selected_ad_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Ad Account Id"},"activation_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activation State"},"active_account":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Active Account"}},"type":"object","required":["accounts"],"title":"MetaAccountsResponseModel"},"MetaAuthResponseModel":{"properties":{"auth_url":{"type":"string","title":"Auth Url"},"auth_type":{"type":"string","title":"Auth Type"}},"type":"object","required":["auth_url","auth_type"],"title":"MetaAuthResponseModel"},"MetaCampaignActionRequest":{"properties":{"platform_type":{"type":"string","title":"Platform Type","description":"Type of ad platform: meta_feed or meta_stories_reels"},"ad_id":{"type":"string","title":"Ad Id","description":"ID of the specific ad to act on"},"ad_account_id":{"type":"string","title":"Ad Account Id","description":"Meta Ad Account ID"},"action":{"type":"string","title":"Action","description":"Action to perform: pause or delete"}},"type":"object","required":["platform_type","ad_id","ad_account_id","action"],"title":"MetaCampaignActionRequest","description":"Request model for pausing/deleting a Meta campaign."},"MetaCampaignResumeRequest":{"properties":{"platform_type":{"type":"string","title":"Platform Type","description":"Type of ad platform: meta_feed or meta_stories_reels"},"ad_id":{"type":"string","title":"Ad Id","description":"ID of the specific ad to act on (DB UUID or Meta ad id)"},"ad_account_id":{"type":"string","title":"Ad Account Id","description":"Meta Ad Account ID"}},"type":"object","required":["platform_type","ad_id","ad_account_id"],"title":"MetaCampaignResumeRequest","description":"Request model for resuming a Meta campaign (no action field)."},"MetaFeedAdRequest":{"properties":{"product_description":{"type":"string","title":"Product Description","description":"Description of the product or service"},"target_audience":{"type":"string","title":"Target Audience","description":"Target audience description"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id","description":"Company profile ID (required)"},"campaign_goals":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Campaign Goals","description":"List of campaign goals"},"key_selling_points":{"type":"string","title":"Key Selling Points","description":"Key selling points","default":""},"num_ads":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Num Ads","description":"Number of ad variations to generate","default":3},"bid_strategy":{"type":"string","title":"Bid Strategy","description":"Bidding strategy","default":"maximize_conversions"},"budget_range":{"type":"string","title":"Budget Range","description":"Budget range (low, medium, high, custom)","default":"medium"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Target country"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province","description":"Target state/province"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"Target city"},"locations":{"anyOf":[{"items":{"$ref":"#/components/schemas/LocationItem"},"type":"array"},{"type":"null"}],"title":"Locations","description":"List of locations to target (countries/regions/states/cities/postal codes/proximities). This does not split budget per location; all locations share the campaign budget."},"reference_images":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":3},{"type":"null"}],"title":"Reference Images","description":"List of reference image base64 data URLs (max 3)"},"max_cpc":{"anyOf":[{"type":"number","minimum":0.01},{"type":"null"}],"title":"Max Cpc","description":"Maximum cost per click in dollars (e.g., 1.50 for $1.50). Required when bid_strategy is 'MANUAL_CPC'"},"experiment_package_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Experiment Package Id","description":"Test package id; created campaigns are stamped with this linkage"},"launch_strategy_mode":{"anyOf":[{"type":"string","pattern":"^(test_learn_pilot|direct_campaign)$"},{"type":"null"}],"title":"Launch Strategy Mode","description":"test_learn_pilot or direct_campaign"},"dayparting_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dayparting Enabled","description":"Whether dayparting/ad scheduling is enabled for this campaign","default":false},"dayparting_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Dayparting Config","description":"Dayparting configuration including schedule, timezone, and platform-specific settings"},"lead_form_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Lead Form Enabled","description":"Whether to use the existing Meta lead-form flow","default":false},"num_images_per_ad":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Num Images Per Ad","description":"Images per ad. Meta Feed uses 1 image for Single Image and 1 thumbnail for Video.","default":1},"placements":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Placements","description":"Ad placements"},"ad_format":{"type":"string","title":"Ad Format","description":"Meta Feed creative format: 'Video' or 'Single Image'","default":"Video"},"video_length":{"type":"integer","maximum":10.0,"minimum":10.0,"title":"Video Length","description":"Video duration is fixed at 10 seconds","default":10}},"type":"object","required":["product_description","target_audience","company_profile_id"],"title":"MetaFeedAdRequest","description":"Request model for Meta Feed ads"},"MetaFeedCampaignUpdateRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"ad_id":{"type":"string","title":"Ad Id","description":"Normalized platform ad UUID"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"long_headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Long Headline"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"ad_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Name"},"call_to_action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Call To Action"},"keywords":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"items":{"$ref":"#/components/schemas/KeywordWithCpc"},"type":"array"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords"},"negative_keywords":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"items":{"$ref":"#/components/schemas/KeywordWithCpc"},"type":"array"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Negative Keywords"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"recommended_daily_budget":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Recommended Daily Budget"},"total_budget":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Budget"},"duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration"},"target_platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Platform"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"business_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Name"},"final_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Final Url"},"headlines":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Headlines"},"descriptions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Descriptions"},"format_setting":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Format Setting"},"primary_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Text"},"destination_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Destination Url"},"ad_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Format"},"placements":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Placements"},"introductory_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Introductory Text"},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt Text"},"aspect_ratio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aspect Ratio"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"linkedin_lead_form_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Linkedin Lead Form Config"},"meta_lead_form_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta Lead Form Config"},"asin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asin"},"sku":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sku"},"targeting_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Targeting Type"},"bidding_strategy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bidding Strategy"},"default_bid":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Default Bid"},"brand_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand Name"},"landing_page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Landing Page Url"},"showcase_products":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Showcase Products"},"targeting_products":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Targeting Products"},"audience_segments":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Audience Segments"},"interests":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Interests"},"lead_form_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Lead Form Enabled"},"bid_strategy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bid Strategy"},"max_cpc":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Cpc"},"ad_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Text"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"objective_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Objective Type"},"video_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Video Length"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"price":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price"},"target_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Url"},"context_hints":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Context Hints"},"objective":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Objective"},"max_bid":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Bid"},"conversion_event_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversion Event Type"},"dayparting_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"string"},{"type":"null"}],"title":"Dayparting Config"},"media_operations":{"anyOf":[{"items":{"$ref":"#/components/schemas/CampaignMediaOperation"},"type":"array"},{"type":"null"}],"title":"Media Operations"},"target_audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Audience"},"target_audience_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Target Audience Json"},"locations":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Locations"}},"type":"object","required":["campaign_id","ad_id"],"title":"MetaFeedCampaignUpdateRequest"},"MetaLaunchAdCampaignRequest":{"properties":{"platform_type":{"type":"string","title":"Platform Type","description":"Type of ad platform: meta_feed or meta_stories_reels"},"ad_id":{"title":"Ad Id","description":"ID of the specific ad to launch (UUID string)"},"ad_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Account Id","description":"Legacy Meta Ad Account ID; launches use the active account"},"page_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Id","description":"Facebook Page ID"},"instagram_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instagram Account Id","description":"Instagram Account ID"},"placements":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Placements","description":"Placements override: instagram_stories, instagram_reels"},"meta_lead_form_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta Lead Form Config","description":"Meta Instant Form configuration"},"audience_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience Group Id","description":"CRM audience to retarget or suppress"},"audience_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience Mode","description":"How to apply the CRM audience: include or exclude"},"approval_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Approval Id","description":"AI-team approval that owns this launch selection"},"execution_authorization_ref":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Execution Authorization Ref"}},"type":"object","required":["platform_type","ad_id"],"title":"MetaLaunchAdCampaignRequest","description":"Request model for launching a Meta ad campaign"},"MetaSelectAdAccountRequest":{"properties":{"ad_account_id":{"type":"string","title":"Ad Account Id","description":"Meta Ad Account ID"},"page_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Id","description":"Facebook Page ID to use as the ad identity"},"instagram_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instagram Account Id","description":"Optional Instagram business account ID linked to the Page"}},"type":"object","required":["ad_account_id"],"title":"MetaSelectAdAccountRequest"},"MetaStoriesReelsAdRequest":{"properties":{"product_description":{"type":"string","title":"Product Description","description":"Description of the product or service"},"target_audience":{"type":"string","title":"Target Audience","description":"Target audience description"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id","description":"Company profile ID (required)"},"campaign_goals":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Campaign Goals","description":"List of campaign goals"},"key_selling_points":{"type":"string","title":"Key Selling Points","description":"Key selling points","default":""},"num_ads":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Num Ads","description":"Number of ad variations to generate","default":3},"bid_strategy":{"type":"string","title":"Bid Strategy","description":"Bidding strategy","default":"maximize_conversions"},"budget_range":{"type":"string","title":"Budget Range","description":"Budget range (low, medium, high, custom)","default":"medium"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Target country"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province","description":"Target state/province"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"Target city"},"locations":{"anyOf":[{"items":{"$ref":"#/components/schemas/LocationItem"},"type":"array"},{"type":"null"}],"title":"Locations","description":"List of locations to target (countries/regions/states/cities/postal codes/proximities). This does not split budget per location; all locations share the campaign budget."},"reference_images":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":3},{"type":"null"}],"title":"Reference Images","description":"List of reference image base64 data URLs (max 3)"},"max_cpc":{"anyOf":[{"type":"number","minimum":0.01},{"type":"null"}],"title":"Max Cpc","description":"Maximum cost per click in dollars (e.g., 1.50 for $1.50). Required when bid_strategy is 'MANUAL_CPC'"},"experiment_package_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Experiment Package Id","description":"Test package id; created campaigns are stamped with this linkage"},"launch_strategy_mode":{"anyOf":[{"type":"string","pattern":"^(test_learn_pilot|direct_campaign)$"},{"type":"null"}],"title":"Launch Strategy Mode","description":"test_learn_pilot or direct_campaign"},"dayparting_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dayparting Enabled","description":"Whether dayparting/ad scheduling is enabled for this campaign","default":false},"dayparting_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Dayparting Config","description":"Dayparting configuration including schedule, timezone, and platform-specific settings"},"lead_form_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Lead Form Enabled","description":"Whether to use the existing Meta lead-form flow","default":false},"ad_format":{"type":"string","title":"Ad Format","description":"Meta Stories & Reels creative format: 'Video' or 'Single Image'","default":"Video"},"video_length":{"type":"integer","maximum":10.0,"minimum":10.0,"title":"Video Length","description":"Video duration is fixed at 10 seconds","default":10}},"type":"object","required":["product_description","target_audience","company_profile_id"],"title":"MetaStoriesReelsAdRequest","description":"Request model for Meta Stories & Reels ads"},"MetaStoriesReelsCampaignUpdateRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"ad_id":{"type":"string","title":"Ad Id","description":"Normalized platform ad UUID"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"long_headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Long Headline"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"ad_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Name"},"call_to_action":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Call To Action"},"keywords":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"items":{"$ref":"#/components/schemas/KeywordWithCpc"},"type":"array"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Keywords"},"negative_keywords":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"items":{"$ref":"#/components/schemas/KeywordWithCpc"},"type":"array"},{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Negative Keywords"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"recommended_daily_budget":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Recommended Daily Budget"},"total_budget":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Budget"},"duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration"},"target_platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Platform"},"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date"},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date"},"business_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Name"},"final_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Final Url"},"headlines":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Headlines"},"descriptions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Descriptions"},"format_setting":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Format Setting"},"primary_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Text"},"destination_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Destination Url"},"ad_format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Format"},"placements":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Placements"},"introductory_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Introductory Text"},"alt_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alt Text"},"aspect_ratio":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aspect Ratio"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"linkedin_lead_form_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Linkedin Lead Form Config"},"meta_lead_form_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Meta Lead Form Config"},"asin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asin"},"sku":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sku"},"targeting_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Targeting Type"},"bidding_strategy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bidding Strategy"},"default_bid":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Default Bid"},"brand_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand Name"},"landing_page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Landing Page Url"},"showcase_products":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Showcase Products"},"targeting_products":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Targeting Products"},"audience_segments":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Audience Segments"},"interests":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Interests"},"lead_form_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Lead Form Enabled"},"bid_strategy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bid Strategy"},"max_cpc":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Cpc"},"ad_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Text"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"objective_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Objective Type"},"video_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Video Length"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"price":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price"},"target_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Url"},"context_hints":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"string"},{"type":"null"}],"title":"Context Hints"},"objective":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Objective"},"max_bid":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Bid"},"conversion_event_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversion Event Type"},"dayparting_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"string"},{"type":"null"}],"title":"Dayparting Config"},"media_operations":{"anyOf":[{"items":{"$ref":"#/components/schemas/CampaignMediaOperation"},"type":"array"},{"type":"null"}],"title":"Media Operations"},"target_audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Audience"},"target_audience_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Target Audience Json"},"locations":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Locations"}},"type":"object","required":["campaign_id","ad_id"],"title":"MetaStoriesReelsCampaignUpdateRequest"},"MetaSyncAdCampaignRequest":{"properties":{"platform_type":{"type":"string","title":"Platform Type","description":"meta_feed or meta_stories_reels"},"ad_id":{"type":"string","title":"Ad Id","description":"ID of the specific ad to sync (UUID string)"},"ad_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Account Id","description":"Meta Ad Account ID (optional override)"},"force_sync_fields":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Force Sync Fields","description":"Optional field allowlist for pending edits that should be synced."},"strict_sync_fields":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Strict Sync Fields","description":"Exact reviewed fields; exclude other saved edits."},"pending_update":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pending Update","description":"Pending Pomo edit payload to apply only after remote sync succeeds."}},"type":"object","required":["platform_type","ad_id"],"title":"MetaSyncAdCampaignRequest","description":"Request model for syncing an online ad campaign to Meta."},"MetaSyncPreviewRequest":{"properties":{"platform_type":{"type":"string","title":"Platform Type","description":"meta_feed or meta_stories_reels"},"ad_id":{"type":"string","title":"Ad Id","description":"ID of the specific ad to sync (UUID string)"},"ad_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Account Id","description":"Meta Ad Account ID (optional override)"},"force_sync_fields":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Force Sync Fields","description":"Optional field allowlist for pending edits that should be previewed."},"pending_update":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pending Update","description":"Pending Pomo edit payload to preview without saving it."}},"type":"object","required":["platform_type","ad_id"],"title":"MetaSyncPreviewRequest","description":"Request model for previewing a Meta sync and billing impact."},"MetricAggregateSnapshot":{"properties":{"impressions":{"type":"integer","minimum":0.0,"title":"Impressions","default":0},"clicks":{"type":"integer","minimum":0.0,"title":"Clicks","default":0},"spend":{"type":"string","title":"Spend","default":"0"},"conversions":{"type":"string","title":"Conversions","default":"0"},"all_conversions":{"type":"string","title":"All Conversions","default":"0"},"conversion_value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversion Value"},"video_views":{"type":"integer","minimum":0.0,"title":"Video Views","default":0},"ctr":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ctr"},"cpc":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cpc"},"cpm":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cpm"},"cpa":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cpa"},"roas":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Roas"},"currency_code":{"anyOf":[{"type":"string","maxLength":16,"minLength":3},{"type":"null"}],"title":"Currency Code"}},"additionalProperties":false,"type":"object","title":"MetricAggregateSnapshot"},"MetricEvidence":{"properties":{"metric":{"type":"string","maxLength":120,"minLength":1,"title":"Metric"},"source_key":{"type":"string","maxLength":120,"minLength":1,"title":"Source Key"},"value":{"$ref":"#/components/schemas/JsonValue"},"unit":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Unit"},"population":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Population"},"content_format":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Content Format"},"window":{"$ref":"#/components/schemas/EvidenceWindow"},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"},"availability":{"type":"string","enum":["available","unavailable"],"title":"Availability"},"unavailable_reason":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Unavailable Reason"},"method":{"type":"string","enum":["observed","derived","inferred","legacy"],"title":"Method","default":"legacy"},"derivation":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Derivation"},"freshness":{"type":"string","enum":["fresh","stale","unknown"],"title":"Freshness","default":"unknown"},"fresh_until":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Fresh Until"},"uncertainty":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Uncertainty"},"conflict":{"type":"string","enum":["none","unresolved","resolved","unknown"],"title":"Conflict","default":"unknown"}},"additionalProperties":false,"type":"object","required":["metric","source_key","availability"],"title":"MetricEvidence"},"MetricMovement":{"properties":{"metric_key":{"type":"string","enum":["impressions","clicks","spend","conversions","all_conversions","conversion_value","video_views","ctr","cpc","cpm","cpa","roas"],"title":"Metric Key"},"before_value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Before Value"},"after_value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"After Value"},"absolute_delta":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Absolute Delta"},"relative_delta":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Relative Delta"},"direction":{"type":"string","enum":["up","down","flat","unavailable"],"title":"Direction"}},"additionalProperties":false,"type":"object","required":["metric_key","direction"],"title":"MetricMovement"},"MorningBriefBudgetResponse":{"properties":{"daily_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Daily Cents"},"total_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Cents"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"duration_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Days"}},"type":"object","title":"MorningBriefBudgetResponse"},"MorningBriefCampaignCardResponse":{"properties":{"channel":{"type":"string","enum":["ads","social"],"title":"Channel"},"campaign_id":{"type":"string","title":"Campaign Id"},"platform":{"type":"string","title":"Platform"},"state":{"type":"string","title":"State"},"preview_type":{"type":"string","enum":["media","search"],"title":"Preview Type","default":"media"},"media":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Media"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption"},"display_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Url"},"idea_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Idea Number"},"variation":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Variation"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["channel","campaign_id","platform","state"],"title":"MorningBriefCampaignCardResponse","description":"A live, campaign-owned card for the Overview creation rail."},"MorningBriefConnectionsResponse":{"properties":{"resolved":{"type":"boolean","title":"Resolved","default":false},"providers":{"additionalProperties":{"type":"string","enum":["connected","not_connected"]},"type":"object","title":"Providers"}},"type":"object","title":"MorningBriefConnectionsResponse","description":"Per-provider connection state resolved server-side, never inferred.\n\n``resolved`` is False when the integration lookup failed; readers must then\nrender neutrally rather than claiming anything is disconnected."},"MorningBriefCreatorPlanResponse":{"properties":{"approval_id":{"type":"string","title":"Approval Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Id"}},"type":"object","required":["approval_id"],"title":"MorningBriefCreatorPlanResponse","description":"The open shortlist decision behind ``creators_pending``.\n\n``approval_id`` is what the Influencers page needs to offer the decision\n(``?reviewTeam=&reviewApproval=``); ``title`` is the team's own sentence\nfor what the shortlist is for."},"MorningBriefCreatorResponse":{"properties":{"name":{"type":"string","title":"Name"},"avatar":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"handle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Handle"},"followers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Followers"},"stage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stage"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"why":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Why"}},"type":"object","required":["name"],"title":"MorningBriefCreatorResponse","description":"A saved creator: name, audience size, and where they publish."},"MorningBriefDecisionItemResponse":{"properties":{"approval_id":{"type":"string","format":"uuid","title":"Approval Id"},"kind":{"type":"string","enum":["spend","advisory"],"title":"Kind"},"title":{"type":"string","title":"Title"},"why":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Why"},"proposed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Proposed"},"surface":{"anyOf":[{"type":"string","enum":["ads","social"]},{"type":"null"}],"title":"Surface"},"creative_count":{"type":"integer","title":"Creative Count","default":0},"budget":{"anyOf":[{"$ref":"#/components/schemas/MorningBriefBudgetResponse"},{"type":"null"}]}},"type":"object","required":["approval_id","kind","title"],"title":"MorningBriefDecisionItemResponse"},"MorningBriefDecisionsResponse":{"properties":{"spend_count":{"type":"integer","title":"Spend Count","default":0},"advisory_count":{"type":"integer","title":"Advisory Count","default":0},"total_planned_spend_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Planned Spend Cents"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"items":{"items":{"$ref":"#/components/schemas/MorningBriefDecisionItemResponse"},"type":"array","title":"Items"}},"type":"object","title":"MorningBriefDecisionsResponse"},"MorningBriefEarnedResponse":{"properties":{"title":{"type":"string","title":"Title"},"dek":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dek"},"status_label":{"type":"string","title":"Status Label","default":"Drafting — ready soon"},"project_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Project Id"}},"type":"object","required":["title"],"title":"MorningBriefEarnedResponse"},"MorningBriefGrowthLeadResponse":{"properties":{"name":{"type":"string","title":"Name"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"why":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Why"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"is_new":{"type":"boolean","title":"Is New","default":false}},"type":"object","required":["name"],"title":"MorningBriefGrowthLeadResponse","description":"A saved B2B opening: a named person at a named company, with fit."},"MorningBriefLeadResponse":{"properties":{"kind":{"type":"string","enum":["spend_decisions","mover","competitor","advisory_queue","quiet","cold_start"],"title":"Kind"},"tile_key":{"anyOf":[{"type":"string","enum":["ads","ai_search","competitors"]},{"type":"null"}],"title":"Tile Key"},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"}},"type":"object","required":["kind"],"title":"MorningBriefLeadResponse","description":"What today is actually about, resolved in code before any authoring."},"MorningBriefListeningGapResponse":{"properties":{"you":{"type":"integer","title":"You"},"leader_name":{"type":"string","title":"Leader Name"},"leader":{"type":"integer","title":"Leader"},"total":{"type":"integer","title":"Total"},"share_pct":{"type":"number","title":"Share Pct"}},"type":"object","required":["you","leader_name","leader","total","share_pct"],"title":"MorningBriefListeningGapResponse","description":"A standing gap — a level, not a change. Kept in its own class so no copy\ncan imply the gap itself moved this week."},"MorningBriefListeningMoverResponse":{"properties":{"name":{"type":"string","title":"Name"},"is_you":{"type":"boolean","title":"Is You","default":false},"current":{"type":"integer","title":"Current"},"prior":{"type":"integer","title":"Prior"},"absolute_delta":{"type":"integer","title":"Absolute Delta"},"relative_delta":{"type":"number","title":"Relative Delta"},"z":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Z"},"window_days":{"type":"integer","title":"Window Days","default":14},"target_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Id"}},"type":"object","required":["name","current","prior","absolute_delta","relative_delta"],"title":"MorningBriefListeningMoverResponse","description":"A conversation move that cleared every significance floor."},"MorningBriefListeningResponse":{"properties":{"share":{"items":{"$ref":"#/components/schemas/MorningBriefShareRowResponse"},"type":"array","title":"Share"},"window_days":{"type":"integer","title":"Window Days","default":14},"insight_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Insight Title"},"insight_why":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Insight Why"},"alert_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Alert Label"},"prospects_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Prospects Count"},"movers":{"items":{"$ref":"#/components/schemas/MorningBriefListeningMoverResponse"},"type":"array","title":"Movers"},"gap":{"anyOf":[{"$ref":"#/components/schemas/MorningBriefListeningGapResponse"},{"type":"null"}]}},"type":"object","title":"MorningBriefListeningResponse","description":"Social listening v2: honest share-of-voice plus the top insight."},"MorningBriefMetricSeriesResponse":{"properties":{"traffic":{"items":{"$ref":"#/components/schemas/MorningBriefSeriesPointResponse"},"type":"array","title":"Traffic"},"ai_search":{"items":{"$ref":"#/components/schemas/MorningBriefSeriesPointResponse"},"type":"array","title":"Ai Search"},"sales":{"items":{"$ref":"#/components/schemas/MorningBriefSeriesPointResponse"},"type":"array","title":"Sales"},"sales_window_end":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Sales Window End"},"sales_units_total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sales Units Total"},"ads_yesterday":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ads Yesterday"},"ads_week_total":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ads Week Total"},"ads_active_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ads Active Days"},"ads_impressions":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ads Impressions"},"ads_clicks":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ads Clicks"},"ads_conversions":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ads Conversions"},"ads_channels":{"items":{"type":"string"},"type":"array","title":"Ads Channels"},"traffic_frame":{"anyOf":[{"$ref":"#/components/schemas/MorningBriefTrafficFrameResponse"},{"type":"null"}]}},"type":"object","title":"MorningBriefMetricSeriesResponse","description":"Real history only. A metric with no stored series gets no entry here —\nthe page renders its number without a diagram rather than faking one."},"MorningBriefPendingCreativeResponse":{"properties":{"approval_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approval Id"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"surface":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Surface"},"state":{"type":"string","enum":["pending","approved"],"title":"State","default":"pending"},"media":{"type":"string","title":"Media"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"bundle_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bundle Title"},"why":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Why"},"expected":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected"},"confidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence"}},"type":"object","required":["media"],"title":"MorningBriefPendingCreativeResponse"},"MorningBriefProspectLeadResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"quote":{"type":"string","title":"Quote"},"why":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Why"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"kind":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"},"target_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Name"},"reply_draft":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reply Draft"}},"type":"object","required":["quote"],"title":"MorningBriefProspectLeadResponse","description":"One person, in their own words, from the prospecting sweep."},"MorningBriefReceiptResponse":{"properties":{"action_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Action Id"},"title":{"type":"string","title":"Title"},"state":{"type":"string","enum":["improved","regressed","no_change","measuring"],"title":"State","default":"measuring"},"chip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chip"},"days_observed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Days Observed"},"decided_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Decided At"}},"type":"object","required":["title"],"title":"MorningBriefReceiptResponse"},"MorningBriefResponse":{"properties":{"version":{"type":"integer","title":"Version","default":1},"run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"},"report_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Report Date"},"generated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Generated At"},"day_kind":{"type":"string","enum":["spend_decisions","advisory","quiet","cold_start"],"title":"Day Kind"},"brand_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand Name"},"lead":{"$ref":"#/components/schemas/MorningBriefLeadResponse"},"verdict":{"$ref":"#/components/schemas/MorningBriefVerdictResponse"},"decisions":{"$ref":"#/components/schemas/MorningBriefDecisionsResponse"},"tiles":{"items":{"$ref":"#/components/schemas/MorningBriefTileResponse"},"type":"array","title":"Tiles"},"receipts":{"items":{"$ref":"#/components/schemas/MorningBriefReceiptResponse"},"type":"array","title":"Receipts"},"worth_a_look":{"items":{"$ref":"#/components/schemas/MorningBriefWorthALookResponse"},"type":"array","title":"Worth A Look"},"connections":{"$ref":"#/components/schemas/MorningBriefConnectionsResponse"},"metric_series":{"anyOf":[{"$ref":"#/components/schemas/MorningBriefMetricSeriesResponse"},{"type":"null"}]},"earned":{"anyOf":[{"$ref":"#/components/schemas/MorningBriefEarnedResponse"},{"type":"null"}]},"trend":{"anyOf":[{"$ref":"#/components/schemas/MorningBriefTrendResponse"},{"type":"null"}]},"listening":{"anyOf":[{"$ref":"#/components/schemas/MorningBriefListeningResponse"},{"type":"null"}]},"strategist":{"anyOf":[{"$ref":"#/components/schemas/MorningBriefStrategistResponse"},{"type":"null"}]},"pending_creatives":{"items":{"$ref":"#/components/schemas/MorningBriefPendingCreativeResponse"},"type":"array","title":"Pending Creatives"},"social_cards":{"items":{"$ref":"#/components/schemas/MorningBriefSocialCardResponse"},"type":"array","title":"Social Cards"},"campaign_cards":{"items":{"$ref":"#/components/schemas/MorningBriefCampaignCardResponse"},"type":"array","title":"Campaign Cards"},"prospect_leads":{"items":{"$ref":"#/components/schemas/MorningBriefProspectLeadResponse"},"type":"array","title":"Prospect Leads"},"growth_leads":{"items":{"$ref":"#/components/schemas/MorningBriefGrowthLeadResponse"},"type":"array","title":"Growth Leads"},"creators":{"items":{"$ref":"#/components/schemas/MorningBriefCreatorResponse"},"type":"array","title":"Creators"},"creators_total":{"type":"integer","title":"Creators Total","default":0},"creators_pending":{"items":{"$ref":"#/components/schemas/MorningBriefCreatorResponse"},"type":"array","title":"Creators Pending"},"creators_pending_total":{"type":"integer","title":"Creators Pending Total","default":0},"creators_pending_plan":{"anyOf":[{"$ref":"#/components/schemas/MorningBriefCreatorPlanResponse"},{"type":"null"}]},"minor_demand_count":{"type":"integer","title":"Minor Demand Count","default":0},"social_cards_scope":{"type":"string","enum":["run","recent"],"title":"Social Cards Scope","default":"recent"},"next_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Run At"},"backfilled":{"type":"boolean","title":"Backfilled","default":false}},"type":"object","required":["day_kind","lead","verdict"],"title":"MorningBriefResponse","description":"One authored artifact per run: everything the home page renders."},"MorningBriefSeriesPointResponse":{"properties":{"d":{"type":"string","format":"date","title":"D"},"v":{"type":"number","title":"V"}},"type":"object","required":["d","v"],"title":"MorningBriefSeriesPointResponse"},"MorningBriefShareRowResponse":{"properties":{"name":{"type":"string","title":"Name"},"count":{"type":"integer","title":"Count"},"is_you":{"type":"boolean","title":"Is You","default":false},"target_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Id"}},"type":"object","required":["name","count"],"title":"MorningBriefShareRowResponse"},"MorningBriefSizingResponse":{"properties":{"label":{"type":"string","title":"Label"},"kind":{"type":"string","enum":["band","computed"],"title":"Kind","default":"band"}},"type":"object","required":["label"],"title":"MorningBriefSizingResponse"},"MorningBriefSocialCardResponse":{"properties":{"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"state":{"type":"string","enum":["draft","scheduled","posted"],"title":"State","default":"draft"},"media":{"type":"string","title":"Media"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption"},"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Post Url"},"scheduled_for":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Scheduled For"}},"type":"object","required":["media"],"title":"MorningBriefSocialCardResponse"},"MorningBriefStrategistResponse":{"properties":{"plan_headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Headline"},"lines":{"items":{"type":"string"},"type":"array","title":"Lines"},"insight_titles":{"items":{"type":"string"},"type":"array","title":"Insight Titles"},"n_insights":{"type":"integer","title":"N Insights","default":0}},"type":"object","title":"MorningBriefStrategistResponse"},"MorningBriefTileHeadlineResponse":{"properties":{"value":{"type":"string","title":"Value"},"unit":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unit"},"delta":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Delta"},"delta_tone":{"anyOf":[{"type":"string","enum":["positive","negative","neutral"]},{"type":"null"}],"title":"Delta Tone"}},"type":"object","required":["value"],"title":"MorningBriefTileHeadlineResponse","description":"At most ONE figure per tile. Denominators belong in the sentence."},"MorningBriefTileResponse":{"properties":{"key":{"type":"string","enum":["ads","ai_search","competitors"],"title":"Key"},"state":{"type":"string","enum":["measured","observed","measuring","not_connected","pending_first_check","unavailable"],"title":"State"},"label":{"type":"string","title":"Label"},"headline":{"anyOf":[{"$ref":"#/components/schemas/MorningBriefTileHeadlineResponse"},{"type":"null"}]},"sentence":{"type":"string","title":"Sentence","default":""},"basis":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Basis"},"lead_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lead Label"},"next_check_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Check At"},"cta_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cta Label"}},"type":"object","required":["key","state","label"],"title":"MorningBriefTileResponse"},"MorningBriefTrafficFrameResponse":{"properties":{"last_day":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Day"},"window_days":{"type":"integer","title":"Window Days","default":7},"current":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Current"},"prior":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Prior"},"absolute_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Absolute Delta"},"relative_delta":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Relative Delta"},"z":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Z"},"flat_baseline":{"type":"boolean","title":"Flat Baseline","default":false},"baseline_low":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Baseline Low"},"baseline_high":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Baseline High"},"complete":{"type":"boolean","title":"Complete","default":false},"significant":{"type":"boolean","title":"Significant","default":false}},"type":"object","title":"MorningBriefTrafficFrameResponse","description":"One window for the number and its delta, anchored on the last day with\ndata — and whether the move clears the significance floors."},"MorningBriefTrendPlayResponse":{"properties":{"label":{"type":"string","title":"Label"},"explanation":{"type":"string","title":"Explanation"},"window_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Window Days"}},"type":"object","required":["label","explanation"],"title":"MorningBriefTrendPlayResponse","description":"A move the trend model wrote for this trend, projected as stored."},"MorningBriefTrendResponse":{"properties":{"title":{"type":"string","title":"Title"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"evidence_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Evidence Count"},"shown_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Shown Count"},"excluded_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Excluded Note"},"fit_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fit Label"},"thumbs":{"items":{"$ref":"#/components/schemas/MorningBriefTrendThumbResponse"},"type":"array","title":"Thumbs"},"plays":{"items":{"$ref":"#/components/schemas/MorningBriefTrendPlayResponse"},"type":"array","title":"Plays"}},"type":"object","required":["title"],"title":"MorningBriefTrendResponse"},"MorningBriefTrendThumbResponse":{"properties":{"kind":{"type":"string","enum":["tiktok_video","image_url"],"title":"Kind","default":"image_url"},"media":{"type":"string","title":"Media"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"views_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Views Label"},"source_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Name"}},"type":"object","required":["media"],"title":"MorningBriefTrendThumbResponse"},"MorningBriefVerdictResponse":{"properties":{"headline":{"type":"string","title":"Headline"},"summary":{"type":"string","title":"Summary","default":""},"source":{"type":"string","enum":["authored","fallback"],"title":"Source","default":"fallback"}},"type":"object","required":["headline"],"title":"MorningBriefVerdictResponse","description":"The one sentence the owner reads first."},"MorningBriefWorthALookResponse":{"properties":{"kind":{"type":"string","enum":["prospects","trend"],"title":"Kind"},"title":{"type":"string","title":"Title"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count"},"window_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Window Days"},"example":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Example"},"sizing":{"anyOf":[{"$ref":"#/components/schemas/MorningBriefSizingResponse"},{"type":"null"}]}},"type":"object","required":["kind","title"],"title":"MorningBriefWorthALookResponse"},"MutationRequest":{"properties":{"idempotency_key":{"type":"string","maxLength":255,"minLength":8,"title":"Idempotency Key"}},"type":"object","required":["idempotency_key"],"title":"MutationRequest"},"NativeArticleViewResponse":{"properties":{"article_id":{"type":"string","format":"uuid","title":"Article Id"},"content_version":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Content Version"},"title":{"type":"string","title":"Title"},"href":{"type":"string","title":"Href"}},"additionalProperties":false,"type":"object","required":["article_id","content_version","title","href"],"title":"NativeArticleViewResponse"},"NativeEffectLimit":{"additionalProperties":true,"type":"object"},"NativeReadFilter":{"properties":{"field":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$","title":"Field"},"value":{"anyOf":[{"type":"string"},{"type":"boolean"},{"type":"integer"}],"title":"Value"}},"additionalProperties":false,"type":"object","required":["field","value"],"title":"NativeReadFilter"},"NativeReadMetadata":{"properties":{"version":{"type":"integer","const":1,"title":"Version","default":1},"records":{"items":{"$ref":"#/components/schemas/NativeReadRecord"},"type":"array","maxItems":20,"title":"Records","default":[]},"page":{"anyOf":[{"$ref":"#/components/schemas/NativeReadPage"},{"type":"null"}]}},"additionalProperties":false,"type":"object","title":"NativeReadMetadata","description":"Dates and collection coverage of saved records; never performance proof."},"NativeReadOrder":{"properties":{"field":{"type":"string","enum":["created_at","updated_at","id"],"title":"Field"},"direction":{"type":"string","enum":["asc","desc"],"title":"Direction"}},"additionalProperties":false,"type":"object","required":["field","direction"],"title":"NativeReadOrder"},"NativeReadPage":{"properties":{"offset":{"type":"integer","minimum":0.0,"title":"Offset"},"requested_limit":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Requested Limit"},"scanned_count":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Scanned Count"},"returned_count":{"type":"integer","maximum":20.0,"minimum":0.0,"title":"Returned Count"},"has_more":{"type":"boolean","title":"Has More"},"next_offset":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Next Offset"},"ordering":{"items":{"$ref":"#/components/schemas/NativeReadOrder"},"type":"array","maxItems":3,"minItems":1,"title":"Ordering"},"filters":{"items":{"$ref":"#/components/schemas/NativeReadFilter"},"type":"array","maxItems":8,"title":"Filters","default":[]}},"additionalProperties":false,"type":"object","required":["offset","requested_limit","scanned_count","returned_count","has_more","ordering"],"title":"NativeReadPage","description":"The native query's actual ordering and coverage, not an inferred total."},"NativeReadRecord":{"properties":{"record_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"string","maxLength":256,"minLength":1}],"title":"Record Id"},"record_ref":{"$ref":"#/components/schemas/ResourceRef"},"record_kind":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$","title":"Record Kind"},"title":{"type":"string","maxLength":255,"title":"Title"},"title_truncated":{"type":"boolean","title":"Title Truncated","default":false},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"record_version":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"type":"null"}],"title":"Record Version"},"artifact_index":{"anyOf":[{"type":"integer","maximum":19.0,"minimum":0.0},{"type":"null"}],"title":"Artifact Index"},"preview_record_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"string","maxLength":256,"minLength":1},{"type":"null"}],"title":"Preview Record Id"},"preview_ref":{"anyOf":[{"$ref":"#/components/schemas/ResourceRef"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["record_id","record_ref","record_kind","title"],"title":"NativeReadRecord","description":"One source-owned saved record; preview reuse is a separate identity."},"NativeResponsibilityReview":{"additionalProperties":true,"type":"object"},"NewEmailSendRequest":{"properties":{"email_account_id":{"type":"string","format":"uuid","title":"Email Account Id"},"target":{"$ref":"#/components/schemas/LeadFinderEmailTarget"},"origin":{"$ref":"#/components/schemas/LeadFinderEmailOrigin"},"expected_to_address":{"type":"string","maxLength":320,"minLength":3,"title":"Expected To Address"},"subject":{"type":"string","maxLength":998,"title":"Subject"},"body_text":{"type":"string","maxLength":100000,"minLength":1,"title":"Body Text"},"signature_text":{"type":"string","maxLength":100000,"title":"Signature Text","default":""},"idempotency_key":{"type":"string","maxLength":128,"minLength":8,"title":"Idempotency Key"}},"type":"object","required":["email_account_id","target","origin","expected_to_address","subject","body_text","idempotency_key"],"title":"NewEmailSendRequest"},"NewEmailSendResponse":{"properties":{"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"message_id":{"type":"string","format":"uuid","title":"Message Id"},"delivery_status":{"type":"string","enum":["pending","sent","failed","unknown"],"title":"Delivery Status"},"from_address":{"type":"string","title":"From Address"},"to_address":{"type":"string","title":"To Address"},"subject":{"type":"string","title":"Subject"},"provider_message_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Message Id"},"provider_thread_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Thread Id"},"safe_message":{"type":"string","title":"Safe Message"},"reauthorization_required":{"type":"boolean","title":"Reauthorization Required"},"person_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Person Ref"}},"type":"object","required":["conversation_id","message_id","delivery_status","from_address","to_address","subject","safe_message","reauthorization_required"],"title":"NewEmailSendResponse"},"ObservedVersionPrecondition":{"properties":{"record_ref":{"$ref":"#/components/schemas/ResourceRef"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Version"},"target":{"$ref":"#/components/schemas/ReadVersionTarget"}},"additionalProperties":false,"type":"object","required":["record_ref","version","target"],"title":"ObservedVersionPrecondition","description":"Core-verified read snapshot and its registry-declared edit precondition."},"OnboardingNarrativeRequest":{"properties":{"stage":{"type":"string","enum":["assessment","competitors","gaps","ads","insights"],"title":"Stage"},"context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context"},"force_refresh":{"type":"boolean","title":"Force Refresh","default":false}},"type":"object","required":["stage"],"title":"OnboardingNarrativeRequest"},"OrganicSocialAnalysisFinding":{"properties":{"provider":{"type":"string","enum":["facebook","instagram","tiktok","youtube"],"title":"Provider"},"title":{"type":"string","title":"Title"},"observation":{"type":"string","title":"Observation"},"business_implication":{"type":"string","title":"Business Implication"},"confidence":{"type":"string","enum":["high","medium","low"],"title":"Confidence"},"evidence_metric_keys":{"items":{"type":"string"},"type":"array","title":"Evidence Metric Keys"}},"type":"object","required":["provider","title","observation","business_implication","confidence"],"title":"OrganicSocialAnalysisFinding"},"OrganicSocialAnalysisRecommendation":{"properties":{"provider":{"type":"string","enum":["facebook","instagram","tiktok","youtube"],"title":"Provider"},"action":{"type":"string","title":"Action"},"rationale":{"type":"string","title":"Rationale"},"evidence_metric_keys":{"items":{"type":"string"},"type":"array","title":"Evidence Metric Keys"}},"type":"object","required":["provider","action","rationale"],"title":"OrganicSocialAnalysisRecommendation"},"OrganicSocialAnalysisSummary":{"properties":{"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"summary":{"type":"string","title":"Summary"},"findings":{"items":{"$ref":"#/components/schemas/OrganicSocialAnalysisFinding"},"type":"array","title":"Findings"},"recommendations":{"items":{"$ref":"#/components/schemas/OrganicSocialAnalysisRecommendation"},"type":"array","title":"Recommendations"},"data_gaps":{"items":{"type":"string"},"type":"array","title":"Data Gaps"},"eligible_providers":{"items":{"type":"string","enum":["facebook","instagram","tiktok","youtube"]},"type":"array","title":"Eligible Providers"}},"type":"object","required":["generated_at","summary"],"title":"OrganicSocialAnalysisSummary"},"OrganicSocialCapabilitiesResponse":{"properties":{"resources":{"items":{"$ref":"#/components/schemas/OrganicSocialResourceCapabilities"},"type":"array","title":"Resources"}},"type":"object","required":["resources"],"title":"OrganicSocialCapabilitiesResponse"},"OrganicSocialCapabilityState":{"properties":{"capability":{"type":"string","title":"Capability"},"available":{"type":"boolean","title":"Available"},"reason_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason Code"},"required_scopes":{"items":{"type":"string"},"type":"array","title":"Required Scopes"},"observed_scopes":{"items":{"type":"string"},"type":"array","title":"Observed Scopes"}},"type":"object","required":["capability","available"],"title":"OrganicSocialCapabilityState"},"OrganicSocialChannelSummary":{"properties":{"resource_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Resource Id"},"platform":{"type":"string","enum":["facebook","instagram","linkedin","tiktok","youtube"],"title":"Platform"},"platform_label":{"type":"string","title":"Platform Label"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name"},"connection_status":{"type":"string","enum":["connected","not_connected","reauthorization_required","review_pending","role_restricted"],"title":"Connection Status"},"analytics_access":{"type":"string","enum":["granted","missing_permission","review_pending","role_restricted","unavailable"],"title":"Analytics Access"},"publishing_access":{"type":"string","enum":["granted","missing_permission","review_pending","role_restricted","unavailable"],"title":"Publishing Access"},"reporting_status":{"type":"string","enum":["reported","verified_zero","no_data","initial_sync","stale","error","unavailable"],"title":"Reporting Status"},"status_detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Detail"},"last_synced_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Synced At"},"metrics":{"items":{"$ref":"#/components/schemas/OrganicSocialMetric"},"type":"array","title":"Metrics"},"observation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observation"},"top_post":{"anyOf":[{"$ref":"#/components/schemas/OrganicSocialTopPost"},{"type":"null"}]}},"type":"object","required":["platform","platform_label","connection_status","analytics_access","publishing_access","reporting_status"],"title":"OrganicSocialChannelSummary"},"OrganicSocialCoverage":{"properties":{"total_channels":{"type":"integer","minimum":0.0,"title":"Total Channels"},"connected_channels":{"type":"integer","minimum":0.0,"title":"Connected Channels"},"reporting_channels":{"type":"integer","minimum":0.0,"title":"Reporting Channels"},"coverage_complete":{"type":"boolean","title":"Coverage Complete"}},"type":"object","required":["total_channels","connected_channels","reporting_channels","coverage_complete"],"title":"OrganicSocialCoverage"},"OrganicSocialMetric":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value"},"unit":{"type":"string","enum":["count","percent","seconds","minutes","hours"],"title":"Unit"},"source_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Label"},"period_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period Label"},"definition_note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Definition Note"},"change":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Change"},"change_unit":{"anyOf":[{"type":"string","enum":["absolute","percent","percentage_points"]},{"type":"null"}],"title":"Change Unit"}},"type":"object","required":["key","label","value","unit"],"title":"OrganicSocialMetric"},"OrganicSocialObservation":{"properties":{"id":{"type":"string","title":"Id"},"platform":{"type":"string","enum":["facebook","instagram","linkedin","tiktok","youtube"],"title":"Platform"},"text":{"type":"string","title":"Text"}},"type":"object","required":["id","platform","text"],"title":"OrganicSocialObservation"},"OrganicSocialOutcome":{"properties":{"headline":{"type":"string","title":"Headline"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"}},"type":"object","required":["headline"],"title":"OrganicSocialOutcome"},"OrganicSocialOverviewResponse":{"properties":{"metric_mode":{"type":"string","enum":["observed","recorded"],"title":"Metric Mode"},"is_demo":{"type":"boolean","const":false,"title":"Is Demo","default":false},"status":{"type":"string","enum":["ready","initial_sync","access_blocked","no_reporting_data"],"title":"Status"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"reporting_start":{"type":"string","format":"date-time","title":"Reporting Start"},"reporting_through":{"type":"string","format":"date-time","title":"Reporting Through"},"coverage":{"$ref":"#/components/schemas/OrganicSocialCoverage"},"outcome":{"anyOf":[{"$ref":"#/components/schemas/OrganicSocialOutcome"},{"type":"null"}]},"summary_facts":{"items":{"$ref":"#/components/schemas/OrganicSocialMetric"},"type":"array","title":"Summary Facts"},"published_post_count":{"type":"integer","minimum":0.0,"title":"Published Post Count","default":0},"recent_posts":{"items":{"$ref":"#/components/schemas/OrganicSocialPublishedPost"},"type":"array","title":"Recent Posts"},"viewer":{"$ref":"#/components/schemas/OrganicSocialViewer"},"channels":{"items":{"$ref":"#/components/schemas/OrganicSocialChannelSummary"},"type":"array","title":"Channels"},"observations":{"items":{"$ref":"#/components/schemas/OrganicSocialObservation"},"type":"array","title":"Observations"},"analysis":{"anyOf":[{"$ref":"#/components/schemas/OrganicSocialAnalysisSummary"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["metric_mode","status","generated_at","reporting_start","reporting_through","coverage","viewer","channels"],"title":"OrganicSocialOverviewResponse"},"OrganicSocialPublishedPost":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"remote_post_id":{"type":"string","title":"Remote Post Id"},"campaign_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Campaign Id"},"platform":{"type":"string","enum":["facebook","instagram","linkedin","tiktok","youtube"],"title":"Platform"},"platform_label":{"type":"string","title":"Platform Label"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name"},"origin":{"type":"string","enum":["pomo","native","unknown"],"title":"Origin"},"title":{"type":"string","title":"Title"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption"},"published_at":{"type":"string","format":"date-time","title":"Published At"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"media_type":{"anyOf":[{"type":"string","enum":["image","video","carousel","short"]},{"type":"null"}],"title":"Media Type"},"permalink":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Permalink"},"metrics":{"items":{"$ref":"#/components/schemas/OrganicSocialMetric"},"type":"array","title":"Metrics"}},"type":"object","required":["id","remote_post_id","platform","platform_label","origin","title","published_at"],"title":"OrganicSocialPublishedPost"},"OrganicSocialRefreshRequest":{"properties":{"window":{"type":"string","enum":["7d","28d","90d"],"title":"Window","default":"28d"}},"type":"object","title":"OrganicSocialRefreshRequest"},"OrganicSocialRefreshResponse":{"properties":{"status":{"type":"string","enum":["queued","no_resources","already_running"],"title":"Status"},"batch_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Batch Key"},"run_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Run Ids"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["status","generated_at"],"title":"OrganicSocialRefreshResponse"},"OrganicSocialRefreshStatusResponse":{"properties":{"batch_key":{"type":"string","title":"Batch Key"},"status":{"type":"string","enum":["queued","running","completed","partial","failed"],"title":"Status"},"runs":{"items":{"$ref":"#/components/schemas/OrganicSocialSyncRunSummary"},"type":"array","title":"Runs"},"manifest_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Manifest Id"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["batch_key","status","runs","updated_at"],"title":"OrganicSocialRefreshStatusResponse"},"OrganicSocialResourceCapabilities":{"properties":{"resource_id":{"type":"string","format":"uuid","title":"Resource Id"},"platform":{"type":"string","enum":["facebook","instagram","linkedin","tiktok","youtube"],"title":"Platform"},"account_name":{"type":"string","title":"Account Name"},"capabilities":{"items":{"$ref":"#/components/schemas/OrganicSocialCapabilityState"},"type":"array","title":"Capabilities"}},"type":"object","required":["resource_id","platform","account_name","capabilities"],"title":"OrganicSocialResourceCapabilities"},"OrganicSocialSyncRunSummary":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"resource_id":{"type":"string","format":"uuid","title":"Resource Id"},"platform":{"type":"string","enum":["facebook","instagram","linkedin","tiktok","youtube"],"title":"Platform"},"stream_kind":{"type":"string","enum":["content_inventory","metrics"],"title":"Stream Kind"},"status":{"type":"string","enum":["queued","running","completed","partial","failed","skipped"],"title":"Status"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"queued_at":{"type":"string","format":"date-time","title":"Queued At"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"finished_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Finished At"}},"type":"object","required":["id","resource_id","platform","stream_kind","status","queued_at"],"title":"OrganicSocialSyncRunSummary"},"OrganicSocialTopPost":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption"},"published_at":{"type":"string","format":"date-time","title":"Published At"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"media_type":{"anyOf":[{"type":"string","enum":["image","video","carousel","short"]},{"type":"null"}],"title":"Media Type"},"permalink":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Permalink"},"metrics":{"items":{"$ref":"#/components/schemas/OrganicSocialMetric"},"type":"array","title":"Metrics"}},"type":"object","required":["id","title","published_at"],"title":"OrganicSocialTopPost"},"OrganicSocialViewer":{"properties":{"can_create_posts":{"type":"boolean","title":"Can Create Posts"},"can_refresh_metrics":{"type":"boolean","title":"Can Refresh Metrics"},"can_manage_connections":{"type":"boolean","title":"Can Manage Connections"},"role_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role Label"}},"type":"object","required":["can_create_posts","can_refresh_metrics","can_manage_connections"],"title":"OrganicSocialViewer"},"OrganizationBillingMetadataResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"name":{"type":"string","title":"Name"},"billing_model":{"anyOf":[{"$ref":"#/components/schemas/BillingModel"},{"type":"null"}]},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"gstin":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gstin"},"gstin_company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gstin Company Name"},"stripe_tax_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Tax Id"}},"type":"object","required":["id","name"],"title":"OrganizationBillingMetadataResponse","description":"Recovery-safe organization billing fields required by checkout flows."},"OrganizationInviteActionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","message"],"title":"OrganizationInviteActionResponse","description":"Response for invite resend/revoke actions."},"OrganizationInviteFailure":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"reason":{"type":"string","title":"Reason"}},"type":"object","required":["email","reason"],"title":"OrganizationInviteFailure","description":"Error details for failed invite operations."},"OrganizationInviteInfoResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"name":{"type":"string","title":"Name"},"member_count":{"type":"integer","title":"Member Count"},"valid":{"type":"boolean","title":"Valid"}},"type":"object","required":["id","name","member_count","valid"],"title":"OrganizationInviteInfoResponse","description":"Response model for organization invitation preview (public endpoint)."},"OrganizationInviteLinkRequest":{"properties":{"role":{"$ref":"#/components/schemas/OrganizationRoleEnum","default":"member"},"company_profile_access":{"anyOf":[{"items":{"$ref":"#/components/schemas/OrganizationInviteProfileAccessRequest"},"type":"array"},{"type":"null"}],"title":"Company Profile Access"},"expires_in_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Expires In Days"}},"type":"object","title":"OrganizationInviteLinkRequest","description":"Request payload for creating an open invite link."},"OrganizationInviteLinkResponse":{"properties":{"invite":{"$ref":"#/components/schemas/OrganizationInviteResponse"}},"type":"object","required":["invite"],"title":"OrganizationInviteLinkResponse","description":"Response payload for open invite link creation."},"OrganizationInviteListResponse":{"properties":{"invites":{"items":{"$ref":"#/components/schemas/OrganizationInviteResponse"},"type":"array","title":"Invites"}},"type":"object","required":["invites"],"title":"OrganizationInviteListResponse","description":"Response payload for listing invites."},"OrganizationInviteProfileAccessRequest":{"properties":{"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"role":{"$ref":"#/components/schemas/ProjectRoleEnum"}},"type":"object","required":["company_profile_id","role"],"title":"OrganizationInviteProfileAccessRequest","description":"Request payload for default company profile access on invite acceptance."},"OrganizationInviteProfileAccessResponse":{"properties":{"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"company_profile_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Name"},"role":{"type":"string","title":"Role"}},"type":"object","required":["company_profile_id","role"],"title":"OrganizationInviteProfileAccessResponse","description":"Response model for invite profile access summary."},"OrganizationInviteResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"role":{"type":"string","title":"Role"},"status":{"type":"string","title":"Status"},"invite_type":{"type":"string","title":"Invite Type"},"invited_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invited By"},"created_at":{"type":"string","title":"Created At"},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At"},"last_sent_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Sent At"},"accepted_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accepted At"},"invite_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invite Url"},"use_count":{"type":"integer","title":"Use Count","default":0},"last_used_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Used At"},"company_profile_access":{"items":{"$ref":"#/components/schemas/OrganizationInviteProfileAccessResponse"},"type":"array","title":"Company Profile Access","default":[]}},"type":"object","required":["id","role","status","invite_type","created_at"],"title":"OrganizationInviteResponse","description":"Response model for a single organization invite."},"OrganizationListItemResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"name":{"type":"string","title":"Name"},"billing_model":{"anyOf":[{"$ref":"#/components/schemas/BillingModel"},{"type":"null"}]},"member_count":{"type":"integer","title":"Member Count"},"user_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Role"},"is_owner":{"type":"boolean","title":"Is Owner"},"subscription_active":{"type":"boolean","title":"Subscription Active","default":false},"subscription_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscription Status"},"subscription_plan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscription Plan"},"subscription_last_reconciled_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subscription Last Reconciled At"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["id","name","member_count","is_owner","created_at","updated_at"],"title":"OrganizationListItemResponse","description":"Response model for organization list item (lightweight, no full member list)."},"OrganizationMemberResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"name":{"type":"string","title":"Name"},"email":{"type":"string","title":"Email"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"is_owner":{"type":"boolean","title":"Is Owner"},"joined_at":{"type":"string","title":"Joined At"}},"type":"object","required":["id","user_id","name","email","is_owner","joined_at"],"title":"OrganizationMemberResponse","description":"Response model for organization member information."},"OrganizationResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"name":{"type":"string","title":"Name"},"billing_model":{"anyOf":[{"$ref":"#/components/schemas/BillingModel"},{"type":"null"}]},"invite_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invite Token"},"members":{"items":{"$ref":"#/components/schemas/OrganizationMemberResponse"},"type":"array","title":"Members"},"member_count":{"type":"integer","title":"Member Count"},"created_at":{"type":"string","title":"Created At"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["id","name","invite_token","members","member_count","created_at","updated_at"],"title":"OrganizationResponse","description":"Response model for organization details with all members."},"OrganizationRoleEnum":{"type":"string","enum":["owner","admin","member"],"title":"OrganizationRoleEnum","description":"Organization-level role options."},"OrganizationRoleUpdateRequest":{"properties":{"role":{"$ref":"#/components/schemas/OrganizationRoleEnum","description":"New role to assign"}},"type":"object","required":["role"],"title":"OrganizationRoleUpdateRequest","description":"Request to update a user's organization role."},"OutcomeCampaignReviewFact":{"properties":{"platform":{"type":"string","maxLength":32,"minLength":1,"title":"Platform"},"external_campaign_document_id":{"anyOf":[{"type":"string","maxLength":191},{"type":"null"}],"title":"External Campaign Document Id"},"pomo_campaign_id":{"anyOf":[{"type":"string","maxLength":191},{"type":"null"}],"title":"Pomo Campaign Id"},"campaign_public_id":{"anyOf":[{"type":"string","maxLength":191},{"type":"null"}],"title":"Campaign Public Id"}},"additionalProperties":false,"type":"object","required":["platform"],"title":"OutcomeCampaignReviewFact"},"OutcomeMetricWindowReviewFact":{"properties":{"start_date":{"type":"string","format":"date","title":"Start Date"},"end_date":{"type":"string","format":"date","title":"End Date"},"expected_days":{"type":"integer","maximum":31.0,"minimum":1.0,"title":"Expected Days"},"observed_days":{"type":"integer","maximum":31.0,"minimum":0.0,"title":"Observed Days"},"account_timezone":{"type":"string","maxLength":128,"minLength":1,"title":"Account Timezone"},"metrics":{"$ref":"#/components/schemas/MetricAggregateSnapshot"}},"additionalProperties":false,"type":"object","required":["start_date","end_date","expected_days","observed_days","account_timezone","metrics"],"title":"OutcomeMetricWindowReviewFact"},"OutcomeReviewNeutralFacts":{"properties":{"kind":{"type":"string","const":"outcome_observation","title":"Kind","default":"outcome_observation"},"agent_team_action_id":{"type":"string","maxLength":191,"minLength":1,"title":"Agent Team Action Id"},"observation_kind":{"type":"string","enum":["performance_association","execution_failure"],"title":"Observation Kind"},"execution_status":{"type":"string","maxLength":40,"minLength":1,"title":"Execution Status"},"execution_completed_at":{"type":"string","format":"date-time","title":"Execution Completed At"},"action_local_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Action Local Date"},"failure_code":{"anyOf":[{"type":"string","maxLength":96},{"type":"null"}],"title":"Failure Code"},"campaign":{"anyOf":[{"$ref":"#/components/schemas/OutcomeCampaignReviewFact"},{"type":"null"}]},"before_window":{"anyOf":[{"$ref":"#/components/schemas/OutcomeMetricWindowReviewFact"},{"type":"null"}]},"after_window":{"anyOf":[{"$ref":"#/components/schemas/OutcomeMetricWindowReviewFact"},{"type":"null"}]},"movements":{"items":{"$ref":"#/components/schemas/MetricMovement"},"type":"array","maxItems":16,"title":"Movements"},"concurrent_action_count":{"type":"integer","maximum":32.0,"minimum":0.0,"title":"Concurrent Action Count"}},"additionalProperties":false,"type":"object","required":["agent_team_action_id","observation_kind","execution_status","execution_completed_at","concurrent_action_count"],"title":"OutcomeReviewNeutralFacts"},"OverviewAdsCreativePreviewResponse":{"properties":{"evidence_id":{"type":"string","title":"Evidence Id"},"asset_library_id":{"type":"string","title":"Asset Library Id"},"media_type":{"type":"string","title":"Media Type"},"platform":{"type":"string","title":"Platform"},"campaign_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign Name"},"performance_tier":{"type":"string","title":"Performance Tier","default":"learning"},"analyzed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Analyzed At"}},"type":"object","required":["evidence_id","asset_library_id","media_type","platform"],"title":"OverviewAdsCreativePreviewResponse","description":"Small, profile-scoped reference to an analyzed visual ad asset."},"OverviewAdsPerformanceChannelResponse":{"properties":{"platform":{"type":"string","title":"Platform"},"label":{"type":"string","title":"Label"},"running_campaigns":{"type":"integer","title":"Running Campaigns","default":0},"running_ads":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Running Ads"},"delivery_verified":{"type":"boolean","title":"Delivery Verified","default":false},"spend_7d":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Spend 7D"},"spend_7d_by_currency":{"additionalProperties":{"type":"number"},"type":"object","title":"Spend 7D By Currency"},"ctr_7d":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ctr 7D"},"conversions_7d":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Conversions 7D"},"high_ads":{"type":"integer","title":"High Ads","default":0},"typical_ads":{"type":"integer","title":"Typical Ads","default":0},"low_ads":{"type":"integer","title":"Low Ads","default":0},"learning_ads":{"type":"integer","title":"Learning Ads","default":0}},"type":"object","required":["platform","label"],"title":"OverviewAdsPerformanceChannelResponse","description":"Truthful, bounded paid-media facts for one provider family."},"OverviewAdsPerformanceSummaryResponse":{"properties":{"report_id":{"type":"string","title":"Report Id"},"run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"},"generated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Generated At"},"report_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Report Date"},"metric_mode":{"type":"string","title":"Metric Mode","default":"production"},"simulation":{"type":"boolean","title":"Simulation","default":false},"delivery_verified":{"type":"boolean","title":"Delivery Verified","default":false},"running_ads":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Running Ads"},"spend_7d":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Spend 7D"},"spend_7d_by_currency":{"additionalProperties":{"type":"number"},"type":"object","title":"Spend 7D By Currency"},"ctr_7d":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ctr 7D"},"conversions_7d":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Conversions 7D"},"high_ads":{"type":"integer","title":"High Ads","default":0},"typical_ads":{"type":"integer","title":"Typical Ads","default":0},"low_ads":{"type":"integer","title":"Low Ads","default":0},"learning_ads":{"type":"integer","title":"Learning Ads","default":0},"optimization_action_count":{"type":"integer","title":"Optimization Action Count","default":0},"creative_analyzed_count":{"type":"integer","title":"Creative Analyzed Count","default":0},"creative_remaining_count":{"type":"integer","title":"Creative Remaining Count","default":0},"creative_previews":{"items":{"$ref":"#/components/schemas/OverviewAdsCreativePreviewResponse"},"type":"array","title":"Creative Previews"},"channels":{"items":{"$ref":"#/components/schemas/OverviewAdsPerformanceChannelResponse"},"type":"array","title":"Channels"}},"type":"object","required":["report_id"],"title":"OverviewAdsPerformanceSummaryResponse","description":"Compact projection of the deterministic Ads Audit report.\n\nCurrency maps remain intact because totals in unlike currencies must never\nbe combined into a fabricated spend number on Overview."},"OverviewAiTeamOutputsResponse":{"properties":{"recommendations":{"items":{"$ref":"#/components/schemas/AgentTeamRecommendationResponse"},"type":"array","title":"Recommendations"},"latest_daily_summary":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamDailySummaryResponse"},{"type":"null"}]},"daily_report_projection":{"anyOf":[{"$ref":"#/components/schemas/OverviewDailyReportProjectionResponse"},{"type":"null"}]}},"type":"object","title":"OverviewAiTeamOutputsResponse","description":"Small, already-sanitized payload used by Today's priorities on first paint."},"OverviewBootstrapResponse":{"properties":{"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"organization_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"product_summary":{"additionalProperties":true,"type":"object","title":"Product Summary"},"trends_bundle":{"additionalProperties":true,"type":"object","title":"Trends Bundle"},"social_summary":{"anyOf":[{"$ref":"#/components/schemas/SocialListeningSummaryResponse"},{"type":"null"}]},"active_team":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamDetailResponse"},{"type":"null"}]},"approvals":{"$ref":"#/components/schemas/AgentTeamApprovalListResponse"},"ai_team_outputs":{"$ref":"#/components/schemas/OverviewAiTeamOutputsResponse"},"aeo_readiness_summary":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Aeo Readiness Summary"},"market_intelligence":{"items":{"$ref":"#/components/schemas/MarketIntelligenceResponse"},"type":"array","title":"Market Intelligence"},"competitors":{"items":{"$ref":"#/components/schemas/CompetitorInfo"},"type":"array","title":"Competitors"},"competitor_cards":{"items":{"$ref":"#/components/schemas/OverviewCompetitorCardResponse"},"type":"array","title":"Competitor Cards"},"ad_spend_summary":{"anyOf":[{"$ref":"#/components/schemas/CompanyProfileDailySpendSummaryResponse"},{"type":"null"}]},"mmm_spend_recommendation":{"anyOf":[{"$ref":"#/components/schemas/OverviewMmmSpendRecommendationResponse"},{"type":"null"}]},"productivity_summary":{"$ref":"#/components/schemas/OverviewProductivitySummaryResponse"},"errors":{"additionalProperties":{"type":"string"},"type":"object","title":"Errors"}},"type":"object","required":["company_profile_id","generated_at"],"title":"OverviewBootstrapResponse"},"OverviewCard":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"state":{"type":"string","title":"State"},"rank":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Rank"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"exploratory":{"type":"boolean","title":"Exploratory","default":false},"href":{"type":"string","title":"Href"},"evidence":{"items":{"$ref":"#/components/schemas/OverviewMetric"},"type":"array","title":"Evidence"},"preview":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Preview"},"readout_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Readout At"},"result":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Result"},"result_metrics":{"items":{"$ref":"#/components/schemas/OverviewMetric"},"type":"array","title":"Result Metrics"},"presentation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Presentation"},"sources":{"items":{"$ref":"#/components/schemas/InsightSource"},"type":"array","title":"Sources"}},"type":"object","required":["id","title","state","created_at","href"],"title":"OverviewCard"},"OverviewChart":{"properties":{"key":{"type":"string","title":"Key"},"title":{"type":"string","title":"Title"},"kind":{"type":"string","enum":["bars","line","scatter","matrix","timeline"],"title":"Kind"},"columns":{"items":{"$ref":"#/components/schemas/OverviewChartColumn"},"type":"array","title":"Columns"},"rows":{"items":{"$ref":"#/components/schemas/OverviewChartRow"},"type":"array","title":"Rows"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"window_start":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Window Start"},"window_end":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Window End"},"destination":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Destination"}},"type":"object","required":["key","title","kind","columns","rows"],"title":"OverviewChart"},"OverviewChartColumn":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"unit":{"type":"string","title":"Unit","default":"count"}},"type":"object","required":["key","label"],"title":"OverviewChartColumn"},"OverviewChartRow":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"values":{"additionalProperties":{"anyOf":[{"type":"number"},{"type":"null"}]},"type":"object","title":"Values"},"date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"questions":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Questions"}},"type":"object","required":["key","label"],"title":"OverviewChartRow"},"OverviewCompetitorCardResponse":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"timestamp":{"type":"string","title":"Timestamp"},"timestampSource":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestampsource"},"competitorName":{"type":"string","title":"Competitorname"},"competitorDomain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Competitordomain"},"headline":{"type":"string","title":"Headline"},"subline":{"type":"string","title":"Subline"},"heroInsight":{"type":"string","title":"Heroinsight"},"signals":{"items":{"$ref":"#/components/schemas/OverviewCompetitorCardSignalResponse"},"type":"array","title":"Signals"},"meta":{"items":{"type":"string"},"type":"array","title":"Meta"},"logoUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logourl"},"mediaUrl":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mediaurl"},"mediaAlt":{"type":"string","title":"Mediaalt"},"placeholderLabel":{"type":"string","title":"Placeholderlabel"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"},"radarMetrics":{"anyOf":[{"items":{"$ref":"#/components/schemas/OverviewCompetitorRadarMetricResponse"},"type":"array"},{"type":"null"}],"title":"Radarmetrics"},"radarState":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Radarstate"},"radarProfileSimilarity":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Radarprofilesimilarity"}},"type":"object","required":["id","title","timestamp","competitorName","headline","subline","heroInsight","mediaAlt","placeholderLabel"],"title":"OverviewCompetitorCardResponse"},"OverviewCompetitorCardSignalResponse":{"properties":{"id":{"type":"string","title":"Id"},"label":{"type":"string","title":"Label"},"value":{"type":"string","title":"Value"},"items":{"items":{"type":"string"},"type":"array","title":"Items"}},"type":"object","required":["id","label","value"],"title":"OverviewCompetitorCardSignalResponse"},"OverviewCompetitorRadarMetricResponse":{"properties":{"id":{"type":"string","title":"Id"},"label":{"type":"string","title":"Label"},"shortLabel":{"type":"string","title":"Shortlabel"},"selfScore":{"type":"integer","title":"Selfscore"},"competitorScore":{"type":"integer","title":"Competitorscore"},"similarity":{"type":"integer","title":"Similarity"}},"type":"object","required":["id","label","shortLabel","selfScore","competitorScore","similarity"],"title":"OverviewCompetitorRadarMetricResponse"},"OverviewDailyReportBudgetResponse":{"properties":{"readiness_tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Readiness Tier"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"total_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Total Label"}},"type":"object","title":"OverviewDailyReportBudgetResponse"},"OverviewDailyReportProjectionResponse":{"properties":{"run_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Run Id"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"executive_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Executive Summary"},"director_insight_package":{"anyOf":[{"$ref":"#/components/schemas/DirectorInsightPackageResponse"},{"type":"null"}]},"sections":{"items":{"$ref":"#/components/schemas/OverviewDailyReportSectionResponse"},"type":"array","title":"Sections"},"budget":{"anyOf":[{"$ref":"#/components/schemas/OverviewDailyReportBudgetResponse"},{"type":"null"}]},"ads_performance":{"anyOf":[{"$ref":"#/components/schemas/OverviewAdsPerformanceSummaryResponse"},{"type":"null"}]}},"type":"object","title":"OverviewDailyReportProjectionResponse","description":"Small latest-run projection shared with the Marketing Director report."},"OverviewDailyReportSectionResponse":{"properties":{"agent_id":{"type":"string","title":"Agent Id"},"label":{"type":"string","title":"Label"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"action_count":{"type":"integer","title":"Action Count","default":0},"primary_action_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Action Title"}},"type":"object","required":["agent_id","label"],"title":"OverviewDailyReportSectionResponse","description":"A compact, exact projection of one authored daily-report section."},"OverviewData":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"goal":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Goal"},"headline":{"anyOf":[{"$ref":"#/components/schemas/OverviewMetric"},{"type":"null"}]},"metrics":{"items":{"$ref":"#/components/schemas/OverviewMetric"},"type":"array","title":"Metrics"},"charts":{"items":{"$ref":"#/components/schemas/OverviewChart"},"type":"array","title":"Charts"},"cards":{"items":{"$ref":"#/components/schemas/OverviewCard"},"type":"array","title":"Cards"},"top_actions":{"items":{"$ref":"#/components/schemas/OverviewTopAction"},"type":"array","title":"Top Actions"},"notes":{"items":{"type":"string"},"type":"array","title":"Notes"},"check_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Check Id"},"available_checks":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Available Checks"},"available_sources":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Available Sources"},"performance":{"anyOf":[{"$ref":"#/components/schemas/OverviewPerformance"},{"type":"null"}]},"paid_accounts":{"items":{"$ref":"#/components/schemas/OverviewPaidAccount"},"type":"array","title":"Paid Accounts"}},"type":"object","title":"OverviewData"},"OverviewMetric":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"value":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Value"},"total":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total"},"unit":{"type":"string","title":"Unit","default":"count"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"},"source_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Path"},"raw_value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Raw Value"}},"type":"object","required":["key","label"],"title":"OverviewMetric"},"OverviewMmmSpendRecommendationPlatformResponse":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"current_spend":{"type":"number","title":"Current Spend","default":0.0},"recommended_spend":{"type":"number","title":"Recommended Spend","default":0.0},"current_spend_pct":{"type":"number","title":"Current Spend Pct","default":0.0},"recommended_spend_pct":{"type":"number","title":"Recommended Spend Pct","default":0.0},"change_spend":{"type":"number","title":"Change Spend","default":0.0},"rationale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rationale"}},"type":"object","required":["key","label"],"title":"OverviewMmmSpendRecommendationPlatformResponse"},"OverviewMmmSpendRecommendationResponse":{"properties":{"report_id":{"type":"string","title":"Report Id"},"generated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Generated At"},"model_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Type"},"confidence_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Confidence Level"},"source_label":{"type":"string","title":"Source Label","default":"MMM"},"total_current_spend":{"type":"number","title":"Total Current Spend","default":0.0},"total_recommended_spend":{"type":"number","title":"Total Recommended Spend","default":0.0},"platforms":{"items":{"$ref":"#/components/schemas/OverviewMmmSpendRecommendationPlatformResponse"},"type":"array","title":"Platforms"}},"type":"object","required":["report_id"],"title":"OverviewMmmSpendRecommendationResponse"},"OverviewPaidAccount":{"properties":{"state":{"type":"string","enum":["ready","partial","empty","connect_required","setup_required","reauthorization_required","collection_disabled","pending","restricted","error","unsupported","historical_unavailable"],"title":"State"},"source":{"type":"string","title":"Source"},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"},"window_start":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Window Start"},"window_end":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Window End"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"coverage":{"type":"string","enum":["complete","partial","unknown"],"title":"Coverage","default":"unknown"},"reason_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason Code"},"destination":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Destination"},"integration_id":{"type":"string","title":"Integration Id"},"platform":{"type":"string","title":"Platform"},"account_id":{"type":"string","title":"Account Id"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name"},"headline":{"anyOf":[{"$ref":"#/components/schemas/OverviewMetric"},{"type":"null"}]},"metrics":{"items":{"$ref":"#/components/schemas/OverviewMetric"},"type":"array","title":"Metrics"}},"type":"object","required":["state","source","integration_id","platform","account_id"],"title":"OverviewPaidAccount"},"OverviewPerformance":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/OverviewPerformanceRow"},"type":"array","title":"Rows"},"observations":{"items":{"$ref":"#/components/schemas/OverviewPerformanceObservation"},"type":"array","title":"Observations"},"sources":{"additionalProperties":{"$ref":"#/components/schemas/OverviewPerformanceSource"},"propertyNames":{"enum":["profile","availability","brand_performance","ai_summary","ai_matrix","inventory","paid","uploaded_sales","traffic","bookings","recommendations","results","market","content"]},"type":"object","title":"Sources"}},"type":"object","required":["rows","observations","sources"],"title":"OverviewPerformance"},"OverviewPerformanceObservation":{"properties":{"source":{"anyOf":[{"$ref":"#/components/schemas/OverviewPerformanceSource"},{"type":"null"}]},"key":{"type":"string","title":"Key"},"text":{"type":"string","title":"Text"},"source_key":{"type":"string","enum":["profile","availability","brand_performance","ai_summary","ai_matrix","inventory","paid","uploaded_sales","traffic","bookings","recommendations","results","market","content"],"title":"Source Key"},"metric":{"anyOf":[{"$ref":"#/components/schemas/OverviewMetric"},{"type":"null"}]}},"type":"object","required":["key","text","source_key"],"title":"OverviewPerformanceObservation"},"OverviewPerformanceRow":{"properties":{"source":{"anyOf":[{"$ref":"#/components/schemas/OverviewPerformanceSource"},{"type":"null"}]},"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"source_key":{"type":"string","enum":["profile","availability","brand_performance","ai_summary","ai_matrix","inventory","paid","uploaded_sales","traffic","bookings","recommendations","results","market","content"],"title":"Source Key"},"metric":{"anyOf":[{"$ref":"#/components/schemas/OverviewMetric"},{"type":"null"}]},"detail":{"type":"string","title":"Detail"},"percent":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Percent"},"supporting_metrics":{"items":{"$ref":"#/components/schemas/OverviewMetric"},"type":"array","title":"Supporting Metrics"}},"type":"object","required":["key","label","source_key","detail"],"title":"OverviewPerformanceRow"},"OverviewPerformanceSource":{"properties":{"state":{"type":"string","enum":["ready","partial","empty","connect_required","setup_required","reauthorization_required","collection_disabled","pending","restricted","error","unsupported","historical_unavailable"],"title":"State"},"source":{"type":"string","title":"Source"},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"},"window_start":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Window Start"},"window_end":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Window End"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"coverage":{"type":"string","enum":["complete","partial","unknown"],"title":"Coverage","default":"unknown"},"reason_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason Code"},"destination":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Destination"}},"type":"object","required":["state","source"],"title":"OverviewPerformanceSource"},"OverviewProductivityBreakdownItem":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"count":{"type":"integer","title":"Count","default":0},"minutes_each":{"type":"integer","title":"Minutes Each","default":0},"total_minutes":{"type":"integer","title":"Total Minutes","default":0},"contributes_to":{"items":{"type":"string"},"type":"array","title":"Contributes To"}},"type":"object","required":["key","label"],"title":"OverviewProductivityBreakdownItem"},"OverviewProductivitySummaryResponse":{"properties":{"data_state":{"type":"string","enum":["ready","empty","unavailable"],"title":"Data State","default":"empty"},"window_days":{"type":"integer","title":"Window Days","default":30},"window_start":{"type":"string","format":"date-time","title":"Window Start"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"time_saved_minutes":{"type":"integer","title":"Time Saved Minutes","default":0},"time_saved_label":{"type":"string","title":"Time Saved Label","default":"0 min"},"signals_surfaced":{"type":"integer","title":"Signals Surfaced","default":0},"marketing_outputs":{"type":"integer","title":"Marketing Outputs","default":0},"basis_label":{"type":"string","title":"Basis Label","default":"No qualifying activity in the last 30 days yet."},"breakdown":{"items":{"$ref":"#/components/schemas/OverviewProductivityBreakdownItem"},"type":"array","title":"Breakdown"}},"type":"object","required":["window_start","generated_at"],"title":"OverviewProductivitySummaryResponse"},"OverviewSection":{"properties":{"state":{"type":"string","enum":["ready","partial","empty","connect_required","setup_required","reauthorization_required","collection_disabled","pending","restricted","error","unsupported","historical_unavailable"],"title":"State"},"data":{"anyOf":[{"$ref":"#/components/schemas/OverviewData"},{"type":"null"}]},"source":{"type":"string","title":"Source"},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"},"window_start":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Window Start"},"window_end":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Window End"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"grain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Grain"},"coverage":{"type":"string","enum":["complete","partial","unknown"],"title":"Coverage","default":"unknown"},"reason_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason Code"},"destination":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Destination"}},"type":"object","required":["state","source"],"title":"OverviewSection"},"OverviewSectionsResponse":{"properties":{"company_profile_id":{"type":"string","title":"Company Profile Id"},"sections":{"additionalProperties":{"$ref":"#/components/schemas/OverviewSection"},"type":"object","title":"Sections"}},"type":"object","required":["company_profile_id","sections"],"title":"OverviewSectionsResponse"},"OverviewTopAction":{"properties":{"id":{"type":"string","title":"Id"},"rank":{"type":"integer","exclusiveMinimum":0.0,"title":"Rank"},"title":{"type":"string","title":"Title"},"requested_action":{"type":"string","title":"Requested Action"},"approval_state":{"type":"string","title":"Approval State"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"href":{"type":"string","title":"Href"}},"type":"object","required":["id","rank","title","requested_action","approval_state","href"],"title":"OverviewTopAction"},"PDPExperienceTier":{"type":"string","enum":["premium","standard","value","luxury"],"title":"PDPExperienceTier","description":"Available experience tiers for PDP generation."},"PDPGenerationGoal":{"type":"string","enum":["purchase","inquiry"],"title":"PDPGenerationGoal","description":"The visitor action the generated page is intended to support."},"PDPGenerationRequest":{"properties":{"tier":{"$ref":"#/components/schemas/PDPExperienceTier","description":"Experience tier that determines aesthetic and layout density."},"tone":{"type":"string","minLength":2,"title":"Tone","description":"Copywriting tone (e.g., 'Bold & Confident', 'Friendly and Warm')."},"goal":{"$ref":"#/components/schemas/PDPGenerationGoal","description":"Purchase preserves commerce PDP defaults; inquiry follows the authored lead or demo request offer.","default":"purchase"},"selected_images":{"items":{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},"type":"array","maxItems":5,"title":"Selected Images","description":"Ordered list of up to five image URLs to embed in the PDP."},"include_marketplace":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Include Marketplace","description":"Override to force marketplace variant generation."},"additional_context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Additional Context","description":"Primary authored instructions defining the offer, audience, CTA and authorized claims; takes precedence over research and template defaults."},"target_audience_segments":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Target Audience Segments","description":"Optional list of audience segments to tailor messaging (from cached target audience)."}},"type":"object","required":["tier","tone"],"title":"PDPGenerationRequest","description":"Request payload for PDP generation."},"PDPGenerationResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Indicates whether generation succeeded.","default":true},"tier":{"$ref":"#/components/schemas/PDPExperienceTier","description":"Tier used during generation."},"tone":{"type":"string","title":"Tone","description":"Tone used during generation."},"include_marketplace":{"type":"boolean","title":"Include Marketplace","description":"Whether a marketplace variant was requested.","default":false},"record_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Record Id","description":"Identifier of the persisted PDP record, if stored."},"used_images":{"items":{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},"type":"array","title":"Used Images","description":"Image URLs that were passed to the generator."},"modern_page":{"$ref":"#/components/schemas/PDPVariantResponse","description":"Modern website PDP variant."},"marketplace_page":{"anyOf":[{"$ref":"#/components/schemas/PDPVariantResponse"},{"type":"null"}],"description":"Marketplace-style PDP variant, if generated."},"marketplace_generated":{"type":"boolean","title":"Marketplace Generated","description":"True when a marketplace variant was produced.","default":false},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings","description":"Non-blocking warnings encountered during generation."}},"type":"object","required":["tier","tone","modern_page"],"title":"PDPGenerationResponse","description":"Response payload returned after PDP generation."},"PDPHistoryItem":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","description":"Record identifier for the stored PDP."},"tier":{"$ref":"#/components/schemas/PDPExperienceTier","description":"Experience tier used for the generation."},"tone":{"type":"string","title":"Tone","description":"Tone used for the copy."},"include_marketplace":{"type":"boolean","title":"Include Marketplace","description":"Whether a marketplace variant was requested."},"marketplace_generated":{"type":"boolean","title":"Marketplace Generated","description":"True if a marketplace variant was produced."},"created_at":{"type":"string","format":"date-time","title":"Created At","description":"Timestamp when the PDP was generated."},"used_images":{"items":{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},"type":"array","title":"Used Images","description":"Images that informed the generation."}},"type":"object","required":["id","tier","tone","include_marketplace","marketplace_generated","created_at"],"title":"PDPHistoryItem","description":"Summary of a previously generated PDP."},"PDPSectionSummary":{"properties":{"heading":{"type":"string","title":"Heading","description":"Human-friendly heading for the section."},"intent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intent","description":"Goal or purpose of the section (e.g., 'Social proof', 'Feature showcase')."}},"type":"object","required":["heading"],"title":"PDPSectionSummary","description":"Summary of a key section returned by the generator."},"PDPVariantResponse":{"properties":{"variant":{"$ref":"#/components/schemas/PDPVariantType","description":"Variant type (modern or marketplace)."},"html":{"type":"string","title":"Html","description":"Full HTML document with inline CSS for the PDP."},"seo_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seo Title","description":"Suggested SEO page title."},"seo_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seo Description","description":"Suggested meta description."},"primary_cta":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Cta","description":"Recommended primary call-to-action copy."},"highlights":{"items":{"type":"string"},"type":"array","title":"Highlights","description":"Key highlight bullets to reuse elsewhere."},"sections":{"items":{"$ref":"#/components/schemas/PDPSectionSummary"},"type":"array","title":"Sections","description":"High-level outline of the sections included in the HTML."},"diagnostics":{"anyOf":[{},{"type":"null"}],"title":"Diagnostics","description":"Optional raw diagnostic information from the generator."}},"type":"object","required":["variant","html"],"title":"PDPVariantResponse","description":"Single PDP variant response."},"PDPVariantType":{"type":"string","enum":["modern","marketplace"],"title":"PDPVariantType","description":"Supported PDP layout variants."},"PageAction":{"properties":{"kind":{"type":"string","enum":["inquiry","external"],"title":"Kind","default":"inquiry"},"url":{"type":"string","maxLength":2048,"title":"Url","default":""}},"additionalProperties":false,"type":"object","title":"PageAction","description":"The authored destination is application state, separate from generated copy."},"PageBrand":{"properties":{"name":{"type":"string","maxLength":160,"title":"Name"},"primary_color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$","title":"Primary Color","default":"#244c3e"},"font":{"type":"string","enum":["sans","serif"],"title":"Font","default":"sans"},"background_color":{"anyOf":[{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},{"type":"null"}],"title":"Background Color"},"logo_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Logo Url"},"website_url":{"type":"string","maxLength":2048,"title":"Website Url","default":""}},"additionalProperties":false,"type":"object","required":["name"],"title":"PageBrand"},"PageConfirmation":{"properties":{"heading":{"type":"string","maxLength":180,"title":"Heading"},"message":{"type":"string","maxLength":800,"title":"Message"}},"additionalProperties":false,"type":"object","required":["heading","message"],"title":"PageConfirmation"},"PageContext":{"properties":{"source":{"type":"string","title":"Source","description":"Current Pomo page key where Markee was opened (e.g., product-detail)"},"route":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Route","description":"Markee v2-only browser pathname; excluded from the v1 payload"},"entity_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Id","description":"Optional entity identifier (not exposed to users)"},"entity_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Name","description":"Human-readable entity name"},"tab":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tab","description":"Active tab/section when chat opened"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content","description":"Optional page content summary for additional grounding"},"extra":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Extra","description":"Structured page-specific context for grounding"}},"type":"object","required":["source"],"title":"PageContext","description":"Lightweight page context sent from the UI to help Markee ground responses."},"PageCreateRequest":{"properties":{"name":{"type":"string","maxLength":180,"minLength":1,"title":"Name"},"design_version":{"type":"integer","enum":[1,2],"title":"Design Version","default":1},"document":{"anyOf":[{"$ref":"#/components/schemas/CampaignPageDocument"},{"type":"null"}]},"prompt":{"anyOf":[{"type":"string","maxLength":3000,"minLength":10},{"type":"null"}],"title":"Prompt"},"qualification":{"$ref":"#/components/schemas/QualificationPolicy"},"booking_enabled":{"type":"boolean","title":"Booking Enabled","default":false},"booking_event_type_uri":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Booking Event Type Uri"},"campaign_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Campaign Id"},"product_offering_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id"},"owner_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Owner User Id"}},"additionalProperties":false,"type":"object","required":["name"],"title":"PageCreateRequest"},"PageDesign":{"properties":{"html":{"type":"string","maxLength":80000,"minLength":40,"title":"Html"},"css":{"type":"string","maxLength":80000,"minLength":40,"title":"Css"},"content":{"items":{"$ref":"#/components/schemas/PageDesignContent"},"type":"array","maxItems":120,"title":"Content"}},"additionalProperties":false,"type":"object","required":["html","css"],"title":"PageDesign"},"PageDesignChange":{"properties":{"operation":{"type":"string","enum":["create","refine","add_image"],"title":"Operation","default":"refine"},"section_id":{"anyOf":[{"type":"string","pattern":"^[a-z][a-z0-9_-]{0,79}$"},{"type":"null"}],"title":"Section Id"},"image_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Image Url"},"placement":{"type":"string","enum":["inside","after"],"title":"Placement","default":"inside"}},"additionalProperties":false,"type":"object","title":"PageDesignChange"},"PageDesignContent":{"properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_.-]{0,79}$","title":"Id"},"kind":{"type":"string","enum":["text","image"],"title":"Kind"},"label":{"type":"string","maxLength":100,"minLength":1,"title":"Label"},"value":{"type":"string","maxLength":3000,"title":"Value"},"alt":{"type":"string","maxLength":300,"title":"Alt","default":""}},"additionalProperties":false,"type":"object","required":["id","kind","label","value"],"title":"PageDesignContent"},"PageDisplayContext":{"properties":{"source":{"type":"string","maxLength":500,"title":"Source"},"route":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Route"},"entity_id":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Entity Id"},"entity_name":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Entity Name"},"tab":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Tab"},"selected_subject":{"anyOf":[{"oneOf":[{"$ref":"#/components/schemas/SavedWorkSubject"},{"$ref":"#/components/schemas/SavedArtifactSubject"},{"$ref":"#/components/schemas/ReadArtifactSubject"},{"$ref":"#/components/schemas/AccountReportSubject"},{"$ref":"#/components/schemas/ApprovalSubject"},{"$ref":"#/components/schemas/InsightSubject"}],"discriminator":{"propertyName":"kind","mapping":{"account_report":"#/components/schemas/AccountReportSubject","approval":"#/components/schemas/ApprovalSubject","artifact":"#/components/schemas/SavedArtifactSubject","insight":"#/components/schemas/InsightSubject","read_artifact":"#/components/schemas/ReadArtifactSubject","work":"#/components/schemas/SavedWorkSubject"}}},{"type":"null"}],"title":"Selected Subject"}},"additionalProperties":false,"type":"object","required":["source"],"title":"PageDisplayContext"},"PageEvidence":{"properties":{"kind":{"type":"string","enum":["case_study","company_background","backing"],"title":"Kind"},"title":{"type":"string","maxLength":100,"title":"Title"},"summary":{"type":"string","maxLength":500,"title":"Summary"},"source_url":{"type":"string","maxLength":2048,"title":"Source Url"}},"additionalProperties":false,"type":"object","required":["kind","title","summary","source_url"],"title":"PageEvidence"},"PageFAQ":{"properties":{"question":{"type":"string","maxLength":250,"title":"Question"},"answer":{"type":"string","maxLength":1500,"title":"Answer"}},"additionalProperties":false,"type":"object","required":["question","answer"],"title":"PageFAQ"},"PageForm":{"properties":{"heading":{"type":"string","maxLength":180,"title":"Heading"},"description":{"type":"string","maxLength":800,"title":"Description"},"questions":{"items":{"$ref":"#/components/schemas/PageQuestion"},"type":"array","maxItems":2,"title":"Questions"},"marketing_opt_in_label":{"type":"string","maxLength":300,"title":"Marketing Opt In Label"},"privacy_url":{"type":"string","maxLength":2048,"title":"Privacy Url","default":""}},"additionalProperties":false,"type":"object","required":["heading","description","marketing_opt_in_label"],"title":"PageForm"},"PageGenerateRequest":{"properties":{"scope":{"type":"string","enum":["content","style"],"title":"Scope","default":"content"},"intent":{"type":"string","enum":["refine","new_direction"],"title":"Intent","default":"refine"},"expected_revision":{"type":"integer","minimum":1.0,"title":"Expected Revision"},"acknowledge_active_ads":{"type":"boolean","title":"Acknowledge Active Ads","default":false},"prompt":{"type":"string","maxLength":3000,"minLength":10,"title":"Prompt"},"design_request":{"anyOf":[{"$ref":"#/components/schemas/PageDesignChange"},{"type":"null"}]}},"additionalProperties":false,"type":"object","required":["expected_revision","prompt"],"title":"PageGenerateRequest"},"PageGenerationRetryRequest":{"properties":{"expected_revision":{"type":"integer","minimum":1.0,"title":"Expected Revision"},"failed_job_id":{"type":"string","format":"uuid","title":"Failed Job Id"}},"additionalProperties":false,"type":"object","required":["expected_revision","failed_job_id"],"title":"PageGenerationRetryRequest"},"PageInfo":{"properties":{"offset":{"type":"integer","title":"Offset"},"limit":{"type":"integer","title":"Limit"},"total":{"type":"integer","title":"Total"},"has_more":{"type":"boolean","title":"Has More"}},"type":"object","required":["offset","limit","total","has_more"],"title":"PageInfo"},"PageOffer":{"properties":{"name":{"type":"string","maxLength":180,"title":"Name"},"audience":{"type":"string","maxLength":500,"title":"Audience"},"headline":{"type":"string","maxLength":180,"title":"Headline"},"description":{"type":"string","maxLength":1200,"title":"Description"},"cta_label":{"type":"string","maxLength":60,"title":"Cta Label"},"eyebrow":{"type":"string","maxLength":100,"title":"Eyebrow","default":""},"highlights":{"items":{"type":"string","maxLength":80},"type":"array","maxItems":4,"title":"Highlights"},"supporting_text":{"type":"string","maxLength":180,"title":"Supporting Text","default":""}},"additionalProperties":false,"type":"object","required":["name","audience","headline","description","cta_label"],"title":"PageOffer"},"PagePatchRequest":{"properties":{"expected_revision":{"type":"integer","minimum":1.0,"title":"Expected Revision"},"name":{"anyOf":[{"type":"string","maxLength":180,"minLength":1},{"type":"null"}],"title":"Name"},"slug":{"anyOf":[{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,62}$"},{"type":"null"}],"title":"Slug"},"document":{"anyOf":[{"$ref":"#/components/schemas/CampaignPageDocument"},{"type":"null"}]},"qualification":{"anyOf":[{"$ref":"#/components/schemas/QualificationPolicy"},{"type":"null"}]},"booking_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Booking Enabled"},"booking_event_type_uri":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Booking Event Type Uri"},"owner_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Owner User Id"},"product_offering_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id"}},"additionalProperties":false,"type":"object","required":["expected_revision"],"title":"PagePatchRequest"},"PageProof":{"properties":{"quote":{"type":"string","maxLength":1200,"title":"Quote"},"attribution":{"type":"string","maxLength":200,"title":"Attribution"},"source_url":{"type":"string","maxLength":2048,"title":"Source Url"},"approved":{"type":"boolean","title":"Approved","default":false}},"additionalProperties":false,"type":"object","required":["quote","attribution","source_url"],"title":"PageProof"},"PageQuestion":{"properties":{"id":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,39}$","title":"Id"},"label":{"type":"string","maxLength":180,"title":"Label"},"options":{"items":{"type":"string"},"type":"array","maxItems":8,"title":"Options"},"required":{"type":"boolean","title":"Required","default":true}},"additionalProperties":false,"type":"object","required":["id","label","options"],"title":"PageQuestion"},"PageReferences":{"properties":{"enabled":{"type":"boolean","title":"Enabled","default":true},"urls":{"items":{"type":"string","maxLength":2048},"type":"array","maxItems":5,"title":"Urls"}},"additionalProperties":false,"type":"object","title":"PageReferences"},"PageReview":{"properties":{"status":{"type":"string","enum":["reviewed","no_product_page","unavailable"],"title":"Status"},"source_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Id"},"suggestions":{"items":{"$ref":"#/components/schemas/PageSuggestion"},"type":"array","title":"Suggestions"},"limitations":{"items":{"type":"string"},"type":"array","title":"Limitations"}},"additionalProperties":false,"type":"object","required":["status"],"title":"PageReview"},"PageRevisionRequest":{"properties":{"expected_revision":{"type":"integer","minimum":1.0,"title":"Expected Revision"},"acknowledge_active_ads":{"type":"boolean","title":"Acknowledge Active Ads","default":false}},"additionalProperties":false,"type":"object","required":["expected_revision"],"title":"PageRevisionRequest"},"PageRewriteRequest":{"properties":{"expected_revision":{"type":"integer","minimum":1.0,"title":"Expected Revision"},"section":{"type":"string","enum":["offer","benefits","process","faqs","form","confirmation"],"title":"Section"},"instruction":{"type":"string","maxLength":1500,"minLength":5,"title":"Instruction"}},"additionalProperties":false,"type":"object","required":["expected_revision","section","instruction"],"title":"PageRewriteRequest"},"PageSectionItem":{"properties":{"title":{"type":"string","maxLength":150,"title":"Title"},"description":{"type":"string","maxLength":1200,"title":"Description"}},"additionalProperties":false,"type":"object","required":["title","description"],"title":"PageSectionItem"},"PageSuggestion":{"properties":{"id":{"type":"string","maxLength":80,"minLength":1,"title":"Id"},"title":{"type":"string","minLength":1,"title":"Title","description":"A short label for the proposed edit."},"observation":{"type":"string","minLength":1,"title":"Observation","description":"A concrete observation about the quoted passage, without claims about unseen page content."},"evidence_quote":{"type":"string","minLength":15,"title":"Evidence Quote","description":"A short, exact, contiguous passage from the retrieved page."},"proposed_change":{"type":"string","minLength":1,"title":"Proposed Change","description":"A concise proposed edit, not a measured outcome."},"proposed_copy":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Proposed Copy","description":"Complete replacement copy using only supported facts, or null."},"source_ids":{"items":{"type":"string"},"type":"array","maxItems":6,"minItems":1,"title":"Source Ids"}},"additionalProperties":false,"type":"object","required":["id","title","observation","evidence_quote","proposed_change","source_ids"],"title":"PageSuggestion"},"PaidCampaignReview":{"additionalProperties":true,"type":"object"},"PaidCampaignReviewField":{"properties":{"label":{"type":"string","maxLength":160,"minLength":1,"title":"Label"},"value":{"type":"string","maxLength":8000,"minLength":1,"title":"Value"}},"additionalProperties":false,"type":"object","required":["label","value"],"title":"PaidCampaignReviewField"},"PaidCampaignStatusReview":{"properties":{"kind":{"type":"string","const":"paid_campaign_status","title":"Kind","default":"paid_campaign_status"},"action":{"type":"string","enum":["pause","resume"],"title":"Action"},"platform":{"type":"string","enum":["google_search","google_display","google_video","meta_feed","meta_stories_reels","tiktok_video","linkedin_ads_image","linkedin_ads_video","chatgpt_chat_card"],"title":"Platform"},"campaign_name":{"type":"string","maxLength":200,"minLength":1,"title":"Campaign Name"},"account_name":{"type":"string","maxLength":200,"minLength":1,"title":"Account Name"},"account_id":{"type":"string","maxLength":200,"minLength":1,"title":"Account Id"},"current_status":{"type":"string","maxLength":200,"minLength":1,"title":"Current Status"},"proposed_status":{"type":"string","enum":["paused","active"],"title":"Proposed Status"},"scope":{"type":"string","maxLength":1000,"minLength":1,"title":"Scope"},"fields":{"items":{"$ref":"#/components/schemas/PaidCampaignReviewField"},"type":"array","maxItems":20,"title":"Fields","default":[]},"observed_at":{"type":"string","format":"date-time","title":"Observed At"},"acknowledgements":{"items":{"type":"string","maxLength":1000,"minLength":1},"type":"array","maxItems":5,"title":"Acknowledgements","default":[]}},"additionalProperties":false,"type":"object","required":["action","platform","campaign_name","account_name","account_id","current_status","proposed_status","scope","observed_at"],"title":"PaidCampaignStatusReview","description":"Current platform delivery terms for a campaign pause or resume."},"PaidCampaignSyncChange":{"properties":{"label":{"type":"string","maxLength":160,"minLength":1,"title":"Label"},"before":{"type":"string","maxLength":8000,"minLength":1,"title":"Before"},"after":{"type":"string","maxLength":8000,"minLength":1,"title":"After"}},"additionalProperties":false,"type":"object","required":["label","before","after"],"title":"PaidCampaignSyncChange"},"PaidCampaignSyncReview":{"properties":{"kind":{"type":"string","const":"paid_campaign_sync","title":"Kind","default":"paid_campaign_sync"},"action":{"type":"string","const":"sync","title":"Action","default":"sync"},"platform":{"type":"string","enum":["google_search","google_display","google_video","meta_feed","meta_stories_reels","tiktok_video","linkedin_ads_image","linkedin_ads_video","chatgpt_chat_card"],"title":"Platform"},"campaign_name":{"type":"string","maxLength":200,"minLength":1,"title":"Campaign Name"},"account_name":{"type":"string","maxLength":200,"minLength":1,"title":"Account Name"},"account_id":{"type":"string","maxLength":200,"minLength":1,"title":"Account Id"},"scope":{"type":"string","maxLength":1000,"minLength":1,"title":"Scope"},"changes":{"items":{"$ref":"#/components/schemas/PaidCampaignSyncChange"},"type":"array","maxItems":40,"minItems":1,"title":"Changes"},"fields":{"items":{"$ref":"#/components/schemas/PaidCampaignReviewField"},"type":"array","maxItems":20,"title":"Fields","default":[]},"media":{"items":{"$ref":"#/components/schemas/WorkReviewMedia"},"type":"array","maxItems":20,"title":"Media","default":[]},"additional_spend":{"anyOf":[{"type":"string","pattern":"^\\d+(?:\\.\\d{1,12})?$"},{"type":"null"}],"title":"Additional Spend"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","title":"Currency"},"commission_amount":{"type":"string","pattern":"^\\d+(?:\\.\\d{1,2})?$","title":"Commission Amount"},"commission_currency":{"type":"string","const":"USD","title":"Commission Currency","default":"USD"},"acknowledgements":{"items":{"type":"string","maxLength":1000,"minLength":1},"type":"array","maxItems":5,"title":"Acknowledgements","default":[]}},"additionalProperties":false,"type":"object","required":["platform","campaign_name","account_name","account_id","scope","changes","currency","commission_amount"],"title":"PaidCampaignSyncReview","description":"Selected live-platform changes and the incremental native service fee."},"PaidMediaPlaybookResponse":{"properties":{"company_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Id"},"revision":{"type":"integer","title":"Revision"},"exists":{"type":"boolean","title":"Exists"},"preset":{"type":"string","title":"Preset"},"lever_autonomy":{"additionalProperties":{"type":"string"},"type":"object","title":"Lever Autonomy"},"max_step_pct":{"type":"number","title":"Max Step Pct"},"auto_step_cap_pct":{"type":"number","title":"Auto Step Cap Pct"},"min_observed_days":{"additionalProperties":{"type":"integer"},"type":"object","title":"Min Observed Days"},"min_volume":{"additionalProperties":{"type":"number"},"type":"object","title":"Min Volume"},"cooldown_days":{"type":"integer","title":"Cooldown Days"},"spend_envelope_monthly":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Spend Envelope Monthly"},"spend_envelope_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Spend Envelope Currency"},"roas_floor_for_scale_up":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Roas Floor For Scale Up"},"protected_campaigns":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Protected Campaigns"},"quiet_windows":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Quiet Windows"},"auto_revert_enabled":{"type":"boolean","title":"Auto Revert Enabled"},"auto_revert_consecutive_days":{"type":"integer","title":"Auto Revert Consecutive Days"},"anomaly_triggers_enabled":{"type":"boolean","title":"Anomaly Triggers Enabled"},"levers":{"items":{"$ref":"#/components/schemas/PlaybookLeverDescriptor"},"type":"array","title":"Levers"},"autonomy_options":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Autonomy Options"},"presets":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Presets"}},"type":"object","required":["revision","exists","preset","lever_autonomy","max_step_pct","auto_step_cap_pct","min_observed_days","min_volume","cooldown_days","protected_campaigns","quiet_windows","auto_revert_enabled","auto_revert_consecutive_days","anomaly_triggers_enabled","levers","autonomy_options","presets"],"title":"PaidMediaPlaybookResponse"},"PaidMediaPlaybookSaveRequest":{"properties":{"values":{"anyOf":[{"$ref":"#/components/schemas/PaidMediaPlaybookValues"},{"type":"null"}]},"preset":{"anyOf":[{"type":"string","enum":["ask","small","run"]},{"type":"null"}],"title":"Preset"},"expected_revision":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Expected Revision"}},"additionalProperties":false,"type":"object","title":"PaidMediaPlaybookSaveRequest","description":"Save the whole playbook, or just pick one of the three levels.\n\n``preset`` is what the product's own UI sends (\"ask\" / \"small\" / \"run\");\n``values`` is the full form for integrations and tests. Either may be\ngiven; when both are, the preset is applied on top of the values."},"PaidMediaPlaybookValues":{"properties":{"lever_autonomy":{"additionalProperties":{"type":"string","enum":["auto","auto_tell","ask","never"]},"type":"object","title":"Lever Autonomy"},"max_step_pct":{"type":"number","maximum":100.0,"minimum":1.0,"title":"Max Step Pct","default":20.0},"auto_step_cap_pct":{"type":"number","maximum":100.0,"minimum":1.0,"title":"Auto Step Cap Pct","default":10.0},"min_observed_days":{"additionalProperties":{"type":"integer"},"type":"object","title":"Min Observed Days"},"min_volume":{"additionalProperties":{"type":"number"},"type":"object","title":"Min Volume"},"cooldown_days":{"type":"integer","maximum":60.0,"minimum":0.0,"title":"Cooldown Days","default":7},"spend_envelope_monthly":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Spend Envelope Monthly"},"spend_envelope_currency":{"anyOf":[{"type":"string","pattern":"^[A-Za-z]{3}$"},{"type":"null"}],"title":"Spend Envelope Currency"},"roas_floor_for_scale_up":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Roas Floor For Scale Up"},"protected_campaigns":{"items":{"$ref":"#/components/schemas/PlaybookProtectedCampaign"},"type":"array","maxItems":100,"title":"Protected Campaigns"},"quiet_windows":{"items":{"$ref":"#/components/schemas/PlaybookQuietWindow"},"type":"array","maxItems":50,"title":"Quiet Windows"},"auto_revert_enabled":{"type":"boolean","title":"Auto Revert Enabled","default":false},"auto_revert_consecutive_days":{"type":"integer","maximum":14.0,"minimum":1.0,"title":"Auto Revert Consecutive Days","default":2},"anomaly_triggers_enabled":{"type":"boolean","title":"Anomaly Triggers Enabled","default":false}},"additionalProperties":false,"type":"object","title":"PaidMediaPlaybookValues","description":"What a client may set. Every field optional; omitted ones keep defaults."},"PaymentHistoryItemResponse":{"properties":{"id":{"type":"string","title":"Id"},"invoice_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Id"},"invoice_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Number"},"amount":{"type":"number","title":"Amount"},"currency":{"type":"string","title":"Currency"},"status":{"type":"string","title":"Status"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"paid_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Paid At"},"refunded":{"type":"boolean","title":"Refunded","default":false},"refund_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Refund Amount"}},"type":"object","required":["id","amount","currency","status"],"title":"PaymentHistoryItemResponse","description":"Response model for a payment history entry."},"PaymentHistoryListResponse":{"properties":{"status":{"type":"string","title":"Status"},"payment_history":{"items":{"$ref":"#/components/schemas/PaymentHistoryItemResponse"},"type":"array","title":"Payment History"}},"type":"object","required":["status","payment_history"],"title":"PaymentHistoryListResponse","description":"Response model for payment history."},"PersonaResponseData":{"properties":{"persona_id":{"type":"string","format":"uuid","title":"Persona Id"},"persona_name":{"type":"string","title":"Persona Name"},"interest_level":{"type":"number","title":"Interest Level"},"purchase_likelihood":{"type":"number","title":"Purchase Likelihood"},"price_sensitivity":{"type":"string","title":"Price Sensitivity"},"initial_reaction":{"type":"string","title":"Initial Reaction"},"perceived_benefits":{"items":{"type":"string"},"type":"array","title":"Perceived Benefits"},"concerns":{"items":{"type":"string"},"type":"array","title":"Concerns"},"feature_requests":{"items":{"type":"string"},"type":"array","title":"Feature Requests"},"would_recommend":{"type":"boolean","title":"Would Recommend"},"recommendation_reason":{"type":"string","title":"Recommendation Reason"}},"type":"object","required":["persona_id","persona_name","interest_level","purchase_likelihood","price_sensitivity","initial_reaction","perceived_benefits","concerns","feature_requests","would_recommend","recommendation_reason"],"title":"PersonaResponseData"},"PersonaSetCreate":{"properties":{"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"location":{"anyOf":[{"$ref":"#/components/schemas/LocationInfo"},{"type":"null"}]}},"type":"object","required":["name"],"title":"PersonaSetCreate"},"PersonaSetResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"location":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Location"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"is_active":{"type":"boolean","title":"Is Active"},"persona_count":{"type":"integer","title":"Persona Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","name","description","location","company_profile_id","is_active","persona_count","created_at","updated_at"],"title":"PersonaSetResponse"},"PersonaSetUpdate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active"}},"type":"object","title":"PersonaSetUpdate"},"PersonalizationValidateRequest":{"properties":{"template":{"type":"string","title":"Template"},"consumer_group_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Consumer Group Id"}},"type":"object","required":["template"],"title":"PersonalizationValidateRequest","description":"Request to validate personalization template"},"PlanChangeValidationResponse":{"properties":{"is_valid":{"type":"boolean","title":"Is Valid"},"is_upgrade":{"type":"boolean","title":"Is Upgrade"},"is_downgrade":{"type":"boolean","title":"Is Downgrade"},"current_plan":{"type":"string","title":"Current Plan"},"target_plan":{"type":"string","title":"Target Plan"},"billing_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Currency"},"billing_interval":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Interval"},"errors":{"items":{"type":"string"},"type":"array","title":"Errors","default":[]},"current_usage":{"additionalProperties":{"type":"integer"},"type":"object","title":"Current Usage","default":{}},"target_limits":{"additionalProperties":{"anyOf":[{"type":"integer"},{"type":"null"}]},"type":"object","title":"Target Limits","default":{}},"proration_amount":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Proration Amount"},"blocking_items":{"anyOf":[{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object"},{"type":"null"}],"title":"Blocking Items"},"payment_method":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payment Method"},"trial_change":{"anyOf":[{"$ref":"#/components/schemas/TrialPlanChangePreview-Output"},{"type":"null"}]}},"type":"object","required":["is_valid","is_upgrade","is_downgrade","current_plan","target_plan"],"title":"PlanChangeValidationResponse","description":"Response model for plan change validation."},"PlatformDaypartingConfig":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"timezone":{"type":"string","title":"Timezone"},"schedule":{"items":{"$ref":"#/components/schemas/DaypartingSlot"},"type":"array","title":"Schedule"},"bid_adjustments":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Bid Adjustments"}},"type":"object","required":["enabled","timezone","schedule"],"title":"PlatformDaypartingConfig"},"PlaybookLeverDescriptor":{"properties":{"key":{"type":"string","title":"Key"},"label":{"type":"string","title":"Label"},"description":{"type":"string","title":"Description"},"sample_unit":{"type":"string","title":"Sample Unit"}},"type":"object","required":["key","label","description","sample_unit"],"title":"PlaybookLeverDescriptor"},"PlaybookProtectedCampaign":{"properties":{"campaign_id":{"type":"string","maxLength":200,"minLength":1,"title":"Campaign Id"},"remote_campaign_id":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Remote Campaign Id"},"label":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Label"},"reason":{"anyOf":[{"type":"string","maxLength":400},{"type":"null"}],"title":"Reason"},"judge_on":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Judge On"}},"additionalProperties":false,"type":"object","required":["campaign_id"],"title":"PlaybookProtectedCampaign"},"PlaybookQuietWindow":{"properties":{"start_date":{"type":"string","format":"date","title":"Start Date"},"end_date":{"type":"string","format":"date","title":"End Date"},"label":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Label"}},"additionalProperties":false,"type":"object","required":["start_date","end_date"],"title":"PlaybookQuietWindow"},"PostMetricsRequest":{"properties":{"post_id":{"type":"string","title":"Post Id"},"metrics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Metrics"}},"type":"object","required":["post_id"],"title":"PostMetricsRequest","description":"Request model for getting Instagram post metrics."},"PostModel":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"campaign_id":{"type":"string","title":"Campaign Id"},"idea_number":{"type":"integer","title":"Idea Number"},"platform":{"type":"string","title":"Platform"},"variation":{"type":"integer","title":"Variation","default":0},"post_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Post Id"},"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Post Url"},"posted_at":{"type":"string","format":"date-time","title":"Posted At"},"status":{"type":"string","title":"Status"},"post_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Post Metadata"}},"type":"object","required":["id","campaign_id","idea_number","platform","posted_at","status"],"title":"PostModel"},"PostResponseModel":{"properties":{"id":{"type":"string","title":"Id"}},"type":"object","required":["id"],"title":"PostResponseModel","description":"Response model for created Instagram post."},"PresenceListResponse":{"properties":{"presence":{"items":{"$ref":"#/components/schemas/PresenceRow"},"type":"array","title":"Presence"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["presence","total"],"title":"PresenceListResponse"},"PresencePingIn":{"properties":{"session_id":{"type":"string","maxLength":96,"minLength":1,"title":"Session Id"},"tab_id":{"type":"string","maxLength":96,"minLength":1,"title":"Tab Id"},"device_id":{"anyOf":[{"type":"string","maxLength":96},{"type":"null"}],"title":"Device Id"},"route_path":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Route Path"},"route_template":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Route Template"},"app_area":{"anyOf":[{"type":"string","maxLength":96},{"type":"null"}],"title":"App Area"},"subview_type":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Subview Type"},"subview_key":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Subview Key"},"subview_label":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Subview Label"},"is_visible":{"type":"boolean","title":"Is Visible","default":true},"last_interaction_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Interaction At"},"last_visible_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Visible At"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["session_id","tab_id"],"title":"PresencePingIn"},"PresencePingResponse":{"properties":{"status":{"type":"string","title":"Status"},"last_ping_at":{"type":"string","format":"date-time","title":"Last Ping At"}},"type":"object","required":["status","last_ping_at"],"title":"PresencePingResponse"},"PresenceRow":{"properties":{"user_id":{"type":"string","title":"User Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"company_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Id"},"session_id":{"type":"string","title":"Session Id"},"tab_id":{"type":"string","title":"Tab Id"},"device_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Device Id"},"route_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Route Path"},"route_template":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Route Template"},"app_area":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"App Area"},"subview_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subview Type"},"subview_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subview Key"},"subview_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subview Label"},"is_visible":{"type":"boolean","title":"Is Visible"},"activity_status":{"type":"string","title":"Activity Status"},"last_interaction_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Interaction At"},"last_visible_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Visible At"},"last_ping_at":{"type":"string","format":"date-time","title":"Last Ping At"}},"type":"object","required":["user_id","session_id","tab_id","is_visible","activity_status","last_ping_at"],"title":"PresenceRow"},"PresentationDailyReportResponse":{"properties":{"version":{"type":"integer","title":"Version","default":1},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Id"},"generated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Generated At"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"},"headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Headline"},"executive_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Executive Summary"},"sections":{"items":{"$ref":"#/components/schemas/DailyReportSectionResponse"},"type":"array","title":"Sections"},"creative_review":{"items":{"$ref":"#/components/schemas/DailyReportCreativeResponse"},"type":"array","title":"Creative Review"},"channel_metrics":{"anyOf":[{"$ref":"#/components/schemas/DailyReportChannelMetricsResponse"},{"type":"null"}]},"marketing_mix":{"anyOf":[{"$ref":"#/components/schemas/DailyReportMarketingMixResponse"},{"type":"null"}]},"director_insight_package":{"anyOf":[{"$ref":"#/components/schemas/DirectorInsightPackageResponse"},{"type":"null"}]},"ads_performance_report":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Ads Performance Report"},"run_guidance":{"anyOf":[{"$ref":"#/components/schemas/AgentTeamRunGuidanceResponse"},{"type":"null"}]}},"type":"object","title":"PresentationDailyReportResponse","description":"AI-authored, presentation-ready daily report rendered faithfully by the UI.\n\nCached on ``AgentTeamRun.stats_json`` at run completion. Absent for older\nruns, in which case the frontend falls back to the count-based summary."},"PreviewRequest":{"properties":{"campaign_id":{"type":"integer","title":"Campaign Id"},"sample_size":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Sample Size","default":5}},"type":"object","required":["campaign_id"],"title":"PreviewRequest","description":"Request for email preview"},"ProductArchiveReview":{"properties":{"kind":{"type":"string","const":"product_archive","title":"Kind","default":"product_archive"},"selection":{"type":"string","enum":["one","selection","all"],"title":"Selection"},"products":{"items":{"$ref":"#/components/schemas/ProductArchiveTarget"},"type":"array","maxItems":200,"minItems":1,"title":"Products"},"total_count":{"type":"integer","maximum":200.0,"minimum":1.0,"title":"Total Count"},"acknowledgements":{"prefixItems":[{"type":"string","const":"I reviewed the products that will leave the active catalog."}],"type":"array","maxItems":1,"minItems":1,"title":"Acknowledgements","default":["I reviewed the products that will leave the active catalog."]}},"additionalProperties":false,"type":"object","required":["selection","products","total_count"],"title":"ProductArchiveReview","description":"Complete catalog targets shown before a human confirms their archive."},"ProductArchiveTarget":{"properties":{"product_id":{"type":"string","format":"uuid","title":"Product Id"},"name":{"type":"string","maxLength":300,"minLength":1,"title":"Name"},"expected_content_version":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Expected Content Version"}},"additionalProperties":false,"type":"object","required":["product_id","name","expected_content_version"],"title":"ProductArchiveTarget","description":"An exact saved catalog revision, owned by the archive review."},"ProductComparisonPage":{"properties":{"offset":{"type":"integer","minimum":0.0,"title":"Offset"},"limit":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Limit"},"returned_count":{"type":"integer","maximum":20.0,"minimum":0.0,"title":"Returned Count"},"has_more":{"type":"boolean","title":"Has More"},"query":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Query"},"status":{"type":"string","enum":["active","archived","all"],"title":"Status"},"ordering":{"type":"string","const":"name_asc_id_asc","title":"Ordering","default":"name_asc_id_asc"}},"additionalProperties":false,"type":"object","required":["offset","limit","returned_count","has_more","query","status"],"title":"ProductComparisonPage"},"ProductComparisonPriceRow":{"properties":{"terms":{"$ref":"#/components/schemas/ProductComparisonTerms"},"role":{"type":"string","enum":["selected_saved","other"],"title":"Role"},"current_marker":{"type":"boolean","title":"Current Marker"},"source_note":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Source Note"}},"additionalProperties":false,"type":"object","required":["terms","role","current_marker","source_note"],"title":"ProductComparisonPriceRow"},"ProductComparisonTerms":{"properties":{"price":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Price"},"unit":{"anyOf":[{"type":"string","maxLength":120,"minLength":1},{"type":"null"}],"title":"Unit"},"currency":{"anyOf":[{"type":"string","maxLength":40,"minLength":1},{"type":"null"}],"title":"Currency"},"variant":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Variant"}},"additionalProperties":false,"type":"object","required":["price","unit","currency","variant"],"title":"ProductComparisonTerms","description":"Every nullable essential is explicit, rather than silently defaulted."},"ProductEventIn":{"properties":{"event_name":{"type":"string","maxLength":96,"minLength":1,"title":"Event Name"},"page_view_id":{"anyOf":[{"type":"string","maxLength":96},{"type":"null"}],"title":"Page View Id"},"route_path":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Route Path"},"route_template":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Route Template"},"app_area":{"anyOf":[{"type":"string","maxLength":96},{"type":"null"}],"title":"App Area"},"component_id":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Component Id"},"action_id":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Action Id"},"object_type":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Object Type"},"object_id":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Object Id"},"subview_type":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Subview Type"},"subview_key":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Subview Key"},"subview_label":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Subview Label"},"duration_ms":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Duration Ms"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"client_timestamp":{"type":"string","format":"date-time","title":"Client Timestamp"}},"type":"object","required":["event_name","client_timestamp"],"title":"ProductEventIn"},"ProductEventRow":{"properties":{"id":{"type":"string","title":"Id"},"user_id":{"type":"string","title":"User Id"},"organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Id"},"company_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Id"},"session_id":{"type":"string","title":"Session Id"},"tab_id":{"type":"string","title":"Tab Id"},"device_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Device Id"},"page_view_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page View Id"},"event_name":{"type":"string","title":"Event Name"},"route_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Route Path"},"route_template":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Route Template"},"app_area":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"App Area"},"component_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Component Id"},"action_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Id"},"object_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Object Type"},"object_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Object Id"},"subview_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subview Type"},"subview_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subview Key"},"subview_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subview Label"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"client_timestamp":{"type":"string","format":"date-time","title":"Client Timestamp"},"server_timestamp":{"type":"string","format":"date-time","title":"Server Timestamp"}},"type":"object","required":["id","user_id","session_id","tab_id","event_name","client_timestamp","server_timestamp"],"title":"ProductEventRow"},"ProductEventTimelineResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/ProductEventRow"},"type":"array","title":"Events"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["events","total"],"title":"ProductEventTimelineResponse"},"ProductEventsBatchIn":{"properties":{"session_id":{"type":"string","maxLength":96,"minLength":1,"title":"Session Id"},"tab_id":{"type":"string","maxLength":96,"minLength":1,"title":"Tab Id"},"device_id":{"anyOf":[{"type":"string","maxLength":96},{"type":"null"}],"title":"Device Id"},"events":{"items":{"$ref":"#/components/schemas/ProductEventIn"},"type":"array","maxItems":100,"minItems":1,"title":"Events"}},"type":"object","required":["session_id","tab_id","events"],"title":"ProductEventsBatchIn"},"ProductEventsBatchResponse":{"properties":{"accepted":{"type":"integer","title":"Accepted"}},"type":"object","required":["accepted"],"title":"ProductEventsBatchResponse"},"ProductIdea":{"properties":{"name":{"type":"string","title":"Name"},"tagline":{"type":"string","title":"Tagline"},"description":{"type":"string","title":"Description"},"target_audience":{"type":"string","title":"Target Audience"},"key_features":{"items":{"type":"string"},"type":"array","title":"Key Features"},"unique_value_proposition":{"type":"string","title":"Unique Value Proposition"},"market_opportunity":{"type":"string","title":"Market Opportunity"},"competitive_advantage":{"type":"string","title":"Competitive Advantage"},"price_range":{"type":"string","title":"Price Range"},"potential_challenges":{"items":{"type":"string"},"type":"array","title":"Potential Challenges"},"success_metrics":{"items":{"type":"string"},"type":"array","title":"Success Metrics"}},"type":"object","required":["name","tagline","description","target_audience","key_features","unique_value_proposition","market_opportunity","competitive_advantage","price_range","potential_challenges","success_metrics"],"title":"ProductIdea"},"ProductIdeaResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"product_offering_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id"},"session_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Title"},"user_input":{"type":"string","title":"User Input"},"product_ideas":{"items":{"$ref":"#/components/schemas/ProductIdea"},"type":"array","title":"Product Ideas"},"context_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Context Data"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","session_title","user_input","product_ideas","context_data","created_at"],"title":"ProductIdeaResponse"},"ProductInsightActivity":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"card_id":{"type":"string","format":"uuid","title":"Card Id"},"team_id":{"type":"string","format":"uuid","title":"Team Id"},"revision":{"type":"integer","title":"Revision"},"kind":{"type":"string","title":"Kind"},"changed_fields":{"items":{"type":"string"},"type":"array","title":"Changed Fields"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"title":{"type":"string","title":"Title"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["id","card_id","team_id","revision","kind","changed_fields","created_at","title","detail"],"title":"ProductInsightActivity"},"ProductInsightCard":{"properties":{"team_id":{"type":"string","format":"uuid","title":"Team Id"},"team_name":{"type":"string","title":"Team Name"},"card":{"$ref":"#/components/schemas/AgentTeamInsightCardResponse"},"revision":{"type":"integer","title":"Revision"},"is_new":{"type":"boolean","title":"Is New"},"is_updated":{"type":"boolean","title":"Is Updated"},"relationship":{"type":"string","enum":["current","previous"],"title":"Relationship","default":"current"},"related_until_revision":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Related Until Revision"},"reviewed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Reviewed At"},"changed_at":{"type":"string","format":"date-time","title":"Changed At"},"evidence_preview":{"items":{"$ref":"#/components/schemas/ProductInsightEvidencePreview"},"type":"array","title":"Evidence Preview"}},"type":"object","required":["team_id","team_name","card","revision","is_new","is_updated","changed_at"],"title":"ProductInsightCard"},"ProductInsightEvidencePreview":{"properties":{"label":{"type":"string","title":"Label"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"observed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observed At"}},"type":"object","required":["label"],"title":"ProductInsightEvidencePreview"},"ProductInsightResponse":{"properties":{"product_offering_id":{"type":"string","format":"uuid","title":"Product Offering Id"},"teams":{"items":{"$ref":"#/components/schemas/ProductInsightTeam"},"type":"array","title":"Teams"},"current":{"items":{"$ref":"#/components/schemas/ProductInsightCard"},"type":"array","title":"Current"},"history":{"items":{"$ref":"#/components/schemas/ProductInsightCard"},"type":"array","title":"History"},"activity":{"items":{"$ref":"#/components/schemas/ProductInsightActivity"},"type":"array","title":"Activity"},"pagination":{"additionalProperties":{"$ref":"#/components/schemas/PageInfo"},"type":"object","title":"Pagination"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"indexing_pending":{"type":"boolean","title":"Indexing Pending","default":false}},"type":"object","required":["product_offering_id","teams","current","history","activity","pagination","generated_at"],"title":"ProductInsightResponse"},"ProductInsightSeenRequest":{"properties":{"receipts":{"items":{"$ref":"#/components/schemas/SeenRevision"},"type":"array","maxItems":50,"title":"Receipts"}},"type":"object","required":["receipts"],"title":"ProductInsightSeenRequest"},"ProductInsightTeam":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"status":{"type":"string","title":"Status"},"default_schedule_minutes":{"type":"integer","title":"Default Schedule Minutes"},"last_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Run At"},"next_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Run At"}},"type":"object","required":["id","name","status","default_schedule_minutes"],"title":"ProductInsightTeam"},"ProductLaunchTestRequest":{"properties":{"launch_session_id":{"type":"string","format":"uuid","title":"Launch Session Id"},"product_idea_index":{"type":"integer","title":"Product Idea Index"},"target_audience_groups":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Target Audience Groups"},"persona_set_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Persona Set Id"}},"type":"object","required":["launch_session_id","product_idea_index"],"title":"ProductLaunchTestRequest"},"ProductLaunchTestResult":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"launch_session_id":{"type":"string","format":"uuid","title":"Launch Session Id"},"product_name":{"type":"string","title":"Product Name"},"product_description":{"type":"string","title":"Product Description"},"total_personas_tested":{"type":"integer","title":"Total Personas Tested"},"overall_interest_score":{"type":"number","title":"Overall Interest Score"},"purchase_intent_score":{"type":"number","title":"Purchase Intent Score"},"market_fit_score":{"type":"number","title":"Market Fit Score"},"sentiment_analysis":{"additionalProperties":true,"type":"object","title":"Sentiment Analysis"},"key_insights":{"items":{"type":"string"},"type":"array","title":"Key Insights"},"recommendations":{"items":{"type":"string"},"type":"array","title":"Recommendations"},"persona_responses":{"items":{"$ref":"#/components/schemas/PersonaResponseData"},"type":"array","title":"Persona Responses"},"test_status":{"type":"string","title":"Test Status"},"started_at":{"type":"string","format":"date-time","title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"pagination":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pagination"}},"type":"object","required":["id","launch_session_id","product_name","product_description","total_personas_tested","overall_interest_score","purchase_intent_score","market_fit_score","sentiment_analysis","key_insights","recommendations","persona_responses","test_status","started_at","completed_at"],"title":"ProductLaunchTestResult"},"ProductOfferingAugmentItem":{"properties":{"source":{"type":"string","enum":["inventory","custom"],"title":"Source"},"inventory_offering_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Inventory Offering Id"},"custom_offering":{"anyOf":[{"$ref":"#/components/schemas/SKU"},{"type":"null"}]},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"}},"type":"object","required":["source"],"title":"ProductOfferingAugmentItem"},"ProductOfferingAugmentRequest":{"properties":{"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"items":{"items":{"$ref":"#/components/schemas/ProductOfferingAugmentItem"},"type":"array","title":"Items"}},"type":"object","required":["company_profile_id","items"],"title":"ProductOfferingAugmentRequest"},"ProductOfferingCurrentPriceUpdateRequest":{"properties":{"expected_content_version":{"anyOf":[{"type":"string","maxLength":64,"minLength":64},{"type":"null"}],"title":"Expected Content Version"},"price":{"type":"string","maxLength":255,"minLength":1,"title":"Price"},"unit":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Unit"}},"type":"object","required":["price"],"title":"ProductOfferingCurrentPriceUpdateRequest"},"ProductOfferingDeleteImageRequest":{"properties":{"image_url":{"type":"string","maxLength":4000,"minLength":1,"title":"Image Url"}},"type":"object","required":["image_url"],"title":"ProductOfferingDeleteImageRequest"},"ProductOfferingExtractUrlRequest":{"properties":{"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"page_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Page Url"},"workflow_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Workflow Id"},"force_recrawl":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Force Recrawl","default":false}},"type":"object","required":["company_profile_id","page_url"],"title":"ProductOfferingExtractUrlRequest"},"ProductOfferingExtractionMetadata":{"properties":{"source":{"anyOf":[{"type":"string","const":"document"},{"type":"null"}],"title":"Source"},"source_document_filename":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Document Filename"}},"type":"object","title":"ProductOfferingExtractionMetadata"},"ProductOfferingRewriteRequest":{"properties":{"field":{"type":"string","enum":["description","key_features"],"title":"Field"},"instructions":{"anyOf":[{"type":"string","maxLength":1500},{"type":"null"}],"title":"Instructions"}},"type":"object","required":["field"],"title":"ProductOfferingRewriteRequest"},"ProductOfferingUpdateRequest":{"properties":{"expected_content_version":{"anyOf":[{"type":"string","maxLength":64,"minLength":64},{"type":"null"}],"title":"Expected Content Version"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"primary_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Category"},"subcategories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Subcategories"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"key_features":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Key Features"},"source_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Source Urls"},"status":{"anyOf":[{"type":"string","enum":["active","inactive","draft"]},{"type":"null"}],"title":"Status"}},"type":"object","title":"ProductOfferingUpdateRequest"},"ProductOfferingUploadImagesResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"uploaded_images":{"items":{"$ref":"#/components/schemas/GalleryImageResponse"},"type":"array","title":"Uploaded Images"},"total":{"type":"integer","title":"Total","default":0},"offering":{"additionalProperties":true,"type":"object","title":"Offering"}},"type":"object","required":["success","offering"],"title":"ProductOfferingUploadImagesResponse"},"ProductPriceComparisonSnapshot":{"properties":{"kind":{"type":"string","const":"product_price_comparison_v1","title":"Kind","default":"product_price_comparison_v1"},"source_scope":{"$ref":"#/components/schemas/CapturedReadScope"},"product_id":{"type":"string","format":"uuid","title":"Product Id"},"product_ref":{"$ref":"#/components/schemas/ResourceRef"},"artifact_index":{"type":"integer","maximum":19.0,"minimum":0.0,"title":"Artifact Index"},"content_version":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Content Version"},"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"name_truncated":{"type":"boolean","title":"Name Truncated"},"price_state":{"type":"string","enum":["recorded","not_recorded","omitted"],"title":"Price State"},"current_price_terms":{"anyOf":[{"$ref":"#/components/schemas/ProductComparisonTerms"},{"type":"null"}]},"price_rows":{"items":{"$ref":"#/components/schemas/ProductComparisonPriceRow"},"type":"array","maxItems":8,"title":"Price Rows"},"record_updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Record Updated At"},"page_scope":{"$ref":"#/components/schemas/ProductComparisonPage"},"omitted_fields":{"items":{"type":"string","enum":["name","price_terms","price_rows","source_notes"]},"type":"array","maxItems":4,"title":"Omitted Fields"}},"additionalProperties":false,"type":"object","required":["source_scope","product_id","product_ref","artifact_index","content_version","name","name_truncated","price_state","current_price_terms","price_rows","record_updated_at","page_scope","omitted_fields"],"title":"ProductPriceComparisonSnapshot","description":"Source-owned saved price facts, distinct from market verification or rights."},"ProductPriceReview":{"properties":{"kind":{"type":"string","const":"product_price","title":"Kind","default":"product_price"},"product_id":{"type":"string","format":"uuid","title":"Product Id"},"name":{"type":"string","maxLength":300,"minLength":1,"title":"Name"},"expected_content_version":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Expected Content Version"},"current":{"$ref":"#/components/schemas/ProductPriceTerms"},"proposed":{"$ref":"#/components/schemas/ProductPriceTerms"},"acknowledgements":{"prefixItems":[{"type":"string","const":"I reviewed the product, price and unit that will be saved."}],"type":"array","maxItems":1,"minItems":1,"title":"Acknowledgements","default":["I reviewed the product, price and unit that will be saved."]}},"additionalProperties":false,"type":"object","required":["product_id","name","expected_content_version","current","proposed"],"title":"ProductPriceReview","description":"Exact catalog price and preserved basis shown before a human saves it."},"ProductPriceTerms":{"properties":{"price":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Price"},"unit":{"anyOf":[{"type":"string","maxLength":120,"minLength":1},{"type":"null"}],"title":"Unit"},"currency":{"anyOf":[{"type":"string","maxLength":40,"minLength":1},{"type":"null"}],"title":"Currency"},"variant":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Variant"}},"additionalProperties":false,"type":"object","title":"ProductPriceTerms"},"ProductRefreshApplyRequest":{"properties":{"review_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Review Id"},"source_urls":{"items":{"type":"string"},"type":"array","title":"Source Urls"},"refresh_urls":{"items":{"type":"string"},"type":"array","title":"Refresh Urls"},"selected_fields":{"items":{"type":"string","enum":["name","description","primary_category","subcategories","tags","key_features","price_list","images","pricing_analysis","feature_comparison","swot_analysis"]},"type":"array","title":"Selected Fields"},"preview_patch":{"additionalProperties":true,"type":"object","title":"Preview Patch"}},"type":"object","title":"ProductRefreshApplyRequest"},"ProductRefreshPreviewRequest":{"properties":{"source_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Source Urls"},"refresh_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Refresh Urls"}},"type":"object","title":"ProductRefreshPreviewRequest"},"ProductResearchResponse":{"properties":{"product_offering_id":{"type":"string","format":"uuid","title":"Product Offering Id"},"status":{"type":"string","enum":["not_generated","queued","generating","ready","failed"],"title":"Status"},"current_revision_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Current Revision Id"},"input_hash":{"type":"string","title":"Input Hash"},"stale":{"type":"boolean","title":"Stale","default":false},"stale_reason":{"anyOf":[{"type":"string","enum":["inputs_changed","review_due"]},{"type":"null"}],"title":"Stale Reason"},"generated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Generated At"},"evidence_checked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Evidence Checked At"},"next_review_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Review At"},"active_job_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Active Job Id"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error"},"auto_refresh_enabled":{"type":"boolean","title":"Auto Refresh Enabled","default":false},"automatic_research_available":{"type":"boolean","title":"Automatic Research Available","default":false},"needs_authorization":{"type":"boolean","title":"Needs Authorization","default":false},"brief":{"anyOf":[{"$ref":"#/components/schemas/ResearchBrief"},{"type":"null"}]},"buyer_questions":{"items":{"$ref":"#/components/schemas/BuyerQuestion"},"type":"array","title":"Buyer Questions"},"page_review":{"anyOf":[{"$ref":"#/components/schemas/PageReview"},{"type":"null"}]},"sources":{"items":{"$ref":"#/components/schemas/ResearchSource"},"type":"array","title":"Sources"}},"additionalProperties":false,"type":"object","required":["product_offering_id","status","input_hash"],"title":"ProductResearchResponse"},"ProfileContentEditApplyRequest":{"properties":{"prompt":{"type":"string","maxLength":2500,"title":"Prompt","default":""},"groups":{"items":{"$ref":"#/components/schemas/ProfileContentEditEntityChange-Input"},"type":"array","title":"Groups"},"operations":{"items":{"$ref":"#/components/schemas/ProfileContentEditOperation"},"type":"array","title":"Operations"},"selected_changes":{"items":{"$ref":"#/components/schemas/ProfileContentEditSelectedChange"},"type":"array","title":"Selected Changes"},"selected_operations":{"items":{"$ref":"#/components/schemas/ProfileContentEditSelectedOperation"},"type":"array","title":"Selected Operations"}},"type":"object","title":"ProfileContentEditApplyRequest"},"ProfileContentEditApplyResponse":{"properties":{"status":{"type":"string","const":"applied","title":"Status"},"applied_changes":{"type":"integer","title":"Applied Changes"},"applied_groups":{"items":{"$ref":"#/components/schemas/ProfileContentEditEntityChange-Output"},"type":"array","title":"Applied Groups"},"applied_operations":{"items":{"$ref":"#/components/schemas/ProfileContentEditOperation"},"type":"array","title":"Applied Operations"}},"type":"object","required":["status","applied_changes"],"title":"ProfileContentEditApplyResponse"},"ProfileContentEditDocumentPreviewRequest":{"properties":{"prompt":{"type":"string","maxLength":2500,"title":"Prompt","default":""},"document_file_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":5,"minItems":1,"title":"Document File Ids"},"targets":{"$ref":"#/components/schemas/ProfileContentEditTargets"}},"type":"object","required":["document_file_ids"],"title":"ProfileContentEditDocumentPreviewRequest"},"ProfileContentEditEntityChange-Input":{"properties":{"entity_type":{"type":"string","enum":["company_profile","company_marketing_strategy","product_offering","product_competitive_analysis","product_marketing_strategy"],"title":"Entity Type"},"entity_id":{"type":"string","title":"Entity Id"},"entity_name":{"type":"string","title":"Entity Name"},"entity_label":{"type":"string","title":"Entity Label"},"selected_by_default":{"type":"boolean","title":"Selected By Default","default":true},"changes":{"items":{"$ref":"#/components/schemas/ProfileContentEditFieldChange"},"type":"array","title":"Changes"}},"type":"object","required":["entity_type","entity_id","entity_name","entity_label"],"title":"ProfileContentEditEntityChange"},"ProfileContentEditEntityChange-Output":{"properties":{"entity_type":{"type":"string","enum":["company_profile","company_marketing_strategy","product_offering","product_competitive_analysis","product_marketing_strategy"],"title":"Entity Type"},"entity_id":{"type":"string","title":"Entity Id"},"entity_name":{"type":"string","title":"Entity Name"},"entity_label":{"type":"string","title":"Entity Label"},"selected_by_default":{"type":"boolean","title":"Selected By Default","default":true},"changes":{"items":{"$ref":"#/components/schemas/ProfileContentEditFieldChange"},"type":"array","title":"Changes"}},"type":"object","required":["entity_type","entity_id","entity_name","entity_label"],"title":"ProfileContentEditEntityChange"},"ProfileContentEditEvidence":{"properties":{"document_file_id":{"type":"string","title":"Document File Id","default":""},"filename":{"type":"string","title":"Filename","default":""},"excerpt":{"type":"string","title":"Excerpt","default":""},"location":{"type":"string","title":"Location","default":""}},"type":"object","title":"ProfileContentEditEvidence"},"ProfileContentEditFieldChange":{"properties":{"field_key":{"type":"string","title":"Field Key"},"field_label":{"type":"string","title":"Field Label"},"before":{"type":"string","title":"Before"},"after":{"type":"string","title":"After"},"before_value":{"title":"Before Value"},"after_value":{"title":"After Value"},"confidence":{"type":"string","enum":["low","medium","high"],"title":"Confidence","default":"medium"},"rationale":{"type":"string","title":"Rationale","default":""},"evidence":{"items":{"$ref":"#/components/schemas/ProfileContentEditEvidence"},"type":"array","title":"Evidence"},"selected_by_default":{"type":"boolean","title":"Selected By Default","default":true}},"type":"object","required":["field_key","field_label","before","after"],"title":"ProfileContentEditFieldChange"},"ProfileContentEditOperation":{"properties":{"operation_type":{"type":"string","enum":["archive_product_offering","create_product_offering"],"title":"Operation Type"},"entity_type":{"type":"string","const":"product_offering","title":"Entity Type","default":"product_offering"},"entity_id":{"type":"string","title":"Entity Id"},"entity_name":{"type":"string","title":"Entity Name"},"entity_label":{"type":"string","title":"Entity Label","default":"Product offering"},"operation_label":{"type":"string","title":"Operation Label"},"before":{"type":"string","title":"Before"},"after":{"type":"string","title":"After"},"after_value":{"title":"After Value"},"confidence":{"type":"string","enum":["low","medium","high"],"title":"Confidence","default":"medium"},"rationale":{"type":"string","title":"Rationale","default":""},"evidence":{"items":{"$ref":"#/components/schemas/ProfileContentEditEvidence"},"type":"array","title":"Evidence"},"selected_by_default":{"type":"boolean","title":"Selected By Default","default":true}},"type":"object","required":["operation_type","entity_id","entity_name","operation_label","before","after"],"title":"ProfileContentEditOperation"},"ProfileContentEditPreviewRequest":{"properties":{"prompt":{"type":"string","maxLength":2500,"minLength":3,"title":"Prompt"},"targets":{"$ref":"#/components/schemas/ProfileContentEditTargets"}},"type":"object","required":["prompt"],"title":"ProfileContentEditPreviewRequest"},"ProfileContentEditPreviewResponse":{"properties":{"status":{"type":"string","enum":["ready","unchanged"],"title":"Status"},"summary":{"type":"string","title":"Summary"},"groups":{"items":{"$ref":"#/components/schemas/ProfileContentEditEntityChange-Output"},"type":"array","title":"Groups"},"operations":{"items":{"$ref":"#/components/schemas/ProfileContentEditOperation"},"type":"array","title":"Operations"},"total_changes":{"type":"integer","title":"Total Changes","default":0}},"type":"object","required":["status","summary"],"title":"ProfileContentEditPreviewResponse"},"ProfileContentEditSelectedChange":{"properties":{"entity_type":{"type":"string","enum":["company_profile","company_marketing_strategy","product_offering","product_competitive_analysis","product_marketing_strategy"],"title":"Entity Type"},"entity_id":{"type":"string","title":"Entity Id"},"field_key":{"type":"string","title":"Field Key"}},"type":"object","required":["entity_type","entity_id","field_key"],"title":"ProfileContentEditSelectedChange"},"ProfileContentEditSelectedOperation":{"properties":{"operation_type":{"type":"string","enum":["archive_product_offering","create_product_offering"],"title":"Operation Type"},"entity_type":{"type":"string","const":"product_offering","title":"Entity Type","default":"product_offering"},"entity_id":{"type":"string","title":"Entity Id"}},"type":"object","required":["operation_type","entity_id"],"title":"ProfileContentEditSelectedOperation"},"ProfileContentEditTargets":{"properties":{"company_profile":{"type":"boolean","title":"Company Profile","default":true},"product_offering_ids":{"items":{"type":"string","format":"uuid"},"type":"array","title":"Product Offering Ids"},"include_all_product_offerings":{"type":"boolean","title":"Include All Product Offerings","default":false}},"type":"object","title":"ProfileContentEditTargets"},"ProgrammaticCampaignGenerationItem":{"properties":{"idea_id":{"type":"string","minLength":1,"title":"Idea Id"},"social_or_ads":{"anyOf":[{"type":"string","enum":["social","ads"]},{"type":"null"}],"title":"Social Or Ads"},"platforms":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Platforms"}},"type":"object","required":["idea_id"],"title":"ProgrammaticCampaignGenerationItem"},"ProgrammaticCampaignGenerationRequest":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ProgrammaticCampaignGenerationItem"},"type":"array","maxItems":10,"minItems":1,"title":"Items"}},"type":"object","required":["items"],"title":"ProgrammaticCampaignGenerationRequest"},"ProgrammaticCampaignGenerationResponse":{"properties":{"organization_id":{"type":"string","title":"Organization Id"},"company_profile_id":{"type":"string","title":"Company Profile Id"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id"},"results":{"items":{"$ref":"#/components/schemas/ProgrammaticCampaignGenerationResult"},"type":"array","title":"Results"}},"type":"object","required":["organization_id","company_profile_id","results"],"title":"ProgrammaticCampaignGenerationResponse"},"ProgrammaticCampaignGenerationResult":{"properties":{"campaign_idea_id":{"type":"string","title":"Campaign Idea Id"},"campaign_type":{"type":"string","title":"Campaign Type"},"platforms":{"items":{"type":"string"},"type":"array","title":"Platforms"},"status":{"type":"string","title":"Status"},"output":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Output"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["campaign_idea_id","campaign_type","platforms","status"],"title":"ProgrammaticCampaignGenerationResult"},"ProgrammaticCampaignIdeasRequest":{"properties":{"campaign_goal":{"type":"string","maxLength":2000,"minLength":1,"title":"Campaign Goal"},"target_audience":{"type":"string","maxLength":2000,"minLength":1,"title":"Target Audience"},"num_ideas":{"type":"integer","maximum":30.0,"minimum":1.0,"title":"Num Ideas"},"platform":{"type":"string","enum":["meta","google","tiktok","linkedin"],"title":"Platform"},"social_or_ads":{"type":"string","enum":["social","ads"],"title":"Social Or Ads","default":"social"}},"type":"object","required":["campaign_goal","target_audience","num_ideas","platform"],"title":"ProgrammaticCampaignIdeasRequest"},"ProgrammaticCampaignIdeasResponse":{"properties":{"campaign_goal":{"type":"string","title":"Campaign Goal"},"target_audience_input":{"type":"string","title":"Target Audience Input"},"target_audiences":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Target Audiences"},"campaign_ideas":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Campaign Ideas"},"platform":{"type":"string","enum":["meta","google","tiktok","linkedin"],"title":"Platform"},"social_or_ads":{"type":"string","enum":["social","ads"],"title":"Social Or Ads"},"num_ideas":{"type":"integer","title":"Num Ideas"},"organization_id":{"type":"string","title":"Organization Id"},"company_profile_id":{"type":"string","title":"Company Profile Id"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id"}},"type":"object","required":["campaign_goal","target_audience_input","target_audiences","campaign_ideas","platform","social_or_ads","num_ideas","organization_id","company_profile_id"],"title":"ProgrammaticCampaignIdeasResponse"},"ProjectRoleEnum":{"type":"string","enum":["admin","contributor","observer"],"title":"ProjectRoleEnum","description":"Project-level role options (for company profiles)."},"ProposalResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"target_item_id":{"type":"string","format":"uuid","title":"Target Item Id"},"target_version":{"type":"integer","title":"Target Version"},"context_hash":{"type":"string","title":"Context Hash"},"state":{"type":"string","title":"State"},"draft_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Draft Text"},"approved_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Approved Text"},"generation_attempt_count":{"type":"integer","title":"Generation Attempt Count"}},"type":"object","required":["id","target_item_id","target_version","context_hash","state","draft_text","approved_text","generation_attempt_count"],"title":"ProposalResponse"},"PublicActionAvailabilityNotice":{"properties":{"state":{"type":"string","const":"not_prepared","title":"State","default":"not_prepared"},"reason":{"$ref":"#/components/schemas/ActionAvailabilityReason"}},"type":"object","required":["reason"],"title":"PublicActionAvailabilityNotice","description":"Typed notice that preserves an answer while removing an unsafe action."},"PublicDispositionKind":{"type":"string","enum":["answered","partial","needs_input","declined","no_answer","cancelled","failed"],"title":"PublicDispositionKind","description":"Closed customer meaning for one terminal assistant execution.\n\nRuntime lifecycle and internal stop causes remain separate. Unknown internal\noutcomes must be projected to ``FAILED`` with an\n``unknown_terminal_outcome`` reason before crossing this public boundary."},"PublicExecutionStep":{"properties":{"step_id":{"anyOf":[{"type":"string","maxLength":128,"pattern":"^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$"},{"type":"null"}],"title":"Step Id","description":"Optional stable machine identity for reconciling one public step across live snapshot revisions. It is not user-visible."},"category":{"type":"string","maxLength":64,"minLength":1,"pattern":"^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$","title":"Category"},"code":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$","title":"Code"},"state":{"type":"string","maxLength":64,"minLength":1,"pattern":"^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$","title":"State"},"terminal":{"type":"boolean","title":"Terminal"},"title":{"type":"string","maxLength":160,"minLength":1,"title":"Title"},"detail":{"anyOf":[{"type":"string","maxLength":500,"minLength":1},{"type":"null"}],"title":"Detail"},"duration_ms":{"anyOf":[{"type":"integer","maximum":9007199254740991.0,"minimum":0.0},{"type":"null"}],"title":"Duration Ms"},"cost_micros":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Cost Micros"},"input_tokens":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Input Tokens"},"output_tokens":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Output Tokens"},"cached_input_tokens":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Cached Input Tokens"},"result_count":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":0.0},{"type":"null"}],"title":"Result Count"},"total_count":{"anyOf":[{"type":"integer","maximum":1000000.0,"minimum":0.0},{"type":"null"}],"title":"Total Count"},"result_state":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$"},{"type":"null"}],"title":"Result State"}},"type":"object","required":["category","code","state","terminal","title"],"title":"PublicExecutionStep","description":"One bounded, presentation-ready item in a public execution snapshot.\n\nThe optional result fields are public operational facts, never model\nreasoning or raw tool arguments. They let clients explain what a step\naccomplished without parsing display copy."},"PublicExecutionSummary":{"properties":{"api_version":{"type":"string","maxLength":64,"pattern":"^pomo\\.agent\\.execution/v[1-9][0-9]*$","title":"Api Version","default":"pomo.agent.execution/v1"},"execution_id":{"type":"string","format":"uuid","title":"Execution Id"},"revision":{"type":"integer","minimum":0.0,"title":"Revision","default":0},"state":{"type":"string","maxLength":64,"minLength":1,"pattern":"^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$","title":"State"},"terminal":{"type":"boolean","title":"Terminal"},"outcome":{"anyOf":[{"type":"string","maxLength":64,"minLength":1,"pattern":"^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$"},{"type":"null"}],"title":"Outcome"},"disposition":{"anyOf":[{"$ref":"#/components/schemas/PublicTerminalDisposition"},{"type":"null"}]},"progress":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Progress"},"summary":{"anyOf":[{"type":"string","maxLength":2000,"minLength":1},{"type":"null"}],"title":"Summary"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"},"duration_ms":{"anyOf":[{"type":"integer","maximum":9007199254740991.0,"minimum":0.0},{"type":"null"}],"title":"Duration Ms"},"cost_micros":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Cost Micros"},"total_step_count":{"type":"integer","maximum":1000000.0,"minimum":0.0,"title":"Total Step Count","default":0},"omitted_step_count":{"type":"integer","maximum":1000000.0,"minimum":0.0,"title":"Omitted Step Count","default":0},"steps":{"items":{"$ref":"#/components/schemas/PublicExecutionStep"},"type":"array","maxItems":40,"title":"Steps","default":[]}},"type":"object","required":["execution_id","state","terminal"],"title":"PublicExecutionSummary","description":"A complete public snapshot of one assistant execution."},"PublicRecoveryOption":{"properties":{"option_id":{"type":"string","maxLength":64,"pattern":"^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$","title":"Option Id"},"kind":{"$ref":"#/components/schemas/RecoveryOptionKind"},"reason":{"$ref":"#/components/schemas/RecoveryOptionReason"},"label":{"type":"string","maxLength":80,"minLength":1,"title":"Label"},"prompt":{"type":"string","maxLength":300,"minLength":1,"title":"Prompt"},"section_ids":{"items":{"type":"string","maxLength":64,"pattern":"^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$"},"type":"array","maxItems":20,"minItems":1,"title":"Section Ids"}},"type":"object","required":["option_id","kind","reason","label","prompt","section_ids"],"title":"PublicRecoveryOption","description":"A bounded Core-authored prompt the user may choose to send.\n\nThe browser may display and submit this prompt verbatim, but it must not\nsynthesize recovery instructions from internal stop reasons."},"PublicTerminalDisposition":{"additionalProperties":true,"type":"object"},"QBCustomerSummaryResponse":{"properties":{"customer_id":{"type":"string","title":"Customer Id"},"customer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Name"},"total_invoiced_cents":{"type":"integer","title":"Total Invoiced Cents"},"total_received_cents":{"type":"integer","title":"Total Received Cents"},"outstanding_balance_cents":{"type":"integer","title":"Outstanding Balance Cents"},"invoice_count":{"type":"integer","title":"Invoice Count"},"first_transaction_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"First Transaction Date"},"last_transaction_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Transaction Date"}},"type":"object","required":["customer_id","customer_name","total_invoiced_cents","total_received_cents","outstanding_balance_cents","invoice_count","first_transaction_date","last_transaction_date"],"title":"QBCustomerSummaryResponse","description":"Customer sales summary response."},"QBDailyFinancialsFullResponse":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"invoice_total_cents":{"type":"integer","title":"Invoice Total Cents"},"sales_receipt_total_cents":{"type":"integer","title":"Sales Receipt Total Cents"},"gross_sales_cents":{"type":"integer","title":"Gross Sales Cents"},"payment_total_cents":{"type":"integer","title":"Payment Total Cents"},"deposit_total_cents":{"type":"integer","title":"Deposit Total Cents"},"credit_memo_total_cents":{"type":"integer","title":"Credit Memo Total Cents"},"refund_total_cents":{"type":"integer","title":"Refund Total Cents"},"net_sales_cents":{"type":"integer","title":"Net Sales Cents"},"bill_total_cents":{"type":"integer","title":"Bill Total Cents"},"purchase_total_cents":{"type":"integer","title":"Purchase Total Cents"},"total_expenses_cents":{"type":"integer","title":"Total Expenses Cents"},"net_cash_flow_cents":{"type":"integer","title":"Net Cash Flow Cents"},"invoice_count":{"type":"integer","title":"Invoice Count"},"sales_receipt_count":{"type":"integer","title":"Sales Receipt Count"},"payment_count":{"type":"integer","title":"Payment Count"},"deposit_count":{"type":"integer","title":"Deposit Count"},"credit_memo_count":{"type":"integer","title":"Credit Memo Count"},"refund_count":{"type":"integer","title":"Refund Count"},"bill_count":{"type":"integer","title":"Bill Count"},"purchase_count":{"type":"integer","title":"Purchase Count"}},"type":"object","required":["metric_date","invoice_total_cents","sales_receipt_total_cents","gross_sales_cents","payment_total_cents","deposit_total_cents","credit_memo_total_cents","refund_total_cents","net_sales_cents","bill_total_cents","purchase_total_cents","total_expenses_cents","net_cash_flow_cents","invoice_count","sales_receipt_count","payment_count","deposit_count","credit_memo_count","refund_count","bill_count","purchase_count"],"title":"QBDailyFinancialsFullResponse","description":"Full daily QuickBooks financials with all entity-level columns."},"QBDailyFinancialsResponse":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"gross_sales_cents":{"type":"integer","title":"Gross Sales Cents"},"net_sales_cents":{"type":"integer","title":"Net Sales Cents"},"total_expenses_cents":{"type":"integer","title":"Total Expenses Cents"},"net_cash_flow_cents":{"type":"integer","title":"Net Cash Flow Cents"},"invoice_count":{"type":"integer","title":"Invoice Count"},"bill_count":{"type":"integer","title":"Bill Count"}},"type":"object","required":["metric_date","gross_sales_cents","net_sales_cents","total_expenses_cents","net_cash_flow_cents","invoice_count","bill_count"],"title":"QBDailyFinancialsResponse","description":"Daily QuickBooks financial metrics response."},"QBDailyMarketingByCategoryResponse":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"marketing_category":{"type":"string","title":"Marketing Category"},"entity_type":{"type":"string","title":"Entity Type"},"expense_count":{"type":"integer","title":"Expense Count"},"total_marketing_cents":{"type":"integer","title":"Total Marketing Cents"},"split_count":{"type":"integer","title":"Split Count"}},"type":"object","required":["metric_date","marketing_category","entity_type","expense_count","total_marketing_cents","split_count"],"title":"QBDailyMarketingByCategoryResponse","description":"Daily marketing spend by category response."},"QBDailyMarketingSpendResponse":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"total_marketing_cents":{"type":"integer","title":"Total Marketing Cents"}},"type":"object","required":["metric_date","total_marketing_cents"],"title":"QBDailyMarketingSpendResponse","description":"Daily marketing spend total response."},"QBMarketingAnnotationResponse":{"properties":{"qb_token":{"type":"string","title":"Qb Token"},"entity_type":{"type":"string","enum":["bill","purchase"],"title":"Entity Type"},"qb_is_marketing_expense":{"type":"boolean","title":"Qb Is Marketing Expense","default":false},"qb_marketing_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qb Marketing Category"},"qb_marketing_category_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Qb Marketing Category Confidence"},"qb_marketing_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qb Marketing Reason"},"qb_marketing_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qb Marketing Source"},"qb_has_splits":{"type":"boolean","title":"Qb Has Splits","default":false}},"type":"object","required":["qb_token","entity_type"],"title":"QBMarketingAnnotationResponse","description":"Lightweight response for annotation writes (no transaction data needed)."},"QBMarketingByCategoryResponse":{"properties":{"year_month":{"type":"string","title":"Year Month"},"marketing_category":{"type":"string","title":"Marketing Category"},"entity_type":{"type":"string","title":"Entity Type"},"expense_count":{"type":"integer","title":"Expense Count"},"total_marketing_cents":{"type":"integer","title":"Total Marketing Cents"},"split_count":{"type":"integer","title":"Split Count"}},"type":"object","required":["year_month","marketing_category","entity_type","expense_count","total_marketing_cents","split_count"],"title":"QBMarketingByCategoryResponse","description":"Monthly marketing spend by category response."},"QBMonthlyFinancialsResponse":{"properties":{"year_month":{"type":"string","title":"Year Month"},"total_transaction_count":{"type":"integer","title":"Total Transaction Count"},"gross_sales_cents":{"type":"integer","title":"Gross Sales Cents"},"payments_received_cents":{"type":"integer","title":"Payments Received Cents"},"total_adjustments_cents":{"type":"integer","title":"Total Adjustments Cents"},"net_sales_cents":{"type":"integer","title":"Net Sales Cents"},"total_expenses_cents":{"type":"integer","title":"Total Expenses Cents"},"net_cash_flow_cents":{"type":"integer","title":"Net Cash Flow Cents"},"gross_sales_mom_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Gross Sales Mom Pct"},"expenses_mom_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Expenses Mom Pct"}},"type":"object","required":["year_month","total_transaction_count","gross_sales_cents","payments_received_cents","total_adjustments_cents","net_sales_cents","total_expenses_cents","net_cash_flow_cents","gross_sales_mom_pct","expenses_mom_pct"],"title":"QBMonthlyFinancialsResponse","description":"Monthly QuickBooks financials with MoM trends response."},"QBRangeSummaryResponse":{"properties":{"total_gross_sales_cents":{"type":"integer","title":"Total Gross Sales Cents"},"total_net_sales_cents":{"type":"integer","title":"Total Net Sales Cents"},"total_expenses_cents":{"type":"integer","title":"Total Expenses Cents"},"total_net_cash_flow_cents":{"type":"integer","title":"Total Net Cash Flow Cents"},"total_invoices":{"type":"integer","title":"Total Invoices"},"total_bills":{"type":"integer","title":"Total Bills"},"total_payments":{"type":"integer","title":"Total Payments"},"avg_daily_sales_cents":{"type":"integer","title":"Avg Daily Sales Cents"},"avg_daily_expenses_cents":{"type":"integer","title":"Avg Daily Expenses Cents"},"total_deposit_cents":{"type":"integer","title":"Total Deposit Cents"},"total_refund_cents":{"type":"integer","title":"Total Refund Cents"},"total_marketing_cents":{"type":"integer","title":"Total Marketing Cents"}},"type":"object","required":["total_gross_sales_cents","total_net_sales_cents","total_expenses_cents","total_net_cash_flow_cents","total_invoices","total_bills","total_payments","avg_daily_sales_cents","avg_daily_expenses_cents","total_deposit_cents","total_refund_cents","total_marketing_cents"],"title":"QBRangeSummaryResponse","description":"QuickBooks summary for a date range response."},"QBSalesByProductResponse":{"properties":{"item_ref_id":{"type":"string","title":"Item Ref Id"},"item_ref_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Ref Name"},"quantity_sold":{"type":"number","title":"Quantity Sold"},"total_revenue_cents":{"type":"integer","title":"Total Revenue Cents"},"avg_unit_price_cents":{"type":"integer","title":"Avg Unit Price Cents"},"first_sale_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"First Sale Date"},"last_sale_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Sale Date"},"invoice_count":{"type":"integer","title":"Invoice Count"}},"type":"object","required":["item_ref_id","item_ref_name","quantity_sold","total_revenue_cents","avg_unit_price_cents","first_sale_date","last_sale_date","invoice_count"],"title":"QBSalesByProductResponse","description":"Product-level sales summary response."},"QBTransactionResponse":{"properties":{"entity_type":{"type":"string","title":"Entity Type"},"qb_token":{"type":"string","title":"Qb Token"},"qb_id":{"type":"string","title":"Qb Id"},"txn_date":{"type":"string","format":"date","title":"Txn Date"},"doc_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Number"},"customer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Name"},"vendor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vendor Name"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name"},"total_cents":{"type":"integer","title":"Total Cents"},"balance_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Balance Cents"},"is_marketing":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Marketing"},"marketing_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Marketing Category"},"marketing_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Marketing Confidence"},"marketing_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Marketing Source"},"has_splits":{"type":"boolean","title":"Has Splits","default":false}},"type":"object","required":["entity_type","qb_token","qb_id","txn_date","total_cents"],"title":"QBTransactionResponse","description":"Single QuickBooks transaction from Silver tables."},"QBVendorSummaryResponse":{"properties":{"vendor_id":{"type":"string","title":"Vendor Id"},"vendor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vendor Name"},"total_expenses_cents":{"type":"integer","title":"Total Expenses Cents"},"outstanding_balance_cents":{"type":"integer","title":"Outstanding Balance Cents"},"bill_count":{"type":"integer","title":"Bill Count"},"purchase_count":{"type":"integer","title":"Purchase Count"},"first_transaction_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"First Transaction Date"},"last_transaction_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Last Transaction Date"}},"type":"object","required":["vendor_id","vendor_name","total_expenses_cents","outstanding_balance_cents","bill_count","purchase_count","first_transaction_date","last_transaction_date"],"title":"QBVendorSummaryResponse","description":"Vendor expense summary response."},"QaQualityClaimReviewCandidateFact":{"properties":{"candidate_id":{"type":"string","maxLength":191,"minLength":1,"title":"Candidate Id"},"candidate_type":{"type":"string","const":"recommendation","title":"Candidate Type","default":"recommendation"},"presentation_position":{"type":"integer","const":0,"title":"Presentation Position","default":0},"review_content_scope":{"type":"string","const":"recommendation_title_rationale_v1","title":"Review Content Scope","default":"recommendation_title_rationale_v1"},"source_content_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Source Content Hash"},"content":{"$ref":"#/components/schemas/RecommendationReviewContentV2"},"review_content_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Review Content Hash"}},"additionalProperties":false,"type":"object","required":["candidate_id","source_content_hash","content","review_content_hash"],"title":"QaQualityClaimReviewCandidateFact"},"QaQualityClaimReviewNeutralFacts":{"properties":{"kind":{"type":"string","const":"qa_quality_claim","title":"Kind","default":"qa_quality_claim"},"criterion":{"type":"string","const":"claim_safety","title":"Criterion","default":"claim_safety"},"criterion_text":{"type":"string","const":"Assess only the visible title and rationale for overstated certainty or unsafe absolute claim language; do not assess external evidentiary support.","title":"Criterion Text","default":"Assess only the visible title and rationale for overstated certainty or unsafe absolute claim language; do not assess external evidentiary support."},"review_content_scope":{"type":"string","const":"recommendation_title_rationale_v1","title":"Review Content Scope","default":"recommendation_title_rationale_v1"},"subject_candidate":{"$ref":"#/components/schemas/QaQualityClaimReviewCandidateFact"},"detector_claim_visible":{"type":"boolean","const":false,"title":"Detector Claim Visible","default":false}},"additionalProperties":false,"type":"object","required":["subject_candidate"],"title":"QaQualityClaimReviewNeutralFacts","description":"One detector-blinded candidate/criterion unit for EVAL adjudication."},"QaReviewCandidateFact":{"properties":{"candidate_id":{"type":"string","maxLength":191,"minLength":1,"title":"Candidate Id"},"candidate_type":{"type":"string","enum":["creative","optimization","bundle_item","recommendation"],"title":"Candidate Type"},"presentation_position":{"type":"integer","maximum":63.0,"minimum":0.0,"title":"Presentation Position"},"source_content_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Source Content Hash"},"content":{"additionalProperties":{"anyOf":[{"type":"boolean"},{"type":"integer"},{"type":"number"},{"type":"string"}]},"propertyNames":{"enum":["headline","title","approval_headline","working_headline","primary_text","body","caption","description","objective","platform","platform_key","target_platform","channel","post_type","recommendation_type","optimization_recommendation_type","campaign_id","campaign_name","change_from","change_to","why_now","impact_estimate","rationale","expected_impact"]},"type":"object","maxProperties":24,"minProperties":1,"title":"Content"},"review_content_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Review Content Hash"}},"additionalProperties":false,"type":"object","required":["candidate_id","candidate_type","presentation_position","source_content_hash","content","review_content_hash"],"title":"QaReviewCandidateFact"},"QaReviewNeutralFacts":{"properties":{"kind":{"type":"string","const":"qa_issue","title":"Kind","default":"qa_issue"},"candidate_set_kind":{"type":"string","enum":["creative","optimization","bundle_item","recommendation"],"title":"Candidate Set Kind"},"affected_candidate_ids":{"items":{"type":"string"},"type":"array","maxItems":64,"title":"Affected Candidate Ids"},"candidates":{"items":{"$ref":"#/components/schemas/QaReviewCandidateFact"},"type":"array","maxItems":64,"minItems":1,"title":"Candidates"}},"additionalProperties":false,"type":"object","required":["candidate_set_kind","affected_candidate_ids","candidates"],"title":"QaReviewNeutralFacts"},"QualificationPolicy":{"properties":{"rules":{"items":{"$ref":"#/components/schemas/QualificationRule"},"type":"array","maxItems":2,"title":"Rules"}},"additionalProperties":false,"type":"object","title":"QualificationPolicy"},"QualificationRule":{"properties":{"question_id":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,39}$","title":"Question Id"},"accepted_options":{"items":{"type":"string"},"type":"array","maxItems":8,"minItems":1,"title":"Accepted Options"}},"additionalProperties":false,"type":"object","required":["question_id","accepted_options"],"title":"QualificationRule"},"QuickBooksAuditEventRow":{"properties":{"id":{"type":"string","title":"Id"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"actor_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor User Id"},"actor_user_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor User Email"},"action":{"type":"string","title":"Action"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["id","timestamp","action"],"title":"QuickBooksAuditEventRow"},"QuickBooksAuditResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/QuickBooksAuditEventRow"},"type":"array","title":"Events"}},"type":"object","required":["events"],"title":"QuickBooksAuditResponse"},"QuickBooksExpenseAnnotateRequest":{"properties":{"qb_is_marketing_expense":{"type":"boolean","title":"Qb Is Marketing Expense","description":"Whether this transaction is marketing spend"},"qb_marketing_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qb Marketing Category","description":"Marketing category (required when qb_is_marketing_expense=true)"},"qb_marketing_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qb Marketing Reason","description":"User-provided annotation reason"}},"type":"object","required":["qb_is_marketing_expense"],"title":"QuickBooksExpenseAnnotateRequest"},"QuickBooksExpenseBulkAnnotateRequest":{"properties":{"qb_tokens":{"items":{"type":"string"},"type":"array","title":"Qb Tokens"},"qb_is_marketing_expense":{"type":"boolean","title":"Qb Is Marketing Expense"},"qb_marketing_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qb Marketing Category"},"qb_marketing_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qb Marketing Reason"}},"type":"object","required":["qb_tokens","qb_is_marketing_expense"],"title":"QuickBooksExpenseBulkAnnotateRequest"},"QuickBooksExpenseBulkAnnotateResponse":{"properties":{"updated":{"type":"integer","title":"Updated","default":0}},"type":"object","title":"QuickBooksExpenseBulkAnnotateResponse"},"QuickBooksExpenseSplitRow":{"properties":{"id":{"type":"string","title":"Id"},"qb_is_marketing_expense":{"type":"boolean","title":"Qb Is Marketing Expense"},"qb_marketing_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qb Marketing Category"},"amount":{"type":"number","title":"Amount"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["id","qb_is_marketing_expense","amount"],"title":"QuickBooksExpenseSplitRow"},"QuickBooksExpenseSplitUpsert":{"properties":{"qb_is_marketing_expense":{"type":"boolean","title":"Qb Is Marketing Expense","default":true},"qb_marketing_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qb Marketing Category"},"amount":{"type":"number","title":"Amount"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["amount"],"title":"QuickBooksExpenseSplitUpsert"},"QuickBooksExpenseSplitsResponse":{"properties":{"qb_token":{"type":"string","title":"Qb Token"},"entity_type":{"type":"string","enum":["bill","purchase"],"title":"Entity Type"},"splits":{"items":{"$ref":"#/components/schemas/QuickBooksExpenseSplitRow"},"type":"array","title":"Splits"}},"type":"object","required":["qb_token","entity_type","splits"],"title":"QuickBooksExpenseSplitsResponse"},"QuickBooksExpenseSplitsUpdateRequest":{"properties":{"splits":{"items":{"$ref":"#/components/schemas/QuickBooksExpenseSplitUpsert"},"type":"array","title":"Splits"},"expense_total_amt":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Expense Total Amt","description":"Parent expense total in dollars (for server-side validation)"}},"type":"object","required":["splits"],"title":"QuickBooksExpenseSplitsUpdateRequest"},"QuickBooksMappingCreateRequest":{"properties":{"match_field":{"type":"string","enum":["vendor","account"],"title":"Match Field"},"match_text":{"type":"string","title":"Match Text"},"qb_is_marketing_expense":{"type":"boolean","title":"Qb Is Marketing Expense","default":true},"qb_marketing_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qb Marketing Category"}},"type":"object","required":["match_field","match_text"],"title":"QuickBooksMappingCreateRequest"},"QuickBooksMappingRow":{"properties":{"id":{"type":"string","title":"Id"},"match_field":{"type":"string","enum":["vendor","account"],"title":"Match Field"},"match_text":{"type":"string","title":"Match Text"},"qb_is_marketing_expense":{"type":"boolean","title":"Qb Is Marketing Expense"},"qb_marketing_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qb Marketing Category"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","match_field","match_text","qb_is_marketing_expense"],"title":"QuickBooksMappingRow"},"QuickBooksMappingUpdateRequest":{"properties":{"match_field":{"anyOf":[{"type":"string","enum":["vendor","account"]},{"type":"null"}],"title":"Match Field"},"match_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Match Text"},"qb_is_marketing_expense":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Qb Is Marketing Expense"},"qb_marketing_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qb Marketing Category"}},"type":"object","title":"QuickBooksMappingUpdateRequest"},"QuickBooksReviewQueueRow":{"properties":{"entity_type":{"type":"string","enum":["bill","purchase"],"title":"Entity Type"},"qb_token":{"type":"string","title":"Qb Token"},"qb_id":{"type":"string","title":"Qb Id"},"qb_txn_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Qb Txn Date"},"qb_vendor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qb Vendor Name"},"qb_account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qb Account Name"},"qb_total_amt":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Qb Total Amt"},"qb_is_marketing_expense":{"type":"boolean","title":"Qb Is Marketing Expense","default":false},"qb_marketing_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qb Marketing Category"},"qb_marketing_category_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Qb Marketing Category Confidence"},"qb_marketing_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qb Marketing Source"},"qb_has_splits":{"type":"boolean","title":"Qb Has Splits","default":false},"flags":{"items":{"type":"string","enum":["uncategorized","low_confidence","large_amount","unmapped_vendor"]},"type":"array","title":"Flags"}},"type":"object","required":["entity_type","qb_token","qb_id"],"title":"QuickBooksReviewQueueRow"},"QuickBooksStatusResponseModel":{"properties":{"connected":{"type":"boolean","title":"Connected","description":"Whether the platform is connected"},"healthy":{"type":"boolean","title":"Healthy","description":"Whether the token is healthy (passed API check)","default":false},"health_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Health Message","description":"Health check result message"},"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id","description":"Platform-specific account identifier"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name","description":"Display name for the account"},"token_expires_soon":{"type":"boolean","title":"Token Expires Soon","description":"Whether token expires within buffer period","default":false},"last_health_check":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Health Check","description":"ISO timestamp of last health check"},"realm_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Realm Id","description":"QuickBooks company realm ID"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name","description":"Company name from QBO CompanyInfo"}},"type":"object","required":["connected"],"title":"QuickBooksStatusResponseModel","description":"Connection status with optional health check.","example":{"account_id":"shop_12345","account_name":"My Store","connected":true,"health_message":"Token is valid","healthy":true,"last_health_check":"2024-01-15T10:30:00Z","token_expires_soon":false}},"ReadArtifactFocus":{"additionalProperties":true,"type":"object"},"ReadArtifactFocusSource":{"properties":{"record_ref":{"$ref":"#/components/schemas/ResourceRef"},"recorded_version":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"type":"null"}],"title":"Recorded Version"},"current_version":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"type":"null"}],"title":"Current Version"},"movement":{"type":"string","enum":["unchanged","changed","unknown","unavailable"],"title":"Movement"},"view":{"type":"string","enum":["recorded","current_native"],"title":"View"}},"additionalProperties":false,"type":"object","required":["record_ref","movement","view"],"title":"ReadArtifactFocusSource"},"ReadArtifactSubject":{"properties":{"kind":{"type":"string","const":"read_artifact","title":"Kind","default":"read_artifact"},"receipt_id":{"type":"string","format":"uuid","title":"Receipt Id"},"artifact_index":{"type":"integer","maximum":19.0,"minimum":0.0,"title":"Artifact Index"},"observed_record_version":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"type":"null"}],"title":"Observed Record Version"}},"additionalProperties":false,"type":"object","required":["receipt_id","artifact_index"],"title":"ReadArtifactSubject","description":"Exact sealed read position; never a synthetic saved-work identity."},"ReadCursor":{"properties":{"sequence":{"type":"integer","minimum":0.0,"title":"Sequence"}},"additionalProperties":false,"type":"object","required":["sequence"],"title":"ReadCursor"},"ReadVersionTarget":{"properties":{"capability_key":{"type":"string","maxLength":120,"pattern":"^[a-z][a-z0-9_]*(?:\\.[a-z][a-z0-9_]*){1,3}$","title":"Capability Key"},"target_argument":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$","title":"Target Argument"},"version_argument":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,63}$","title":"Version Argument"}},"additionalProperties":false,"type":"object","required":["capability_key","target_argument","version_argument"],"title":"ReadVersionTarget","description":"Registry-owned precondition mapping, never model-selected JSON paths."},"RecommendationReviewContentV2":{"properties":{"title":{"type":"string","maxLength":240,"minLength":1,"title":"Title"},"rationale":{"type":"string","maxLength":240,"minLength":1,"title":"Rationale"}},"additionalProperties":false,"type":"object","required":["title","rationale"],"title":"RecommendationReviewContentV2","description":"The complete, bounded text surface QA-v2 is authorized to review."},"RecoveryOptionKind":{"type":"string","enum":["retry","refine","clarify"],"title":"RecoveryOptionKind","description":"Closed Core-owned continuation offered after an incomplete turn."},"RecoveryOptionReason":{"type":"string","enum":["stale_evidence","incomplete_collection","source_unavailable","needs_clarification","stopped_early"],"title":"RecoveryOptionReason","description":"Customer-safe reason that a recovery option is available."},"RegistrationFormData":{"properties":{"name":{"type":"string","title":"Name"},"company":{"type":"string","title":"Company"},"title":{"type":"string","title":"Title"},"company_link":{"type":"string","title":"Company Link"},"tos_hash":{"type":"string","title":"Tos Hash"},"tos_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tos Version"},"selected_plan":{"type":"string","title":"Selected Plan","default":"gold"},"billing_interval":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Interval"},"recaptcha_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Recaptcha Token"}},"type":"object","required":["name","company","title","company_link","tos_hash"],"title":"RegistrationFormData","description":"Registration data for a new user creating their own organization."},"RegistrationResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"User Id"},"organization_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Organization Id"},"organization_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Name"},"on_waitlist":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"On Waitlist","default":false},"waitlist_position":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Waitlist Position"},"registration_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Type"},"registration_complete":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Registration Complete"}},"type":"object","required":["success","message"],"title":"RegistrationResponse","description":"Response from registration endpoint (new users creating their own organization)."},"RegistrationTouchRequest":{"properties":{"event_name":{"type":"string","title":"Event Name"},"path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Path"},"phase":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phase"},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata"}},"type":"object","required":["event_name"],"title":"RegistrationTouchRequest","description":"Record a pre-registration page or lifecycle event after Clerk auth."},"RegistrationTouchResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"registration_lead_id":{"type":"string","format":"uuid","title":"Registration Lead Id"},"registration_event_id":{"type":"string","format":"uuid","title":"Registration Event Id"},"current_phase":{"type":"string","title":"Current Phase"}},"type":"object","required":["success","registration_lead_id","registration_event_id","current_phase"],"title":"RegistrationTouchResponse","description":"Response after recording a registration funnel event."},"RelatedSourceArticle":{"properties":{"article_id":{"type":"string","format":"uuid","title":"Article Id"},"title":{"type":"string","title":"Title"},"status":{"type":"string","enum":["generating","ready","failed"],"title":"Status"},"version_changed":{"type":"boolean","title":"Version Changed"},"href":{"type":"string","title":"Href"}},"additionalProperties":false,"type":"object","required":["article_id","title","status","version_changed","href"],"title":"RelatedSourceArticle"},"ReleaseAnnouncementClaimRequest":{"properties":{"spotlight_release_id":{"type":"string","maxLength":128,"minLength":1,"title":"Spotlight Release Id","description":"Stable ID of the release shown as the digest spotlight"},"release_ids":{"items":{"type":"string"},"type":"array","maxItems":50,"minItems":1,"title":"Release Ids","description":"Stable IDs covered by the announcement digest"}},"additionalProperties":false,"type":"object","required":["spotlight_release_id","release_ids"],"title":"ReleaseAnnouncementClaimRequest","description":"Claim one release-announcement spotlight and its visible digest."},"ReleaseAnnouncementClaimResponse":{"properties":{"claimed":{"type":"boolean","title":"Claimed"},"spotlight_release_id":{"type":"string","title":"Spotlight Release Id"},"covered_release_ids":{"items":{"type":"string"},"type":"array","title":"Covered Release Ids"},"claimed_at":{"type":"string","format":"date-time","title":"Claimed At"}},"type":"object","required":["claimed","spotlight_release_id","covered_release_ids","claimed_at"],"title":"ReleaseAnnouncementClaimResponse","description":"Result of atomically claiming a release-announcement spotlight."},"ReplaceImageRequest":{"properties":{"url":{"type":"string","title":"Url"},"image_data":{"type":"string","title":"Image Data"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"}},"type":"object","required":["url","image_data"],"title":"ReplaceImageRequest","description":"Request model for replacing an image."},"ReportReadyBindingInput":{"properties":{"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"work_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Work Id"},"surface":{"type":"string","pattern":"^(web|slack|both)$","title":"Surface","default":"web"},"destination_id":{"anyOf":[{"type":"string","maxLength":191,"minLength":1},{"type":"null"}],"title":"Destination Id"},"connection_generation":{"anyOf":[{"type":"string","maxLength":191},{"type":"null"}],"title":"Connection Generation"}},"additionalProperties":false,"type":"object","required":["conversation_id"],"title":"ReportReadyBindingInput","description":"Client shape; tenant and recipient IDs are filled from auth/context."},"RequirementDisposition":{"type":"string","enum":["satisfied","exhausted","blocked","attempted_incomplete","unattempted"],"title":"RequirementDisposition","description":"Closed terminal state of one accepted material requirement."},"ResearchBrief":{"properties":{"headline":{"type":"string","minLength":1,"title":"Headline","description":"One concise, complete sentence."},"summary":{"type":"string","minLength":1,"title":"Summary","description":"Two or three complete sentences about the supported product facts."},"source_ids":{"items":{"type":"string"},"type":"array","maxItems":6,"minItems":1,"title":"Source Ids"}},"additionalProperties":false,"type":"object","required":["headline","summary","source_ids"],"title":"ResearchBrief"},"ResearchHistoryEntry":{"properties":{"revision_id":{"type":"string","format":"uuid","title":"Revision Id"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"},"evidence_checked_at":{"type":"string","format":"date-time","title":"Evidence Checked At"},"input_hash":{"type":"string","title":"Input Hash"},"is_current":{"type":"boolean","title":"Is Current"},"brief":{"$ref":"#/components/schemas/ResearchBrief"},"buyer_questions":{"items":{"$ref":"#/components/schemas/BuyerQuestion"},"type":"array","title":"Buyer Questions"},"page_review":{"$ref":"#/components/schemas/PageReview"},"sources":{"items":{"$ref":"#/components/schemas/ResearchSource"},"type":"array","title":"Sources"}},"additionalProperties":false,"type":"object","required":["revision_id","generated_at","evidence_checked_at","input_hash","is_current","brief","buyer_questions","page_review","sources"],"title":"ResearchHistoryEntry"},"ResearchHistoryResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ResearchHistoryEntry"},"type":"array","title":"Items"},"next_before":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Next Before"}},"additionalProperties":false,"type":"object","required":["items"],"title":"ResearchHistoryResponse"},"ResearchSettingsRequest":{"properties":{"auto_refresh_enabled":{"type":"boolean","title":"Auto Refresh Enabled"}},"additionalProperties":false,"type":"object","required":["auto_refresh_enabled"],"title":"ResearchSettingsRequest"},"ResearchSource":{"properties":{"id":{"type":"string","title":"Id"},"kind":{"type":"string","enum":["merchant_catalog","saved_strategy","saved_competitive_analysis","observed_product_page"],"title":"Kind"},"title":{"type":"string","title":"Title"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"record_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Record Id"},"recorded_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Recorded At"},"retrieved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Retrieved At"},"content_hash":{"type":"string","title":"Content Hash"}},"additionalProperties":false,"type":"object","required":["id","kind","title","content_hash"],"title":"ResearchSource"},"ResolveVideoSourceRequest":{"properties":{"source_url":{"type":"string","maxLength":4096,"minLength":1,"title":"Source Url"}},"additionalProperties":false,"type":"object","required":["source_url"],"title":"ResolveVideoSourceRequest"},"ResourceRef":{"type":"string","title":"ResourceRef","description":"Stable, tenant-opaque resource reference serialized as a JSON string."},"ResponsibilityPreparationTerms":{"properties":{"scope":{"type":"string","enum":["new_work","selected_work","new_and_selected"],"title":"Scope"},"limits":{"items":{"$ref":"#/components/schemas/NativeEffectLimit"},"type":"array","maxItems":32,"minItems":1,"title":"Limits","description":"Every accepted quantitative limit belongs here, including explicit zero allowances. For example, no new images requires images.generated with maximum 0, not just a prose constraint. Preserve the person's limits exactly; propose missing material limits for confirmation."}},"additionalProperties":false,"type":"object","required":["scope","limits"],"title":"ResponsibilityPreparationTerms","description":"Explicit preparation authority, independent of marketing output format."},"RevenueByChannelResponse":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"source_vendor":{"type":"string","title":"Source Vendor"},"source_channel":{"type":"string","title":"Source Channel"},"gross_revenue_cents":{"type":"integer","title":"Gross Revenue Cents"},"discount_cents":{"type":"integer","title":"Discount Cents"},"refund_cents":{"type":"integer","title":"Refund Cents"},"net_revenue_cents":{"type":"integer","title":"Net Revenue Cents"},"transaction_count":{"type":"integer","title":"Transaction Count"},"avg_order_value_cents":{"type":"integer","title":"Avg Order Value Cents"}},"type":"object","required":["metric_date","source_vendor","source_channel","gross_revenue_cents","discount_cents","refund_cents","net_revenue_cents","transaction_count","avg_order_value_cents"],"title":"RevenueByChannelResponse","description":"Response model for revenue by channel."},"RevenueSummaryResponse":{"properties":{"total_net_revenue_cents":{"type":"integer","title":"Total Net Revenue Cents"},"total_gross_revenue_cents":{"type":"integer","title":"Total Gross Revenue Cents"},"total_discount_cents":{"type":"integer","title":"Total Discount Cents"},"total_refund_cents":{"type":"integer","title":"Total Refund Cents"},"total_transactions":{"type":"integer","title":"Total Transactions"},"total_orders":{"type":"integer","title":"Total Orders"},"avg_order_value_cents":{"type":"integer","title":"Avg Order Value Cents"},"start_date":{"type":"string","title":"Start Date"},"end_date":{"type":"string","title":"End Date"}},"type":"object","required":["total_net_revenue_cents","total_gross_revenue_cents","total_discount_cents","total_refund_cents","total_transactions","total_orders","avg_order_value_cents","start_date","end_date"],"title":"RevenueSummaryResponse","description":"Response model for revenue summary."},"ReviewPacketBlinding":{"properties":{"detector_rationale_visible":{"type":"boolean","const":false,"title":"Detector Rationale Visible","default":false},"detector_confidence_visible":{"type":"boolean","const":false,"title":"Detector Confidence Visible","default":false},"peer_adjudications_visible":{"type":"boolean","const":false,"title":"Peer Adjudications Visible","default":false},"source_decision_visible":{"type":"boolean","const":false,"title":"Source Decision Visible","default":false}},"additionalProperties":false,"type":"object","title":"ReviewPacketBlinding","description":"Truthful attestations for fields withheld from the reviewer.\n\nThe criterion itself is intentionally visible because it is the neutral\nclaim being adjudicated. Detector rationale/confidence, prior human labels,\nand the original source decision are all hidden in GOV-1 v1."},"ReviewPacketFindingRef":{"properties":{"system_finding_id":{"type":"string","format":"uuid","title":"System Finding Id"},"event_id":{"type":"string","format":"uuid","title":"Event Id"},"sequence":{"type":"integer","minimum":1.0,"title":"Sequence"},"content_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Content Hash"},"processor_key":{"type":"string","enum":["reports_output_qa","reports_action_outcome"],"title":"Processor Key"},"processor_version":{"type":"string","maxLength":64,"minLength":1,"title":"Processor Version"}},"additionalProperties":false,"type":"object","required":["system_finding_id","event_id","sequence","content_hash","processor_key","processor_version"],"title":"ReviewPacketFindingRef"},"ReviewPacketSourceRef":{"properties":{"event_id":{"type":"string","format":"uuid","title":"Event Id"},"sequence":{"type":"integer","minimum":1.0,"title":"Sequence"},"content_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Content Hash"}},"additionalProperties":false,"type":"object","required":["event_id","sequence","content_hash"],"title":"ReviewPacketSourceRef"},"ReviewPacketTarget":{"properties":{"kind":{"type":"string","enum":["qa_issue","qa_quality_claim","outcome_observation"],"title":"Kind"},"key":{"type":"string","maxLength":191,"minLength":1,"title":"Key"},"criterion":{"type":"string","maxLength":96,"minLength":1,"title":"Criterion"}},"additionalProperties":false,"type":"object","required":["kind","key","criterion"],"title":"ReviewPacketTarget"},"SEORecommendationStatusRequest":{"properties":{"status":{"type":"string","enum":["open","done","dismissed"],"title":"Status"}},"type":"object","required":["status"],"title":"SEORecommendationStatusRequest","description":"One user-set fix status for an SEO recommendation."},"SHCustomerOverviewResponse":{"properties":{"year_month":{"type":"string","title":"Year Month"},"total_customers":{"type":"integer","title":"Total Customers"},"new_customers":{"type":"integer","title":"New Customers"},"returning_customers":{"type":"integer","title":"Returning Customers"},"avg_orders_per_customer":{"type":"number","title":"Avg Orders Per Customer"},"avg_lifetime_value_cents":{"type":"integer","title":"Avg Lifetime Value Cents"},"marketing_opted_in":{"type":"integer","title":"Marketing Opted In"}},"type":"object","required":["year_month","total_customers","new_customers","returning_customers","avg_orders_per_customer","avg_lifetime_value_cents","marketing_opted_in"],"title":"SHCustomerOverviewResponse","description":"Monthly Shopify customer overview response."},"SHDailySalesResponse":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"order_count":{"type":"integer","title":"Order Count"},"gross_sales_cents":{"type":"integer","title":"Gross Sales Cents"},"net_sales_cents":{"type":"integer","title":"Net Sales Cents"},"total_discount_cents":{"type":"integer","title":"Total Discount Cents"},"total_tax_cents":{"type":"integer","title":"Total Tax Cents"},"avg_order_value_cents":{"type":"integer","title":"Avg Order Value Cents"},"unique_customers":{"type":"integer","title":"Unique Customers"}},"type":"object","required":["metric_date","order_count","gross_sales_cents","net_sales_cents","total_discount_cents","total_tax_cents","avg_order_value_cents","unique_customers"],"title":"SHDailySalesResponse","description":"Daily Shopify sales metrics response."},"SHFulfillmentStatusResponse":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"pending_count":{"type":"integer","title":"Pending Count"},"fulfilled_count":{"type":"integer","title":"Fulfilled Count"},"partial_count":{"type":"integer","title":"Partial Count"},"unfulfilled_count":{"type":"integer","title":"Unfulfilled Count"},"fulfillment_rate":{"type":"number","title":"Fulfillment Rate"}},"type":"object","required":["metric_date","pending_count","fulfilled_count","partial_count","unfulfilled_count","fulfillment_rate"],"title":"SHFulfillmentStatusResponse","description":"Daily Shopify fulfillment status response."},"SHProductCatalogResponse":{"properties":{"product_id":{"type":"string","title":"Product Id"},"product_name":{"type":"string","title":"Product Name"},"product_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Type"},"vendor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vendor"},"status":{"type":"string","title":"Status"},"variant_count":{"type":"integer","title":"Variant Count"},"total_inventory":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Inventory"},"shopify_product_gid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shopify Product Gid"}},"type":"object","required":["product_id","product_name","status","variant_count"],"title":"SHProductCatalogResponse","description":"Shopify product catalog entry."},"SHRangeSummaryResponse":{"properties":{"total_orders":{"type":"integer","title":"Total Orders"},"total_gross_sales_cents":{"type":"integer","title":"Total Gross Sales Cents"},"total_net_revenue_cents":{"type":"integer","title":"Total Net Revenue Cents"},"avg_order_value_cents":{"type":"integer","title":"Avg Order Value Cents"},"total_unique_customers":{"type":"integer","title":"Total Unique Customers"},"total_products":{"type":"integer","title":"Total Products"},"total_inventory":{"type":"integer","title":"Total Inventory"},"fulfillment_rate":{"type":"number","title":"Fulfillment Rate"}},"type":"object","required":["total_orders","total_gross_sales_cents","total_net_revenue_cents","avg_order_value_cents","total_unique_customers","total_products","total_inventory","fulfillment_rate"],"title":"SHRangeSummaryResponse","description":"Shopify summary for a date range response."},"SHTransactionResponse":{"properties":{"sh_token":{"type":"string","title":"Sh Token"},"order_id":{"type":"string","title":"Order Id"},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"},"financial_status":{"type":"string","title":"Financial Status"},"fulfillment_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fulfillment Status"},"total_price_cents":{"type":"integer","title":"Total Price Cents"},"order_date":{"type":"string","format":"date","title":"Order Date"},"shopify_order_gid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shopify Order Gid"},"shopify_customer_gid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shopify Customer Gid"}},"type":"object","required":["sh_token","order_id","financial_status","total_price_cents","order_date"],"title":"SHTransactionResponse","description":"Single Shopify order from Silver tables."},"SKU":{"properties":{"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"target_audience":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Target Audience","default":[]},"key_features":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Key Features","default":[]},"sku_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Sku Urls","default":[]},"images":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Images","default":[]},"primary_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Category","default":""},"subcategories":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Subcategories","default":[]},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags","default":[]},"attributes":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attributes","default":{}},"source_urls":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Source Urls","default":[]},"business_characteristics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Business Characteristics","default":[]},"offering_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Offering Type","default":"primary"},"price_list":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Price List","default":[]},"extraction_metadata":{"anyOf":[{"$ref":"#/components/schemas/ProductOfferingExtractionMetadata"},{"type":"null"}]}},"type":"object","required":["name","description"],"title":"SKU"},"SQDailySalesByLocationResponse":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"location_id":{"type":"string","title":"Location Id"},"location_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Name"},"order_count":{"type":"integer","title":"Order Count"},"gross_sales_cents":{"type":"integer","title":"Gross Sales Cents"},"net_sales_cents":{"type":"integer","title":"Net Sales Cents"},"payment_count":{"type":"integer","title":"Payment Count"},"total_collected_cents":{"type":"integer","title":"Total Collected Cents"},"refund_count":{"type":"integer","title":"Refund Count"},"total_refunded_cents":{"type":"integer","title":"Total Refunded Cents"},"unique_customers":{"type":"integer","title":"Unique Customers"}},"type":"object","required":["metric_date","location_id","order_count","gross_sales_cents","net_sales_cents","payment_count","total_collected_cents","refund_count","total_refunded_cents","unique_customers"],"title":"SQDailySalesByLocationResponse","description":"Daily Square sales by location response."},"SQDailySalesResponse":{"properties":{"metric_date":{"type":"string","format":"date","title":"Metric Date"},"order_count":{"type":"integer","title":"Order Count"},"completed_order_count":{"type":"integer","title":"Completed Order Count"},"canceled_order_count":{"type":"integer","title":"Canceled Order Count"},"gross_sales_cents":{"type":"integer","title":"Gross Sales Cents"},"total_discount_cents":{"type":"integer","title":"Total Discount Cents"},"total_tax_cents":{"type":"integer","title":"Total Tax Cents"},"total_tip_cents":{"type":"integer","title":"Total Tip Cents"},"net_sales_cents":{"type":"integer","title":"Net Sales Cents"},"payment_count":{"type":"integer","title":"Payment Count"},"total_collected_cents":{"type":"integer","title":"Total Collected Cents"},"refund_count":{"type":"integer","title":"Refund Count"},"total_refunded_cents":{"type":"integer","title":"Total Refunded Cents"},"net_revenue_cents":{"type":"integer","title":"Net Revenue Cents"},"avg_order_value_cents":{"type":"integer","title":"Avg Order Value Cents"},"unique_customers":{"type":"integer","title":"Unique Customers"}},"type":"object","required":["metric_date","order_count","completed_order_count","canceled_order_count","gross_sales_cents","total_discount_cents","total_tax_cents","total_tip_cents","net_sales_cents","payment_count","total_collected_cents","refund_count","total_refunded_cents","net_revenue_cents","avg_order_value_cents","unique_customers"],"title":"SQDailySalesResponse","description":"Daily Square sales metrics response."},"SQLocationSalesResponse":{"properties":{"year_month":{"type":"string","title":"Year Month"},"location_id":{"type":"string","title":"Location Id"},"location_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Name"},"order_count":{"type":"integer","title":"Order Count"},"unique_customers":{"type":"integer","title":"Unique Customers"},"gross_sales_cents":{"type":"integer","title":"Gross Sales Cents"},"net_sales_cents":{"type":"integer","title":"Net Sales Cents"},"avg_order_value_cents":{"type":"integer","title":"Avg Order Value Cents"}},"type":"object","required":["year_month","location_id","order_count","unique_customers","gross_sales_cents","net_sales_cents","avg_order_value_cents"],"title":"SQLocationSalesResponse","description":"Monthly location-level Square sales response."},"SQProductSalesResponse":{"properties":{"year_month":{"type":"string","title":"Year Month"},"catalog_object_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Catalog Object Id"},"product_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Name"},"variation_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variation Name"},"units_sold":{"type":"number","title":"Units Sold"},"order_count":{"type":"integer","title":"Order Count"},"gross_revenue_cents":{"type":"integer","title":"Gross Revenue Cents"},"discount_cents":{"type":"integer","title":"Discount Cents"},"net_revenue_cents":{"type":"integer","title":"Net Revenue Cents"},"avg_unit_price_cents":{"type":"integer","title":"Avg Unit Price Cents"}},"type":"object","required":["year_month","units_sold","order_count","gross_revenue_cents","discount_cents","net_revenue_cents","avg_unit_price_cents"],"title":"SQProductSalesResponse","description":"Product-level Square sales response."},"SQRangeSummaryResponse":{"properties":{"total_gross_sales_cents":{"type":"integer","title":"Total Gross Sales Cents"},"total_net_revenue_cents":{"type":"integer","title":"Total Net Revenue Cents"},"total_orders":{"type":"integer","title":"Total Orders"},"total_refunds":{"type":"integer","title":"Total Refunds"},"avg_order_value_cents":{"type":"integer","title":"Avg Order Value Cents"},"total_unique_customers":{"type":"integer","title":"Total Unique Customers"},"total_collected_cents":{"type":"integer","title":"Total Collected Cents"},"total_refunded_cents":{"type":"integer","title":"Total Refunded Cents"}},"type":"object","required":["total_gross_sales_cents","total_net_revenue_cents","total_orders","total_refunds","avg_order_value_cents","total_unique_customers","total_collected_cents","total_refunded_cents"],"title":"SQRangeSummaryResponse","description":"Square summary for a date range response."},"SQTransactionResponse":{"properties":{"sq_token":{"type":"string","title":"Sq Token"},"entity_type":{"type":"string","title":"Entity Type"},"transaction_id":{"type":"string","title":"Transaction Id"},"location_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Id"},"order_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Order Id"},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"},"amount_cents":{"type":"integer","title":"Amount Cents"},"status":{"type":"string","title":"Status"},"source_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Type"},"transaction_date":{"type":"string","format":"date","title":"Transaction Date"}},"type":"object","required":["sq_token","entity_type","transaction_id","amount_cents","status","transaction_date"],"title":"SQTransactionResponse","description":"Single Square transaction from Silver tables."},"SaveCreatorOutreachDraftRequest":{"properties":{"channel":{"type":"string","maxLength":64,"minLength":1,"title":"Channel"},"target_label":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Target Label"},"target_value":{"type":"string","maxLength":500,"minLength":1,"title":"Target Value"},"subject":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Subject"},"message":{"type":"string","maxLength":4000,"minLength":1,"title":"Message"},"last_prompt":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Last Prompt"}},"type":"object","required":["channel","target_value","message"],"title":"SaveCreatorOutreachDraftRequest"},"SavedArtifactSubject":{"properties":{"kind":{"type":"string","const":"artifact","title":"Kind","default":"artifact"},"artifact_ref":{"$ref":"#/components/schemas/ResourceRef"},"linked_work_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Linked Work Id"},"observed_work_revision":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Observed Work Revision"},"observed_artifact_revision":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Observed Artifact Revision"}},"additionalProperties":false,"type":"object","required":["artifact_ref"],"title":"SavedArtifactSubject","description":"Untrusted client selection of an exact saved artifact."},"SavedEmailBody":{"properties":{"source_kind":{"type":"string","enum":["marketing_email_campaign","crm_outreach_draft"],"title":"Source Kind"},"ref":{"$ref":"#/components/schemas/ResourceRef"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Version"},"scope":{"$ref":"#/components/schemas/CapturedReadScope"},"body_format":{"type":"string","enum":["html","plain_text"],"title":"Body Format"},"workflow_status":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Workflow Status"},"target_audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Audience"},"from_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From Name"},"reply_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reply To"},"recipient_name":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Recipient Name"},"recipient_email":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Recipient Email"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"kind":{"type":"string","const":"saved_email_body_v1","title":"Kind","default":"saved_email_body_v1"},"subject":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subject"},"body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Body"},"subject_characters":{"type":"integer","minimum":0.0,"title":"Subject Characters"},"body_characters":{"type":"integer","minimum":0.0,"title":"Body Characters"}},"additionalProperties":false,"type":"object","required":["source_kind","ref","version","scope","body_format","subject","body","subject_characters","body_characters"],"title":"SavedEmailBody"},"SavedEmailPreview":{"properties":{"source_kind":{"type":"string","enum":["marketing_email_campaign","crm_outreach_draft"],"title":"Source Kind"},"ref":{"$ref":"#/components/schemas/ResourceRef"},"version":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Version"},"scope":{"$ref":"#/components/schemas/CapturedReadScope"},"body_format":{"type":"string","enum":["html","plain_text"],"title":"Body Format"},"workflow_status":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Workflow Status"},"target_audience":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Audience"},"from_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"From Name"},"reply_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reply To"},"recipient_name":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Recipient Name"},"recipient_email":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Recipient Email"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"kind":{"type":"string","const":"saved_email_preview_v1","title":"Kind","default":"saved_email_preview_v1"},"subject_preview":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Subject Preview"},"subject_characters":{"type":"integer","minimum":0.0,"title":"Subject Characters"},"subject_truncated":{"type":"boolean","title":"Subject Truncated"},"body_characters":{"type":"integer","minimum":0.0,"title":"Body Characters"},"body_href":{"type":"string","maxLength":1000,"minLength":1,"title":"Body Href"},"metadata_original_characters":{"anyOf":[{"additionalProperties":{"type":"integer","minimum":1.0},"propertyNames":{"enum":["target_audience","from_name","reply_to"]},"type":"object","maxProperties":3},{"type":"null"}],"title":"Metadata Original Characters"}},"additionalProperties":false,"type":"object","required":["source_kind","ref","version","scope","body_format","subject_characters","subject_truncated","body_characters","body_href"],"title":"SavedEmailPreview"},"SavedWorkSubject":{"properties":{"kind":{"type":"string","const":"work","title":"Kind","default":"work"},"work_id":{"type":"string","format":"uuid","title":"Work Id"},"observed_work_revision":{"type":"integer","minimum":1.0,"title":"Observed Work Revision"},"artifact_ref":{"anyOf":[{"$ref":"#/components/schemas/ResourceRef"},{"type":"null"}]},"observed_artifact_revision":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Observed Artifact Revision"}},"additionalProperties":false,"type":"object","required":["work_id","observed_work_revision"],"title":"SavedWorkSubject","description":"Untrusted client selection of one saved work item.\n\nThis is a pointer only. Core resolves the work and its current operation\nbefore it is copied into :class:`TurnRequest`."},"ScanResponse":{"properties":{"competitor_id":{"type":"string","format":"uuid","title":"Competitor Id"},"competitor_name":{"type":"string","title":"Competitor Name"},"scanned_at":{"type":"string","title":"Scanned At"},"campaigns_found":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Campaigns Found"},"errors":{"items":{"type":"string"},"type":"array","title":"Errors"}},"type":"object","required":["competitor_id","competitor_name","scanned_at","campaigns_found","errors"],"title":"ScanResponse","description":"Response from competitor scan."},"ScreenshotUploadResponse":{"properties":{"screenshot_url":{"type":"string","title":"Screenshot Url","description":"URL of the uploaded screenshot"}},"type":"object","required":["screenshot_url"],"title":"ScreenshotUploadResponse","description":"Response schema for screenshot upload."},"SectionDisposition":{"type":"string","enum":["complete","partial","blocked","unavailable","not_attempted"],"title":"SectionDisposition","description":"Closed aggregate state for a server-owned answer section."},"SeenRevision":{"properties":{"card_id":{"type":"string","format":"uuid","title":"Card Id"},"revision":{"type":"integer","minimum":1.0,"title":"Revision"}},"type":"object","required":["card_id","revision"],"title":"SeenRevision"},"SendCampaignRequest":{"properties":{"campaign_id":{"type":"integer","title":"Campaign Id"},"consumer_group_ids":{"items":{"type":"integer"},"type":"array","title":"Consumer Group Ids"},"scheduled_time":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Scheduled Time"},"ab_test_config":{"anyOf":[{"$ref":"#/components/schemas/ABTestConfig"},{"type":"null"}]}},"type":"object","required":["campaign_id","consumer_group_ids"],"title":"SendCampaignRequest","description":"Request to send campaign"},"SendOrganizationInviteEmailRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"}},"type":"object","required":["email"],"title":"SendOrganizationInviteEmailRequest","description":"Request payload for sending an invite email to a prospective member."},"SendOrganizationInviteEmailResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","message"],"title":"SendOrganizationInviteEmailResponse","description":"Response returned after attempting to send an invite email."},"Settings":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"version":{"type":"string","maxLength":36,"minLength":1,"title":"Version"},"pinned_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":1000,"title":"Pinned Ids"}},"type":"object","required":["enabled","version","pinned_ids"],"title":"Settings"},"ShareFileResponse":{"properties":{"id":{"type":"string","title":"Id"},"filename":{"type":"string","title":"Filename"},"is_shared":{"type":"boolean","title":"Is Shared"},"message":{"type":"string","title":"Message"}},"type":"object","required":["id","filename","is_shared","message"],"title":"ShareFileResponse"},"SharedFileItem":{"properties":{"id":{"type":"string","title":"Id"},"filename":{"type":"string","title":"Filename"},"file_type":{"type":"string","title":"File Type"},"file_size":{"type":"integer","title":"File Size"},"file_url":{"type":"string","title":"File Url"},"summary_preview":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary Preview"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"owner_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner Email"},"is_owner":{"type":"boolean","title":"Is Owner","default":false},"is_shared":{"type":"boolean","title":"Is Shared","default":true}},"type":"object","required":["id","filename","file_type","file_size","file_url","created_at"],"title":"SharedFileItem","description":"Schema for a shared file in the knowledge base"},"SharedFilesResponse":{"properties":{"files":{"items":{"$ref":"#/components/schemas/SharedFileItem"},"type":"array","title":"Files"},"total":{"type":"integer","title":"Total"},"page":{"type":"integer","title":"Page"},"total_pages":{"type":"integer","title":"Total Pages"}},"type":"object","required":["files","total","page","total_pages"],"title":"SharedFilesResponse","description":"Response for shared files list endpoint"},"ShopifyInstallResolveRequestModel":{"properties":{"claim_handle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Claim Handle","description":"Optional legacy URL claim; when present it must match the httpOnly claim cookie"},"chosen_organization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chosen Organization Id","description":"Org selected for the multi-org case"},"chosen_company_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chosen Company Profile Id","description":"Existing matched profile selected to connect"},"chosen_create_new":{"type":"boolean","title":"Chosen Create New","description":"User opted to start a new brand profile instead of a match","default":false},"chosen_new_organization":{"type":"boolean","title":"Chosen New Organization","description":"User chose a separate Shopify client business for this store","default":false}},"type":"object","title":"ShopifyInstallResolveRequestModel"},"ShopifyRegistrationFormData":{"properties":{"name":{"type":"string","title":"Name"},"company":{"type":"string","title":"Company"},"title":{"type":"string","title":"Title"},"company_link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Link"},"tos_hash":{"type":"string","title":"Tos Hash"},"tos_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tos Version"}},"type":"object","required":["name","company","title","tos_hash"],"title":"ShopifyRegistrationFormData","description":"Account details for a merchant arriving from a verified Shopify install.\n\nShopify owns plan selection and billing for this path, so Stripe plan and\nbilling-interval fields are intentionally absent. The endpoint validates a\nbrowser-bound Shopify claim before this data can create a user. The website\nis optional because the verified shop's storefront URL is used when omitted."},"ShopifyShopResponseModel":{"properties":{"connected":{"type":"boolean","title":"Connected","description":"Whether the platform is connected"},"account":{"anyOf":[{"$ref":"#/components/schemas/DataSourceAccountInfo"},{"type":"null"}],"description":"Account details if connected"},"shop":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Shop","description":"Shop details"}},"type":"object","required":["connected"],"title":"ShopifyShopResponseModel","description":"Response model for shop information."},"ShopifyStatusResponseModel":{"properties":{"connected":{"type":"boolean","title":"Connected","description":"Whether the platform is connected"},"healthy":{"type":"boolean","title":"Healthy","description":"Whether the token is healthy (passed API check)","default":false},"health_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Health Message","description":"Health check result message"},"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id","description":"Platform-specific account identifier"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name","description":"Display name for the account"},"token_expires_soon":{"type":"boolean","title":"Token Expires Soon","description":"Whether token expires within buffer period","default":false},"last_health_check":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Health Check","description":"ISO timestamp of last health check"},"shop_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shop Domain","description":"Shopify store domain"},"shop_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shop Name","description":"Shop name"},"capabilities":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Capabilities","description":"Approved Shopify data capabilities"}},"type":"object","required":["connected"],"title":"ShopifyStatusResponseModel","description":"Response model for connection status with health check.","example":{"account_id":"shop_12345","account_name":"My Store","connected":true,"health_message":"Token is valid","healthy":true,"last_health_check":"2024-01-15T10:30:00Z","token_expires_soon":false}},"ShopifySubscriptionSummary":{"properties":{"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"shop_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Shop Domain"},"billing_status":{"type":"string","title":"Billing Status","default":"unbound"},"verification_state":{"type":"string","enum":["current","stale","unavailable"],"title":"Verification State","default":"unavailable"},"plan_handle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Handle"},"billing_interval":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Interval"},"cancel_at_period_end":{"type":"boolean","title":"Cancel At Period End","default":false},"trial_ends_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Trial Ends At"},"current_period_ends_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Current Period Ends At"},"verified_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Verified At"},"pricing_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pricing Url"}},"type":"object","required":["company_profile_id"],"title":"ShopifySubscriptionSummary"},"ShortenedURL":{"properties":{"long_url":{"type":"string","title":"Long Url"},"campaign_id":{"type":"string","title":"Campaign Id"},"short_code":{"type":"string","title":"Short Code"},"short_url":{"type":"string","title":"Short Url"}},"type":"object","required":["long_url","campaign_id","short_code","short_url"],"title":"ShortenedURL","description":"Full shortened URL model"},"ShortenedURLCreate":{"properties":{"long_url":{"type":"string","title":"Long Url"},"campaign_id":{"type":"string","title":"Campaign Id"}},"type":"object","required":["long_url","campaign_id"],"title":"ShortenedURLCreate","description":"Schema for creating a shortened URL"},"SignedUrlResponse":{"properties":{"signed_url":{"type":"string","title":"Signed Url"},"expires_in_seconds":{"type":"integer","title":"Expires In Seconds"}},"type":"object","required":["signed_url","expires_in_seconds"],"title":"SignedUrlResponse"},"SlackChannelAudienceResponse":{"properties":{"member_count":{"type":"integer","title":"Member Count","default":0},"classified_count":{"type":"integer","title":"Classified Count","default":0},"with_access":{"items":{"type":"string"},"type":"array","title":"With Access"},"without_access":{"items":{"type":"string"},"type":"array","title":"Without Access"},"is_externally_shared":{"type":"boolean","title":"Is Externally Shared","default":false},"is_private":{"type":"boolean","title":"Is Private","default":false},"sharing_known":{"type":"boolean","title":"Sharing Known","default":false},"unavailable_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unavailable Reason"},"roster_capped":{"type":"boolean","title":"Roster Capped","default":false}},"type":"object","title":"SlackChannelAudienceResponse","description":"Who will be able to read this profile's data once the channel is bound.\n\nA bot reply is an ordinary channel message, so binding grants every member\n— now and later — read access to whatever the assistant answers. Surfacing\nthe split is the difference between an informed grant and an invisible one."},"SlackChannelBindRequest":{"properties":{"slack_channel_id":{"type":"string","maxLength":64,"minLength":2,"title":"Slack Channel Id"},"slack_channel_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Slack Channel Name"}},"type":"object","required":["slack_channel_id"],"title":"SlackChannelBindRequest"},"SlackChannelBindResponse":{"properties":{"bound":{"type":"boolean","title":"Bound"},"binding":{"anyOf":[{"$ref":"#/components/schemas/SlackChannelBindingResponse"},{"type":"null"}]},"notices":{"items":{"type":"string"},"type":"array","title":"Notices"},"audience":{"anyOf":[{"$ref":"#/components/schemas/SlackChannelAudienceResponse"},{"type":"null"}]}},"type":"object","required":["bound"],"title":"SlackChannelBindResponse"},"SlackChannelBindingResponse":{"properties":{"slack_channel_id":{"type":"string","title":"Slack Channel Id"},"slack_channel_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slack Channel Name"},"company_profile_id":{"type":"string","title":"Company Profile Id"},"company_profile_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Name"},"bound_by_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bound By Email"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["slack_channel_id","company_profile_id"],"title":"SlackChannelBindingResponse"},"SlackChannelBindingsListResponse":{"properties":{"bindings":{"items":{"$ref":"#/components/schemas/SlackChannelBindingResponse"},"type":"array","title":"Bindings"}},"type":"object","title":"SlackChannelBindingsListResponse"},"SlackChannelResponse":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"is_private":{"type":"boolean","title":"Is Private","default":false},"is_member":{"type":"boolean","title":"Is Member","default":false}},"type":"object","required":["id","name"],"title":"SlackChannelResponse"},"SlackChannelsListResponse":{"properties":{"channels":{"items":{"$ref":"#/components/schemas/SlackChannelResponse"},"type":"array","title":"Channels"}},"type":"object","title":"SlackChannelsListResponse"},"SlackLinkRequest":{"properties":{"slack_user_id":{"type":"string","maxLength":64,"minLength":2,"title":"Slack User Id"},"slack_team_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Slack Team Id"},"slack_user_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Slack User Name"}},"type":"object","required":["slack_user_id"],"title":"SlackLinkRequest"},"SlackLinkResponse":{"properties":{"linked":{"type":"boolean","title":"Linked"},"slack_team_id":{"type":"string","title":"Slack Team Id"},"slack_user_id":{"type":"string","title":"Slack User Id"}},"type":"object","required":["linked","slack_team_id","slack_user_id"],"title":"SlackLinkResponse"},"SlackProactiveApproverResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","required":["user_id"],"title":"SlackProactiveApproverResponse"},"SlackProactiveConsentRequest":{"properties":{"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"conversation_id":{"type":"string","format":"uuid","title":"Conversation Id"},"slack_team_id":{"type":"string","maxLength":64,"minLength":1,"title":"Slack Team Id"},"slack_channel_id":{"type":"string","maxLength":64,"minLength":1,"title":"Slack Channel Id"},"install_key":{"type":"string","maxLength":64,"minLength":1,"title":"Install Key"},"connection_generation":{"type":"string","maxLength":191,"minLength":1,"title":"Connection Generation"},"enabled":{"type":"boolean","title":"Enabled"},"reason":{"type":"string","enum":["explicit_opt_in","same_initiating_dm","user_stop"],"title":"Reason"}},"additionalProperties":false,"type":"object","required":["organization_id","company_profile_id","conversation_id","slack_team_id","slack_channel_id","install_key","connection_generation","enabled","reason"],"title":"SlackProactiveConsentRequest"},"SlackProactiveSettingsResponse":{"properties":{"enabled":{"type":"boolean","title":"Enabled","default":false},"channel_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Channel Id"},"channel_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Channel Name"},"channel_pinned":{"type":"boolean","title":"Channel Pinned","default":false},"approvers":{"items":{"$ref":"#/components/schemas/SlackProactiveApproverResponse"},"type":"array","title":"Approvers"},"can_manage":{"type":"boolean","title":"Can Manage","default":false},"notices":{"items":{"type":"string"},"type":"array","title":"Notices"}},"type":"object","title":"SlackProactiveSettingsResponse","description":"What Pomo may post in this workspace on its own (MAC-462)."},"SlackProactiveSettingsUpdateRequest":{"properties":{"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"channel_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Channel Id"}},"type":"object","title":"SlackProactiveSettingsUpdateRequest","description":"A partial update: only the fields sent change; null clears a field."},"SlackSettingsUpdateRequest":{"properties":{"default_channel_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Default Channel Id"},"allowlist_patterns":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowlist Patterns","description":"Optional Slack email allowlist patterns (e.g. *@machflow.ai, user@domain.com, @domain.com)"},"default_markee_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Default Markee User Id","description":"Pomo user that allowlisted Slack users act as. Required before an allowlist can be saved; choose the least-privileged account that can do the work, since every matching Slack user inherits its access."}},"type":"object","title":"SlackSettingsUpdateRequest"},"SlackStatusResponse":{"properties":{"connected":{"type":"boolean","title":"Connected","description":"Whether the platform is connected"},"healthy":{"type":"boolean","title":"Healthy","description":"Whether the token is healthy (passed API check)","default":false},"health_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Health Message","description":"Health check result message"},"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id","description":"Platform-specific account identifier"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name","description":"Display name for the account"},"token_expires_soon":{"type":"boolean","title":"Token Expires Soon","description":"Whether token expires within buffer period","default":false},"last_health_check":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Health Check","description":"ISO timestamp of last health check"},"rollout_admitted":{"type":"boolean","title":"Rollout Admitted","default":false},"rollout_reason":{"type":"string","title":"Rollout Reason","default":"enabled"},"connect_allowed":{"type":"boolean","title":"Connect Allowed","default":false},"reauthorization_required":{"type":"boolean","title":"Reauthorization Required","description":"The profile is still bound to a workspace, but Slack no longer accepts Pomo's token for it (the app was removed or the token revoked). Nothing can be posted until someone reconnects.","default":false},"team_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Id"},"team_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team Name"},"workspace_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workspace Url"},"bot_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bot User Id"},"default_channel_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default Channel Id"},"linked_slack_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linked Slack User Id"},"linked_slack_user_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linked Slack User Name"},"allowlist_patterns":{"items":{"type":"string"},"type":"array","title":"Allowlist Patterns"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"notices":{"items":{"type":"string"},"type":"array","title":"Notices","description":"Plain-language explanations of anything in the request that was not applied. Not-yet-having-access is an expected state, not an error, so it is reported here and the rest of the settings still save. The other fields always reflect what is actually stored, so the caller can see what did and did not take effect."}},"type":"object","required":["connected"],"title":"SlackStatusResponse","example":{"account_id":"shop_12345","account_name":"My Store","connected":true,"health_message":"Token is valid","healthy":true,"last_health_check":"2024-01-15T10:30:00Z","token_expires_soon":false}},"SocialListeningCitationSentimentResponse":{"properties":{"citation_id":{"type":"string","title":"Citation Id"},"sentiment_label":{"type":"string","enum":["positive","neutral","negative"],"title":"Sentiment Label"}},"type":"object","required":["citation_id","sentiment_label"],"title":"SocialListeningCitationSentimentResponse"},"SocialListeningMarketerSignalResponse":{"properties":{"category":{"type":"string","enum":["Demand","Barrier","Opportunity","Risk","Signal"],"title":"Category"},"text":{"type":"string","title":"Text"}},"type":"object","required":["category","text"],"title":"SocialListeningMarketerSignalResponse"},"SocialListeningSettingsResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"company_profile_id":{"type":"string","title":"Company Profile Id"},"lookback_days":{"type":"integer","title":"Lookback Days"},"allowed_lookback_days":{"items":{"type":"integer"},"type":"array","title":"Allowed Lookback Days"},"custom_query_terms":{"items":{"type":"string"},"type":"array","title":"Custom Query Terms"},"excluded_query_terms":{"items":{"type":"string"},"type":"array","title":"Excluded Query Terms"},"source_scope":{"items":{"type":"string"},"type":"array","title":"Source Scope"},"include_company_targets":{"type":"boolean","title":"Include Company Targets","default":true},"include_competitor_targets":{"type":"boolean","title":"Include Competitor Targets","default":true},"include_product_targets":{"type":"boolean","title":"Include Product Targets","default":true},"max_custom_query_terms":{"type":"integer","title":"Max Custom Query Terms"},"max_query_term_length":{"type":"integer","title":"Max Query Term Length"},"available_query_platforms":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Available Query Platforms"},"active_target_query_terms":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Active Target Query Terms"},"target_query_overrides":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Target Query Overrides"},"metadata_json":{"additionalProperties":true,"type":"object","title":"Metadata Json"},"updated_by_user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated By User Id"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["company_profile_id","lookback_days","max_custom_query_terms","max_query_term_length"],"title":"SocialListeningSettingsResponse"},"SocialListeningSettingsUpdateRequest":{"properties":{"lookback_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Lookback Days"},"custom_query_terms":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Custom Query Terms"},"target_query_overrides":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Target Query Overrides"}},"type":"object","title":"SocialListeningSettingsUpdateRequest"},"SocialListeningSummaryAnalysisItemResponse":{"properties":{"theme_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Theme Key"},"title":{"type":"string","title":"Title"},"analysis":{"type":"string","title":"Analysis"},"recommendation":{"type":"string","title":"Recommendation"},"drivers":{"items":{"type":"string"},"type":"array","title":"Drivers"},"marketer_signals":{"items":{"$ref":"#/components/schemas/SocialListeningMarketerSignalResponse"},"type":"array","title":"Marketer Signals"},"citations":{"items":{"$ref":"#/components/schemas/SocialListeningSummaryCitationResponse"},"type":"array","title":"Citations"},"citation_mention_ids":{"items":{"type":"string"},"type":"array","title":"Citation Mention Ids"},"group_citation_ids":{"items":{"type":"string"},"type":"array","title":"Group Citation Ids"},"group_mention_ids":{"items":{"type":"string"},"type":"array","title":"Group Mention Ids"},"group_metrics":{"additionalProperties":true,"type":"object","title":"Group Metrics"},"citation_sentiments":{"items":{"$ref":"#/components/schemas/SocialListeningCitationSentimentResponse"},"type":"array","title":"Citation Sentiments"},"theme_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Theme Type"},"priority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority"},"sentiment_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentiment Label"}},"type":"object","required":["title","analysis","recommendation"],"title":"SocialListeningSummaryAnalysisItemResponse"},"SocialListeningSummaryCitationResponse":{"properties":{"citation_id":{"type":"string","title":"Citation Id"},"mention_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mention Id"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Type"},"content_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Id"},"platform_post_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform Post Id"},"platform_comment_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform Comment Id"},"canonical_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Canonical Url"},"permalink":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Permalink"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"author":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author"},"community_prefixed":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Community Prefixed"},"target_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Type"},"target_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Name"},"competitor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Competitor Name"},"product_offering_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Offering Name"},"created_datetime":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created Datetime"},"engagement_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Engagement Count"},"sentiment_label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sentiment Label"}},"type":"object","required":["citation_id"],"title":"SocialListeningSummaryCitationResponse"},"SocialListeningSummaryResponse":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"company_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Id"},"summary_markdown":{"type":"string","title":"Summary Markdown"},"analysis_items":{"items":{"$ref":"#/components/schemas/SocialListeningSummaryAnalysisItemResponse"},"type":"array","title":"Analysis Items"},"model_name":{"type":"string","title":"Model Name"},"mention_count":{"type":"integer","title":"Mention Count"},"lookback_days":{"type":"integer","title":"Lookback Days"},"latest_mention_created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Mention Created At"},"generated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Generated At"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"},"is_cached":{"type":"boolean","title":"Is Cached"},"summary_metadata":{"additionalProperties":true,"type":"object","title":"Summary Metadata"}},"type":"object","required":["summary_markdown","model_name","mention_count","lookback_days","is_cached"],"title":"SocialListeningSummaryResponse"},"SocialPostBody":{"properties":{"post_ref":{"$ref":"#/components/schemas/ResourceRef"},"creative_state_token":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Creative State Token"},"schedule_state_token":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"type":"null"}],"title":"Schedule State Token"},"caption":{"type":"string","title":"Caption"},"hashtags":{"items":{"type":"string"},"type":"array","title":"Hashtags","default":[]},"media":{"items":{"$ref":"#/components/schemas/SocialPostMedia"},"type":"array","title":"Media","default":[]},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"post_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Post Type"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"scheduled_for":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Scheduled For"},"posted_at":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Posted At"},"requires_video_render":{"type":"boolean","title":"Requires Video Render","default":false}},"additionalProperties":false,"type":"object","required":["post_ref","creative_state_token","caption"],"title":"SocialPostBody","description":"The complete saved post at the exact version its preview named."},"SocialPostCampaignCreate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption"},"hashtags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hashtags"},"target_platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Platform"},"post_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Post Type"},"media_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Media Type"},"platform_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Platform Config"},"target_audience":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Target Audience"},"product_offering_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"post_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Post Id"},"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Post Url"},"posted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Posted At"},"scheduled_for":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Scheduled For"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"post_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Post Metadata"},"auto_rating":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Auto Rating"},"campaign_id":{"type":"string","title":"Campaign Id"},"idea_number":{"type":"integer","title":"Idea Number"},"variation":{"type":"integer","title":"Variation","default":0}},"type":"object","required":["campaign_id","idea_number"],"title":"SocialPostCampaignCreate"},"SocialPostCampaignMediaResponse":{"properties":{"media_type":{"type":"string","title":"Media Type"},"media_url":{"type":"string","title":"Media Url"},"thumbnail_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail Url"},"video_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Video Url"},"original_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Prompt"},"enhanced_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Enhanced Prompt"},"width":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Height"},"duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration"},"file_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"File Size"},"media_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Media Metadata"},"position":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Position","default":0},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"social_post_campaign_id":{"type":"string","format":"uuid","title":"Social Post Campaign Id"},"creation_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creation Date"}},"type":"object","required":["media_type","media_url","id","social_post_campaign_id","creation_date"],"title":"SocialPostCampaignMediaResponse"},"SocialPostCampaignResponse":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption"},"hashtags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hashtags"},"target_platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Platform"},"post_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Post Type"},"media_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Media Type"},"platform_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Platform Config"},"target_audience":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Target Audience"},"product_offering_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"post_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Post Id"},"post_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Post Url"},"posted_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Posted At"},"scheduled_for":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scheduled For"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"post_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Post Metadata"},"auto_rating":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Auto Rating"},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"company_profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Profile Id"},"campaign_id":{"type":"string","title":"Campaign Id"},"idea_number":{"type":"integer","title":"Idea Number"},"variation":{"type":"integer","title":"Variation"},"creation_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creation Date"},"last_modified":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Modified"},"media":{"items":{"$ref":"#/components/schemas/SocialPostCampaignMediaResponse"},"type":"array","title":"Media","default":[]}},"type":"object","required":["id","company_profile_id","campaign_id","idea_number","variation","creation_date","last_modified"],"title":"SocialPostCampaignResponse"},"SocialPostDirectEditPatch":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption"},"hashtags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Hashtags"},"image_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Description"},"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url"},"platform_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Platform Config"},"media_operations":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Media Operations"}},"type":"object","title":"SocialPostDirectEditPatch"},"SocialPostMedia":{"properties":{"kind":{"type":"string","enum":["image","video"],"title":"Kind"},"href":{"type":"string","maxLength":1000,"minLength":1,"title":"Href"},"label":{"anyOf":[{"type":"string","maxLength":120,"minLength":1},{"type":"null"}],"title":"Label"},"role":{"anyOf":[{"type":"string","pattern":"^[a-z][a-z0-9_]{0,79}$"},{"type":"null"}],"title":"Role"},"width":{"anyOf":[{"type":"integer","maximum":50000.0,"minimum":1.0},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer","maximum":50000.0,"minimum":1.0},{"type":"null"}],"title":"Height"},"slot_id":{"type":"string","format":"uuid","title":"Slot Id"},"position":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Position"}},"additionalProperties":false,"type":"object","required":["kind","href","slot_id"],"title":"SocialPostMedia","description":"An original native post slot, not a guessed Gallery identity."},"SocialPostPreview":{"properties":{"post_ref":{"$ref":"#/components/schemas/ResourceRef"},"creative_state_token":{"type":"string","pattern":"^[a-f0-9]{64}$","title":"Creative State Token"},"schedule_state_token":{"anyOf":[{"type":"string","pattern":"^[a-f0-9]{64}$"},{"type":"null"}],"title":"Schedule State Token"},"body_href":{"type":"string","maxLength":1000,"minLength":1,"pattern":"^/api/","title":"Body Href"},"caption_excerpt":{"type":"string","maxLength":1000,"title":"Caption Excerpt"},"caption_characters":{"type":"integer","minimum":0.0,"title":"Caption Characters"},"hashtags_count":{"type":"integer","minimum":0.0,"title":"Hashtags Count"},"media_count":{"type":"integer","minimum":0.0,"title":"Media Count"},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"post_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Post Type"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"additionalProperties":false,"type":"object","required":["post_ref","creative_state_token","body_href","caption_excerpt","caption_characters","hashtags_count","media_count"],"title":"SocialPostPreview","description":"A bounded native snapshot; ``body_href`` reads the complete saved post."},"SocialPostRequest":{"properties":{"product_description":{"type":"string","title":"Product Description","description":"Description of product/service"},"target_audience":{"type":"string","title":"Target Audience","description":"Target audience description"},"platform":{"type":"string","title":"Platform","description":"Social media platform (instagram, facebook, linkedin, x, tiktok_social)"},"post_type":{"type":"string","title":"Post Type","description":"Type of post (feed_post, story, reel, article, thread)"},"media_type":{"type":"string","title":"Media Type","description":"Type of media (image, video, text, carousel)","default":"image"},"campaign_goals":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Campaign Goals","description":"Campaign goals"},"key_selling_points":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key Selling Points","description":"Key selling points","default":""},"reference_images":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Reference Images","description":"Base64 encoded reference images"},"use_brand_style":{"type":"boolean","title":"Use Brand Style","description":"Maintain brand consistency","default":true},"num_posts":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Num Posts","description":"Number of posts to generate","default":1},"num_media":{"type":"integer","maximum":35.0,"minimum":0.0,"title":"Num Media","description":"Number of media items per post","default":1},"video_duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Video Duration","description":"Video duration is fixed at 10 seconds"},"platform_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Platform Config","description":"Platform-specific configuration"}},"type":"object","required":["product_description","target_audience","platform","post_type"],"title":"SocialPostRequest","description":"Request model for generating social posts."},"SocialProspectingCandidateStatusUpdateRequest":{"properties":{"status":{"anyOf":[{"type":"string","pattern":"^(new|reviewed|saved|dismissed)$"},{"type":"null"}],"title":"Status"},"handoff_status":{"anyOf":[{"type":"string","pattern":"^(not_ready|ready|copied|exported|contacted|replied|converted|disqualified)$"},{"type":"null"}],"title":"Handoff Status"},"block_account":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Block Account","default":false},"feedback_reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Feedback Reason"},"handoff_note":{"anyOf":[{"type":"string","maxLength":600},{"type":"null"}],"title":"Handoff Note"}},"type":"object","title":"SocialProspectingCandidateStatusUpdateRequest"},"SocialProspectingExportResponse":{"properties":{"candidates":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Candidates"},"total":{"type":"integer","title":"Total","default":0}},"type":"object","title":"SocialProspectingExportResponse"},"SocialProspectingResponse":{"properties":{"access":{"additionalProperties":true,"type":"object","title":"Access"},"summary":{"additionalProperties":true,"type":"object","title":"Summary"},"candidates":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Candidates"},"pagination":{"additionalProperties":true,"type":"object","title":"Pagination"},"filters":{"additionalProperties":true,"type":"object","title":"Filters"}},"type":"object","required":["access","summary"],"title":"SocialProspectingResponse"},"SocialProspectingSettingsUpdateRequest":{"properties":{"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"platforms":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Platforms"},"custom_keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Custom Keywords"},"source_keywords":{"anyOf":[{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object"},{"type":"null"}],"title":"Source Keywords"},"excluded_keywords":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Excluded Keywords"},"target_moments":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Target Moments"},"seed_lookback_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seed Lookback Days"},"incremental_lookback_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Incremental Lookback Days"},"min_score":{"anyOf":[{"type":"integer","maximum":95.0,"minimum":50.0},{"type":"null"}],"title":"Min Score"},"max_mentions_per_run":{"anyOf":[{"type":"integer","maximum":300.0,"minimum":20.0},{"type":"null"}],"title":"Max Mentions Per Run"},"dm_tone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dm Tone"}},"type":"object","title":"SocialProspectingSettingsUpdateRequest"},"SocialPublicationVerificationEvidence":{"properties":{"provider_post_id":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}],"title":"Provider Post Id"},"provider_post_url":{"anyOf":[{"type":"string","maxLength":4096},{"type":"null"}],"title":"Provider Post Url"},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"},"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"}},"type":"object","title":"SocialPublicationVerificationEvidence"},"SocialPublicationVerificationResolutionRequest":{"properties":{"outcome":{"type":"string","enum":["confirmed_published","confirmed_not_published"],"title":"Outcome"},"provider_evidence":{"anyOf":[{"$ref":"#/components/schemas/SocialPublicationVerificationEvidence"},{"type":"null"}]},"expected_state_token":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","title":"Expected State Token","description":"Opaque campaign/schedule/publication token captured when this verification outcome was reviewed."}},"type":"object","required":["outcome","expected_state_token"],"title":"SocialPublicationVerificationResolutionRequest"},"SocialSchedulePostingIdentity":{"properties":{"instagram_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instagram Account Id"},"instagram_auth_method":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instagram Auth Method"},"instagram_account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instagram Account Name"},"instagram_username":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Instagram Username"},"facebook_page_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facebook Page Id"},"facebook_page_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facebook Page Name"},"tiktok_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tiktok Account Id"},"tiktok_account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tiktok Account Name"}},"type":"object","title":"SocialSchedulePostingIdentity"},"SocialScheduleReview":{"properties":{"kind":{"type":"string","const":"social_schedule","title":"Kind","default":"social_schedule"},"action":{"type":"string","enum":["schedule","cancel_schedule"],"title":"Action"},"platform":{"type":"string","enum":["instagram","facebook"],"title":"Platform"},"account_name":{"type":"string","maxLength":200,"minLength":1,"title":"Account Name"},"account_id":{"type":"string","maxLength":200,"minLength":1,"title":"Account Id"},"scheduled_at":{"type":"string","format":"date-time","title":"Scheduled At"},"timezone":{"type":"string","maxLength":100,"minLength":1,"title":"Timezone"},"caption":{"type":"string","maxLength":64000,"title":"Caption","default":""},"hashtags":{"items":{"type":"string","maxLength":200,"minLength":1},"type":"array","maxItems":100,"title":"Hashtags","default":[]},"media":{"items":{"$ref":"#/components/schemas/WorkReviewMedia"},"type":"array","maxItems":35,"title":"Media","default":[]}},"additionalProperties":false,"type":"object","required":["action","platform","account_name","account_id","scheduled_at","timezone"],"title":"SocialScheduleReview","description":"Exact native publishing terms shown before a human confirms the work."},"SocialScheduleUpsertRequest":{"properties":{"schedule_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Schedule Id"},"campaign_id":{"type":"string","title":"Campaign Id"},"idea_number":{"type":"integer","title":"Idea Number"},"variation":{"type":"integer","title":"Variation","default":0},"platform":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Platform"},"scheduled_local_date":{"type":"string","title":"Scheduled Local Date"},"scheduled_local_time":{"type":"string","title":"Scheduled Local Time"},"schedule_timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Schedule Timezone"},"posting_identity":{"$ref":"#/components/schemas/SocialSchedulePostingIdentity"},"expected_state_token":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","title":"Expected State Token","description":"Opaque release-state token returned by the campaign API. It prevents a stale scheduling window from overwriting newer content or a newer schedule."},"validate_only":{"type":"boolean","title":"Validate Only","default":false}},"type":"object","required":["campaign_id","idea_number","scheduled_local_date","scheduled_local_time","posting_identity","expected_state_token"],"title":"SocialScheduleUpsertRequest"},"SourceArticlesResponse":{"properties":{"observed_at":{"type":"string","format":"date-time","title":"Observed At"},"articles":{"items":{"$ref":"#/components/schemas/RelatedSourceArticle"},"type":"array","maxItems":6,"title":"Articles","default":[]},"unavailable_count":{"type":"integer","minimum":0.0,"title":"Unavailable Count","default":0},"omitted_count":{"type":"integer","minimum":0.0,"title":"Omitted Count","default":0}},"additionalProperties":false,"type":"object","required":["observed_at"],"title":"SourceArticlesResponse"},"SourceCreateRequest":{"properties":{"social_media_integration_id":{"type":"string","format":"uuid","title":"Social Media Integration Id"},"page_id":{"type":"string","maxLength":255,"minLength":1,"title":"Page Id"},"page_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Page Name"},"idempotency_key":{"type":"string","maxLength":255,"minLength":8,"title":"Idempotency Key"}},"type":"object","required":["social_media_integration_id","page_id","idempotency_key"],"title":"SourceCreateRequest"},"SourceResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"provider":{"type":"string","title":"Provider"},"surface":{"type":"string","title":"Surface"},"external_resource_id":{"type":"string","title":"External Resource Id"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"status":{"type":"string","title":"Status"},"history_status":{"type":"string","title":"History Status"},"next_sync_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Sync At"},"last_succeeded_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Succeeded At"},"safe_error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Safe Error Code"}},"type":"object","required":["id","provider","surface","external_resource_id","display_name","status","history_status","next_sync_at","last_succeeded_at","safe_error_code"],"title":"SourceResponse"},"SquareStatusResponseModel":{"properties":{"connected":{"type":"boolean","title":"Connected","description":"Whether the platform is connected"},"healthy":{"type":"boolean","title":"Healthy","description":"Whether the token is healthy (passed API check)","default":false},"health_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Health Message","description":"Health check result message"},"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id","description":"Platform-specific account identifier"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name","description":"Display name for the account"},"token_expires_soon":{"type":"boolean","title":"Token Expires Soon","description":"Whether token expires within buffer period","default":false},"last_health_check":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Health Check","description":"ISO timestamp of last health check"},"merchant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Merchant Id","description":"Square merchant ID"},"available":{"type":"boolean","title":"Available","default":true},"unavailable_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unavailable Reason"},"business_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Name","description":"Business name"},"primary_location_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Location Id","description":"Primary location ID"},"locations_count":{"type":"integer","title":"Locations Count","description":"Number of locations","default":0},"granted_scopes":{"items":{"type":"string"},"type":"array","title":"Granted Scopes","description":"Granted Square OAuth scopes"},"has_write_access":{"type":"boolean","title":"Has Write Access","description":"Whether the current integration includes Square write scopes","default":false},"write_access_missing_scopes":{"items":{"type":"string"},"type":"array","title":"Write Access Missing Scopes","description":"Missing standard Square write scopes required for sandbox seeding"}},"type":"object","required":["connected"],"title":"SquareStatusResponseModel","description":"Response model for Square connection status with health check.","example":{"account_id":"shop_12345","account_name":"My Store","connected":true,"health_message":"Token is valid","healthy":true,"last_health_check":"2024-01-15T10:30:00Z","token_expires_soon":false}},"StartInvitationSessionRequest":{"properties":{"invite_token":{"type":"string","maxLength":2048,"minLength":1,"title":"Invite Token"}},"type":"object","required":["invite_token"],"title":"StartInvitationSessionRequest"},"StartRequest":{"properties":{"company_url":{"type":"string","maxLength":2048,"minLength":3,"title":"Company Url"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"document_ids":{"items":{"type":"string"},"type":"array","maxItems":3,"title":"Document Ids"}},"type":"object","required":["company_url","company_profile_id"],"title":"StartRequest"},"Step1ConfirmRequest":{"properties":{"company_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Company Url"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"company_info":{"$ref":"#/components/schemas/CompanyInfo"}},"type":"object","required":["company_url","company_profile_id","company_info"],"title":"Step1ConfirmRequest"},"Step1ExtractRequest":{"properties":{"company_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Company Url"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"}},"type":"object","required":["company_url","company_profile_id"],"title":"Step1ExtractRequest"},"Step2ConfirmRequest":{"properties":{"company_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Company Url"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"skus":{"items":{"$ref":"#/components/schemas/SKU"},"type":"array","title":"Skus"},"force_competitor_refresh":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Force Competitor Refresh","default":false},"scope_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope Key"}},"type":"object","required":["company_url","company_profile_id","skus"],"title":"Step2ConfirmRequest"},"Step2DiscoverRequest":{"properties":{"company_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Company Url"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"}},"type":"object","required":["company_url","company_profile_id"],"title":"Step2DiscoverRequest"},"StripeDailySalesResponse":{"properties":{"company_profile_id":{"type":"string","title":"Company Profile Id"},"metric_date":{"type":"string","format":"date","title":"Metric Date"},"charge_count":{"type":"integer","title":"Charge Count"},"gross_sales_cents":{"type":"integer","title":"Gross Sales Cents"},"refunded_charge_count":{"type":"integer","title":"Refunded Charge Count"},"total_refunded_cents":{"type":"integer","title":"Total Refunded Cents"},"net_revenue_cents":{"type":"integer","title":"Net Revenue Cents"},"unique_customers":{"type":"integer","title":"Unique Customers"}},"type":"object","required":["company_profile_id","metric_date","charge_count","gross_sales_cents","refunded_charge_count","total_refunded_cents","net_revenue_cents","unique_customers"],"title":"StripeDailySalesResponse","description":"Daily Stripe sales metrics response."},"StripeRangeSummaryResponse":{"properties":{"total_gross_sales_cents":{"type":"integer","title":"Total Gross Sales Cents"},"total_refunded_cents":{"type":"integer","title":"Total Refunded Cents"},"total_net_revenue_cents":{"type":"integer","title":"Total Net Revenue Cents"},"total_charges":{"type":"integer","title":"Total Charges"},"total_refunded_charges":{"type":"integer","title":"Total Refunded Charges"},"avg_charge_value_cents":{"type":"integer","title":"Avg Charge Value Cents"},"total_unique_customers":{"type":"integer","title":"Total Unique Customers"}},"type":"object","required":["total_gross_sales_cents","total_refunded_cents","total_net_revenue_cents","total_charges","total_refunded_charges","avg_charge_value_cents","total_unique_customers"],"title":"StripeRangeSummaryResponse","description":"Stripe summary for a date range response."},"StripeStatusResponseModel":{"properties":{"connected":{"type":"boolean","title":"Connected","description":"Whether the platform is connected"},"healthy":{"type":"boolean","title":"Healthy","description":"Whether the token is healthy (passed API check)","default":false},"health_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Health Message","description":"Health check result message"},"account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Id","description":"Platform-specific account identifier"},"account_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Account Name","description":"Display name for the account"},"token_expires_soon":{"type":"boolean","title":"Token Expires Soon","description":"Whether token expires within buffer period","default":false},"last_health_check":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Health Check","description":"ISO timestamp of last health check"},"business_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Name","description":"Business name"},"livemode":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Livemode","description":"Whether Stripe is in live mode"},"charges_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Charges Enabled","description":"Whether charges are enabled"}},"type":"object","required":["connected"],"title":"StripeStatusResponseModel","description":"Response model for connection status with health check.","example":{"account_id":"shop_12345","account_name":"My Store","connected":true,"health_message":"Token is valid","healthy":true,"last_health_check":"2024-01-15T10:30:00Z","token_expires_soon":false}},"StructuredTimedBeatScriptModel":{"properties":{"total_runtime_seconds":{"anyOf":[{"type":"integer"},{"type":"number"}],"title":"Total Runtime Seconds","description":"Total runtime for the video in seconds"},"beats":{"items":{"$ref":"#/components/schemas/StructuredVideoBeatModel"},"type":"array","title":"Beats","description":"Contiguous timestamped beats that cover the full runtime"}},"type":"object","required":["total_runtime_seconds"],"title":"StructuredTimedBeatScriptModel"},"StructuredVideoBeatModel":{"properties":{"start_seconds":{"type":"number","title":"Start Seconds","description":"Beat start time in seconds"},"end_seconds":{"type":"number","title":"End Seconds","description":"Beat end time in seconds"},"visual_action":{"type":"string","title":"Visual Action","description":"What happens visually during this beat"},"spoken_audio":{"type":"string","title":"Spoken Audio","description":"What is spoken during this beat, or an empty string when silent"},"sound_effects":{"type":"string","title":"Sound Effects","description":"Beat-specific sound effects or audio accents, or an empty string when none"},"cta_delivery":{"type":"string","title":"Cta Delivery","description":"How this beat advances or lands the CTA/value takeaway"},"cta_delivery_mode":{"anyOf":[{"type":"string","enum":["spoken","visual","none"]},{"type":"null"}],"title":"Cta Delivery Mode","description":"How the CTA is delivered: spoken, visual or none"}},"type":"object","required":["start_seconds","end_seconds","visual_action","spoken_audio","sound_effects","cta_delivery"],"title":"StructuredVideoBeatModel"},"StructuredVideoPromptModel":{"properties":{"opening_frame_continuity":{"type":"string","title":"Opening Frame Continuity","description":"How the shot starts from the first frame"},"subject_product_invariants":{"type":"string","title":"Subject Product Invariants","description":"Who and what must remain unchanged throughout the shot"},"talent_presence":{"type":"string","title":"Talent Presence","description":"Whether a person is visible on camera, how much of them is shown, and whether that visibility stays consistent"},"spoken_audio_delivery":{"type":"string","title":"Spoken Audio Delivery","description":"How spoken lines are delivered across the clip, such as on-camera speech, voiceover, off-camera speech, or fully silent"},"timed_beat_script":{"$ref":"#/components/schemas/StructuredTimedBeatScriptModel","description":"Timed beat script covering the full runtime"},"camera_composition":{"type":"string","title":"Camera Composition","description":"Shot type, framing, angle, lens feel, and movement"},"context_environment":{"type":"string","title":"Context Environment","description":"Where the action happens and what remains present in the scene"},"style_lighting_ambience":{"type":"string","title":"Style Lighting Ambience","description":"Visual tone, lighting, palette, and ambience"},"global_audio_bed":{"type":"string","title":"Global Audio Bed","description":"Continuous music, ambience, or room tone for the full clip"},"constraints":{"type":"string","title":"Constraints","description":"Continuity and brand-safety constraints for the video"},"video_intent":{"anyOf":[{"$ref":"#/components/schemas/VideoPromptIntent"},{"type":"null"}],"description":"The explicit people, audio, camera and style choices the script was written under"}},"type":"object","required":["opening_frame_continuity","subject_product_invariants","talent_presence","spoken_audio_delivery","timed_beat_script","camera_composition","context_environment","style_lighting_ambience","global_audio_bed","constraints"],"title":"StructuredVideoPromptModel"},"StyleDefinition":{"properties":{"id":{"type":"string","maxLength":1200,"minLength":1,"title":"Id"},"name":{"type":"string","maxLength":1200,"minLength":1,"title":"Name"},"visual_definition":{"type":"string","maxLength":1200,"minLength":1,"title":"Visual Definition"},"relevance":{"type":"string","title":"Relevance","default":""}},"additionalProperties":false,"type":"object","required":["id","name","visual_definition"],"title":"StyleDefinition"},"SubmissionType":{"type":"string","enum":["book_demo","contact"],"title":"SubmissionType","description":"Type of contact submission."},"SubscriptionResponse":{"properties":{"id":{"type":"string","title":"Id"},"plan_id":{"type":"string","title":"Plan Id"},"status":{"type":"string","title":"Status"},"current_period_start":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Period Start"},"current_period_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Period End"},"cancel_at_period_end":{"type":"boolean","title":"Cancel At Period End"},"trial_end":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trial End"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"}},"type":"object","required":["id","plan_id","status","cancel_at_period_end","created_at"],"title":"SubscriptionResponse","description":"Response model for subscription information."},"SubscriptionTier":{"properties":{"id":{"type":"string","title":"Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"price":{"type":"number","title":"Price"},"currency":{"type":"string","title":"Currency","default":"USD"},"features":{"items":{"type":"string"},"type":"array","title":"Features"},"stripe_price_id":{"type":"string","title":"Stripe Price Id"}},"type":"object","required":["id","name","description","price","features","stripe_price_id"],"title":"SubscriptionTier","description":"Model representing a subscription tier."},"SystemFindingAdjudicationRequest":{"properties":{"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"finding_event_id":{"type":"string","format":"uuid","title":"Finding Event Id"},"finding_event_content_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Finding Event Content Hash"},"processor_version":{"type":"string","maxLength":64,"minLength":1,"title":"Processor Version"},"target_kind":{"type":"string","enum":["qa_issue","qa_quality_claim","outcome_observation"],"title":"Target Kind"},"target_key":{"type":"string","maxLength":191,"minLength":1,"title":"Target Key"},"label":{"type":"string","enum":["issue_present","issue_absent","inconclusive"],"title":"Label"},"review_packet_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Review Packet Hash"},"note":{"anyOf":[{"type":"string","maxLength":600},{"type":"null"}],"title":"Note"},"client_request_id":{"type":"string","format":"uuid","title":"Client Request Id"}},"additionalProperties":false,"type":"object","required":["organization_id","company_profile_id","finding_event_id","finding_event_content_hash","processor_version","target_kind","target_key","label","review_packet_hash","client_request_id"],"title":"SystemFindingAdjudicationRequest","description":"Client-supplied preconditions and one independent human label.\n\nProcessor identity, review protocol, actor identity, event sequence, and\nblinding attestations are resolved and verified by the service. Accepting\nthose values from the browser would turn server guarantees into claims."},"SystemFindingAdjudicationResult":{"properties":{"review_event_id":{"type":"string","format":"uuid","title":"Review Event Id"},"review_event_sequence":{"type":"integer","minimum":1.0,"title":"Review Event Sequence"},"review_event_content_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Review Event Content Hash"},"system_finding_id":{"type":"string","format":"uuid","title":"System Finding Id"},"finding_event_id":{"type":"string","format":"uuid","title":"Finding Event Id"},"target_kind":{"type":"string","enum":["qa_issue","qa_quality_claim","outcome_observation"],"title":"Target Kind"},"target_key":{"type":"string","maxLength":191,"minLength":1,"title":"Target Key"},"label":{"type":"string","enum":["issue_present","issue_absent","inconclusive"],"title":"Label"},"review_packet_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Review Packet Hash"},"current_review_state":{"type":"string","enum":["unreviewed","confirmed","dismissed","inconclusive"],"title":"Current Review State"},"current_review_state_scope":{"type":"string","enum":["projection","finding_version_claims"],"title":"Current Review State Scope","default":"projection"},"replayed":{"type":"boolean","title":"Replayed"}},"additionalProperties":false,"type":"object","required":["review_event_id","review_event_sequence","review_event_content_hash","system_finding_id","finding_event_id","target_kind","target_key","label","review_packet_hash","current_review_state","replayed"],"title":"SystemFindingAdjudicationResult"},"SystemFindingReviewPacket":{"properties":{"review_protocol_version":{"type":"string","enum":["system-finding-blinded-review-v1","system-finding-blinded-review-v2"],"title":"Review Protocol Version","default":"system-finding-blinded-review-v1"},"finding":{"$ref":"#/components/schemas/ReviewPacketFindingRef"},"source":{"$ref":"#/components/schemas/ReviewPacketSourceRef"},"target":{"$ref":"#/components/schemas/ReviewPacketTarget"},"neutral_facts":{"oneOf":[{"$ref":"#/components/schemas/QaReviewNeutralFacts"},{"$ref":"#/components/schemas/QaQualityClaimReviewNeutralFacts"},{"$ref":"#/components/schemas/OutcomeReviewNeutralFacts"}],"title":"Neutral Facts","discriminator":{"propertyName":"kind","mapping":{"outcome_observation":"#/components/schemas/OutcomeReviewNeutralFacts","qa_issue":"#/components/schemas/QaReviewNeutralFacts","qa_quality_claim":"#/components/schemas/QaQualityClaimReviewNeutralFacts"}}},"blinding":{"$ref":"#/components/schemas/ReviewPacketBlinding"}},"additionalProperties":false,"type":"object","required":["finding","source","target","neutral_facts"],"title":"SystemFindingReviewPacket","description":"The exact bounded neutral packet shown to one independent reviewer."},"SystemFindingReviewQueueItem":{"properties":{"system_finding_id":{"type":"string","format":"uuid","title":"System Finding Id"},"company_profile_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Company Profile Id"},"finding_event_id":{"type":"string","format":"uuid","title":"Finding Event Id"},"finding_event_sequence":{"type":"integer","minimum":1.0,"title":"Finding Event Sequence"},"finding_event_content_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Finding Event Content Hash"},"processor_key":{"type":"string","maxLength":64,"minLength":1,"title":"Processor Key"},"processor_version":{"type":"string","maxLength":64,"minLength":1,"title":"Processor Version"},"target_kind":{"type":"string","enum":["qa_issue","qa_quality_claim","outcome_observation"],"title":"Target Kind"},"target_key":{"type":"string","maxLength":191,"minLength":1,"title":"Target Key"},"review_criterion":{"type":"string","maxLength":96,"minLength":1,"title":"Review Criterion"},"review_packet":{"$ref":"#/components/schemas/SystemFindingReviewPacket"},"review_packet_hash":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Review Packet Hash"}},"additionalProperties":false,"type":"object","required":["system_finding_id","finding_event_id","finding_event_sequence","finding_event_content_hash","processor_key","processor_version","target_kind","target_key","review_criterion","review_packet","review_packet_hash"],"title":"SystemFindingReviewQueueItem"},"SystemFindingReviewQueuePage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/SystemFindingReviewQueueItem"},"type":"array","maxItems":100,"title":"Items"},"next_cursor":{"anyOf":[{"type":"string","maxLength":1024,"minLength":1},{"type":"null"}],"title":"Next Cursor"},"integrity_skipped_count":{"type":"integer","minimum":0.0,"title":"Integrity Skipped Count","default":0},"stale_skipped_count":{"type":"integer","minimum":0.0,"title":"Stale Skipped Count","default":0},"page_complete":{"type":"boolean","title":"Page Complete","default":true}},"additionalProperties":false,"type":"object","required":["items"],"title":"SystemFindingReviewQueuePage"},"TargetAudienceRequest":{"properties":{"user_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Prompt","description":"Optional user prompt to guide target audience generation"},"product_offering_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id","description":"Product offering ID (UUID). Omit/null for company-wide targeting"},"product_offering_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product Offering Name","description":"Product offering name for reference"},"pinned_audiences":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Pinned Audiences","description":"List of audience objects to keep; generator will refresh remaining slots"},"locations":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Locations","description":"Structured campaign scope locations to use when generating local audiences"},"target_locations":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Target Locations","description":"Deprecated alias for locations"},"user_provided_locations":{"type":"boolean","title":"User Provided Locations","description":"Whether the user explicitly selected campaign scope locations","default":false}},"type":"object","title":"TargetAudienceRequest","description":"Request schema for target audience generation"},"TeamControlReview":{"properties":{"kind":{"type":"string","const":"team_control","title":"Kind","default":"team_control"},"action":{"type":"string","enum":["run_now","resume"],"title":"Action"},"team_name":{"type":"string","maxLength":200,"minLength":1,"title":"Team Name"},"current_status":{"type":"string","enum":["active","paused"],"title":"Current Status"},"approval_policy":{"type":"string","maxLength":500,"minLength":1,"title":"Approval Policy"},"execution_note":{"type":"string","maxLength":500,"minLength":1,"title":"Execution Note"},"permitted_actions":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":8,"minItems":1,"title":"Permitted Actions"},"cadence":{"type":"string","maxLength":500,"minLength":1,"title":"Cadence"},"scope_note":{"type":"string","maxLength":500,"minLength":1,"title":"Scope Note"}},"additionalProperties":false,"type":"object","required":["action","team_name","current_status","approval_policy","execution_note","permitted_actions","cadence","scope_note"],"title":"TeamControlReview","description":"A business-readable confirmation of existing team authority and cadence."},"TeamDecisionReview":{"properties":{"kind":{"type":"string","const":"team_decision","title":"Kind","default":"team_decision"},"action":{"type":"string","enum":["approve","dismiss","defer"],"title":"Action"},"decision_kind":{"type":"string","enum":["ads_bundle","social_bundle","optimization","acknowledgement","plan_bundle","other"],"title":"Decision Kind"},"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title"},"team_name":{"type":"string","maxLength":200,"minLength":1,"title":"Team Name"},"rationale":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Rationale"},"expected_outcome":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Expected Outcome"},"items":{"items":{"$ref":"#/components/schemas/TeamDecisionReviewItem"},"type":"array","maxItems":40,"title":"Items","default":[]},"excluded_count":{"type":"integer","minimum":0.0,"title":"Excluded Count"},"spend_summary":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Spend Summary"},"schedule_summary":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Schedule Summary"},"note":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Note"},"defer_hours":{"anyOf":[{"type":"integer","maximum":720.0,"minimum":1.0},{"type":"null"}],"title":"Defer Hours"},"counter_proposal":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Counter Proposal"},"effect":{"type":"string","maxLength":600,"minLength":1,"title":"Effect"}},"additionalProperties":false,"type":"object","required":["action","decision_kind","title","team_name","excluded_count","effect"],"title":"TeamDecisionReview","description":"The exact decision a person applies to a card the AI team staged.\n\nThe card itself stays canonical in Pomo; this names what approving,\ndismissing or deferring it does, which items are included, and what it\nwill spend or schedule, so the confirmation can be judged on its own."},"TeamDecisionReviewItem":{"properties":{"label":{"type":"string","maxLength":200,"minLength":1,"title":"Label"},"detail":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Detail"},"included":{"type":"boolean","title":"Included"}},"additionalProperties":false,"type":"object","required":["label","included"],"title":"TeamDecisionReviewItem","description":"One creative, post or campaign change the decision covers."},"TerminalAccountability":{"additionalProperties":true,"type":"object"},"TerminalAccountabilityReason":{"type":"string","enum":["supported_content","authoritative_empty","denied","ambiguous","unavailable","protocol_error","insufficient_records","incomplete_collection","stale_evidence","no_supported_claim","evidence_not_retained","exhausted","deadline","iteration_limit","repair_exhaustion","no_attempt","inconclusive_attempt"],"title":"TerminalAccountabilityReason","description":"Bounded explanation for a requirement or section disposition."},"TerminalCause":{"type":"string","enum":["normal_completion","intentional_partial","needs_input","bounded_exhaustion","deadline","iteration_limit","repair_exhaustion","protocol_error","verifier_failure","dependency_failure","transport_projection","event_projection","evidence_receipt","declined","security_refusal","security_blocked","cancelled","failed","unknown_terminal_outcome"],"title":"TerminalCause","description":"Closed server-owned cause for the final accountability assessment."},"TerminalOperationalStatus":{"properties":{"work_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":12,"title":"Work Ids","default":[]},"read_receipt_ids":{"items":{"type":"string","format":"uuid"},"type":"array","maxItems":12,"title":"Read Receipt Ids","default":[]},"observation_ids":{"items":{"type":"string","maxLength":500,"minLength":1},"type":"array","maxItems":12,"title":"Observation Ids","default":[]},"incomplete":{"type":"boolean","title":"Incomplete"}},"type":"object","required":["incomplete"],"title":"TerminalOperationalStatus","description":"Retained status support from Core receipts, separate from market evidence.\n\nThe runtime and host derive this projection from the same typed operational\ncompletion. Identifiers authorize no action and never claim a job finished."},"TerminalRequirementDisposition":{"properties":{"requirement_id":{"type":"string","pattern":"^req_[0-9a-f]{16}$","title":"Requirement Id"},"disposition":{"$ref":"#/components/schemas/RequirementDisposition"},"reason":{"$ref":"#/components/schemas/TerminalAccountabilityReason"},"answer_contribution":{"$ref":"#/components/schemas/AnswerContribution"}},"type":"object","required":["requirement_id","disposition","reason","answer_contribution"],"title":"TerminalRequirementDisposition","description":"Terminal accountability for one stable accepted requirement identity."},"TerminalSectionDisposition":{"properties":{"section_id":{"type":"string","maxLength":64,"pattern":"^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$","title":"Section Id"},"label":{"anyOf":[{"type":"string","maxLength":96,"minLength":1},{"type":"null"}],"title":"Label"},"disposition":{"$ref":"#/components/schemas/SectionDisposition"},"reason":{"$ref":"#/components/schemas/TerminalAccountabilityReason"},"requirement_ids":{"items":{"type":"string","pattern":"^req_[0-9a-f]{16}$"},"type":"array","maxItems":20,"minItems":1,"title":"Requirement Ids"}},"type":"object","required":["section_id","disposition","reason","requirement_ids"],"title":"TerminalSectionDisposition","description":"Terminal aggregate for one stable server-owned answer section."},"TestEmailRequest":{"properties":{"campaign_id":{"type":"integer","title":"Campaign Id"},"test_emails":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":1,"title":"Test Emails"}},"type":"object","required":["campaign_id","test_emails"],"title":"TestEmailRequest","description":"Request to send test emails"},"TikTokAccountsResponseModel":{"properties":{"accounts":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Accounts"},"activation_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activation State"},"active_account":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Active Account"}},"type":"object","required":["accounts"],"title":"TikTokAccountsResponseModel"},"TikTokActivateAccountRequest":{"properties":{"advertiser_id":{"type":"string","title":"Advertiser Id","description":"TikTok advertiser ID to activate for future launches"}},"type":"object","required":["advertiser_id"],"title":"TikTokActivateAccountRequest"},"TikTokAdPauseRequest":{"properties":{"ad_id":{"type":"string","title":"Ad Id","description":"The database UUID of the ad to pause"},"advertiser_id":{"type":"string","title":"Advertiser Id","description":"The TikTok advertiser ID"}},"type":"object","required":["ad_id","advertiser_id"],"title":"TikTokAdPauseRequest","description":"Request model for pausing a TikTok ad"},"TikTokAdResumeRequest":{"properties":{"ad_id":{"type":"string","title":"Ad Id","description":"The database UUID of the ad to resume"},"advertiser_id":{"type":"string","title":"Advertiser Id","description":"The TikTok advertiser ID"}},"type":"object","required":["ad_id","advertiser_id"],"title":"TikTokAdResumeRequest","description":"Request model for resuming a TikTok ad"},"TikTokAdStatusResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"message":{"type":"string","title":"Message"},"status":{"type":"string","title":"Status","description":"The new status of the ad (active/paused)"}},"type":"object","required":["success","message","status"],"title":"TikTokAdStatusResponse","description":"Response model for ad status update operations"},"TikTokAuthResponseModel":{"properties":{"auth_url":{"type":"string","title":"Auth Url"}},"type":"object","required":["auth_url"],"title":"TikTokAuthResponseModel"},"TikTokDmSourceCreateRequest":{"properties":{"social_media_integration_id":{"type":"string","format":"uuid","title":"Social Media Integration Id"},"account_id":{"type":"string","maxLength":255,"minLength":1,"title":"Account Id"},"account_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Account Name"},"idempotency_key":{"type":"string","maxLength":255,"minLength":8,"title":"Idempotency Key"},"activation_mode":{"type":"string","enum":["draft_only","active"],"title":"Activation Mode","default":"draft_only"}},"type":"object","required":["social_media_integration_id","account_id","idempotency_key"],"title":"TikTokDmSourceCreateRequest"},"TikTokLaunchVideoAdRequest":{"properties":{"ad_id":{"type":"string","title":"Ad Id"},"advertiser_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Advertiser Id"},"audience_group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience Group Id","description":"CRM audience to retarget or suppress"},"audience_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Audience Mode","description":"How to apply the CRM audience: include or exclude"},"ad_text_override":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Ad Text Override","description":"Optional override for ad_text (TikTok requirement: max 100 chars)"},"display_name_override":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Display Name Override","description":"Optional override for display_name (TikTok requirement: max 40 chars)"},"ad_name_override":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Ad Name Override","description":"Optional override for ad_name (TikTok requirement: max 512 chars)"}},"type":"object","required":["ad_id"],"title":"TikTokLaunchVideoAdRequest","description":"Request model for launching a TikTok video ad with optional text field overrides"},"TikTokSocialPostCampaignRequest":{"properties":{"campaign_id":{"type":"string","title":"Campaign Id"},"idea_number":{"type":"integer","title":"Idea Number"},"variation":{"type":"integer","title":"Variation","default":0},"tiktok_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tiktok Account Id"},"settings":{"$ref":"#/components/schemas/TikTokSocialPublishSettings"},"expected_creative_state_token":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","title":"Expected Creative State Token","description":"Server-issued fingerprint for the exact creative the user reviewed"}},"type":"object","required":["campaign_id","idea_number","settings","expected_creative_state_token"],"title":"TikTokSocialPostCampaignRequest"},"TikTokSocialPublishSettings":{"properties":{"privacy_level":{"type":"string","title":"Privacy Level","description":"TikTok privacy_level from creator_info.privacy_level_options"},"allow_comment":{"type":"boolean","title":"Allow Comment","default":false},"allow_duet":{"type":"boolean","title":"Allow Duet","default":false},"allow_stitch":{"type":"boolean","title":"Allow Stitch","default":false},"commercial_content_disclosure":{"type":"boolean","title":"Commercial Content Disclosure","default":false},"brand_content_toggle":{"type":"boolean","title":"Brand Content Toggle","default":false},"brand_organic_toggle":{"type":"boolean","title":"Brand Organic Toggle","default":false},"is_aigc":{"type":"boolean","title":"Is Aigc","default":true},"video_cover_timestamp_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Video Cover Timestamp Ms"},"photo_cover_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Photo Cover Index","default":0},"auto_add_music":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Auto Add Music","default":true}},"type":"object","required":["privacy_level"],"title":"TikTokSocialPublishSettings"},"TikTokSocialPublishSettingsRequest":{"properties":{"expected_creative_state_token":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","title":"Expected Creative State Token"},"campaign_id":{"type":"string","title":"Campaign Id"},"idea_number":{"type":"integer","title":"Idea Number"},"variation":{"type":"integer","title":"Variation","default":0},"settings":{"$ref":"#/components/schemas/TikTokSocialPublishSettings"}},"type":"object","required":["expected_creative_state_token","campaign_id","idea_number","settings"],"title":"TikTokSocialPublishSettingsRequest"},"TikTokSyncAdRequest":{"properties":{"ad_id":{"type":"string","title":"Ad Id","description":"Normalized platform ad UUID"},"advertiser_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Advertiser Id","description":"TikTok advertiser ID"},"pending_update":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pending Update","description":"Pending Pomo edit payload to apply only after sync succeeds."}},"type":"object","required":["ad_id"],"title":"TikTokSyncAdRequest","description":"Request model for syncing saved Pomo changes to a TikTok ad baseline."},"TikTokSyncPreviewRequest":{"properties":{"ad_id":{"type":"string","title":"Ad Id","description":"Normalized platform ad UUID"},"advertiser_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Advertiser Id","description":"TikTok advertiser ID"},"pending_update":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Pending Update","description":"Pending Pomo edit payload to preview without saving it."}},"type":"object","required":["ad_id"],"title":"TikTokSyncPreviewRequest","description":"Request model for previewing a TikTok normalized sync."},"TikTokVideoAdRequest":{"properties":{"product_description":{"type":"string","title":"Product Description"},"target_audience":{"type":"string","title":"Target Audience"},"campaign_goals":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Campaign Goals"},"key_selling_points":{"type":"string","title":"Key Selling Points","default":""},"num_ads":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Num Ads","default":3},"video_length":{"type":"integer","maximum":10.0,"minimum":10.0,"title":"Video Length","description":"Video duration is fixed at 10 seconds","default":10},"bid_strategy":{"type":"string","title":"Bid Strategy","default":"automatic"},"budget_range":{"type":"string","title":"Budget Range","default":"medium"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"reference_images":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":3},{"type":"null"}],"title":"Reference Images"}},"type":"object","required":["product_description","target_audience"],"title":"TikTokVideoAdRequest"},"TransactionHistoryResponse":{"properties":{"transactions":{"items":{},"type":"array","title":"Transactions"},"total":{"type":"integer","title":"Total"},"limit":{"type":"integer","title":"Limit"},"offset":{"type":"integer","title":"Offset"}},"type":"object","required":["transactions","total","limit","offset"],"title":"TransactionHistoryResponse","description":"Credit transaction history response."},"TransferOwnershipRequest":{"properties":{"new_owner_user_id":{"type":"string","format":"uuid","title":"New Owner User Id","description":"User ID of the new owner"},"confirmation":{"type":"boolean","title":"Confirmation","description":"Confirmation flag (must be True)"}},"type":"object","required":["new_owner_user_id","confirmation"],"title":"TransferOwnershipRequest","description":"Request to transfer organization ownership."},"TrendData":{"properties":{"date":{"type":"string","title":"Date"},"impressions":{"type":"integer","title":"Impressions"},"clicks":{"type":"integer","title":"Clicks"},"conversions":{"type":"integer","title":"Conversions"}},"type":"object","required":["date","impressions","clicks","conversions"],"title":"TrendData","description":"Daily trend data"},"TrendSuppressionResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"acted_by_user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Acted By User Id"},"platform":{"type":"string","enum":["google","tiktok","youtube","yelp","amazon"],"title":"Platform"},"source_record_id":{"type":"string","title":"Source Record Id"},"reason":{"type":"string","enum":["not_interested","irrelevant","duplicate"],"title":"Reason"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","organization_id","company_profile_id","platform","source_record_id","reason"],"title":"TrendSuppressionResponse"},"TrendSuppressionUpsertRequest":{"properties":{"platform":{"type":"string","enum":["google","tiktok","youtube","yelp","amazon"],"title":"Platform"},"source_record_id":{"type":"string","minLength":1,"title":"Source Record Id"},"reason":{"type":"string","enum":["not_interested","irrelevant","duplicate"],"title":"Reason"}},"type":"object","required":["platform","source_record_id","reason"],"title":"TrendSuppressionUpsertRequest"},"TrialPlanChangeAmount":{"properties":{"amount":{"type":"integer","minimum":0.0,"title":"Amount","description":"Currency minor units"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","title":"Currency"},"estimated":{"type":"boolean","title":"Estimated","default":false}},"type":"object","required":["amount","currency"],"title":"TrialPlanChangeAmount"},"TrialPlanChangeBillingTerms":{"properties":{"amount_due_now":{"anyOf":[{"$ref":"#/components/schemas/TrialPlanChangeAmount"},{"type":"null"}]},"first_paid_invoice":{"anyOf":[{"$ref":"#/components/schemas/TrialPlanChangeAmount"},{"type":"null"}]},"first_paid_invoice_at":{"type":"string","format":"date-time","title":"First Paid Invoice At"},"renewal":{"anyOf":[{"$ref":"#/components/schemas/TrialPlanChangeAmount"},{"type":"null"}]},"renews_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Renews At"}},"type":"object","required":["amount_due_now","first_paid_invoice","first_paid_invoice_at"],"title":"TrialPlanChangeBillingTerms"},"TrialPlanChangeBlocker":{"properties":{"resource":{"type":"string","enum":["company_profiles","competitors","collaborators"],"title":"Resource"},"current":{"type":"integer","minimum":0.0,"title":"Current"},"limit":{"type":"integer","minimum":0.0,"title":"Limit"},"profile_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Id"},"profile_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Name"}},"type":"object","required":["resource","current","limit"],"title":"TrialPlanChangeBlocker"},"TrialPlanChangeConfirmation":{"properties":{"operation_id":{"type":"string","format":"uuid","title":"Operation Id"},"reviewed":{"$ref":"#/components/schemas/TrialPlanChangePreview-Input"},"accept_paid_conversion":{"type":"boolean","title":"Accept Paid Conversion","default":false},"payment_retry_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Payment Retry Id"},"payment_method_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Method Id"}},"type":"object","required":["operation_id","reviewed"],"title":"TrialPlanChangeConfirmation"},"TrialPlanChangePaymentMethod":{"properties":{"collection_required":{"type":"boolean","title":"Collection Required"},"authentication_may_be_required":{"type":"boolean","title":"Authentication May Be Required"},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"customer_default_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Default Id"},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand"},"last4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last4"}},"type":"object","required":["collection_required","authentication_may_be_required"],"title":"TrialPlanChangePaymentMethod"},"TrialPlanChangePreview-Input":{"properties":{"effect":{"type":"string","enum":["no_change","preserve_trial","convert_to_paid"],"title":"Effect"},"source":{"$ref":"#/components/schemas/TrialPlanChangeSource"},"target":{"$ref":"#/components/schemas/TrialPlanSelection"},"resources":{"$ref":"#/components/schemas/TrialPlanChangeResources"},"billing":{"$ref":"#/components/schemas/TrialPlanChangeBillingTerms"},"payment_method":{"$ref":"#/components/schemas/TrialPlanChangePaymentMethod"}},"type":"object","required":["effect","source","target","resources","billing","payment_method"],"title":"TrialPlanChangePreview"},"TrialPlanChangePreview-Output":{"properties":{"effect":{"type":"string","enum":["no_change","preserve_trial","convert_to_paid"],"title":"Effect"},"source":{"$ref":"#/components/schemas/TrialPlanChangeSource"},"target":{"$ref":"#/components/schemas/TrialPlanSelection"},"resources":{"$ref":"#/components/schemas/TrialPlanChangeResources"},"billing":{"$ref":"#/components/schemas/TrialPlanChangeBillingTerms"},"payment_method":{"$ref":"#/components/schemas/TrialPlanChangePaymentMethod"}},"type":"object","required":["effect","source","target","resources","billing","payment_method"],"title":"TrialPlanChangePreview"},"TrialPlanChangeResources":{"properties":{"current_usage":{"additionalProperties":{"type":"integer"},"type":"object","title":"Current Usage"},"target_limits":{"additionalProperties":{"anyOf":[{"type":"integer"},{"type":"null"}]},"type":"object","title":"Target Limits"},"blockers":{"items":{"$ref":"#/components/schemas/TrialPlanChangeBlocker"},"type":"array","title":"Blockers"}},"type":"object","required":["current_usage","target_limits"],"title":"TrialPlanChangeResources"},"TrialPlanChangeSource":{"properties":{"subscription_id":{"type":"string","title":"Subscription Id"},"customer_id":{"type":"string","title":"Customer Id"},"item_id":{"type":"string","title":"Item Id"},"quantity":{"type":"integer","exclusiveMinimum":0.0,"title":"Quantity"},"selection":{"$ref":"#/components/schemas/TrialPlanSelection"},"trial_start":{"type":"string","format":"date-time","title":"Trial Start"},"trial_end":{"type":"string","format":"date-time","title":"Trial End"},"billing_cycle_anchor":{"type":"string","format":"date-time","title":"Billing Cycle Anchor"},"latest_invoice_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Invoice Id"}},"type":"object","required":["subscription_id","customer_id","item_id","quantity","selection","trial_start","trial_end","billing_cycle_anchor"],"title":"TrialPlanChangeSource","description":"Reviewed billing state; execution must compare against a fresh retrieval."},"TrialPlanSelection":{"properties":{"plan":{"type":"string","enum":["silver","gold","platinum"],"title":"Plan"},"billing_interval":{"type":"string","enum":["MONTHLY","YEARLY"],"title":"Billing Interval"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","title":"Currency"},"price_id":{"type":"string","minLength":1,"title":"Price Id"}},"type":"object","required":["plan","billing_interval","currency","price_id"],"title":"TrialPlanSelection"},"UnderstandingDetail":{"properties":{"label":{"type":"string","maxLength":80,"minLength":1,"title":"Label"},"value":{"type":"string","maxLength":600,"minLength":1,"title":"Value"}},"additionalProperties":false,"type":"object","required":["label","value"],"title":"UnderstandingDetail"},"UnderstandingGroup":{"properties":{"kind":{"type":"string","maxLength":40,"minLength":1,"title":"Kind"},"label":{"type":"string","maxLength":80,"minLength":1,"title":"Label"},"count":{"type":"integer","exclusiveMinimum":0.0,"title":"Count"}},"additionalProperties":false,"type":"object","required":["kind","label","count"],"title":"UnderstandingGroup","description":"One kind of context record Pomo is reading, and how many of them.\n\nThe label is already agreed with the count, so a reader prints the two\ntogether without inflecting anything. It names the record and claims no\nstate: the frame holds a proposed action and an expired approval beside\nfinished work, so \"actions taken\" would be a count the data cannot support.\nA group exists only where there is something to count."},"UpdateConversation":{"properties":{"presentation_context":{"anyOf":[{"$ref":"#/components/schemas/ConversationPresentationContext"},{"type":"null"}]},"title":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Title"},"lifecycle":{"anyOf":[{"type":"string","enum":["active","closed"]},{"type":"null"}],"title":"Lifecycle"}},"additionalProperties":false,"type":"object","title":"UpdateConversation"},"UpdateCreatorContactsRequest":{"properties":{"contacts_json":{"additionalProperties":true,"type":"object","title":"Contacts Json"}},"type":"object","required":["contacts_json"],"title":"UpdateCreatorContactsRequest"},"UpdateCreatorListMembershipRequest":{"properties":{"outreach_stage":{"anyOf":[{"type":"string","enum":["saved","outreached","replied","negotiating","confirmed","rejected"]},{"type":"null"}],"title":"Outreach Stage"},"priority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes"},"position":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Position"}},"type":"object","title":"UpdateCreatorListMembershipRequest"},"UpdateCreatorListRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":255,"minLength":1},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"is_pinned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Pinned"},"metadata_json":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata Json"}},"type":"object","title":"UpdateCreatorListRequest"},"UpdateCreatorLocationsRequest":{"properties":{"creator_locations_json":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Creator Locations Json"}},"type":"object","title":"UpdateCreatorLocationsRequest"},"UpdateOutreachStageRequest":{"properties":{"outreach_stage":{"type":"string","enum":["saved","outreached","replied","negotiating","confirmed","rejected"],"title":"Outreach Stage"}},"type":"object","required":["outreach_stage"],"title":"UpdateOutreachStageRequest"},"UpdatePostRequest":{"properties":{"caption":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Caption"},"hashtags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Hashtags"},"platform_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Platform Config"},"scheduled_for":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scheduled For"}},"type":"object","title":"UpdatePostRequest","description":"Request model for updating a post."},"User":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"google_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Google Id"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status","default":"active"},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"is_active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Active","default":true},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"auth_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Auth Provider"},"registration_data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Registration Data"}},"type":"object","required":["email","id"],"title":"User"},"UserPermissionSummary":{"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"user_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Name"},"user_email":{"type":"string","title":"User Email"},"organization_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Organization Role"},"has_approval_access":{"type":"boolean","title":"Has Approval Access","default":false},"accessible_projects":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Accessible Projects","description":"List of projects user has access to with their roles"}},"type":"object","required":["user_id","user_email"],"title":"UserPermissionSummary","description":"Summary of a user's permissions in the organization."},"UserPreferencesPartial":{"properties":{"preferences":{"additionalProperties":true,"type":"object","title":"Preferences","description":"User preferences as key-value pairs"}},"type":"object","title":"UserPreferencesPartial","description":"Response schema that returns only the preferences object without metadata.\nUseful for lightweight responses."},"UserPreferencesResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"user_id":{"type":"string","format":"uuid","title":"User Id"},"preferences":{"additionalProperties":true,"type":"object","title":"Preferences","description":"User preferences as key-value pairs"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","user_id","created_at","updated_at"],"title":"UserPreferencesResponse","description":"Response schema for user preferences.\nReturns the complete preferences object with metadata."},"UserPreferencesUpdate":{"properties":{"preferences":{"additionalProperties":true,"type":"object","title":"Preferences","description":"Preferences to update (will be merged with existing preferences)"}},"type":"object","required":["preferences"],"title":"UserPreferencesUpdate","description":"Schema for updating user preferences.\nAccepts a dictionary of preferences to merge with existing preferences.\n\nExample:\n{\n  \"tutorial_completed\": true,\n  \"daily_digest_theme\": \"dark\",\n  \"onboarding_dismissed\": true\n}"},"UserUpdate":{"properties":{"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"password":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Password"},"profile_completed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Profile Completed"},"google_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Google Id"},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"company_link":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Link"}},"type":"object","title":"UserUpdate","description":"Schema for user profile updates. Status changes require admin privileges."},"ValidatePlanChangeRequest":{"properties":{"payment_method_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payment Method Id"},"organization_id":{"type":"string","title":"Organization Id"},"target_plan":{"type":"string","title":"Target Plan"},"billing_interval":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing Interval"}},"type":"object","required":["organization_id","target_plan"],"title":"ValidatePlanChangeRequest","description":"Request model for validating a plan change."},"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"},"VideoCaptionRequest":{"properties":{"source_asset_id":{"type":"string","format":"uuid","title":"Source Asset Id"},"request_identity":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Request Identity"}},"additionalProperties":false,"type":"object","required":["source_asset_id"],"title":"VideoCaptionRequest"},"VideoEditorOperation":{"type":"string","enum":["manual_render","gemini_edit","captions"],"title":"VideoEditorOperation"},"VideoPromptIntent":{"properties":{"people_mode":{"anyOf":[{"type":"string","enum":["none","hands","pov","creator","background"]},{"type":"null"}],"title":"People Mode","description":"Explicit human presence. Omit when the person has not chosen."},"audio_mode":{"anyOf":[{"type":"string","enum":["silent","ambient","music","voiceover","creator"]},{"type":"null"}],"title":"Audio Mode","description":"Silent means no sound; ambient means environmental sound with no speech or music."},"camera_mode":{"anyOf":[{"type":"string","enum":["slow_push","handheld_ugc","orbit","static_closeup","smooth_pan","screen_capture"]},{"type":"null"}],"title":"Camera Mode","description":"Explicit framing and movement. Screen capture describes framing, not verified footage provenance."},"style_mode":{"anyOf":[{"type":"string","enum":["premium","ugc","bright_lifestyle","studio_product","bold_social","minimal","raw"]},{"type":"null"}],"title":"Style Mode","description":"Explicit visual finish. Raw means unpolished appearance; it does not authorize fabricated real-world evidence."}},"additionalProperties":false,"type":"object","title":"VideoPromptIntent"},"VideoRenderReview":{"properties":{"kind":{"type":"string","const":"video_render","title":"Kind","default":"video_render"},"prompt":{"type":"string","maxLength":8000,"minLength":1,"title":"Prompt"},"duration_seconds":{"type":"integer","maximum":600.0,"minimum":1.0,"title":"Duration Seconds"},"aspect_ratio":{"type":"string","pattern":"^[1-9][0-9]{0,3}:[1-9][0-9]{0,3}$","title":"Aspect Ratio"},"video_count":{"type":"integer","maximum":8.0,"minimum":1.0,"title":"Video Count","default":1},"usage_summary":{"type":"string","maxLength":500,"minLength":1,"title":"Usage Summary"},"frame":{"$ref":"#/components/schemas/WorkReviewMedia"}},"additionalProperties":false,"type":"object","required":["prompt","duration_seconds","aspect_ratio","usage_summary","frame"],"title":"VideoRenderReview","description":"Native video-render terms; accepting a frame is a human UI control."},"VideoRequestCancellationRequest":{"properties":{"operation":{"$ref":"#/components/schemas/VideoEditorOperation"}},"additionalProperties":false,"type":"object","required":["operation"],"title":"VideoRequestCancellationRequest"},"VideoSelectionRequest":{"properties":{"campaign_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"string"}],"title":"Campaign Id","description":"Campaign ID (can be UUID database ID or string campaign_id)"},"campaign_type":{"type":"string","title":"Campaign Type","description":"Type of campaign (e.g., google_video, tiktok_video)"},"selected_video_url":{"type":"string","title":"Selected Video Url","description":"URL of the selected video asset"},"variation_index":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Variation Index","description":"Index of the selected video (0-based)"},"total_variations":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Variations","description":"Total number of videos that were presented"},"selection_metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Selection Metadata","description":"Additional metadata about the selection"},"ad_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ad Id","description":"Specific ad ID for ad campaigns"}},"type":"object","required":["campaign_id","campaign_type","selected_video_url"],"title":"VideoSelectionRequest","description":"Request schema for selecting or uploading a replacement video for a campaign."},"VideoSelectionResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"campaign_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"string"}],"title":"Campaign Id"},"campaign_type":{"type":"string","title":"Campaign Type"},"selected_video_url":{"type":"string","title":"Selected Video Url"},"selected_thumbnail_url":{"type":"string","title":"Selected Thumbnail Url"},"selected_companion_image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Companion Image Url"},"message":{"type":"string","title":"Message"}},"type":"object","required":["success","campaign_id","campaign_type","selected_video_url","selected_thumbnail_url","message"],"title":"VideoSelectionResponse","description":"Response schema for video selection."},"VideoTextValidationRequest":{"properties":{"texts":{"items":{"type":"string"},"type":"array","maxItems":21,"minItems":1,"title":"Texts"}},"additionalProperties":false,"type":"object","required":["texts"],"title":"VideoTextValidationRequest"},"VideoTextValidationResponse":{"properties":{"unsupported_characters":{"items":{"type":"string"},"type":"array","title":"Unsupported Characters"}},"type":"object","required":["unsupported_characters"],"title":"VideoTextValidationResponse"},"WebsiteActionKind":{"type":"string","enum":["factual_update","new_page","metadata","internal_links","structured_data","robots_access","sitemap_reference","page_indexing","canonical_url","technical_restore"],"title":"WebsiteActionKind"},"WebsiteApprovalRequest":{"properties":{"revision":{"type":"integer","minimum":1.0,"title":"Revision"},"approval_digest":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Approval Digest"}},"additionalProperties":false,"type":"object","required":["revision","approval_digest"],"title":"WebsiteApprovalRequest"},"WebsiteChangeCreate":{"properties":{"site_id":{"type":"string","format":"uuid","title":"Site Id"},"action_kind":{"$ref":"#/components/schemas/WebsiteActionKind"},"title":{"type":"string","maxLength":220,"minLength":1,"title":"Title"},"buyer_question":{"type":"string","maxLength":2000,"title":"Buyer Question","default":""},"instruction":{"type":"string","maxLength":12000,"title":"Instruction","default":""},"resource_id":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Resource Id"},"resource_kind":{"type":"string","enum":["page","post","technical"],"title":"Resource Kind","default":"page"},"technical":{"anyOf":[{"$ref":"#/components/schemas/WebsiteTechnicalInput"},{"type":"null"}]},"field_overrides":{"additionalProperties":true,"type":"object","maxProperties":4,"title":"Field Overrides"},"target_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Target Url"},"evidence_refs":{"items":{"$ref":"#/components/schemas/WebsiteEvidenceInput"},"type":"array","maxItems":24,"title":"Evidence Refs"}},"additionalProperties":false,"type":"object","required":["site_id","action_kind","title"],"title":"WebsiteChangeCreate"},"WebsiteChangeUpdate":{"properties":{"revision":{"type":"integer","minimum":1.0,"title":"Revision"},"instruction":{"anyOf":[{"type":"string","maxLength":12000},{"type":"null"}],"title":"Instruction"},"fields":{"anyOf":[{"additionalProperties":true,"type":"object","maxProperties":16},{"type":"null"}],"title":"Fields"}},"additionalProperties":false,"type":"object","required":["revision"],"title":"WebsiteChangeUpdate"},"WebsiteEvidenceInput":{"properties":{"label":{"type":"string","maxLength":220,"minLength":1,"title":"Label"},"url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Url"},"source":{"type":"string","maxLength":64,"title":"Source","default":"user"},"detail":{"type":"string","maxLength":12000,"title":"Detail","default":""}},"additionalProperties":false,"type":"object","required":["label"],"title":"WebsiteEvidenceInput"},"WebsiteSiteCreate":{"properties":{"provider":{"type":"string","const":"wordpress","title":"Provider"},"name":{"type":"string","maxLength":160,"minLength":1,"title":"Name"},"base_url":{"type":"string","maxLength":2048,"minLength":8,"title":"Base Url"},"config":{"additionalProperties":true,"type":"object","maxProperties":32,"title":"Config"},"credentials":{"additionalProperties":{"type":"string","format":"password","writeOnly":true},"type":"object","maxProperties":16,"title":"Credentials"}},"additionalProperties":false,"type":"object","required":["provider","name","base_url"],"title":"WebsiteSiteCreate"},"WebsiteSiteUpdate":{"properties":{"credential_version":{"type":"integer","minimum":1.0,"title":"Credential Version"},"name":{"anyOf":[{"type":"string","maxLength":160,"minLength":1},{"type":"null"}],"title":"Name"},"config":{"anyOf":[{"additionalProperties":true,"type":"object","maxProperties":32},{"type":"null"}],"title":"Config"},"credentials":{"anyOf":[{"additionalProperties":{"type":"string","format":"password","writeOnly":true},"type":"object","maxProperties":16},{"type":"null"}],"title":"Credentials"}},"additionalProperties":false,"type":"object","required":["credential_version"],"title":"WebsiteSiteUpdate"},"WebsiteTechnicalInput":{"properties":{"crawler":{"anyOf":[{"type":"string","enum":["Googlebot","bingbot","OAI-SearchBot"]},{"type":"null"}],"title":"Crawler"},"page_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Page Url"},"sitemap_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Sitemap Url"},"intent_confirmed":{"type":"boolean","title":"Intent Confirmed","default":false},"restore_change_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Restore Change Id"}},"additionalProperties":false,"type":"object","title":"WebsiteTechnicalInput"},"WeeklySchedule":{"properties":{"weekday":{"type":"integer","maximum":6.0,"minimum":0.0,"title":"Weekday","description":"Monday is 0, Sunday is 6."},"local_time":{"type":"string","pattern":"^\\d{2}:\\d{2}$","title":"Local Time","description":"Accepted local clock time in the responsibility's IANA timezone."}},"additionalProperties":false,"type":"object","required":["weekday","local_time"],"title":"WeeklySchedule"},"WorkAction":{"properties":{"kind":{"$ref":"#/components/schemas/WorkActionKind"},"label":{"type":"string","maxLength":100,"minLength":1,"title":"Label"},"href":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Href"}},"additionalProperties":false,"type":"object","required":["kind","label"],"title":"WorkAction"},"WorkActionKind":{"type":"string","enum":["open","review","resume","check_progress","cancel","retry","confirm"],"title":"WorkActionKind"},"WorkArrangementSuggestion":{"properties":{"source_work_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Work Id"},"source_work_revision":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Source Work Revision"},"source_read_receipt_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Source Read Receipt Id"},"evidence_summary":{"type":"string","maxLength":500,"title":"Evidence Summary"},"question":{"type":"string","maxLength":240,"minLength":1,"title":"Question"},"accept_label":{"type":"string","maxLength":60,"minLength":1,"title":"Accept Label"}},"additionalProperties":false,"type":"object","required":["evidence_summary","question","accept_label"],"title":"WorkArrangementSuggestion","description":"An optional native proposal displayed beneath its completed source work."},"WorkArtifact":{"additionalProperties":true,"type":"object"},"WorkArtifactVariant":{"properties":{"label":{"type":"string","maxLength":80,"minLength":1,"title":"Label"},"ref":{"$ref":"#/components/schemas/ResourceRef"},"media_kind":{"type":"string","enum":["image","video"],"title":"Media Kind"},"media_href":{"type":"string","maxLength":1000,"minLength":1,"title":"Media Href"},"width":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Height"}},"additionalProperties":false,"type":"object","required":["label","ref","media_kind","media_href"],"title":"WorkArtifactVariant","description":"One shape of a single creative, named by the canvas it was saved for.\n\nA platform can require the same creative in several sizes. They are not\nseparate saved work, and listed as siblings they read as one picture saved\ntwice, so they travel with the artifact that owns them."},"WorkChange":{"properties":{"label":{"type":"string","maxLength":160,"minLength":1,"title":"Label"},"before":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Before"},"after":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"After"}},"additionalProperties":false,"type":"object","required":["label"],"title":"WorkChange"},"WorkCollectionPreview":{"properties":{"title":{"type":"string","maxLength":200,"minLength":1,"title":"Title"},"rows":{"items":{"$ref":"#/components/schemas/WorkCollectionRow"},"type":"array","maxItems":8,"title":"Rows","default":[]},"total_count":{"type":"integer","minimum":0.0,"title":"Total Count"}},"additionalProperties":false,"type":"object","required":["title","total_count"],"title":"WorkCollectionPreview","description":"A compact saved shortlist or roster, with a known total and bounded rows."},"WorkCollectionRow":{"additionalProperties":true,"type":"object"},"WorkCollectionSource":{"properties":{"label":{"type":"string","maxLength":80,"minLength":1,"title":"Label"},"href":{"type":"string","maxLength":2048,"minLength":1,"title":"Href"}},"additionalProperties":false,"type":"object","required":["label","href"],"title":"WorkCollectionSource"},"WorkControlRequest":{"properties":{"organization_id":{"type":"string","format":"uuid","title":"Organization Id"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id"},"disclosure_conversation_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Disclosure Conversation Id"},"expected_revision":{"type":"integer","minimum":1.0,"title":"Expected Revision"},"action":{"type":"string","enum":["cancel","retry","confirm"],"title":"Action"},"idempotency_key":{"type":"string","format":"uuid","title":"Idempotency Key"},"accepted_acknowledgements":{"items":{"type":"string","maxLength":1000,"minLength":1},"type":"array","maxItems":5,"title":"Accepted Acknowledgements","default":[]}},"additionalProperties":false,"type":"object","required":["organization_id","company_profile_id","expected_revision","action","idempotency_key"],"title":"WorkControlRequest"},"WorkDisclosure":{"properties":{"grant_scope":{"type":"string","enum":["read","collaborate"],"title":"Grant Scope","default":"read"}},"additionalProperties":false,"type":"object","title":"WorkDisclosure"},"WorkDocumentPreview":{"properties":{"ref":{"$ref":"#/components/schemas/ResourceRef"},"version":{"type":"string","maxLength":64,"minLength":1,"title":"Version"},"body_href":{"type":"string","maxLength":1000,"minLength":1,"pattern":"^/api/","title":"Body Href"},"body_characters":{"type":"integer","maximum":120000.0,"minimum":0.0,"title":"Body Characters"},"presentation":{"type":"string","enum":["markdown","earned_media"],"title":"Presentation","default":"markdown"}},"additionalProperties":false,"type":"object","required":["ref","version","body_href","body_characters"],"title":"WorkDocumentPreview","description":"A small locator for one exact saved document version."},"WorkFollowUpPreview":{"additionalProperties":true,"type":"object"},"WorkItemSnapshot":{"additionalProperties":true,"type":"object"},"WorkListResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/WorkItemSnapshot"},"type":"array","title":"Items"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"additionalProperties":false,"type":"object","required":["items"],"title":"WorkListResponse"},"WorkPlanningPreview":{"properties":{"kind":{"type":"string","const":"brand_timing","title":"Kind","default":"brand_timing"},"state":{"type":"string","enum":["tentative","confirmed","withdrawn"],"title":"State"},"timing_label":{"type":"string","maxLength":240,"minLength":1,"pattern":"\\S","title":"Timing Label"},"duration_label":{"anyOf":[{"type":"string","maxLength":240,"minLength":1,"pattern":"\\S"},{"type":"null"}],"title":"Duration Label"},"source_label":{"anyOf":[{"type":"string","maxLength":1000,"minLength":1,"pattern":"\\S"},{"type":"null"}],"title":"Source Label"},"certainty_label":{"anyOf":[{"type":"string","maxLength":400,"minLength":1,"pattern":"\\S"},{"type":"null"}],"title":"Certainty Label"}},"additionalProperties":false,"type":"object","required":["state","timing_label"],"title":"WorkPlanningPreview","description":"Native planning context for display, never confirmation authority."},"WorkReviewMedia":{"properties":{"kind":{"type":"string","enum":["image","video"],"title":"Kind"},"href":{"type":"string","maxLength":1000,"minLength":1,"title":"Href"},"label":{"anyOf":[{"type":"string","maxLength":120,"minLength":1},{"type":"null"}],"title":"Label"},"role":{"anyOf":[{"type":"string","pattern":"^[a-z][a-z0-9_]{0,79}$"},{"type":"null"}],"title":"Role"},"width":{"anyOf":[{"type":"integer","maximum":50000.0,"minimum":1.0},{"type":"null"}],"title":"Width"},"height":{"anyOf":[{"type":"integer","maximum":50000.0,"minimum":1.0},{"type":"null"}],"title":"Height"}},"additionalProperties":false,"type":"object","required":["kind","href"],"title":"WorkReviewMedia"},"WorkState":{"type":"string","enum":["draft","queued","running","needs_input","needs_approval","scheduled","completed","partial","failed","cancelled"],"title":"WorkState"},"WorkflowStatus":{"type":"string","enum":["draft","review","approved","scheduled","sending","sent","failed"],"title":"WorkflowStatus","description":"Email campaign workflow status values."},"WorkflowUpdateRequest":{"properties":{"campaign_id":{"type":"integer","title":"Campaign Id"},"new_status":{"type":"string","pattern":"^(draft|review|approved|scheduled|sending|sent|failed)$","title":"New Status"}},"type":"object","required":["campaign_id","new_status"],"title":"WorkflowUpdateRequest","description":"Request to update workflow status"},"YouTubeSocialPostCampaignRequest":{"properties":{"campaign_id":{"type":"string","maxLength":255,"minLength":1,"title":"Campaign Id"},"idea_number":{"type":"integer","minimum":0.0,"title":"Idea Number"},"variation":{"type":"integer","minimum":0.0,"title":"Variation","default":0},"channel_id":{"type":"string","maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9_-]+$","title":"Channel Id"},"privacy_status":{"type":"string","enum":["private","unlisted","public"],"title":"Privacy Status","default":"private"},"content_format":{"type":"string","const":"short_video","title":"Content Format","default":"short_video"},"self_declared_made_for_kids":{"type":"boolean","title":"Self Declared Made For Kids"},"contains_synthetic_media":{"type":"boolean","title":"Contains Synthetic Media"},"notify_subscribers":{"type":"boolean","title":"Notify Subscribers","default":false},"category_id":{"type":"string","pattern":"^\\d{1,3}$","title":"Category Id","default":"22"},"expected_creative_state_token":{"type":"string","maxLength":64,"minLength":64,"pattern":"^[0-9a-f]{64}$","title":"Expected Creative State Token","description":"Server-issued fingerprint for the exact creative reviewed"}},"additionalProperties":false,"type":"object","required":["campaign_id","idea_number","channel_id","self_declared_made_for_kids","contains_synthetic_media","expected_creative_state_token"],"title":"YouTubeSocialPostCampaignRequest","description":"Publish the exact server-owned campaign creative the user approved."},"routes__ai_personas__GeneratePersonasRequest":{"properties":{"product_offering_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Product Offering Id"},"personas_per_group":{"type":"integer","maximum":100.0,"title":"Personas Per Group","description":"Number of personas per target group","default":50},"persona_set_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Persona Set Id"},"location":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Location"}},"type":"object","title":"GeneratePersonasRequest"},"routes__ai_testing__GeneratePersonasRequest":{"properties":{"location":{"anyOf":[{"$ref":"#/components/schemas/LocationInfo"},{"type":"null"}]},"persona_set_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona Set Name"},"persona_set_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona Set Description"}},"type":"object","title":"GeneratePersonasRequest"},"routes__external_platform__google_action__GoogleDisplayAdRequest":{"properties":{"account_id":{"type":"string","title":"Account Id","description":"Google Ads account ID"},"ad_group_id":{"type":"string","title":"Ad Group Id","description":"Ad group ID to create the ad in"},"headline":{"type":"string","title":"Headline","description":"Headline text for the ad"},"long_headline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Long Headline","description":"Long headline for responsive display ads (max 90 characters)"},"description":{"type":"string","title":"Description","description":"Description text for the ad"},"business_name":{"type":"string","title":"Business Name","description":"Business name for the ad"},"image_url":{"type":"string","title":"Image Url","description":"URL of an image to use for the ad"},"final_url":{"type":"string","title":"Final Url","description":"Landing page URL for the ad"}},"additionalProperties":false,"type":"object","required":["account_id","ad_group_id","headline","description","business_name","image_url","final_url"],"title":"GoogleDisplayAdRequest","description":"Request model for creating a Google Display ad."},"schemas__campaigns__ads__google__GoogleDisplayAdRequest":{"properties":{"product_description":{"type":"string","title":"Product Description","description":"Description of the product or service"},"target_audience":{"type":"string","title":"Target Audience","description":"Target audience description"},"company_profile_id":{"type":"string","format":"uuid","title":"Company Profile Id","description":"Company profile ID (required)"},"campaign_goals":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Campaign Goals","description":"List of campaign goals"},"key_selling_points":{"type":"string","title":"Key Selling Points","description":"Key selling points","default":""},"num_ads":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Num Ads","description":"Number of ad variations to generate","default":3},"bid_strategy":{"type":"string","title":"Bid Strategy","description":"Bidding strategy","default":"maximize_conversions"},"budget_range":{"type":"string","title":"Budget Range","description":"Budget range (low, medium, high, custom)","default":"medium"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","description":"Target country"},"state_province":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State Province","description":"Target state/province"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","description":"Target city"},"locations":{"anyOf":[{"items":{"$ref":"#/components/schemas/LocationItem"},"type":"array"},{"type":"null"}],"title":"Locations","description":"List of locations to target (countries/regions/states/cities/postal codes/proximities). This does not split budget per location; all locations share the campaign budget."},"reference_images":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":3},{"type":"null"}],"title":"Reference Images","description":"List of reference image base64 data URLs (max 3)"},"max_cpc":{"anyOf":[{"type":"number","minimum":0.01},{"type":"null"}],"title":"Max Cpc","description":"Maximum cost per click in dollars (e.g., 1.50 for $1.50). Required when bid_strategy is 'MANUAL_CPC'"},"experiment_package_id":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Experiment Package Id","description":"Test package id; created campaigns are stamped with this linkage"},"launch_strategy_mode":{"anyOf":[{"type":"string","pattern":"^(test_learn_pilot|direct_campaign)$"},{"type":"null"}],"title":"Launch Strategy Mode","description":"test_learn_pilot or direct_campaign"},"dayparting_enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Dayparting Enabled","description":"Whether dayparting/ad scheduling is enabled for this campaign","default":false},"dayparting_config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Dayparting Config","description":"Dayparting configuration including schedule, timezone, and platform-specific settings"},"num_images_per_ad":{"type":"integer","maximum":5.0,"minimum":1.0,"title":"Num Images Per Ad","description":"Number of images per ad","default":2}},"additionalProperties":false,"type":"object","required":["product_description","target_audience","company_profile_id"],"title":"GoogleDisplayAdRequest","description":"Request model for Google Display ads"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}}}