{"components":{"schemas":{"ProjectVoiceResolveRequest":{"type":"object","additionalProperties":false,"required":["providerVoiceId","language"],"properties":{"providerVoiceId":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[a-zA-Z0-9_-]+$"},"language":{"type":"string","minLength":2,"maxLength":12}}},"ProjectVoiceIdentity":{"type":"object","required":["id"],"properties":{"id":{"type":"string"}}},"ProjectVoiceIdentityEnvelope":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/ProjectVoiceIdentity"}}},"VideoFormatPreview":{"type":"object","required":["title","language","durationSeconds","videoUrl","posterUrl"],"properties":{"title":{"type":"string"},"language":{"type":"string"},"durationSeconds":{"type":"number"},"videoUrl":{"type":"string","format":"uri"},"posterUrl":{"type":"string","format":"uri"}}},"VideoFormatPreviewEnvelope":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/VideoFormatPreview"}}},"MobileAppConfigEnvelope":{"type":"object","required":["data"],"properties":{"data":{"type":"object","additionalProperties":true,"required":["clientContract","contentTypes","destinations","features","revision","videoBlueprints"],"properties":{"clientContract":{"type":"integer","minimum":1},"contentTypes":{"type":"array","items":{"type":"object","additionalProperties":true}},"destinations":{"type":"array","items":{"type":"object","additionalProperties":true}},"features":{"type":"array","items":{"type":"object","additionalProperties":true}},"revision":{"type":"string","pattern":"^[a-f0-9]{64}$"},"videoBlueprints":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}},"ProjectListPage":{"type":"object","required":["items","total","nextCursor"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Project"}},"total":{"type":"integer"},"nextCursor":{"type":"string","nullable":true}}},"ProjectListPageEnvelope":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/ProjectListPage"}}},"SeoResearchPage":{"type":"object","required":["items","total","nextCursor"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SeoResearchRun"}},"total":{"type":"integer"},"nextCursor":{"type":"string","nullable":true}}},"SeoResearchPageEnvelope":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/SeoResearchPage"}}},"AdvancedResearchPage":{"type":"object","required":["items","total","nextCursor"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/AdvancedResearchRun"}},"total":{"type":"integer"},"nextCursor":{"type":"string","nullable":true}}},"AdvancedResearchPageEnvelope":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/AdvancedResearchPage"}}},"ProjectContentItem":{"properties":{"id":{"type":"string"},"kind":{"enum":["campaign_output","campaign","reel","carousel","text_post","job"],"type":"string"},"sourceId":{"type":"string"},"title":{"type":"string"},"excerpt":{"type":"string"},"contentType":{"enum":["video","carousel","post","article","job"],"type":"string"},"status":{"type":"string"},"lifecycle":{"enum":["idea","creating","needsReview","changesRequested","ready","scheduled","publishing","published","needsAttention","cancelled"],"type":"string"},"statusGroup":{"enum":["attention","active","ready","scheduled","published","cancelled"],"type":"string"},"updatedAt":{"format":"date-time","type":"string"},"scheduledAt":{"format":"date-time","type":"string"},"scheduleEntries":{"items":{"$ref":"#/components/schemas/ProjectContentScheduleEntry"},"type":"array"},"destinations":{"items":{"type":"string"},"type":"array"},"campaignId":{"type":"string"},"outputId":{"type":"string"},"reelId":{"type":"string"},"carouselId":{"type":"string"},"jobId":{"type":"string"},"parentJobId":{"type":"string"},"platform":{"type":"string"}},"required":["id","kind","sourceId","title","excerpt","contentType","status","lifecycle","statusGroup","updatedAt","destinations"],"type":"object"},"ProjectContentScheduleEntry":{"properties":{"id":{"type":"string"},"status":{"type":"string"},"scheduledAt":{"format":"date-time","type":"string"},"destination":{"type":"string"}},"required":["id","status","scheduledAt","destination"],"type":"object"},"ProjectContentCounts":{"properties":{"all":{"type":"integer"},"attention":{"type":"integer"},"active":{"type":"integer"},"ready":{"type":"integer"},"scheduled":{"type":"integer"},"published":{"type":"integer"},"cancelled":{"type":"integer"}},"required":["all","attention","active","ready","scheduled","published","cancelled"],"type":"object"},"ProjectContentPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ProjectContentItem"},"type":"array"},"total":{"type":"integer"},"counts":{"$ref":"#/components/schemas/ProjectContentCounts"},"nextCursor":{"nullable":true,"type":"string"}},"required":["items","total","counts","nextCursor"],"type":"object"},"ProjectContentPageEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/ProjectContentPage"}},"required":["data"],"type":"object"},"ProjectContentTextPost":{"properties":{"id":{"type":"string"},"parentJobId":{"type":"string"},"platform":{"type":"string"},"format":{"type":"string"},"body":{"type":"string"},"title":{"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","parentJobId","platform","format","body","updatedAt"],"type":"object"},"ProjectContentDetail":{"properties":{"item":{"$ref":"#/components/schemas/ProjectContentItem"},"campaign":{"$ref":"#/components/schemas/ContentCampaignDetail"},"output":{"$ref":"#/components/schemas/CampaignOutput"},"reel":{"$ref":"#/components/schemas/ReelResult"},"carousel":{"$ref":"#/components/schemas/CarouselResult"},"textPost":{"$ref":"#/components/schemas/ProjectContentTextPost"},"job":{"$ref":"#/components/schemas/GenerationJobDetail"}},"required":["item"],"type":"object"},"ProjectContentDetailEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/ProjectContentDetail"}},"required":["data"],"type":"object"},"ReelResultEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/ReelResult"}},"required":["data"],"type":"object"},"CarouselResultEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/CarouselResult"}},"required":["data"],"type":"object"},"ApiError":{"properties":{"code":{"type":"string"},"details":{},"message":{"type":"string"},"requestId":{"type":"string"}},"required":["code","message","requestId"],"type":"object"},"ApiErrorEnvelope":{"properties":{"error":{"$ref":"#/components/schemas/ApiError"}},"required":["error"],"type":"object"},"AppleSignInRequest":{"properties":{"deviceId":{"type":"string"},"deviceName":{"type":"string"},"familyName":{"type":"string"},"givenName":{"type":"string"},"identityToken":{"type":"string"},"nonce":{"type":"string"}},"required":["identityToken","nonce"],"type":"object"},"GoogleSignInRequest":{"properties":{"deviceId":{"type":"string"},"deviceName":{"type":"string"},"identityToken":{"type":"string"}},"required":["identityToken"],"type":"object"},"CredentialsSignInRequest":{"properties":{"deviceId":{"type":"string"},"deviceName":{"type":"string"},"email":{"format":"email","type":"string"},"password":{"format":"password","type":"string"}},"required":["email","password"],"type":"object"},"AuthSession":{"properties":{"accessToken":{"type":"string"},"expiresIn":{"format":"int32","type":"integer"},"refreshToken":{"type":"string"},"tokenType":{"enum":["Bearer"],"type":"string"},"user":{"$ref":"#/components/schemas/MobileUser"}},"required":["accessToken","expiresIn","refreshToken","tokenType","user"],"type":"object"},"AuthSessionEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/AuthSession"}},"required":["data"],"type":"object"},"AvatarAgent":{"additionalProperties":true,"properties":{"accountCount":{"format":"int32","type":"integer"},"agentEnabled":{"type":"boolean"},"agentStatus":{"type":"string"},"contentPlanCount":{"format":"int32","type":"integer"},"defaultLanguage":{"type":"string"},"enabledLanguages":{"items":{"type":"string"},"type":"array"},"id":{"type":"string"},"identityStatus":{"type":"string"},"lastPlannedThrough":{"format":"date-time","nullable":true,"type":"string"},"name":{"type":"string"},"previewImageUrl":{"format":"uri","nullable":true,"type":"string"},"status":{"type":"string"}},"required":["id","name","status","agentEnabled","agentStatus","identityStatus"],"type":"object"},"AvatarAgentsPayload":{"properties":{"agents":{"items":{"$ref":"#/components/schemas/AvatarAgent"},"type":"array"},"manageOnWebUrl":{"format":"uri","type":"string"},"voiceOptions":{"items":{"$ref":"#/components/schemas/VoiceOption"},"type":"array"}},"required":["agents","manageOnWebUrl","voiceOptions"],"type":"object"},"AvatarAgentsEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/AvatarAgentsPayload"}},"required":["data"],"type":"object"},"AvatarVoiceFacets":{"properties":{"accents":{"items":{"type":"string"},"type":"array"},"ages":{"items":{"type":"string"},"type":"array"},"categories":{"items":{"type":"string"},"type":"array"},"descriptives":{"items":{"type":"string"},"type":"array"},"useCases":{"items":{"type":"string"},"type":"array"}},"required":["accents","ages","categories","descriptives","useCases"],"type":"object"},"AvatarVoiceOptionsPayload":{"properties":{"facets":{"$ref":"#/components/schemas/AvatarVoiceFacets"},"gender":{"enum":["female","male"],"type":"string"},"hasMore":{"type":"boolean"},"language":{"type":"string"},"page":{"minimum":0,"type":"integer"},"sort":{"enum":["trending","cloned_by_count","usage_character_count_1y","created_date"],"type":"string"},"totalCount":{"minimum":0,"type":"integer"},"usedFallback":{"type":"boolean"},"voices":{"items":{"$ref":"#/components/schemas/VoiceOption"},"type":"array"}},"required":["facets","gender","hasMore","language","page","sort","totalCount","usedFallback","voices"],"type":"object"},"AvatarVoiceOptionsEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/AvatarVoiceOptionsPayload"}},"required":["data"],"type":"object"},"AvatarReferenceUpdate":{"properties":{"consistencyPrompt":{"type":"string"},"faceReferenceAssetIds":{"items":{"type":"string"},"type":"array"},"fullBodyReferenceAssetIds":{"items":{"type":"string"},"type":"array"},"referenceNotes":{"type":"string"},"styleReferenceAssetIds":{"items":{"type":"string"},"type":"array"}},"required":["faceReferenceAssetIds","fullBodyReferenceAssetIds","styleReferenceAssetIds"],"type":"object"},"VoiceOption":{"properties":{"accent":{"nullable":true,"type":"string"},"age":{"nullable":true,"type":"string"},"descriptive":{"nullable":true,"type":"string"},"gender":{"enum":["female","male"],"type":"string"},"id":{"type":"string"},"language":{"nullable":true,"type":"string"},"languages":{"items":{"type":"string"},"type":"array"},"name":{"type":"string"},"previewUrl":{"format":"uri","nullable":true,"type":"string"},"previewUrlsByLanguage":{"additionalProperties":{"format":"uri","type":"string"},"type":"object"},"provider":{"type":"string"},"providerVoiceId":{"type":"string"},"useCase":{"nullable":true,"type":"string"}},"required":["id","name","gender","provider","providerVoiceId"],"type":"object"},"EditorialCalendarRequest":{"additionalProperties":false,"properties":{"autoExtend":{"default":true,"type":"boolean"},"businessContext":{"type":"string"},"contentPillars":{"items":{"type":"string"},"type":"array"},"destination":{"default":"wordpress","type":"string"},"generationLeadHours":{"default":72,"maximum":336,"minimum":12,"type":"integer"},"languageCode":{"default":"en","type":"string"},"minimumSearchVolume":{"default":10,"minimum":0,"type":"integer"},"name":{"type":"string"},"publishTime":{"default":"09:00","type":"string"},"publishTimeWindow":{"additionalProperties":false,"properties":{"end":{"type":"string"},"fallback":{"default":"09:30","type":"string"},"start":{"type":"string"}},"required":["start","end"],"type":"object"},"publishingConnectionId":{"type":"string"},"researchMode":{"default":"dataforseo_perplexity","enum":["business_context","dataforseo","dataforseo_perplexity"],"type":"string"},"refreshLeadDays":{"default":7,"maximum":14,"minimum":1,"type":"integer"},"reviewPolicy":{"default":"auto_publish_on_pass","enum":["manual","auto_publish_on_pass"],"type":"string"},"seedKeywords":{"items":{"type":"string"},"maxItems":20,"type":"array"},"startDate":{"format":"date","type":"string"},"timezone":{"default":"UTC","type":"string"},"weekdays":{"items":{"type":"string"},"type":"array"},"weeks":{"default":4,"maximum":4,"minimum":1,"type":"integer"}},"type":"object"},"EditorialCalendar":{"additionalProperties":true,"properties":{"autoExtend":{"type":"boolean"},"createdAt":{"format":"date-time","type":"string"},"destination":{"type":"string"},"id":{"type":"string"},"items":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"name":{"type":"string"},"projectId":{"type":"string"},"publishTime":{"type":"string"},"publishTimeWindow":{"additionalProperties":false,"properties":{"end":{"type":"string"},"fallback":{"type":"string"},"start":{"type":"string"}},"required":["start","end","fallback"],"type":"object"},"refreshErrorMessage":{"type":"string"},"refreshLeadDays":{"type":"integer"},"refreshStatus":{"type":"string"},"researchMode":{"type":"string"},"reviewPolicy":{"type":"string"},"status":{"type":"string"},"timezone":{"type":"string"},"updatedAt":{"format":"date-time","type":"string"},"weekdays":{"items":{"type":"string"},"type":"array"},"weeks":{"type":"integer"}},"required":["id","projectId","name","status","items","createdAt","updatedAt"],"type":"object"},"ContentPlanGenerateRequest":{"properties":{"avatarId":{"type":"string"},"cadence":{"enum":["daily","custom_weekdays"],"type":"string"},"days":{"maximum":7,"minimum":1,"type":"integer"},"includeExistingMaterials":{"type":"boolean"},"includeExperimentSlots":{"type":"boolean"},"startDate":{"format":"date","type":"string"},"strategy":{"enum":["story_arc","reuse_materials","experiment_mix"],"type":"string"},"theme":{"type":"string"},"timeSlots":{"items":{"type":"string"},"type":"array"},"timezone":{"type":"string"},"videosPerDay":{"maximum":5,"minimum":1,"type":"integer"},"weekdays":{"items":{"type":"string"},"type":"array"}},"type":"object"},"ContentPlanItem":{"additionalProperties":true,"properties":{"avatarId":{"nullable":true,"type":"string"},"brief":{"type":"string"},"hook":{"nullable":true,"type":"string"},"id":{"type":"string"},"pillar":{"nullable":true,"type":"string"},"scheduledAt":{"format":"date-time","type":"string"},"scheduledDate":{"format":"date","type":"string"},"scheduledTime":{"type":"string"},"status":{"type":"string"},"timezone":{"type":"string"},"title":{"type":"string"}},"required":["id","title","brief","scheduledAt","scheduledDate","scheduledTime","status","timezone"],"type":"object"},"ContentPlanItemRequest":{"additionalProperties":true,"properties":{"avatarId":{"nullable":true,"type":"string"},"brief":{"type":"string"},"hook":{"nullable":true,"type":"string"},"scheduledDate":{"format":"date","type":"string"},"scheduledTime":{"type":"string"},"status":{"type":"string"},"timezone":{"type":"string"},"title":{"type":"string"}},"type":"object"},"ContentPlanPayload":{"properties":{"avatars":{"items":{"$ref":"#/components/schemas/ContentPlanAvatar"},"type":"array"},"items":{"items":{"$ref":"#/components/schemas/ContentPlanItem"},"type":"array"},"profiles":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"range":{"properties":{"from":{"format":"date","type":"string"},"to":{"format":"date","type":"string"}},"required":["from","to"],"type":"object"}},"required":["avatars","items","profiles","range"],"type":"object"},"ContentPlanAvatar":{"properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"}},"required":["id","name","status"],"type":"object"},"ContentPlanEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/ContentPlanPayload"}},"required":["data"],"type":"object"},"DeleteAccountRequest":{"properties":{"confirmation":{"enum":["DELETE"],"type":"string"}},"required":["confirmation"],"type":"object"},"DeleteProjectRequest":{"properties":{"confirmationName":{"type":"string"}},"required":["confirmationName"],"type":"object"},"GenericEnvelope":{"properties":{"data":{"additionalProperties":true,"type":"object"}},"required":["data"],"type":"object"},"SeoResearchRequest":{"additionalProperties":false,"properties":{"idempotencyKey":{"format":"uuid","type":"string"},"languageCode":{"default":"en","type":"string"},"limit":{"default":50,"maximum":100,"minimum":10,"type":"integer"},"locationCode":{"minimum":1,"type":"integer"},"locationName":{"type":"string"},"minimumSearchVolume":{"default":10,"minimum":0,"type":"integer"},"refreshMode":{"default":"prefer_cache","enum":["prefer_cache","trends_only","metrics_only","force_full"],"type":"string"},"seedKeywords":{"items":{"type":"string"},"maxItems":10,"minItems":1,"type":"array"}},"required":["idempotencyKey","locationCode","locationName","seedKeywords"],"type":"object"},"SeoKeywordSelectionRequest":{"additionalProperties":false,"properties":{"keywordIds":{"items":{"type":"string"},"maxItems":100,"type":"array"}},"required":["keywordIds"],"type":"object"},"SeoMonthlySearch":{"additionalProperties":false,"properties":{"month":{"maximum":12,"minimum":1,"type":"integer"},"searchVolume":{"minimum":0,"type":"integer"},"year":{"type":"integer"}},"required":["month","searchVolume","year"],"type":"object"},"SeoTrendPoint":{"additionalProperties":false,"properties":{"date":{"format":"date","type":"string"},"value":{"format":"double","minimum":0,"type":"number"}},"required":["date","value"],"type":"object"},"SeoResearchSource":{"additionalProperties":false,"properties":{"cacheStatus":{"enum":["fresh","cache_hit","stale_fallback"],"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"fetchedAt":{"format":"date-time","type":"string"},"providerUpdatedAt":{"format":"date-time","type":"string"},"source":{"enum":["keyword_ideas","trends"],"type":"string"},"staleUntil":{"format":"date-time","type":"string"}},"required":["cacheStatus","expiresAt","fetchedAt","source"],"type":"object"},"SeoResearchKeyword":{"additionalProperties":false,"properties":{"competition":{"format":"double","minimum":0,"type":"number"},"competitionLevel":{"type":"string"},"cpc":{"format":"double","minimum":0,"type":"number"},"id":{"type":"string"},"keyword":{"type":"string"},"keywordDifficulty":{"format":"double","maximum":100,"minimum":0,"type":"number"},"metricsUpdatedAt":{"format":"date-time","type":"string"},"monthlySearches":{"items":{"$ref":"#/components/schemas/SeoMonthlySearch"},"type":"array"},"opportunityScore":{"format":"double","minimum":0,"type":"number"},"searchIntent":{"type":"string"},"searchVolume":{"minimum":0,"type":"integer"},"selected":{"type":"boolean"},"trendPercentage":{"format":"double","type":"number"},"trendPoints":{"items":{"$ref":"#/components/schemas/SeoTrendPoint"},"type":"array"}},"required":["id","keyword","monthlySearches","opportunityScore","selected","trendPoints"],"type":"object"},"SeoResearchRun":{"additionalProperties":false,"properties":{"cacheExpiresAt":{"format":"date-time","type":"string"},"completedAt":{"format":"date-time","type":"string"},"createdAt":{"format":"date-time","type":"string"},"errorMessage":{"type":"string"},"fromCache":{"type":"boolean"},"id":{"type":"string"},"internalCredits":{"minimum":0,"type":"integer"},"keywords":{"items":{"$ref":"#/components/schemas/SeoResearchKeyword"},"type":"array"},"languageCode":{"type":"string"},"locationCode":{"type":"integer"},"locationName":{"type":"string"},"minimumSearchVolume":{"minimum":0,"type":"integer"},"providerCost":{"format":"double","minimum":0,"type":"number"},"revalidationRunId":{"type":"string"},"refreshMode":{"enum":["prefer_cache","trends_only","metrics_only","force_full"],"type":"string"},"seedKeywords":{"items":{"type":"string"},"type":"array"},"sources":{"items":{"$ref":"#/components/schemas/SeoResearchSource"},"type":"array"},"status":{"enum":["running","succeeded","failed"],"type":"string"},"warnings":{"items":{"type":"string"},"type":"array"}},"required":["createdAt","fromCache","id","internalCredits","keywords","languageCode","locationCode","locationName","minimumSearchVolume","providerCost","refreshMode","seedKeywords","sources","status","warnings"],"type":"object"},"SeoResearchRunEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/SeoResearchRun"}},"required":["data"],"type":"object"},"SeoResearchRunsEnvelope":{"properties":{"data":{"items":{"$ref":"#/components/schemas/SeoResearchRun"},"type":"array"}},"required":["data"],"type":"object"},"SeoResearchCacheComponentEstimate":{"additionalProperties":false,"properties":{"component":{"enum":["keyword_metrics","trends"],"type":"string"},"fetchedAt":{"format":"date-time","type":"string"},"freshUntil":{"format":"date-time","type":"string"},"staleUntil":{"format":"date-time","type":"string"},"status":{"enum":["missing","fresh","stale","expired"],"type":"string"}},"required":["component","status"],"type":"object"},"SeoResearchCostEstimate":{"additionalProperties":false,"properties":{"components":{"items":{"$ref":"#/components/schemas/SeoResearchCacheComponentEstimate"},"type":"array"},"currency":{"enum":["USD"],"type":"string"},"estimatedProviderCostMax":{"format":"double","minimum":0,"type":"number"},"internalCredits":{"minimum":0,"type":"integer"},"providerCalls":{"items":{"enum":["keyword_ideas","trends"],"type":"string"},"type":"array"},"refreshMode":{"enum":["prefer_cache","trends_only","metrics_only","force_full"],"type":"string"},"requiresConfirmation":{"type":"boolean"}},"required":["components","currency","estimatedProviderCostMax","internalCredits","providerCalls","refreshMode","requiresConfirmation"],"type":"object"},"SeoResearchCostEstimateEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/SeoResearchCostEstimate"}},"required":["data"],"type":"object"},"AdvancedResearchRequest":{"additionalProperties":false,"properties":{"appCategory":{"type":"string"},"appCollection":{"enum":["top_free_ios","top_paid_ios","top_grossing_ios","new_ios","new_free_ios","new_paid_ios","featured","topselling_paid","topselling_free","topselling_new_free","topselling_new_paid","topgrossing","movers_shakers"],"type":"string"},"appIds":{"default":[],"items":{"type":"string"},"maxItems":20,"type":"array"},"domains":{"default":[],"items":{"type":"string"},"maxItems":20,"type":"array"},"idempotencyKey":{"format":"uuid","type":"string"},"keywords":{"default":[],"items":{"type":"string"},"maxItems":1000,"type":"array"},"languageCode":{"default":"en","type":"string"},"limit":{"default":100,"maximum":1000,"minimum":1,"type":"integer"},"locationCode":{"minimum":1,"type":"integer"},"locationName":{"type":"string"},"store":{"enum":["apple","google"],"type":"string"},"workflow":{"enum":["keyword_overview","search_intent","bulk_keyword_difficulty","related_keywords","keyword_suggestions","keywords_for_site","ranked_keywords","relevant_pages","competitors_domain","serp_competitors","domain_intersection","page_intersection","serp_organic_advanced","app_search","app_info","app_list","app_reviews","aso_keywords_for_app","aso_app_competitors","aso_app_intersection","aso_bulk_app_metrics"],"type":"string"}},"required":["idempotencyKey","locationCode","locationName","workflow"],"type":"object"},"AdvancedResearchAppCatalog":{"additionalProperties":false,"properties":{"categories":{"items":{"type":"string"},"type":"array"},"collections":{"items":{"type":"string"},"type":"array"},"store":{"enum":["apple","google"],"type":"string"}},"required":["categories","collections","store"],"type":"object"},"AdvancedResearchAppCatalogEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/AdvancedResearchAppCatalog"}},"required":["data"],"type":"object"},"OpportunityScoreBreakdown":{"additionalProperties":false,"properties":{"authority":{"format":"double","maximum":1,"minimum":0,"type":"number"},"competition":{"format":"double","maximum":1,"minimum":0,"type":"number"},"freshness":{"format":"double","maximum":1,"minimum":0,"type":"number"},"intent":{"format":"double","maximum":1,"minimum":0,"type":"number"},"platformSuitability":{"format":"double","maximum":1,"minimum":0,"type":"number"},"trend":{"format":"double","maximum":1,"minimum":0,"type":"number"},"volume":{"format":"double","maximum":1,"minimum":0,"type":"number"}},"required":["authority","competition","freshness","intent","platformSuitability","trend","volume"],"type":"object"},"AdvancedResearchEvidence":{"additionalProperties":false,"properties":{"appId":{"type":"string"},"description":{"type":"string"},"domain":{"type":"string"},"id":{"type":"string"},"intent":{"type":"string"},"keyword":{"type":"string"},"keywordDifficulty":{"format":"double","maximum":100,"minimum":0,"type":"number"},"opportunityScore":{"format":"double","maximum":100,"minimum":0,"type":"number"},"rank":{"format":"double","minimum":0,"type":"number"},"rating":{"format":"double","maximum":5,"minimum":0,"type":"number"},"reviewCount":{"minimum":0,"type":"integer"},"scoreBreakdown":{"$ref":"#/components/schemas/OpportunityScoreBreakdown"},"searchVolume":{"minimum":0,"type":"integer"},"selected":{"default":false,"type":"boolean"},"serpFeatures":{"items":{"type":"string"},"type":"array"},"title":{"type":"string"},"updatedAt":{"format":"date-time","type":"string"},"url":{"type":"string"}},"required":["id","opportunityScore","scoreBreakdown","selected","serpFeatures"],"type":"object"},"AdvancedResearchTopicCluster":{"additionalProperties":false,"properties":{"intent":{"type":"string"},"keywords":{"items":{"type":"string"},"type":"array"},"name":{"type":"string"}},"required":["keywords","name"],"type":"object"},"AdvancedResearchInsights":{"additionalProperties":false,"properties":{"aiOverviewOpportunities":{"items":{"type":"string"},"type":"array"},"contentRefreshRecommendations":{"items":{"type":"string"},"type":"array"},"discussionOpportunities":{"items":{"type":"string"},"type":"array"},"featuredSnippetOpportunities":{"items":{"type":"string"},"type":"array"},"internalLinkRecommendations":{"items":{"type":"string"},"type":"array"},"peopleAlsoAsk":{"items":{"type":"string"},"type":"array"},"recurringComplaints":{"items":{"type":"string"},"type":"array"},"reviewNeeds":{"items":{"type":"string"},"type":"array"},"topicClusters":{"items":{"$ref":"#/components/schemas/AdvancedResearchTopicCluster"},"type":"array"},"videoOpportunities":{"items":{"type":"string"},"type":"array"}},"required":["aiOverviewOpportunities","contentRefreshRecommendations","discussionOpportunities","featuredSnippetOpportunities","internalLinkRecommendations","peopleAlsoAsk","recurringComplaints","reviewNeeds","topicClusters","videoOpportunities"],"type":"object"},"AsoAppleMetadata":{"additionalProperties":false,"properties":{"description":{"type":"string"},"keywordField":{"type":"string"},"promotionalText":{"type":"string"},"releaseNotes":{"type":"string"},"subtitle":{"type":"string"},"title":{"type":"string"}},"required":["description","keywordField","promotionalText","releaseNotes","subtitle","title"],"type":"object"},"AsoGoogleMetadata":{"additionalProperties":false,"properties":{"fullDescription":{"type":"string"},"releaseNotes":{"type":"string"},"shortDescription":{"type":"string"},"title":{"type":"string"}},"required":["fullDescription","releaseNotes","shortDescription","title"],"type":"object"},"AsoScreenshotBrief":{"additionalProperties":false,"properties":{"headline":{"type":"string"},"visualDirection":{"type":"string"}},"required":["headline","visualDirection"],"type":"object"},"AsoMetadataRecommendations":{"additionalProperties":false,"properties":{"apple":{"$ref":"#/components/schemas/AsoAppleMetadata"},"google":{"$ref":"#/components/schemas/AsoGoogleMetadata"},"screenshotBriefs":{"items":{"$ref":"#/components/schemas/AsoScreenshotBrief"},"type":"array"}},"required":["screenshotBriefs"],"type":"object"},"AdvancedResearchRun":{"additionalProperties":false,"properties":{"asoRecommendations":{"$ref":"#/components/schemas/AsoMetadataRecommendations"},"completedAt":{"format":"date-time","type":"string"},"createdAt":{"format":"date-time","type":"string"},"evidence":{"items":{"$ref":"#/components/schemas/AdvancedResearchEvidence"},"type":"array"},"fetchedAt":{"format":"date-time","type":"string"},"freshUntil":{"format":"date-time","type":"string"},"id":{"type":"string"},"insights":{"$ref":"#/components/schemas/AdvancedResearchInsights"},"internalCredits":{"minimum":0,"type":"integer"},"providerCost":{"format":"double","minimum":0,"type":"number"},"providerTaskId":{"type":"string"},"request":{"$ref":"#/components/schemas/AdvancedResearchRequest"},"staleUntil":{"format":"date-time","type":"string"},"status":{"enum":["queued","running","waiting_provider","succeeded","failed"],"type":"string"},"warnings":{"items":{"type":"string"},"type":"array"}},"required":["createdAt","evidence","id","insights","internalCredits","providerCost","request","status","warnings"],"type":"object"},"AdvancedResearchRunEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/AdvancedResearchRun"}},"required":["data"],"type":"object"},"AdvancedResearchRunsEnvelope":{"properties":{"data":{"items":{"$ref":"#/components/schemas/AdvancedResearchRun"},"type":"array"}},"required":["data"],"type":"object"},"AdvancedResearchSelectionRequest":{"additionalProperties":false,"properties":{"evidenceIds":{"items":{"type":"string"},"maxItems":1000,"type":"array"}},"required":["evidenceIds"],"type":"object"},"AdvancedResearchCostEstimate":{"additionalProperties":false,"properties":{"cacheStatus":{"enum":["missing","fresh","stale","expired"],"type":"string"},"estimatedProviderCostMax":{"format":"double","minimum":0,"type":"number"},"freshUntil":{"format":"date-time","type":"string"},"internalCredits":{"minimum":0,"type":"integer"},"providerEndpoint":{"type":"string"},"requiresConfirmation":{"type":"boolean"},"staleUntil":{"format":"date-time","type":"string"}},"required":["cacheStatus","estimatedProviderCostMax","internalCredits","providerEndpoint","requiresConfirmation"],"type":"object"},"AdvancedResearchCostEstimateEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/AdvancedResearchCostEstimate"}},"required":["data"],"type":"object"},"CampaignEvidenceReference":{"additionalProperties":false,"properties":{"evidenceId":{"type":"string"},"runId":{"type":"string"},"source":{"enum":["seo","advanced"],"type":"string"}},"required":["evidenceId","runId","source"],"type":"object"},"CampaignMarket":{"additionalProperties":false,"properties":{"countryCode":{"type":"string"},"languageCode":{"type":"string"},"locationCode":{"type":"integer"},"locationName":{"type":"string"}},"required":["countryCode","languageCode","locationCode","locationName"],"type":"object"},"CampaignSchedule":{"additionalProperties":false,"properties":{"cadence":{"enum":["once","daily","weekly","custom"],"type":"string"},"cronExpression":{"type":"string"},"publishAt":{"format":"date-time","type":"string"},"timezone":{"type":"string"}},"required":["cadence","timezone"],"type":"object"},"ContentCampaign":{"additionalProperties":false,"properties":{"analytics":{"$ref":"#/components/schemas/JsonObject"},"audience":{"type":"string"},"brandVoice":{"type":"string"},"concept":{"$ref":"#/components/schemas/JsonObject"},"contentPillars":{"items":{"type":"string"},"type":"array"},"createdAt":{"format":"date-time","type":"string"},"destinations":{"items":{"type":"string"},"type":"array"},"evidence":{"items":{"$ref":"#/components/schemas/CampaignEvidenceReference"},"type":"array"},"funnelStage":{"enum":["top","middle","bottom","retention"],"type":"string"},"goal":{"enum":["awareness","education","consideration","conversion","retention","launch"],"type":"string"},"id":{"type":"string"},"market":{"$ref":"#/components/schemas/CampaignMarket"},"name":{"type":"string"},"personas":{"items":{"type":"string"},"type":"array"},"primaryNarrative":{"type":"string"},"productOffer":{"type":"string"},"projectId":{"type":"string"},"provenance":{"$ref":"#/components/schemas/JsonObject"},"schedule":{"$ref":"#/components/schemas/CampaignSchedule"},"status":{"enum":["draft","generating","in_review","approved","scheduled","publishing","completed","failed","cancelled"],"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["analytics","audience","brandVoice","contentPillars","createdAt","destinations","evidence","funnelStage","goal","id","market","name","personas","productOffer","projectId","provenance","status","updatedAt"],"type":"object"},"EditorialFeedbackInput":{"additionalProperties":false,"properties":{"reason":{"enum":["generic","wrong_voice","incorrect_fact","weak_hook","repeated_topic","visual_mismatch"],"type":"string"},"target":{"minLength":1,"maxLength":200,"type":"string"},"note":{"minLength":1,"maxLength":1000,"type":"string"},"approvedForReuse":{"type":"boolean"}},"required":["reason","target","note","approvedForReuse"],"type":"object"},"EditorialFeedback":{"additionalProperties":false,"properties":{"reason":{"enum":["generic","wrong_voice","incorrect_fact","weak_hook","repeated_topic","visual_mismatch"],"type":"string"},"target":{"minLength":1,"maxLength":200,"type":"string"},"note":{"minLength":1,"maxLength":1000,"type":"string"},"approvedForReuse":{"type":"boolean"},"revision":{"minimum":1,"type":"integer"},"updatedAt":{"format":"date-time","type":"string"}},"required":["reason","target","note","approvedForReuse","revision","updatedAt"],"type":"object"},"CampaignOutput":{"additionalProperties":false,"properties":{"editorialFeedback":{"$ref":"#/components/schemas/EditorialFeedback"},"approvalNote":{"type":"string"},"approvedAt":{"format":"date-time","type":"string"},"brief":{"$ref":"#/components/schemas/JsonObject"},"campaignId":{"type":"string"},"content":{"$ref":"#/components/schemas/JsonObject"},"createdAt":{"format":"date-time","type":"string"},"destination":{"type":"string"},"errorMessage":{"type":"string"},"id":{"type":"string"},"provider":{"type":"string"},"publishedAt":{"format":"date-time","type":"string"},"quality":{"$ref":"#/components/schemas/JsonObject"},"revision":{"type":"integer"},"scheduledFor":{"format":"date-time","type":"string"},"status":{"enum":["queued","generating","draft","approved","rejected","scheduled","publishing","published","failed","cancelled"],"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["brief","campaignId","createdAt","destination","id","revision","status","updatedAt"],"type":"object"},"ContentCampaignDetail":{"additionalProperties":false,"properties":{"campaign":{"$ref":"#/components/schemas/ContentCampaign"},"outputs":{"items":{"$ref":"#/components/schemas/CampaignOutput"},"type":"array"}},"required":["campaign","outputs"],"type":"object"},"ContentCampaignDetailEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/ContentCampaignDetail"}},"required":["data"],"type":"object"},"ContentCampaignsEnvelope":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ContentCampaignDetail"},"type":"array"}},"required":["data"],"type":"object"},"CreateContentCampaignRequest":{"additionalProperties":false,"properties":{"audience":{"type":"string"},"brandVoice":{"type":"string"},"contentPillars":{"items":{"type":"string"},"type":"array"},"destinations":{"items":{"type":"string"},"type":"array"},"evidence":{"items":{"$ref":"#/components/schemas/CampaignEvidenceReference"},"type":"array"},"funnelStage":{"enum":["top","middle","bottom","retention"],"type":"string"},"goal":{"enum":["awareness","education","consideration","conversion","retention","launch"],"type":"string"},"idempotencyKey":{"format":"uuid","type":"string"},"market":{"$ref":"#/components/schemas/CampaignMarket"},"name":{"type":"string"},"personas":{"items":{"type":"string"},"type":"array"},"primaryNarrative":{"type":"string"},"productOffer":{"type":"string"},"providerProfile":{"enum":["mock","standard","premium"],"type":"string"},"selectedAssetIds":{"items":{"maxLength":191,"minLength":1,"type":"string"},"maxItems":10,"type":"array","uniqueItems":true},"schedule":{"$ref":"#/components/schemas/CampaignSchedule"}},"required":["audience","brandVoice","contentPillars","destinations","evidence","funnelStage","goal","idempotencyKey","market","name","personas","productOffer"],"type":"object"},"GenerateCampaignOutputsRequest":{"additionalProperties":false,"properties":{"destinations":{"items":{"type":"string"},"type":"array"},"idempotencyKey":{"format":"uuid","type":"string"}},"required":["idempotencyKey"],"type":"object"},"CampaignOutputEditRequest":{"additionalProperties":false,"description":"Provide content and/or feedback. Feedback changes require expectedFeedbackUpdatedAt; null feedback withdraws the saved note. Null expectedFeedbackUpdatedAt means no existing feedback.","properties":{"content":{"$ref":"#/components/schemas/JsonObject"},"expectedRevision":{"minimum":1,"type":"integer"},"expectedFeedbackUpdatedAt":{"format":"date-time","type":["string","null"]},"feedback":{"anyOf":[{"$ref":"#/components/schemas/EditorialFeedbackInput"},{"type":"null"}]},"idempotencyKey":{"format":"uuid","type":"string"}},"required":["expectedRevision"],"anyOf":[{"required":["content"]},{"required":["feedback","expectedFeedbackUpdatedAt"]}],"dependentRequired":{"feedback":["expectedFeedbackUpdatedAt"]},"type":"object"},"CampaignOutputApprovalRequest":{"additionalProperties":false,"description":"Feedback changes require expectedFeedbackUpdatedAt; null withdraws feedback.","properties":{"decision":{"enum":["approved","rejected"],"type":"string"},"expectedRevision":{"minimum":1,"type":"integer"},"expectedFeedbackUpdatedAt":{"format":"date-time","type":["string","null"]},"feedback":{"anyOf":[{"$ref":"#/components/schemas/EditorialFeedbackInput"},{"type":"null"}]},"idempotencyKey":{"format":"uuid","type":"string"},"note":{"maxLength":2000,"type":"string"}},"required":["decision","expectedRevision"],"dependentRequired":{"feedback":["expectedFeedbackUpdatedAt"]},"type":"object"},"CampaignOutputRegenerationRequest":{"additionalProperties":false,"description":"Feedback changes require expectedFeedbackUpdatedAt; null withdraws feedback. Scope review evaluates the current copy without rewriting it.","properties":{"expectedRevision":{"minimum":1,"type":"integer"},"expectedFeedbackUpdatedAt":{"format":"date-time","type":["string","null"]},"feedback":{"anyOf":[{"$ref":"#/components/schemas/EditorialFeedbackInput"},{"type":"null"}]},"idempotencyKey":{"format":"uuid","type":"string"},"instructions":{"maxLength":2000,"type":"string"},"scope":{"enum":["full","section","slide","hook","caption","scene","cta","visual","review"],"type":"string"},"target":{"minLength":1,"maxLength":200,"type":"string"}},"required":["expectedRevision","idempotencyKey","scope"],"dependentRequired":{"feedback":["expectedFeedbackUpdatedAt"]},"type":"object"},"PublishingCertificationEvidence":{"additionalProperties":false,"properties":{"action":{"type":"string"},"actorId":{"type":"string"},"details":{"$ref":"#/components/schemas/JsonObject"},"result":{"enum":["passed","failed","recorded"],"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["action","details","result","timestamp"],"type":"object"},"PublishingConnection":{"additionalProperties":false,"properties":{"adapterId":{"type":"string"},"certificationEvidence":{"items":{"$ref":"#/components/schemas/PublishingCertificationEvidence"},"type":"array"},"certificationFailureReason":{"type":"string"},"certificationNotes":{"type":"string"},"certificationState":{"enum":["configuration_missing","connected","oauth_verified","sandbox_verified","draft_verified","publishing_verified","reconciliation_verified","production_enabled","suspended","export_only"],"type":"string"},"certificationUpdatedAt":{"format":"date-time","type":"string"},"connectedAt":{"format":"date-time","type":"string"},"configuration":{"$ref":"#/components/schemas/JsonObject"},"createdAt":{"format":"date-time","type":"string"},"destination":{"type":"string"},"draftVerifiedAt":{"format":"date-time","type":"string"},"expiresAt":{"format":"date-time","type":"string"},"id":{"type":"string"},"label":{"type":"string"},"lastError":{"type":"string"},"lastReconciliationAt":{"format":"date-time","type":"string"},"lastSuccessfulDraftAt":{"format":"date-time","type":"string"},"lastSuccessfulPublishAt":{"format":"date-time","type":"string"},"lastSuccessfulValidationAt":{"format":"date-time","type":"string"},"lastVerifiedAt":{"format":"date-time","type":"string"},"oauthVerifiedAt":{"format":"date-time","type":"string"},"productionEnabledAt":{"format":"date-time","type":"string"},"productionEnabledById":{"type":"string"},"projectId":{"type":"string"},"providerAccountIdentity":{"$ref":"#/components/schemas/JsonObject"},"publishingVerifiedAt":{"format":"date-time","type":"string"},"reconciliationVerifiedAt":{"format":"date-time","type":"string"},"sandboxVerifiedAt":{"format":"date-time","type":"string"},"scopes":{"items":{"type":"string"},"type":"array"},"status":{"enum":["configuration_required","connecting","ready","error","revoked"],"type":"string"},"suspendedAt":{"format":"date-time","type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["adapterId","certificationEvidence","certificationState","configuration","createdAt","destination","id","label","projectId","scopes","status","updatedAt"],"type":"object"},"PublishingConnectionEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/PublishingConnection"}},"required":["data"],"type":"object"},"PublishingConnectionsEnvelope":{"properties":{"data":{"items":{"$ref":"#/components/schemas/PublishingConnection"},"type":"array"}},"required":["data"],"type":"object"},"CreatePublishingConnectionRequest":{"additionalProperties":false,"properties":{"configuration":{"$ref":"#/components/schemas/JsonObject"},"credentials":{"$ref":"#/components/schemas/JsonObject"},"destination":{"type":"string"},"label":{"type":"string"}},"required":["configuration","credentials","destination","label"],"type":"object"},"CreateOfficialPublishingConnectionRequest":{"additionalProperties":false,"properties":{"accountIdentifier":{"description":"Exact Bluesky handle/DID or Reddit username. Passwords, client secrets, access tokens, and refresh tokens are never accepted.","maxLength":253,"minLength":3,"type":"string"},"automationAccountConfirmed":{"description":"Reddit only: confirms the selected account is dedicated to approved app automation and is not mixed-use.","type":"boolean"},"botToken":{"maxLength":256,"minLength":20,"type":"string","writeOnly":true},"channelId":{"description":"Public @username or negative integral Bot API channel ID; numeric IDs are additionally bounded to at most 52 significant bits.","maxLength":64,"minLength":1,"pattern":"^(?:@[A-Za-z0-9_]{5,32}|-[1-9][0-9]*)$","type":"string"},"disableLinkPreview":{"type":"boolean"},"label":{"maxLength":160,"minLength":1,"type":"string"},"platform":{"enum":["tiktok","instagram","youtube","facebook","threads","linkedin","x","pinterest","telegram","bluesky","reddit","snapchat"],"type":"string"},"providerAccountId":{"description":"Exact Facebook Page ID, Pinterest board ID, or Snapchat Public Profile UUID. OAuth client secrets are server-owned.","maxLength":64,"type":"string"},"subreddit":{"description":"Reddit only: exact subreddit without r/.","maxLength":21,"minLength":3,"pattern":"^[A-Za-z0-9_]{3,21}$","type":"string"}},"required":["label","platform"],"type":"object"},"UpdatePublishingCertificationRequest":{"additionalProperties":false,"properties":{"action":{"enum":["mark_connected","mark_oauth_verified","mark_sandbox_verified","mark_draft_verified","mark_publishing_verified","mark_reconciliation_verified","enable_production","suspend","resume"],"type":"string"},"evidence":{"$ref":"#/components/schemas/JsonObject"},"failureReason":{"type":"string"},"notes":{"type":"string"},"providerAccountIdentity":{"$ref":"#/components/schemas/JsonObject"},"result":{"enum":["passed","failed"],"type":"string"}},"required":["action"],"type":"object"},"PublishingPreviewRequest":{"additionalProperties":false,"properties":{"connectionId":{"type":"string"}},"required":["connectionId"],"type":"object"},"PublishingPreview":{"additionalProperties":false,"properties":{"body":{},"headers":{"additionalProperties":{"type":"string"},"type":"object"},"method":{"enum":["GET","POST","PUT","PATCH","DELETE"],"type":"string"},"redacted":{"type":"boolean"},"url":{"format":"uri","type":"string"}},"required":["body","headers","method","redacted","url"],"type":"object"},"PublishingPreviewEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/PublishingPreview"}},"required":["data"],"type":"object"},"CampaignPublishRequest":{"additionalProperties":false,"properties":{"connectionId":{"type":"string"},"expectedRevision":{"minimum":1,"type":"integer"},"idempotencyKey":{"format":"uuid","type":"string"},"mode":{"enum":["draft","publish"],"type":"string"},"scheduledFor":{"format":"date-time","type":"string"}},"required":["connectionId","expectedRevision","idempotencyKey"],"type":"object"},"CampaignPublishAttempt":{"additionalProperties":false,"properties":{"attemptCount":{"type":"integer"},"campaignId":{"type":"string"},"connectionId":{"type":"string"},"createdAt":{"format":"date-time","type":"string"},"deadLetterAt":{"format":"date-time","type":"string"},"destination":{"type":"string"},"errorMessage":{"type":"string"},"externalId":{"type":"string"},"id":{"type":"string"},"mode":{"enum":["draft","publish"],"type":"string"},"nextAttemptAt":{"format":"date-time","type":"string"},"operationId":{"pattern":"^campaign_publish:[A-Za-z0-9_-]+$","type":"string"},"operationStatus":{"enum":["queued","running","needs_input","needs_approval","partial","succeeded","failed","cancelled","ambiguous"],"type":"string"},"outputId":{"type":"string"},"permalink":{"format":"uri","type":"string"},"providerStatus":{"type":"string"},"providerSubmittedAt":{"format":"date-time","type":"string"},"publishedAt":{"format":"date-time","type":"string"},"reconciledAt":{"format":"date-time","type":"string"},"revision":{"type":"integer"},"scheduledFor":{"format":"date-time","type":"string"},"status":{"enum":["queued","publishing","processing","published","retrying","failed","cancelled","dead_letter"],"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["attemptCount","campaignId","connectionId","createdAt","destination","id","mode","operationId","operationStatus","outputId","revision","status","updatedAt"],"type":"object"},"CampaignPublishAttemptEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/CampaignPublishAttempt"}},"required":["data"],"type":"object"},"CampaignPublishAttemptsEnvelope":{"properties":{"data":{"items":{"$ref":"#/components/schemas/CampaignPublishAttempt"},"type":"array"}},"required":["data"],"type":"object"},"OperationAction":{"additionalProperties":false,"properties":{"href":{"type":"string"},"kind":{"enum":["cancel","retry","verify_provider","open_result","wait"],"type":"string"},"label":{"type":"string"}},"required":["kind","label"],"type":"object"},"OperationEvent":{"additionalProperties":false,"properties":{"at":{"format":"date-time","type":"string"},"details":{"$ref":"#/components/schemas/JsonObject"},"id":{"type":"string"},"message":{"type":"string"},"status":{"enum":["queued","running","needs_input","needs_approval","partial","succeeded","failed","cancelled","ambiguous"],"type":"string"},"type":{"type":"string"}},"required":["at","details","id","message","type"],"type":"object"},"OperationSubject":{"additionalProperties":false,"properties":{"attemptId":{"type":"string"},"campaignId":{"type":"string"},"connectionId":{"type":"string"},"destination":{"type":"string"},"outputId":{"type":"string"},"revision":{"minimum":1,"type":"integer"}},"required":["attemptId","campaignId","connectionId","destination","outputId","revision"],"type":"object"},"Operation":{"additionalProperties":false,"properties":{"completedAt":{"format":"date-time","type":"string"},"createdAt":{"format":"date-time","type":"string"},"events":{"items":{"$ref":"#/components/schemas/OperationEvent"},"type":"array"},"humanActionPath":{"type":"string"},"id":{"pattern":"^campaign_publish:[A-Za-z0-9_-]+$","type":"string"},"nextActions":{"items":{"$ref":"#/components/schemas/OperationAction"},"type":"array"},"projectId":{"type":"string"},"resultUrl":{"format":"uri","type":"string"},"status":{"enum":["queued","running","needs_input","needs_approval","partial","succeeded","failed","cancelled","ambiguous"],"type":"string"},"subject":{"$ref":"#/components/schemas/OperationSubject"},"type":{"enum":["campaign_publish"],"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["createdAt","events","id","nextActions","projectId","status","subject","type","updatedAt"],"type":"object"},"OperationEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/Operation"}},"required":["data"],"type":"object"},"PublishingOAuthStartResponse":{"additionalProperties":false,"properties":{"authorizationUrl":{"format":"uri","type":"string"},"expiresAt":{"format":"date-time","type":"string"}},"required":["authorizationUrl","expiresAt"],"type":"object"},"PublishingOAuthStartEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/PublishingOAuthStartResponse"}},"required":["data"],"type":"object"},"ProjectOperationsBudget":{"additionalProperties":false,"properties":{"alertThresholdPercent":{"type":"integer"},"projectDailyAdvancedCreditLimit":{"type":"integer"},"projectDailyProviderCostLimitUsd":{"format":"double","type":"number"},"projectDailySeoCreditLimit":{"type":"integer"},"providerCostAlert":{"type":"boolean"},"userDailyAdvancedCreditLimit":{"type":"integer"},"userDailySeoCreditLimit":{"type":"integer"}},"required":["alertThresholdPercent","projectDailyAdvancedCreditLimit","projectDailyProviderCostLimitUsd","projectDailySeoCreditLimit","providerCostAlert","userDailyAdvancedCreditLimit","userDailySeoCreditLimit"],"type":"object"},"ProjectOperationsConnections":{"additionalProperties":false,"properties":{"byCertification":{"additionalProperties":{"type":"integer"},"type":"object"},"byStatus":{"additionalProperties":{"type":"integer"},"type":"object"},"productionEnabled":{"type":"integer"},"ready":{"type":"integer"},"total":{"type":"integer"}},"required":["byCertification","byStatus","productionEnabled","ready","total"],"type":"object"},"ProjectOperationsProviderStatus":{"additionalProperties":false,"properties":{"destination":{"type":"string"},"enabled":{"type":"boolean"},"productionEnabledConnections":{"type":"integer"},"readyConnections":{"type":"integer"},"state":{"enum":["live","configuration_required","export_only","unavailable"],"type":"string"}},"required":["destination","enabled","productionEnabledConnections","readyConnections","state"],"type":"object"},"ProjectOperationsPublishing":{"additionalProperties":false,"properties":{"byStatus":{"additionalProperties":{"type":"integer"},"type":"object"},"deadLetters":{"type":"integer"},"failedLast24Hours":{"type":"integer"},"publishedLast24Hours":{"type":"integer"},"totalLast30Days":{"type":"integer"}},"required":["byStatus","deadLetters","failedLast24Hours","publishedLast24Hours","totalLast30Days"],"type":"object"},"ProjectOperationsResearchDay":{"additionalProperties":false,"properties":{"date":{"format":"date","type":"string"},"internalCredits":{"type":"integer"},"providerCostUsd":{"format":"double","type":"number"}},"required":["date","internalCredits","providerCostUsd"],"type":"object"},"ProjectOperationsResearch":{"additionalProperties":false,"properties":{"availableUserCredits":{"type":"integer"},"cacheHitRate":{"format":"double","type":"number"},"daily":{"items":{"$ref":"#/components/schemas/ProjectOperationsResearchDay"},"type":"array"},"internalCreditsLast30Days":{"type":"integer"},"internalCreditsToday":{"type":"integer"},"providerCostLast30DaysUsd":{"format":"double","type":"number"},"providerCostTodayUsd":{"format":"double","type":"number"},"runsLast30Days":{"type":"integer"}},"required":["availableUserCredits","cacheHitRate","daily","internalCreditsLast30Days","internalCreditsToday","providerCostLast30DaysUsd","providerCostTodayUsd","runsLast30Days"],"type":"object"},"ProjectOperationsGenerationCall":{"additionalProperties":false,"properties":{"billableUnits":{"$ref":"#/components/schemas/JsonObject"},"capability":{"type":"string"},"costSource":{"type":"string"},"costStatus":{"enum":["exact","estimated","not_billable","unpriced"],"type":"string"},"costUsd":{"format":"double","type":"number"},"id":{"type":"string"},"latencyMs":{"type":"integer"},"model":{"type":"string"},"output":{"type":"string"},"provider":{"type":"string"},"providerRequestId":{"type":"string"},"status":{"enum":["queued","running","paused","succeeded","failed","cancelled"],"type":"string"}},"required":["capability","costSource","costStatus","costUsd","id","provider","status"],"type":"object"},"ProjectOperationsGenerationJob":{"additionalProperties":false,"properties":{"calls":{"items":{"$ref":"#/components/schemas/ProjectOperationsGenerationCall"},"type":"array"},"completedAt":{"format":"date-time","type":"string"},"costCoverage":{"enum":["exact","estimated","partial","unpriced","not_billable"],"type":"string"},"costUsd":{"format":"double","type":"number"},"createdAt":{"format":"date-time","type":"string"},"id":{"type":"string"},"label":{"type":"string"},"productType":{"enum":["reel","carousel","blog","content"],"type":"string"},"status":{"enum":["queued","running","paused","succeeded","failed","cancelled"],"type":"string"}},"required":["calls","costCoverage","costUsd","createdAt","id","label","productType","status"],"type":"object"},"ProjectOperationsGenerationCosts":{"additionalProperties":false,"properties":{"callsLast30Days":{"type":"integer"},"estimatedCostLast30DaysUsd":{"format":"double","type":"number"},"exactCostLast30DaysUsd":{"format":"double","type":"number"},"jobs":{"items":{"$ref":"#/components/schemas/ProjectOperationsGenerationJob"},"type":"array"},"jobsLast30Days":{"type":"integer"},"pricedCallsLast30Days":{"type":"integer"},"totalCostLast30DaysUsd":{"format":"double","type":"number"},"unpricedCallsLast30Days":{"type":"integer"}},"required":["callsLast30Days","estimatedCostLast30DaysUsd","exactCostLast30DaysUsd","jobs","jobsLast30Days","pricedCallsLast30Days","totalCostLast30DaysUsd","unpricedCallsLast30Days"],"type":"object"},"ProjectOperationsSummary":{"additionalProperties":false,"properties":{"budget":{"$ref":"#/components/schemas/ProjectOperationsBudget"},"connections":{"$ref":"#/components/schemas/ProjectOperationsConnections"},"generatedAt":{"format":"date-time","type":"string"},"generationCosts":{"$ref":"#/components/schemas/ProjectOperationsGenerationCosts"},"providerStatuses":{"items":{"$ref":"#/components/schemas/ProjectOperationsProviderStatus"},"type":"array"},"publishing":{"$ref":"#/components/schemas/ProjectOperationsPublishing"},"research":{"$ref":"#/components/schemas/ProjectOperationsResearch"}},"required":["budget","connections","generatedAt","generationCosts","providerStatuses","publishing","research"],"type":"object"},"ProjectOperationsSummaryEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/ProjectOperationsSummary"}},"required":["data"],"type":"object"},"AnalyticsConnection":{"additionalProperties":false,"properties":{"availability":{"enum":["official_api","public_api","manual_import","unavailable"],"type":"string"},"createdAt":{"format":"date-time","type":"string"},"expiresAt":{"format":"date-time","type":"string"},"id":{"type":"string"},"label":{"type":"string"},"lastError":{"type":"string"},"lastSyncedAt":{"format":"date-time","type":"string"},"lastVerifiedAt":{"format":"date-time","type":"string"},"projectId":{"type":"string"},"provider":{"enum":["google_search_console","google_analytics_4","youtube","meta","tiktok","linkedin","x","pinterest","reddit","telegram","wordpress","shopify","wix","webflow","ghost","bluesky","dataforseo","manual_import"],"type":"string"},"providerAccountIdentity":{"$ref":"#/components/schemas/JsonObject"},"publishingConnectionId":{"type":"string"},"scopes":{"items":{"type":"string"},"type":"array"},"status":{"enum":["configuration_required","connected","ready","error","revoked"],"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["availability","createdAt","id","label","projectId","provider","scopes","status","updatedAt"],"type":"object"},"AnalyticsConnectionEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/AnalyticsConnection"}},"required":["data"],"type":"object"},"AnalyticsConnectionsEnvelope":{"properties":{"data":{"items":{"$ref":"#/components/schemas/AnalyticsConnection"},"type":"array"}},"required":["data"],"type":"object"},"CreateAnalyticsConnectionRequest":{"additionalProperties":false,"properties":{"configuration":{"$ref":"#/components/schemas/JsonObject"},"credentials":{"$ref":"#/components/schemas/JsonObject"},"label":{"type":"string"},"provider":{"type":"string"},"publishingConnectionId":{"type":"string"}},"required":["configuration","credentials","label","provider"],"type":"object"},"AnalyticsSyncRequest":{"additionalProperties":false,"properties":{"approvedCostUsd":{"format":"double","minimum":0,"type":"number"},"idempotencyKey":{"format":"uuid","type":"string"},"isBackfill":{"type":"boolean"},"rangeEnd":{"format":"date-time","type":"string"},"rangeStart":{"format":"date-time","type":"string"}},"required":["idempotencyKey","rangeEnd","rangeStart"],"type":"object"},"AnalyticsSyncRun":{"additionalProperties":false,"properties":{"approvedCostUsd":{"format":"double","type":"number"},"completedAt":{"format":"date-time","type":"string"},"connectionId":{"type":"string"},"createdAt":{"format":"date-time","type":"string"},"errorMessage":{"type":"string"},"id":{"type":"string"},"isBackfill":{"type":"boolean"},"projectId":{"type":"string"},"providerCostUsd":{"format":"double","type":"number"},"rangeEnd":{"format":"date-time","type":"string"},"rangeStart":{"format":"date-time","type":"string"},"recordsRead":{"type":"integer"},"recordsWritten":{"type":"integer"},"startedAt":{"format":"date-time","type":"string"},"status":{"enum":["queued","running","succeeded","partial","failed","cancelled"],"type":"string"},"trigger":{"type":"string"}},"required":["connectionId","createdAt","id","isBackfill","projectId","providerCostUsd","rangeEnd","rangeStart","recordsRead","recordsWritten","status","trigger"],"type":"object"},"AnalyticsSyncRunEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/AnalyticsSyncRun"}},"required":["data"],"type":"object"},"ManualPerformanceMetric":{"additionalProperties":false,"properties":{"aggregation":{"enum":["count","sum","average","ratio","latest","state"],"type":"string"},"comparable":{"type":"boolean"},"definition":{"type":"string"},"dimensionKey":{"type":"string"},"estimated":{"type":"boolean"},"normalization":{"$ref":"#/components/schemas/JsonObject"},"normalizedName":{"enum":["impressions","reach","views","unique_viewers","watch_time","average_view_duration","completion_rate","likes_reactions","comments","shares_reposts","saves","link_clicks","profile_visits","followers_subscribers_gained","click_through_rate","engagement_rate","conversions","search_impressions","search_clicks","search_ctr","average_search_position","landing_page_sessions","engaged_sessions","keyword_rank","keyword_rank_change","indexed_state","rating","rating_change","review_count","review_count_change","review_sentiment","competitor_rank","competitor_rank_change","publication_status"],"type":"string"},"providerName":{"type":"string"},"unit":{"enum":["count","milliseconds","seconds","minutes","percentage","position","rating","boolean","state"],"type":"string"},"value":{"format":"double","type":"number"}},"required":["aggregation","comparable","normalizedName","providerName","unit","value"],"type":"object"},"ManualPerformanceSnapshotInput":{"additionalProperties":false,"properties":{"capturedAt":{"format":"date-time","type":"string"},"contentFormat":{"type":"string"},"contentUrl":{"format":"uri","type":"string"},"creativeVariant":{"type":"string"},"destination":{"type":"string"},"isPartial":{"type":"boolean"},"market":{"type":"string"},"metrics":{"items":{"$ref":"#/components/schemas/ManualPerformanceMetric"},"type":"array"},"periodEnd":{"format":"date-time","type":"string"},"periodStart":{"format":"date-time","type":"string"},"providerAccountId":{"type":"string"},"providerContentId":{"type":"string"},"publicationTimestamp":{"format":"date-time","type":"string"},"rawMetrics":{"$ref":"#/components/schemas/JsonObject"},"staleAt":{"format":"date-time","type":"string"},"topicCluster":{"items":{"type":"string"},"type":"array"}},"required":["destination","metrics","periodEnd","periodStart"],"type":"object"},"AnalyticsManualImportRequest":{"additionalProperties":false,"properties":{"idempotencyKey":{"format":"uuid","type":"string"},"snapshots":{"items":{"$ref":"#/components/schemas/ManualPerformanceSnapshotInput"},"type":"array"},"sourceLabel":{"type":"string"}},"required":["idempotencyKey","snapshots","sourceLabel"],"type":"object"},"PerformanceMetricSummary":{"additionalProperties":false,"properties":{"aggregation":{"type":"string"},"normalizedName":{"type":"string"},"sampleSize":{"type":"integer"},"unit":{"type":"string"},"value":{"format":"double","type":"number"}},"required":["aggregation","normalizedName","sampleSize","unit","value"],"type":"object"},"PerformancePlatformBreakdown":{"additionalProperties":false,"properties":{"destination":{"type":"string"},"metrics":{"items":{"$ref":"#/components/schemas/PerformanceMetricSummary"},"type":"array"}},"required":["destination","metrics"],"type":"object"},"PerformanceGroupedBreakdown":{"additionalProperties":false,"properties":{"key":{"type":"string"},"label":{"type":"string"},"metrics":{"items":{"$ref":"#/components/schemas/PerformanceMetricSummary"},"type":"array"},"snapshotCount":{"type":"integer"}},"required":["key","label","metrics","snapshotCount"],"type":"object"},"PerformanceEntityBreakdown":{"additionalProperties":false,"properties":{"destination":{"type":"string"},"key":{"type":"string"},"label":{"type":"string"},"metrics":{"items":{"$ref":"#/components/schemas/PerformanceMetricSummary"},"type":"array"},"snapshotCount":{"type":"integer"}},"required":["key","label","metrics","snapshotCount"],"type":"object"},"PerformanceContentHighlight":{"additionalProperties":false,"properties":{"aggregation":{"type":"string"},"campaignId":{"type":"string"},"contentFormat":{"type":"string"},"contentId":{"type":"string"},"destination":{"type":"string"},"direction":{"enum":["top","underperforming"],"type":"string"},"lowerIsBetter":{"type":"boolean"},"metricName":{"type":"string"},"sampleSize":{"type":"integer"},"unit":{"type":"string"},"value":{"format":"double","type":"number"}},"required":["aggregation","contentId","destination","direction","lowerIsBetter","metricName","sampleSize","unit","value"],"type":"object"},"PerformanceExecutive":{"additionalProperties":false,"properties":{"attributedCampaignCount":{"type":"integer"},"contentFormatCount":{"type":"integer"},"observedContentCount":{"type":"integer"},"platformCount":{"type":"integer"},"providerConnectionCount":{"type":"integer"},"readyProviderConnectionCount":{"type":"integer"},"snapshotCount":{"type":"integer"},"unavailableProviderConnectionCount":{"type":"integer"}},"required":["attributedCampaignCount","contentFormatCount","observedContentCount","platformCount","providerConnectionCount","readyProviderConnectionCount","snapshotCount","unavailableProviderConnectionCount"],"type":"object"},"PerformanceCostEfficiency":{"additionalProperties":false,"properties":{"analyticsProviderCostUsd":{"format":"double","type":"number"},"complete":{"type":"boolean"},"costPerAttributedOutputUsd":{"format":"double","type":"number"},"costPerObservedConversionUsd":{"format":"double","type":"number"},"observedConversionCount":{"format":"double","type":"number"},"observedOutputCount":{"type":"integer"},"researchProviderCostUsd":{"format":"double","type":"number"},"scopeNote":{"type":"string"},"totalProviderCostUsd":{"format":"double","type":"number"}},"required":["analyticsProviderCostUsd","complete","observedConversionCount","observedOutputCount","researchProviderCostUsd","scopeNote","totalProviderCostUsd"],"type":"object"},"PerformancePublishingReliability":{"additionalProperties":false,"properties":{"averageAttemptCount":{"format":"double","type":"number"},"cancelled":{"type":"integer"},"deadLetters":{"type":"integer"},"failed":{"type":"integer"},"providerIdentityCoverage":{"format":"double","type":"number"},"published":{"type":"integer"},"queuedOrPublishing":{"type":"integer"},"retrying":{"type":"integer"},"successRate":{"format":"double","type":"number"},"totalAttempts":{"type":"integer"}},"required":["averageAttemptCount","cancelled","deadLetters","failed","providerIdentityCoverage","published","queuedOrPublishing","retrying","successRate","totalAttempts"],"type":"object"},"PerformanceResearchAttribution":{"additionalProperties":false,"properties":{"advancedResearchSnapshots":{"type":"integer"},"seoResearchSnapshots":{"type":"integer"},"topicAttributedSnapshots":{"type":"integer"},"unattributedSnapshots":{"type":"integer"}},"required":["advancedResearchSnapshots","seoResearchSnapshots","topicAttributedSnapshots","unattributedSnapshots"],"type":"object"},"PerformanceFreshness":{"additionalProperties":false,"properties":{"lastSyncedAt":{"format":"date-time","type":"string"},"missingCampaignAttributionCount":{"type":"integer"},"missingContentIdentityCount":{"type":"integer"},"missingPublicationTimestampCount":{"type":"integer"},"partialSnapshotCount":{"type":"integer"},"snapshotLimitReached":{"type":"boolean"},"staleSnapshotCount":{"type":"integer"}},"required":["missingCampaignAttributionCount","missingContentIdentityCount","missingPublicationTimestampCount","partialSnapshotCount","snapshotLimitReached","staleSnapshotCount"],"type":"object"},"PerformanceRecommendationDiversityGuard":{"additionalProperties":false,"properties":{"avoidExactReplication":{"type":"boolean"},"maxInfluencedOutputs":{"maximum":20,"minimum":1,"type":"integer"},"preserveBrandConstraints":{"type":"boolean"},"requireAdjacentVariation":{"type":"boolean"}},"required":["avoidExactReplication","maxInfluencedOutputs","preserveBrandConstraints","requireAdjacentVariation"],"type":"object"},"PerformanceRecommendation":{"additionalProperties":false,"properties":{"approvedAt":{"format":"date-time","type":"string"},"campaignId":{"type":"string"},"confidence":{"format":"double","type":"number"},"correlationOnly":{"type":"boolean"},"createdAt":{"format":"date-time","type":"string"},"dateRangeEnd":{"format":"date-time","type":"string"},"dateRangeStart":{"format":"date-time","type":"string"},"diversityGuard":{"$ref":"#/components/schemas/PerformanceRecommendationDiversityGuard"},"id":{"type":"string"},"incompleteData":{"type":"boolean"},"kind":{"type":"string"},"metricEvidence":{"$ref":"#/components/schemas/JsonObject"},"platforms":{"items":{"type":"string"},"type":"array"},"projectId":{"type":"string"},"rationale":{"type":"string"},"sampleSize":{"type":"integer"},"statisticallyWeak":{"type":"boolean"},"status":{"enum":["draft","approved","dismissed","applied","expired"],"type":"string"},"summary":{"type":"string"},"title":{"type":"string"}},"required":["confidence","correlationOnly","createdAt","dateRangeEnd","dateRangeStart","diversityGuard","id","incompleteData","kind","metricEvidence","platforms","projectId","rationale","sampleSize","statisticallyWeak","status","summary","title"],"type":"object"},"PerformanceDashboard":{"additionalProperties":false,"properties":{"asoPerformance":{"items":{"$ref":"#/components/schemas/PerformanceEntityBreakdown"},"type":"array"},"campaignBreakdown":{"items":{"$ref":"#/components/schemas/PerformanceGroupedBreakdown"},"type":"array"},"contentFormatBreakdown":{"items":{"$ref":"#/components/schemas/PerformanceGroupedBreakdown"},"type":"array"},"contentHighlights":{"items":{"$ref":"#/components/schemas/PerformanceContentHighlight"},"type":"array"},"costEfficiency":{"$ref":"#/components/schemas/PerformanceCostEfficiency"},"executive":{"$ref":"#/components/schemas/PerformanceExecutive"},"freshness":{"$ref":"#/components/schemas/PerformanceFreshness"},"generatedAt":{"format":"date-time","type":"string"},"metrics":{"items":{"$ref":"#/components/schemas/PerformanceMetricSummary"},"type":"array"},"platformBreakdown":{"items":{"$ref":"#/components/schemas/PerformancePlatformBreakdown"},"type":"array"},"projectId":{"type":"string"},"publishingReliability":{"$ref":"#/components/schemas/PerformancePublishingReliability"},"recommendations":{"items":{"$ref":"#/components/schemas/PerformanceRecommendation"},"type":"array"},"researchAttribution":{"$ref":"#/components/schemas/PerformanceResearchAttribution"},"seoPerformance":{"items":{"$ref":"#/components/schemas/PerformanceEntityBreakdown"},"type":"array"}},"required":["asoPerformance","campaignBreakdown","contentFormatBreakdown","contentHighlights","costEfficiency","executive","freshness","generatedAt","metrics","platformBreakdown","projectId","publishingReliability","recommendations","researchAttribution","seoPerformance"],"type":"object"},"PerformanceDashboardEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/PerformanceDashboard"}},"required":["data"],"type":"object"},"UpdatePerformanceRecommendationRequest":{"additionalProperties":false,"properties":{"action":{"enum":["approve","dismiss","apply"],"type":"string"},"outputIds":{"items":{"type":"string"},"type":"array"},"rationale":{"type":"string"}},"required":["action"],"type":"object"},"PerformanceRecommendationEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/PerformanceRecommendation"}},"required":["data"],"type":"object"},"JsonObject":{"additionalProperties":true,"type":"object"},"DownloadDescriptor":{"properties":{"checksumSha256":{"nullable":true,"pattern":"^[a-f0-9]{64}$","type":"string"},"expiresInSeconds":{"format":"int32","nullable":true,"type":"integer"},"filename":{"type":"string"},"mimeType":{"type":"string"},"sizeBytes":{"nullable":true,"pattern":"^[0-9]+$","type":"string"},"url":{"format":"uri","type":"string"}},"required":["filename","mimeType","url"],"type":"object"},"DownloadDescriptorEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/DownloadDescriptor"}},"required":["data"],"type":"object"},"PublishingPackageApproval":{"additionalProperties":false,"properties":{"approvedAt":{"format":"date-time","nullable":true,"type":"string"},"approvedById":{"nullable":true,"type":"string"},"consentVersion":{"nullable":true,"type":"string"},"fingerprint":{"nullable":true,"pattern":"^[a-f0-9]{64}$","type":"string"},"required":{"type":"boolean"}},"required":["approvedAt","approvedById","consentVersion","fingerprint","required"],"type":"object"},"PublishingPackageCover":{"additionalProperties":false,"properties":{"assetId":{"nullable":true,"type":"string"},"checksumSha256":{"nullable":true,"pattern":"^[a-f0-9]{64}$","type":"string"},"download":{"anyOf":[{"$ref":"#/components/schemas/DownloadDescriptor"},{"type":"null"}]},"generation":{"enum":["READY","ON_DEMAND"],"type":"string"},"mimeType":{"nullable":true,"type":"string"},"sizeBytes":{"nullable":true,"pattern":"^[0-9]+$","type":"string"},"source":{"enum":["ASSET","VIDEO_FRAME"],"type":"string"},"storageKey":{"nullable":true,"type":"string"},"timestampMs":{"minimum":0,"nullable":true,"type":"integer"}},"required":["assetId","download","generation","source","timestampMs"],"type":"object"},"PublishingPackageSpoken":{"additionalProperties":false,"properties":{"captions":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"subtitles":{"additionalProperties":false,"properties":{"format":{"enum":["NONE","SRT"],"type":"string"},"text":{"nullable":true,"type":"string"}},"required":["format","text"],"type":"object"},"transcript":{"nullable":true,"type":"string"}},"required":["captions","subtitles","transcript"],"type":"object"},"PublishingPackagePost":{"additionalProperties":false,"properties":{"altText":{"items":{"type":"string"},"type":"array"},"cta":{"nullable":true,"type":"string"},"description":{"nullable":true,"type":"string"},"hashtags":{"items":{"type":"string"},"type":"array"},"language":{"type":"string"},"locale":{"type":"string"},"platform":{"type":"string"},"title":{"nullable":true,"type":"string"}},"required":["altText","cta","description","hashtags","language","locale","platform","title"],"type":"object"},"PublishingPackagePublication":{"additionalProperties":false,"properties":{"account":{"additionalProperties":true,"type":"object"},"platform":{"type":"string"},"post":{"$ref":"#/components/schemas/PublishingPackagePost"},"providerMetadata":{"additionalProperties":true,"type":"object"},"providerSubmissionId":{"nullable":true,"type":"string"},"scheduledFor":{"format":"date-time","type":"string"},"status":{"type":"string"}},"required":["account","platform","post","providerMetadata","providerSubmissionId","scheduledFor","status"],"type":"object"},"PublishingPackage":{"additionalProperties":false,"properties":{"approval":{"$ref":"#/components/schemas/PublishingPackageApproval"},"batchId":{"type":"string"},"content":{"additionalProperties":true,"type":"object"},"cover":{"anyOf":[{"$ref":"#/components/schemas/PublishingPackageCover"},{"type":"null"}]},"immutable":{"type":"boolean"},"media":{"additionalProperties":true,"type":"object"},"packageFingerprint":{"pattern":"^[a-f0-9]{64}$","type":"string"},"packageRevision":{"minimum":1,"type":"integer"},"projectId":{"type":"string"},"providerSubmissionCreated":{"type":"boolean"},"publishing":{"items":{"$ref":"#/components/schemas/PublishingPackagePublication"},"type":"array"},"publishingResponsibility":{"enum":["EXTERNAL","MANAGED"],"type":"string"},"revisionId":{"type":"string"},"schemaVersion":{"enum":["publishing-package.v1","publishing-package.v2"],"type":"string"},"spoken":{"$ref":"#/components/schemas/PublishingPackageSpoken"},"status":{"type":"string"}},"required":["approval","batchId","content","cover","immutable","media","packageFingerprint","packageRevision","projectId","providerSubmissionCreated","publishing","publishingResponsibility","revisionId","schemaVersion","spoken","status"],"type":"object"},"PublishingPackageEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/PublishingPackage"}},"required":["data"],"type":"object"},"ProjectAsset":{"properties":{"createdAt":{"format":"date-time","type":"string"},"durationMs":{"format":"int32","nullable":true,"type":"integer"},"height":{"format":"int32","nullable":true,"type":"integer"},"id":{"type":"string"},"includeByDefault":{"type":"boolean"},"label":{"nullable":true,"type":"string"},"metadata":{"additionalProperties":true,"nullable":true,"type":"object"},"mimeType":{"nullable":true,"type":"string"},"origin":{"type":"string"},"publicUrl":{"format":"uri","nullable":true,"type":"string"},"purpose":{"type":"string"},"sizeBytes":{"nullable":true,"type":"string"},"status":{"type":"string"},"type":{"type":"string"},"updatedAt":{"format":"date-time","type":"string"},"width":{"format":"int32","nullable":true,"type":"integer"}},"required":["id","type","status","purpose","origin","includeByDefault","createdAt","updatedAt"],"type":"object"},"PaginationMeta":{"properties":{"nextCursor":{"nullable":true,"type":"string"}},"required":["nextCursor"],"type":"object"},"PaginatedProjectAssetsResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ProjectAsset"},"type":"array"},"meta":{"$ref":"#/components/schemas/PaginationMeta"}},"required":["data","meta"],"type":"object"},"UpdateProjectAssetRequest":{"properties":{"includeByDefault":{"type":"boolean"},"label":{"type":"string"},"metadata":{"additionalProperties":true,"type":"object"},"purpose":{"enum":["AVATAR_REFERENCE","APP_SCREENSHOT","WEBSITE_SCREENSHOT","PRODUCT_IMAGE","BRAND_ASSET","BROLL_VIDEO","GENERATED_MEDIA","RENDER_OUTPUT"],"type":"string"}},"type":"object"},"GenerateProjectImageRequest":{"additionalProperties":false,"properties":{"prompt":{"type":"string","minLength":10,"maxLength":4000},"label":{"type":"string","minLength":1,"maxLength":160},"aspectRatio":{"type":"string","enum":["1:1","4:5","9:16","16:9"],"default":"1:1"},"referenceAssetIds":{"type":"array","maxItems":1,"items":{"type":"string"},"default":[]},"idempotencyKey":{"type":"string","minLength":8,"maxLength":120}},"required":["prompt"],"type":"object"},"QueuedProjectImage":{"properties":{"jobId":{"type":"string"},"projectId":{"type":"string"},"status":{"type":"string","enum":["queued"]}},"required":["jobId","projectId","status"],"type":"object"},"QueuedProjectImageEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/QueuedProjectImage"}},"required":["data"],"type":"object"},"AssetMutationResponse":{"properties":{"assetId":{"type":"string"},"status":{"type":"string"}},"required":["assetId","status"],"type":"object"},"AssetMutationEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/AssetMutationResponse"}},"required":["data"],"type":"object"},"CreateUploadRequest":{"properties":{"contentType":{"type":"string"},"filename":{"type":"string"},"label":{"nullable":true,"type":"string"},"purpose":{"enum":["AVATAR_REFERENCE","APP_SCREENSHOT","WEBSITE_SCREENSHOT","PRODUCT_IMAGE","BRAND_ASSET","BROLL_VIDEO","GENERATED_MEDIA","RENDER_OUTPUT"],"type":"string"},"sizeBytes":{"format":"int32","type":"integer"}},"required":["contentType","filename","sizeBytes"],"type":"object"},"FinalizeUploadRequest":{"properties":{"durationMs":{"format":"int32","type":"integer"},"height":{"format":"int32","type":"integer"},"width":{"format":"int32","type":"integer"}},"type":"object"},"UploadReservation":{"properties":{"assetId":{"type":"string"},"expiresInSeconds":{"format":"int32","type":"integer"},"key":{"type":"string"},"uploadUrl":{"format":"uri","type":"string"}},"required":["assetId","expiresInSeconds","key","uploadUrl"],"type":"object"},"UploadReservationEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/UploadReservation"}},"required":["data"],"type":"object"},"JobMutation":{"properties":{"carouselId":{"nullable":true,"type":"string"},"jobId":{"nullable":true,"type":"string"},"projectId":{"nullable":true,"type":"string"},"reelId":{"nullable":true,"type":"string"},"status":{"type":"string"}},"required":["status"],"type":"object"},"JobMutationEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/JobMutation"}},"required":["data"],"type":"object"},"ReadyCreatorRequest":{"properties":{"creatorId":{"maxLength":80,"minLength":1,"type":"string"}},"required":["creatorId"],"type":"object"},"ReadyCreatorSelection":{"properties":{"avatarId":{"type":"string"},"created":{"type":"boolean"},"creatorId":{"type":"string"},"projectId":{"type":"string"},"status":{"enum":["ready"],"type":"string"}},"required":["avatarId","created","creatorId","projectId","status"],"type":"object"},"ReadyCreatorSelectionEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/ReadyCreatorSelection"}},"required":["data"],"type":"object"},"CreationOutputCapability":{"additionalProperties":false,"properties":{"costLabel":{"type":"string"},"description":{"type":"string"},"fields":{"items":{"type":"string"},"type":"array"},"id":{"enum":["reel","carousel","content_pack"],"type":"string"},"label":{"type":"string"},"resultFormats":{"items":{"type":"string"},"type":"array"}},"required":["costLabel","description","fields","id","label","resultFormats"],"type":"object"},"CreationDestination":{"additionalProperties":false,"properties":{"format":{"enum":["instagram_caption","tiktok_caption","youtube_metadata","linkedin_post","x_post","telegram_post","reddit_post","website_article"],"type":"string"},"id":{"enum":["instagram_reels","tiktok","youtube_shorts","linkedin","x","telegram","reddit","website_blog"],"type":"string"},"label":{"type":"string"},"media":{"type":"string"}},"required":["format","id","label","media"],"type":"object"},"ProjectIdeaDraft":{"additionalProperties":false,"properties":{"avatarId":{"nullable":true,"type":"string"},"brief":{"maxLength":4000,"minLength":1,"type":"string"},"language":{"maxLength":12,"minLength":2,"type":"string"},"outputType":{"enum":["reel","carousel","content_pack"],"type":"string"},"source":{"enum":["generated","manual"],"type":"string"},"title":{"nullable":true,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["brief","language","outputType","source","updatedAt"],"type":"object"},"ProjectIdeaDraftEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/ProjectIdeaDraft","nullable":true}},"required":["data"],"type":"object"},"ProjectIdeaDraftUpsertRequest":{"additionalProperties":false,"properties":{"avatarId":{"type":"string"},"brief":{"maxLength":4000,"minLength":1,"type":"string"},"language":{"maxLength":12,"minLength":2,"type":"string"},"outputType":{"enum":["reel","carousel","content_pack"],"type":"string"},"source":{"enum":["generated","manual"],"type":"string"},"title":{"maxLength":160,"minLength":1,"type":"string"}},"required":["brief","language","outputType"],"type":"object"},"OutputSuggestionRequest":{"properties":{"activeAvatarId":{"type":"string"},"brandName":{"maxLength":120,"minLength":1,"type":"string"},"brief":{"maxLength":4000,"type":"string"},"callToAction":{"maxLength":240,"minLength":1,"type":"string"},"durationSeconds":{"maximum":120,"minimum":5,"type":"integer"},"frameCount":{"maximum":10,"minimum":5,"type":"integer"},"imageSource":{"enum":["openai","project_media"],"type":"string"},"language":{"maxLength":12,"minLength":2,"type":"string"},"outputTarget":{"enum":["video","script","terms","audio","subtitle","materials","analysis"],"type":"string"},"blueprintId":{"enum":["avatar_sticker_explainer","emotional_story","reddit_story","character_explainer","motion_graphics","document_explainer","italian_brainrot","texting_story","quiz","prompt_to_video","voice_over"],"type":"string"},"productType":{"enum":["reel","carousel","content_pack"],"type":"string"},"targetAudience":{"maxLength":240,"minLength":1,"type":"string"},"templateStyle":{"enum":["auto","editorial","image_led"],"type":"string"},"title":{"maxLength":160,"minLength":1,"type":"string"},"tone":{"maxLength":120,"minLength":1,"type":"string"},"variantCount":{"maximum":4,"minimum":1,"type":"integer"},"videoModel":{"enum":["composition","native_selfie"],"type":"string"},"voiceId":{"type":"string"}},"required":["productType"],"type":"object"},"OutputSuggestion":{"properties":{"brief":{"type":"string"},"briefLabel":{"type":"string"},"creditsRemaining":{"format":"int32","type":"integer"},"title":{"type":"string"}},"required":["brief","briefLabel","creditsRemaining","title"],"type":"object"},"OutputSuggestionEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/OutputSuggestion"}},"required":["data"],"type":"object"},"RenderResult":{"properties":{"createdAt":{"format":"date-time","type":"string"},"id":{"type":"string"},"mimeType":{"nullable":true,"type":"string"},"previewUrl":{"format":"uri","nullable":true,"type":"string"},"status":{"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","status","updatedAt"],"type":"object"},"PublishCaption":{"properties":{"caption":{"type":"string"},"hashtags":{"items":{"type":"string"},"type":"array"}},"required":["caption","hashtags"],"type":"object"},"ReelResult":{"properties":{"createdAt":{"format":"date-time","type":"string"},"id":{"type":"string"},"name":{"type":"string"},"publishCaption":{"$ref":"#/components/schemas/PublishCaption"},"renderOutputs":{"items":{"$ref":"#/components/schemas/RenderResult"},"type":"array"},"status":{"type":"string"},"thumbnailUrl":{"format":"uri","nullable":true,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","name","publishCaption","status","renderOutputs","updatedAt"],"type":"object"},"ReelResultsEnvelope":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ReelResult"},"type":"array"}},"required":["data"],"type":"object"},"CarouselFrameResult":{"properties":{"frameIndex":{"format":"int32","type":"integer"},"id":{"type":"string"},"mimeType":{"nullable":true,"type":"string"},"previewUrl":{"format":"uri","nullable":true,"type":"string"},"status":{"type":"string"},"title":{"nullable":true,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","frameIndex","status","updatedAt"],"type":"object"},"CarouselResult":{"properties":{"createdAt":{"format":"date-time","type":"string"},"frames":{"items":{"$ref":"#/components/schemas/CarouselFrameResult"},"type":"array"},"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"templateStyle":{"nullable":true,"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","name","status","frames","updatedAt"],"type":"object"},"CarouselResultsEnvelope":{"properties":{"data":{"items":{"$ref":"#/components/schemas/CarouselResult"},"type":"array"}},"required":["data"],"type":"object"},"JobResourceSummary":{"properties":{"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"}},"required":["id","name","status"],"type":"object"},"GenerationJobDetail":{"properties":{"carousel":{"nullable":true,"properties":{"frames":{"items":{"$ref":"#/components/schemas/CarouselFrameResult"},"type":"array"},"id":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"templateStyle":{"nullable":true,"type":"string"}},"type":"object"},"completedAt":{"format":"date-time","nullable":true,"type":"string"},"completedStages":{"items":{"type":"string"},"type":"array"},"createdAt":{"format":"date-time","type":"string"},"currentStage":{"type":"string"},"errorMessage":{"nullable":true,"type":"string"},"id":{"type":"string"},"jobId":{"type":"string"},"kind":{"type":"string"},"projectId":{"type":"string"},"reel":{"$ref":"#/components/schemas/JobResourceSummary","nullable":true},"renderOutputs":{"items":{"$ref":"#/components/schemas/RenderResult"},"type":"array"},"startedAt":{"format":"date-time","nullable":true,"type":"string"},"status":{"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["id","jobId","projectId","kind","status","currentStage","completedStages","renderOutputs","createdAt","updatedAt"],"type":"object"},"GenerationJobDetailEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/GenerationJobDetail"}},"required":["data"],"type":"object"},"MobileUser":{"properties":{"credits":{"format":"int32","type":"integer"},"email":{"nullable":true,"type":"string"},"id":{"type":"string"},"image":{"format":"uri","nullable":true,"type":"string"},"name":{"nullable":true,"type":"string"},"starterCredits":{"format":"int32","type":"integer"}},"required":["id","credits","starterCredits"],"type":"object"},"MobileUserEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/MobileUser"}},"required":["data"],"type":"object"},"MobileBillingPlan":{"properties":{"creditAllowance":{"format":"int32","minimum":1,"type":"integer"},"id":{"type":"string"},"period":{"enum":["monthly","annual"],"type":"string"}},"required":["creditAllowance","id","period"],"type":"object"},"MobileBillingStatus":{"properties":{"activeProductId":{"nullable":true,"type":"string"},"appAccountToken":{"format":"uuid","type":"string"},"credits":{"format":"int32","type":"integer"},"expiresAt":{"format":"date-time","nullable":true,"type":"string"},"hasPaidAccess":{"type":"boolean"},"plans":{"items":{"$ref":"#/components/schemas/MobileBillingPlan"},"type":"array"}},"required":["activeProductId","appAccountToken","credits","expiresAt","hasPaidAccess","plans"],"type":"object"},"MobileBillingStatusEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/MobileBillingStatus"}},"required":["data"],"type":"object"},"MobileAppStoreTransactionRequest":{"additionalProperties":false,"properties":{"signedTransaction":{"minLength":100,"maxLength":100000,"type":"string"}},"required":["signedTransaction"],"type":"object"},"StarterPackCatalogEnvelope":{"properties":{"data":{"properties":{"cost":{"format":"int32","type":"integer"},"creators":{"items":{"properties":{"description":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"previewUrl":{"format":"uri","type":"string"}},"required":["description","id","name"],"type":"object"},"type":"array"},"deliveryProviders":{"items":{"properties":{"id":{"enum":["shopify","wordpress_org","wordpress_com","wix","webflow","notion","webhook"],"type":"string"},"modes":{"items":{"enum":["automatic","approval"],"type":"string"},"type":"array"},"name":{"type":"string"},"status":{"enum":["planned","preview_only"],"type":"string"}},"required":["id","modes","name","status"],"type":"object"},"type":"array"},"includes":{"items":{"type":"string"},"type":"array"},"keywordResearchAvailable":{"type":"boolean"},"searchMarkets":{"items":{"properties":{"countryCode":{"maxLength":2,"minLength":2,"type":"string"},"languages":{"items":{"properties":{"code":{"type":"string"},"keywordCount":{"format":"int64","minimum":0,"type":"integer"},"name":{"type":"string"}},"required":["code","keywordCount","name"],"type":"object"},"type":"array"},"locationCode":{"format":"int32","type":"integer"},"name":{"type":"string"},"type":{"type":"string"}},"required":["countryCode","languages","locationCode","name","type"],"type":"object"},"type":"array"}},"required":["cost","creators","deliveryProviders","includes","keywordResearchAvailable","searchMarkets"],"type":"object"}},"required":["data"],"type":"object"},"StarterPackRequest":{"properties":{"blogDescription":{"maxLength":4000,"minLength":10,"type":"string"},"blogImageCount":{"maximum":4,"minimum":0,"type":"integer"},"blogTargetWords":{"maximum":3000,"minimum":600,"type":"integer"},"brandName":{"maxLength":120,"minLength":1,"type":"string"},"callToAction":{"maxLength":120,"minLength":1,"type":"string"},"creator":{"oneOf":[{"additionalProperties":false,"properties":{"creatorId":{"type":"string"},"mode":{"enum":["ready"],"type":"string"}},"required":["creatorId","mode"],"type":"object"},{"additionalProperties":false,"properties":{"avatarId":{"type":"string"},"mode":{"enum":["custom"],"type":"string"}},"required":["avatarId","mode"],"type":"object"}]},"idempotencyKey":{"format":"uuid","type":"string"},"ideaMode":{"enum":["recommended"],"type":"string"},"language":{"type":"string"},"palette":{"items":{"type":"string"},"maxItems":5,"minItems":2,"type":"array"},"pillars":{"items":{"type":"string"},"maxItems":3,"minItems":3,"type":"array"},"platforms":{"items":{"enum":["instagram_reels","tiktok","youtube_shorts","linkedin","x","telegram","reddit","website_blog"],"type":"string"},"maxItems":3,"minItems":1,"type":"array"},"profileUrl":{"format":"uri","type":"string"},"searchCountryCode":{"maxLength":2,"minLength":2,"type":"string"},"searchLocationCode":{"format":"int32","minimum":1,"type":"integer"},"searchLocationName":{"maxLength":120,"minLength":1,"type":"string"},"socialVisualMode":{"enum":["auto","none","photo","infographic"],"type":"string"},"templateId":{"enum":["starter-blog-intro-v2"],"type":"string"}},"required":["blogDescription","brandName","creator","idempotencyKey","platforms"],"type":"object"},"StarterPackResultEnvelope":{"properties":{"data":{"additionalProperties":true,"type":"object"}},"required":["data"],"type":"object"},"Project":{"properties":{"counts":{"additionalProperties":{"format":"int32","type":"integer"},"type":"object"},"enabledDestinationIds":{"items":{"type":"string"},"type":"array"},"id":{"type":"string"},"lanes":{"items":{"enum":["SHORT_VIDEO","SOCIAL_CONTENT","CMS_ARTICLE"],"type":"string"},"type":"array"},"lifecycleStatus":{"enum":["SETUP_DRAFT","ACTIVE"],"type":"string"},"name":{"type":"string"},"primaryDestination":{"type":"string"},"role":{"enum":["VIEW","EDIT","ADMIN"],"type":"string"},"slug":{"type":"string"},"updatedAt":{"format":"date-time","type":"string"},"workstreams":{"items":{"$ref":"#/components/schemas/ProjectWorkstream"},"type":"array"}},"required":["counts","enabledDestinationIds","id","lanes","lifecycleStatus","name","role","slug","updatedAt","workstreams"],"type":"object"},"ProjectDestinationsUpdateRequest":{"additionalProperties":false,"properties":{"destinationIds":{"items":{"enum":["custom_webhook","wordpress","shopify_blog","wix_blog","webflow_cms","ghost","instagram_post","linkedin_post","linkedin_article","x_post","x_thread","telegram_channel","reddit_post","facebook_page","threads_post","bluesky_post","tiktok_video","instagram_reel","youtube_short","facebook_reel","snapchat_spotlight","instagram_carousel","linkedin_document","facebook_carousel","pinterest_pin","tiktok_carousel","youtube_video_metadata","youtube_community_post","google_business_post"],"type":"string"},"maxItems":29,"minItems":1,"type":"array","uniqueItems":true},"primaryDestinationId":{"enum":["custom_webhook","wordpress","shopify_blog","wix_blog","webflow_cms","ghost","instagram_post","linkedin_post","linkedin_article","x_post","x_thread","telegram_channel","reddit_post","facebook_page","threads_post","bluesky_post","tiktok_video","instagram_reel","youtube_short","facebook_reel","snapchat_spotlight","instagram_carousel","linkedin_document","facebook_carousel","pinterest_pin","tiktok_carousel","youtube_video_metadata","youtube_community_post","google_business_post"],"type":"string"}},"required":["destinationIds"],"type":"object"},"ProjectSetupCreateRequest":{"additionalProperties":false,"properties":{"idempotencyKey":{"format":"uuid","type":"string"},"kind":{"default":"create_project","enum":["create_project","add_destinations"],"type":"string"},"projectId":{"type":"string"}},"required":["idempotencyKey"],"type":"object"},"ProjectSetupUpdateRequest":{"additionalProperties":false,"properties":{"brief":{"$ref":"#/components/schemas/JsonObject"},"calendarSettings":{"$ref":"#/components/schemas/JsonObject"},"contentPlanPreview":{"$ref":"#/components/schemas/ProjectSetupPlanPreview"},"creatorSelection":{"$ref":"#/components/schemas/JsonObject"},"currentStep":{"enum":["destination","connection","project_source","project_brief","creator","content_plan","review","provisioning","complete"],"type":"string"},"expectedRevision":{"minimum":1,"type":"integer"},"primaryDestination":{"enum":["custom_webhook","wordpress","shopify_blog","wix_blog","webflow_cms","ghost","instagram_post","linkedin_post","linkedin_article","x_post","x_thread","telegram_channel","reddit_post","facebook_page","threads_post","bluesky_post","tiktok_video","instagram_reel","youtube_short","facebook_reel","snapchat_spotlight","instagram_carousel","linkedin_document","facebook_carousel","pinterest_pin","tiktok_carousel","youtube_video_metadata","youtube_community_post","google_business_post"],"type":"string"},"selectedDestinations":{"items":{"enum":["custom_webhook","wordpress","shopify_blog","wix_blog","webflow_cms","ghost","instagram_post","linkedin_post","linkedin_article","x_post","x_thread","telegram_channel","reddit_post","facebook_page","threads_post","bluesky_post","tiktok_video","instagram_reel","youtube_short","facebook_reel","snapchat_spotlight","instagram_carousel","linkedin_document","facebook_carousel","pinterest_pin","tiktok_carousel","youtube_video_metadata","youtube_community_post","google_business_post"],"type":"string"},"maxItems":29,"minItems":1,"type":"array"},"sourceAnalysis":{"$ref":"#/components/schemas/JsonObject","nullable":true},"sourceMode":{"enum":["analyze_public_link","describe_myself"],"type":"string"},"sourceUrl":{"format":"uri","maxLength":2000,"nullable":true,"type":"string"}},"required":["expectedRevision"],"type":"object"},"ProjectSetupSession":{"additionalProperties":true,"properties":{"brief":{"$ref":"#/components/schemas/JsonObject","nullable":true},"calendarSettings":{"$ref":"#/components/schemas/JsonObject","nullable":true},"completedAt":{"format":"date-time","nullable":true,"type":"string"},"contentPlanPreview":{"$ref":"#/components/schemas/ProjectSetupPlanPreview","nullable":true},"contentPlanPreviewHash":{"nullable":true,"type":"string"},"createdAt":{"format":"date-time","type":"string"},"creatorSelection":{"$ref":"#/components/schemas/JsonObject","nullable":true},"currentStep":{"enum":["destination","connection","project_source","project_brief","creator","content_plan","review","provisioning","complete"],"type":"string"},"id":{"type":"string"},"idempotencyKey":{"format":"uuid","type":"string"},"kind":{"enum":["CREATE_PROJECT","ADD_DESTINATIONS"],"type":"string"},"lastError":{"$ref":"#/components/schemas/JsonObject","nullable":true},"primaryDestination":{"enum":["custom_webhook","wordpress","shopify_blog","wix_blog","webflow_cms","ghost","instagram_post","linkedin_post","linkedin_article","x_post","x_thread","telegram_channel","reddit_post","facebook_page","threads_post","bluesky_post","tiktok_video","instagram_reel","youtube_short","facebook_reel","snapchat_spotlight","instagram_carousel","linkedin_document","facebook_carousel","pinterest_pin","tiktok_carousel","youtube_video_metadata","youtube_community_post","google_business_post"],"type":"string","nullable":true},"project":{"$ref":"#/components/schemas/JsonObject","nullable":true},"projectId":{"nullable":true,"type":"string"},"provisioning":{"$ref":"#/components/schemas/JsonObject","nullable":true},"revision":{"minimum":1,"type":"integer"},"selectedDestinations":{"items":{"enum":["custom_webhook","wordpress","shopify_blog","wix_blog","webflow_cms","ghost","instagram_post","linkedin_post","linkedin_article","x_post","x_thread","telegram_channel","reddit_post","facebook_page","threads_post","bluesky_post","tiktok_video","instagram_reel","youtube_short","facebook_reel","snapchat_spotlight","instagram_carousel","linkedin_document","facebook_carousel","pinterest_pin","tiktok_carousel","youtube_video_metadata","youtube_community_post","google_business_post"],"type":"string"},"type":"array"},"sourceAnalysis":{"$ref":"#/components/schemas/JsonObject","nullable":true},"sourceMode":{"enum":["analyze_public_link","describe_myself"],"nullable":true,"type":"string"},"sourceUrl":{"format":"uri","nullable":true,"type":"string"},"status":{"enum":["draft","provisioning","complete","failed","abandoned"],"type":"string"},"updatedAt":{"format":"date-time","type":"string"}},"required":["currentStep","id","kind","revision","selectedDestinations","status"],"type":"object"},"ProjectSetupSessionEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/ProjectSetupSession"}},"required":["data"],"type":"object"},"ProjectSetupSessionsEnvelope":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ProjectSetupSession"},"type":"array"}},"required":["data"],"type":"object"},"ProjectSetupDestination":{"additionalProperties":false,"properties":{"brandFamily":{"enum":["custom","wordpress","shopify","wix","webflow","ghost","instagram","linkedin","x","telegram","reddit","facebook","threads","bluesky","tiktok","youtube","snapchat","pinterest","google_business"],"type":"string"},"brandLabel":{"type":"string"},"category":{"enum":["cms","community","social","video","carousel","youtube","local"],"type":"string"},"connectionFlow":{"enum":["official_oauth","credentials","export_only","unavailable"],"type":"string"},"contentLane":{"enum":["short_video","social_content","cms_article"],"type":"string"},"contentKind":{"enum":["cms_article","social_post","video_package","carousel_package","youtube_package","local_post"],"type":"string"},"description":{"type":"string"},"deliveryStatus":{"enum":["direct_publish","setup_required","export","unavailable"],"type":"string"},"destination":{"enum":["custom_webhook","wordpress","shopify_blog","wix_blog","webflow_cms","ghost","instagram_post","linkedin_post","linkedin_article","x_post","x_thread","telegram_channel","reddit_post","facebook_page","threads_post","bluesky_post","tiktok_video","instagram_reel","youtube_short","facebook_reel","snapchat_spotlight","instagram_carousel","linkedin_document","facebook_carousel","pinterest_pin","tiktok_carousel","youtube_video_metadata","youtube_community_post","google_business_post"],"type":"string"},"drafting":{"type":"boolean"},"exportFormats":{"items":{"type":"string"},"type":"array"},"featuredGroup":{"enum":["short_video","website_cms","social","local_presence"],"type":"string"},"formatLabel":{"type":"string"},"group":{"enum":["short_video","website_cms","social","local_presence"],"type":"string"},"iconKey":{"pattern":"^brand_[a-z0-9_]+$","type":"string"},"label":{"type":"string"},"outputType":{"enum":["reel","carousel","content_pack","google_business_post"],"type":"string"},"publishingState":{"enum":["live","configuration_required","export_only","unavailable"],"type":"string"},"scheduling":{"type":"boolean"},"selectable":{"type":"boolean"}},"required":["brandFamily","brandLabel","category","connectionFlow","contentKind","contentLane","deliveryStatus","description","destination","drafting","exportFormats","featuredGroup","formatLabel","group","iconKey","label","outputType","publishingState","scheduling","selectable"],"type":"object"},"PlatformCatalogFamily":{"additionalProperties":false,"properties":{"formats":{"items":{"$ref":"#/components/schemas/ProjectSetupDestination"},"type":"array"},"groups":{"items":{"enum":["short_video","website_cms","social","local_presence"],"type":"string"},"type":"array"},"iconKey":{"pattern":"^brand_[a-z0-9_]+$","type":"string"},"id":{"enum":["custom","wordpress","shopify","wix","webflow","ghost","instagram","linkedin","x","telegram","reddit","facebook","threads","bluesky","tiktok","youtube","snapchat","pinterest","google_business"],"type":"string"},"label":{"type":"string"},"selectable":{"type":"boolean"}},"required":["formats","groups","iconKey","id","label","selectable"],"type":"object"},"PlatformCatalog":{"additionalProperties":false,"properties":{"destinations":{"items":{"$ref":"#/components/schemas/ProjectSetupDestination"},"type":"array"},"families":{"items":{"$ref":"#/components/schemas/PlatformCatalogFamily"},"type":"array"},"version":{"enum":[1],"type":"integer"}},"required":["destinations","families","version"],"type":"object"},"PlatformCatalogEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/PlatformCatalog"}},"required":["data"],"type":"object"},"CanonicalContentGenerationRequest":{"additionalProperties":false,"properties":{"brandName":{"maxLength":120,"minLength":1,"type":"string"},"brief":{"maxLength":4000,"minLength":10,"type":"string"},"callToAction":{"maxLength":500,"minLength":1,"type":"string"},"countryCode":{"maxLength":2,"minLength":2,"type":"string"},"destinations":{"items":{"enum":["custom_webhook","wordpress","shopify_blog","wix_blog","webflow_cms","ghost","instagram_post","linkedin_post","linkedin_article","x_post","x_thread","telegram_channel","reddit_post","facebook_page","threads_post","bluesky_post","tiktok_video","instagram_reel","youtube_short","facebook_reel","snapchat_spotlight","instagram_carousel","linkedin_document","facebook_carousel","pinterest_pin","tiktok_carousel","youtube_video_metadata","youtube_community_post","google_business_post"],"type":"string"},"maxItems":3,"minItems":1,"type":"array","uniqueItems":true},"idempotencyKey":{"format":"uuid","type":"string"},"languageCode":{"maxLength":12,"minLength":2,"type":"string"},"locationCode":{"minimum":1,"type":"integer"},"locationName":{"maxLength":160,"minLength":1,"type":"string"},"projectId":{"maxLength":191,"minLength":1,"type":"string"},"selectedAssetIds":{"description":"Ready PNG, JPEG or WebP images from this project to reuse in generated media.","items":{"maxLength":191,"minLength":1,"type":"string"},"maxItems":10,"type":"array","uniqueItems":true},"targetAudience":{"maxLength":800,"minLength":5,"type":"string"},"title":{"maxLength":160,"minLength":1,"type":"string"},"tone":{"maxLength":240,"minLength":3,"type":"string"}},"required":["brandName","brief","callToAction","countryCode","destinations","idempotencyKey","languageCode","locationCode","locationName","projectId","targetAudience","title","tone"],"type":"object"},"CanonicalContentGenerationResult":{"additionalProperties":false,"properties":{"campaignId":{"type":"string"},"outputIds":{"items":{"type":"string"},"type":"array"},"projectId":{"type":"string"},"status":{"enum":["queued"],"type":"string"}},"required":["campaignId","outputIds","projectId","status"],"type":"object"},"CanonicalContentGenerationEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/CanonicalContentGenerationResult"}},"required":["data"],"type":"object"},"ProjectSetupReadyCreator":{"additionalProperties":true,"properties":{"description":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"previewUrl":{"format":"uri","nullable":true,"type":"string"}},"required":["id","name"],"type":"object"},"ProjectSetupSnapshot":{"additionalProperties":false,"properties":{"catalog":{"items":{"$ref":"#/components/schemas/ProjectSetupDestination"},"type":"array"},"connections":{"items":{"$ref":"#/components/schemas/PublishingConnection"},"type":"array"},"creators":{"items":{"$ref":"#/components/schemas/ProjectSetupReadyCreator"},"type":"array"},"session":{"$ref":"#/components/schemas/ProjectSetupSession"}},"required":["catalog","connections","creators","session"],"type":"object"},"ProjectSetupSnapshotEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/ProjectSetupSnapshot"}},"required":["data"],"type":"object"},"ProjectSourceAnalyzeRequest":{"additionalProperties":false,"properties":{"url":{"format":"uri","maxLength":2000,"type":"string"}},"required":["url"],"type":"object"},"ProjectSourceAnalysisEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/JsonObject"}},"required":["data"],"type":"object"},"ProjectSetupPreviewRequest":{"additionalProperties":false,"properties":{"expectedRevision":{"minimum":1,"type":"integer"}},"required":["expectedRevision"],"type":"object"},"ProjectSetupPlanItem":{"additionalProperties":false,"properties":{"brief":{"type":"string"},"destinationPackages":{"$ref":"#/components/schemas/JsonObject"},"hook":{"type":"string"},"lane":{"enum":["short_video","social_content","cms_article"],"type":"string"},"scheduledFor":{"format":"date-time","type":"string"},"scriptDraft":{"type":"string"},"slotKey":{"type":"string"},"title":{"type":"string"}},"required":["brief","destinationPackages","lane","scheduledFor","slotKey","title"],"type":"object"},"ProjectSetupPlanPreview":{"additionalProperties":false,"properties":{"generatedAt":{"format":"date-time","type":"string"},"items":{"items":{"$ref":"#/components/schemas/ProjectSetupPlanItem"},"type":"array"}},"required":["generatedAt","items"],"type":"object"},"ProjectSetupPreview":{"additionalProperties":false,"properties":{"hash":{"pattern":"^[a-f0-9]{64}$","type":"string"},"preview":{"$ref":"#/components/schemas/ProjectSetupPlanPreview"},"session":{"$ref":"#/components/schemas/ProjectSetupSession"}},"required":["hash","preview","session"],"type":"object"},"ProjectSetupPreviewEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/ProjectSetupPreview"}},"required":["data"],"type":"object"},"ProjectSetupCompleteRequest":{"additionalProperties":false,"properties":{"expectedRevision":{"minimum":1,"type":"integer"},"previewHash":{"pattern":"^[a-f0-9]{64}$","type":"string"}},"required":["expectedRevision","previewHash"],"type":"object"},"ProjectWorkstream":{"additionalProperties":false,"properties":{"capabilities":{"$ref":"#/components/schemas/ProjectWorkstreamCapabilities"},"destinationIds":{"items":{"type":"string"},"minItems":1,"type":"array"},"id":{"enum":["short_video","social","blog","local_presence"],"type":"string"},"kind":{"enum":["short_video","social","blog","local_presence"],"type":"string"},"lane":{"enum":["short_video","social_content","cms_article"],"type":"string"},"templateId":{"enum":["short_video_standard","social_publishing","blog_publishing","local_presence"],"type":"string"},"version":{"enum":[1],"type":"integer"}},"required":["capabilities","destinationIds","id","kind","lane","templateId","version"],"type":"object"},"ProjectWorkstreamCapabilities":{"additionalProperties":false,"properties":{"analytics":{"type":"boolean"},"connection":{"enum":["official_oauth","credentials","export_only","unavailable","per_destination"],"type":"string"},"drafting":{"type":"boolean"},"export":{"type":"boolean"},"generation":{"type":"boolean"},"planning":{"type":"boolean"},"publishing":{"enum":["live","configuration_required","export_only","unavailable"],"type":"string"},"scheduling":{"type":"boolean"}},"required":["analytics","connection","drafting","export","generation","planning","publishing","scheduling"],"type":"object"},"ProjectCreateRequest":{"anyOf":[{"required":["websiteUrl"]},{"required":["name"]}],"properties":{"callToAction":{"maxLength":240,"type":"string"},"creatorId":{"maxLength":80,"type":"string"},"description":{"maxLength":1000,"type":"string"},"language":{"maxLength":12,"minLength":2,"type":"string"},"name":{"maxLength":120,"type":"string"},"targetAudience":{"maxLength":240,"type":"string"},"tone":{"maxLength":120,"type":"string"},"trendRegion":{"maxLength":8,"minLength":2,"type":"string"},"websiteUrl":{"maxLength":500,"minLength":3,"type":"string"}},"type":"object"},"ProjectRenameRequest":{"properties":{"name":{"maxLength":120,"type":"string"}},"required":["name"],"type":"object"},"ProjectEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/Project"}},"required":["data"],"type":"object"},"ProjectsEnvelope":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Project"},"type":"array"}},"required":["data"],"type":"object"},"ProjectHome":{"additionalProperties":true,"properties":{"attention":{"properties":{"active":{"format":"int32","type":"integer"},"failed":{"format":"int32","type":"integer"},"incompleteSetup":{"type":"boolean"},"needsReview":{"format":"int32","type":"integer"}},"required":["active","failed","incompleteSetup","needsReview"],"type":"object"},"assets":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"avatars":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"carousels":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"jobs":{"items":{"additionalProperties":true,"type":"object"},"type":"array"},"project":{"$ref":"#/components/schemas/Project"},"reels":{"items":{"additionalProperties":true,"type":"object"},"type":"array"}},"required":["project","assets","avatars","carousels","jobs","reels"],"type":"object"},"ProjectHomeEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/ProjectHome"}},"required":["data"],"type":"object"},"ProjectMemberRequest":{"properties":{"email":{"format":"email","type":"string"},"role":{"enum":["VIEW","EDIT","ADMIN"],"type":"string"}},"required":["email","role"],"type":"object"},"ProjectMemberUpdateRequest":{"properties":{"role":{"enum":["VIEW","EDIT","ADMIN"],"type":"string"}},"required":["role"],"type":"object"},"ProjectSettings":{"additionalProperties":true,"properties":{"canEdit":{"type":"boolean"},"canManage":{"type":"boolean"},"creationDestinations":{"items":{"$ref":"#/components/schemas/CreationDestination"},"type":"array"},"creationOutputCapabilities":{"items":{"$ref":"#/components/schemas/CreationOutputCapability"},"type":"array"},"destinationCatalog":{"items":{"$ref":"#/components/schemas/ProjectSetupDestination"},"type":"array"},"defaultAvatarId":{"nullable":true,"type":"string"},"generationDefaults":{"$ref":"#/components/schemas/JsonObject"},"id":{"type":"string"},"isOwner":{"type":"boolean"},"name":{"type":"string"},"role":{"type":"string"}},"required":["id","name","role","canEdit","canManage","isOwner","generationDefaults","creationDestinations","creationOutputCapabilities","destinationCatalog"],"type":"object"},"ProjectSettingsEnvelope":{"properties":{"data":{"$ref":"#/components/schemas/ProjectSettings"}},"required":["data"],"type":"object"},"ProjectSettingsUpdateRequest":{"properties":{"defaultAvatarId":{"nullable":true,"type":"string"},"generationDefaults":{"$ref":"#/components/schemas/JsonObject"},"name":{"type":"string"}},"type":"object"},"RefreshRequest":{"properties":{"deviceId":{"type":"string"},"deviceName":{"type":"string"},"refreshToken":{"type":"string"}},"required":["refreshToken"],"type":"object"},"PushTokenRequest":{"properties":{"environment":{"enum":["sandbox","production"],"type":"string"},"token":{"pattern":"^[a-fA-F0-9]{64,512}$","type":"string"}},"required":["environment","token"],"type":"object"}},"securitySchemes":{"bearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http"}}},"info":{"description":"Versioned native mobile API for AI Content Factory.","title":"AI Content Factory Mobile API","version":"0.3.0"},"openapi":"3.1.0","paths":{"/api/v1/auth/apple":{"post":{"operationId":"signInWithApple","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppleSignInRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthSessionEnvelope"}}},"description":"Success"}},"summary":"Sign in with Apple","tags":["Auth"]}},"/api/v1/auth/google":{"post":{"operationId":"signInWithGoogle","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoogleSignInRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthSessionEnvelope"}}},"description":"Success"}},"summary":"Sign in with Google","tags":["Auth"]}},"/api/v1/auth/credentials":{"post":{"operationId":"signInWithCredentials","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CredentialsSignInRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthSessionEnvelope"}}},"description":"Success"}},"summary":"Sign in with a pre-provisioned reviewer account","tags":["Auth"]}},"/api/v1/auth/logout":{"post":{"operationId":"logout","responses":{"204":{"description":"Logged out"}},"summary":"Revoke the current session","tags":["Auth"],"security":[{"bearerAuth":[]}]}},"/api/v1/auth/me":{"delete":{"operationId":"deleteAccount","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteAccountRequest"}}},"required":true},"responses":{"204":{"description":"Deleted"}},"summary":"Delete the current user","tags":["Auth"],"security":[{"bearerAuth":[]}]},"get":{"operationId":"getCurrentUser","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MobileUserEnvelope"}}},"description":"Success"}},"summary":"Get the current user","tags":["Auth"],"security":[{"bearerAuth":[]}]}},"/api/v1/auth/refresh":{"post":{"operationId":"refreshSession","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthSessionEnvelope"}}},"description":"Success"}},"summary":"Rotate a refresh token","tags":["Auth"]}},"/api/v1/auth/push-token":{"delete":{"operationId":"unregisterPushToken","responses":{"204":{"description":"Unregistered"}},"summary":"Unregister the current device from push notifications","tags":["Auth"],"security":[{"bearerAuth":[]}]},"post":{"operationId":"registerPushToken","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PushTokenRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Register an APNs device token","tags":["Auth"],"security":[{"bearerAuth":[]}]}},"/api/v1/health":{"get":{"operationId":"getHealth","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Health check","tags":["System"]}},"/api/v1/readiness":{"get":{"operationId":"getReadiness","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Database and queue readiness check","tags":["System"]}},"/api/v1/app-config":{"get":{"operationId":"getMobileAppConfig","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MobileAppConfigEnvelope"}}},"description":"Success"},"304":{"description":"Configuration has not changed"}},"summary":"Get versioned server-driven mobile capabilities","tags":["System"],"security":[{"bearerAuth":[]}]}},"/api/v1/billing/status":{"get":{"operationId":"getMobileBillingStatus","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MobileBillingStatusEnvelope"}}},"description":"Success"}},"summary":"Get StoreKit products and server-authoritative paid access","tags":["Billing"],"security":[{"bearerAuth":[]}]}},"/api/v1/billing/app-store-transactions":{"post":{"operationId":"syncMobileAppStoreTransaction","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MobileAppStoreTransactionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MobileBillingStatusEnvelope"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Success"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Success"}},"summary":"Verify and grant one App Store subscription transaction","tags":["Billing"],"security":[{"bearerAuth":[]}]}},"/api/v1/platforms":{"get":{"operationId":"getPlatformCatalog","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformCatalogEnvelope"}}},"description":"Success"}},"summary":"Get the canonical Platform First catalog","tags":["Platforms"],"security":[{"bearerAuth":[]}]}},"/api/v1/project-setup":{"get":{"operationId":"listProjectSetupSessions","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSetupSessionsEnvelope"}}},"description":"Success"}},"summary":"List resumable project setup sessions","tags":["Project Setup"],"security":[{"bearerAuth":[]}]},"post":{"operationId":"startProjectSetup","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSetupCreateRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSetupSessionEnvelope"}}},"description":"Success"}},"summary":"Start or resume idempotent project setup","tags":["Project Setup"],"security":[{"bearerAuth":[]}]}},"/api/v1/project-setup/{sessionId}":{"get":{"operationId":"getProjectSetup","parameters":[{"in":"path","name":"sessionId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSetupSnapshotEnvelope"}}},"description":"Success"}},"summary":"Get setup, destination catalog, connection status, and creators","tags":["Project Setup"],"security":[{"bearerAuth":[]}]},"patch":{"operationId":"updateProjectSetup","parameters":[{"in":"path","name":"sessionId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSetupUpdateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSetupSessionEnvelope"}}},"description":"Success"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Success"}},"summary":"Save setup step data with optimistic revision","tags":["Project Setup"],"security":[{"bearerAuth":[]}]}},"/api/v1/project-setup/{sessionId}/analyze":{"post":{"operationId":"analyzeProjectSetupSource","parameters":[{"in":"path","name":"sessionId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSourceAnalyzeRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSourceAnalysisEnvelope"}}},"description":"Success"}},"summary":"Analyze a public project source","tags":["Project Setup"],"security":[{"bearerAuth":[]}]}},"/api/v1/project-setup/{sessionId}/preview":{"post":{"operationId":"previewProjectSetupPlan","parameters":[{"in":"path","name":"sessionId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSetupPreviewRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSetupPreviewEnvelope"}}},"description":"Success"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Success"}},"summary":"Build and persist a content plan preview","tags":["Project Setup"],"security":[{"bearerAuth":[]}]}},"/api/v1/project-setup/{sessionId}/complete":{"post":{"operationId":"completeProjectSetup","parameters":[{"in":"path","name":"sessionId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSetupCompleteRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSetupSessionEnvelope"}}},"description":"Success"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Success"}},"summary":"Request idempotent setup provisioning","tags":["Project Setup"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/page":{"get":{"operationId":"listProjectsPage","parameters":[{"in":"query","name":"cursor","schema":{"type":"string","maxLength":1024}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"in":"query","name":"query","schema":{"type":"string","maxLength":160}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectListPageEnvelope"}}},"description":"Success"}},"summary":"Search and page accessible projects","tags":["Projects"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/seo-research/page":{"get":{"operationId":"listSeoResearchPage","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"query","name":"cursor","schema":{"type":"string","maxLength":1024}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"in":"query","name":"query","schema":{"type":"string","maxLength":160}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeoResearchPageEnvelope"}}},"description":"Success"}},"summary":"Search saved SEO research","tags":["Research"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/advanced-research/page":{"get":{"operationId":"listAdvancedResearchPage","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"query","name":"cursor","schema":{"type":"string","maxLength":1024}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"in":"query","name":"query","schema":{"type":"string","maxLength":160}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvancedResearchPageEnvelope"}}},"description":"Success"}},"summary":"Search saved research workflows","tags":["Research"],"security":[{"bearerAuth":[]}]}},"/api/v1/video-catalog/formats/{blueprintId}/preview":{"get":{"operationId":"getVideoFormatPreview","parameters":[{"in":"path","name":"blueprintId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoFormatPreviewEnvelope"}}},"description":"Success"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"No published example exists"}},"summary":"Get temporary URLs for a published video format example","tags":["Video Catalog"],"security":[{"bearerAuth":[]}]}},"/api/v1/video-catalog/formats":{"get":{"operationId":"listVideoFormats","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Get canonical video format capabilities","tags":["Video Catalog"],"security":[{"bearerAuth":[]}]}},"/api/v1/video-catalog/characters":{"get":{"operationId":"listVideoCharacters","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Get ready catalog characters with immutable pose versions","tags":["Video Catalog"],"security":[{"bearerAuth":[]}]}},"/api/v1/video-catalog":{"get":{"operationId":"listVideoCatalog","parameters":[{"in":"query","name":"cursor","schema":{"type":"string","maxLength":120}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":40}},{"in":"query","name":"kind","schema":{"type":"string"}},{"in":"query","name":"collection","schema":{"type":"string"}},{"in":"query","name":"blueprintId","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Page ready licensed catalog assets","tags":["Video Catalog"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects":{"get":{"operationId":"listProjects","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectsEnvelope"}}},"description":"Success"}},"summary":"List accessible projects","tags":["Projects"],"security":[{"bearerAuth":[]}]},"post":{"operationId":"createProject","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectCreateRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectEnvelope"}}},"description":"Success"}},"summary":"Create a project","tags":["Projects"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/starter-pack-catalog":{"get":{"operationId":"getStarterPackCatalog","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StarterPackCatalogEnvelope"}}},"description":"Success"}},"summary":"Get reusable Starter Pack creators and pricing","tags":["Starter Pack"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}":{"delete":{"operationId":"deleteProject","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteProjectRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Delete a project","tags":["Projects"],"security":[{"bearerAuth":[]}]},"get":{"operationId":"getProject","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectEnvelope"}}},"description":"Success"}},"summary":"Get a project","tags":["Projects"],"security":[{"bearerAuth":[]}]},"patch":{"operationId":"renameProject","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectRenameRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectEnvelope"}}},"description":"Success"}},"summary":"Rename a project","tags":["Projects"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/destinations":{"patch":{"operationId":"updateProjectDestinations","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectDestinationsUpdateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectEnvelope"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Success"}},"summary":"Update the agents and destinations enabled for a project","tags":["Projects"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content":{"get":{"operationId":"listProjectContent","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"query","name":"cursor","schema":{"type":"string","maxLength":1000}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":30}},{"in":"query","name":"q","schema":{"type":"string","maxLength":200}},{"in":"query","name":"scheduleFrom","description":"Inclusive calendar interval start. Both bounds required; maximum 93 days.","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"scheduleTo","description":"Exclusive calendar interval end.","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"type","schema":{"type":"string","enum":["all","video","carousel","post","article","job"]}},{"in":"query","name":"status","schema":{"type":"string","enum":["all","attention","active","ready","scheduled","published","cancelled"]}},{"in":"query","name":"workstream","schema":{"type":"string","enum":["all","short_video","social","blog","local_presence"]}},{"in":"query","name":"destination","schema":{"enum":["custom_webhook","wordpress","shopify_blog","wix_blog","webflow_cms","ghost","instagram_post","linkedin_post","linkedin_article","x_post","x_thread","telegram_channel","reddit_post","facebook_page","threads_post","bluesky_post","tiktok_video","instagram_reel","youtube_short","facebook_reel","snapchat_spotlight","instagram_carousel","linkedin_document","facebook_carousel","pinterest_pin","tiktok_carousel","youtube_video_metadata","youtube_community_post","google_business_post"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectContentPageEnvelope"}}},"description":"Success"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Invalid query or cursor"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Project not found"}},"summary":"Browse all project content with server filters and stable cursor pagination","description":"Sorted by updatedAt descending then id descending. Counts respect search, type and lane before status. Cursor is opaque and bound to the project and filters. Linked generation jobs are folded into their deliverables.","tags":["Outputs"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content/{contentId}":{"get":{"operationId":"getProjectContent","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"contentId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectContentDetailEnvelope"}}},"description":"Success"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Content not found"}},"summary":"Read a content item directly, including older history","tags":["Outputs"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/reels/{reelId}":{"get":{"operationId":"getProjectReel","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"reelId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReelResultEnvelope"}}},"description":"Success"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Video not found"}},"summary":"Get a project video by ID","tags":["Outputs"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/carousels/{carouselId}":{"get":{"operationId":"getProjectCarousel","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"carouselId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarouselResultEnvelope"}}},"description":"Success"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}},"description":"Carousel not found"}},"summary":"Get a project carousel by ID","tags":["Outputs"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/home":{"get":{"operationId":"getProjectHome","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectHomeEnvelope"}}},"description":"Success"}},"summary":"Get the mobile project home","tags":["Projects"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/seo-research":{"get":{"operationId":"listSeoResearchRuns","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeoResearchRunsEnvelope"}}},"description":"Success"}},"summary":"List saved SEO research runs","tags":["Research"],"security":[{"bearerAuth":[]}]},"post":{"operationId":"createSeoResearchRun","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeoResearchRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeoResearchRunEnvelope"}}},"description":"Cached result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeoResearchRunEnvelope"}}},"description":"Fresh saved result"}},"summary":"Run and save SEO keyword research","tags":["Research"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/seo-research/estimate":{"post":{"operationId":"estimateSeoResearchCost","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeoResearchRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeoResearchCostEstimateEnvelope"}}},"description":"Success"}},"summary":"Preview cache freshness and paid SEO refresh cost","tags":["Research"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/seo-research/{runId}":{"get":{"operationId":"getSeoResearchRun","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"runId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeoResearchRunEnvelope"}}},"description":"Success"}},"summary":"Get one saved SEO research run","tags":["Research"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/advanced-research":{"get":{"operationId":"listAdvancedResearchRuns","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvancedResearchRunsEnvelope"}}},"description":"Success"}},"summary":"List SEO and ASO evidence workflows","tags":["Research"],"security":[{"bearerAuth":[]}]},"post":{"operationId":"createAdvancedResearchRun","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvancedResearchRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvancedResearchRunEnvelope"}}},"description":"Cached result"},"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvancedResearchRunEnvelope"}}},"description":"Queued provider research"}},"summary":"Queue a high-value SEO or ASO workflow","tags":["Research"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/advanced-research/estimate":{"post":{"operationId":"estimateAdvancedResearchCost","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvancedResearchRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvancedResearchCostEstimateEnvelope"}}},"description":"Success"}},"summary":"Preview advanced research freshness and cost","tags":["Research"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/advanced-research/catalog":{"get":{"operationId":"getAdvancedResearchAppCatalog","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"query","name":"store","required":true,"schema":{"enum":["apple","google"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvancedResearchAppCatalogEnvelope"}}},"description":"Success"}},"summary":"Get cached App Store or Google Play categories and chart collections","tags":["Research"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/advanced-research/{runId}":{"get":{"operationId":"getAdvancedResearchRun","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"runId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvancedResearchRunEnvelope"}}},"description":"Success"}},"summary":"Get an advanced research run","tags":["Research"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/advanced-research/{runId}/selection":{"patch":{"operationId":"updateAdvancedResearchSelection","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"runId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvancedResearchSelectionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvancedResearchRunEnvelope"}}},"description":"Success"}},"summary":"Select campaign evidence","tags":["Research"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/seo-research/{runId}/selection":{"patch":{"operationId":"updateSeoResearchSelection","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"runId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeoKeywordSelectionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeoResearchRunEnvelope"}}},"description":"Success"}},"summary":"Save the selected keywords for a research run","tags":["Research"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content-campaigns":{"get":{"operationId":"listContentCampaigns","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentCampaignsEnvelope"}}},"description":"Success"}},"summary":"List evidence-backed campaigns","tags":["Campaigns"],"security":[{"bearerAuth":[]}]},"post":{"operationId":"createContentCampaign","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateContentCampaignRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentCampaignDetailEnvelope"}}},"description":"Success"}},"summary":"Create an evidence-backed campaign","tags":["Campaigns"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content-campaigns/create-and-generate":{"post":{"operationId":"createAndGenerateContentCampaign","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateContentCampaignRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentCampaignDetailEnvelope"}}},"description":"Success"}},"summary":"Atomically reserve one credit and generate a native content set","tags":["Campaigns"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content-campaigns/{campaignId}":{"get":{"operationId":"getContentCampaign","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"campaignId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentCampaignDetailEnvelope"}}},"description":"Success"}},"summary":"Get campaign outputs","tags":["Campaigns"],"security":[{"bearerAuth":[]}]},"patch":{"operationId":"updateContentCampaign","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"campaignId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonObject"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentCampaignDetailEnvelope"}}},"description":"Success"}},"summary":"Update a campaign brief","tags":["Campaigns"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content-campaigns/{campaignId}/generate":{"post":{"operationId":"generateContentCampaign","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"campaignId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateCampaignOutputsRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentCampaignDetailEnvelope"}}},"description":"Success"}},"summary":"Generate native destination outputs","tags":["Campaigns"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content-campaigns/{campaignId}/publish-attempts":{"get":{"operationId":"listCampaignPublishAttempts","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"campaignId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignPublishAttemptsEnvelope"}}},"description":"Success"}},"summary":"List campaign delivery attempts","tags":["Publishing"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content-campaigns/{campaignId}/publish-attempts/{attemptId}/retry":{"post":{"operationId":"retryCampaignPublishAttempt","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"campaignId","required":true,"schema":{"type":"string"}},{"in":"path","name":"attemptId","required":true,"schema":{"type":"string"}}],"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignPublishAttemptEnvelope"}}},"description":"Success"}},"summary":"Retry a failed delivery","tags":["Publishing"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content-campaigns/{campaignId}/publish-attempts/{attemptId}/cancel":{"post":{"operationId":"cancelCampaignPublishAttempt","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"campaignId","required":true,"schema":{"type":"string"}},{"in":"path","name":"attemptId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignPublishAttemptEnvelope"}}},"description":"Success"}},"summary":"Cancel queued delivery","tags":["Publishing"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content-campaigns/{campaignId}/outputs/{outputId}":{"patch":{"operationId":"updateCampaignOutput","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"campaignId","required":true,"schema":{"type":"string"}},{"in":"path","name":"outputId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignOutputEditRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Save a campaign output revision","tags":["Campaigns"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content-campaigns/{campaignId}/outputs/{outputId}/approval":{"post":{"operationId":"reviewCampaignOutput","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"campaignId","required":true,"schema":{"type":"string"}},{"in":"path","name":"outputId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignOutputApprovalRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Approve or reject an output","tags":["Campaigns"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content-campaigns/{campaignId}/outputs/{outputId}/regenerate":{"post":{"operationId":"regenerateCampaignOutput","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"campaignId","required":true,"schema":{"type":"string"}},{"in":"path","name":"outputId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignOutputRegenerationRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Regenerate one output scope","tags":["Campaigns"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content-campaigns/{campaignId}/outputs/{outputId}/revisions":{"get":{"operationId":"listCampaignOutputRevisions","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"campaignId","required":true,"schema":{"type":"string"}},{"in":"path","name":"outputId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"List immutable output revisions","tags":["Campaigns"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content-campaigns/{campaignId}/outputs/{outputId}/publishing-preview":{"post":{"operationId":"previewCampaignPublishing","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"campaignId","required":true,"schema":{"type":"string"}},{"in":"path","name":"outputId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishingPreviewRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishingPreviewEnvelope"}}},"description":"Success"}},"summary":"Preview a redacted provider request","tags":["Publishing"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content-campaigns/{campaignId}/outputs/{outputId}/publish":{"post":{"operationId":"publishCampaignOutput","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"campaignId","required":true,"schema":{"type":"string"}},{"in":"path","name":"outputId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignPublishRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignPublishAttemptEnvelope"}}},"description":"Success"}},"summary":"Queue approved provider delivery","tags":["Publishing"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/publishing-connections":{"get":{"operationId":"listPublishingConnections","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishingConnectionsEnvelope"}}},"description":"Success"}},"summary":"List safe publishing connection metadata","tags":["Publishing"],"security":[{"bearerAuth":[]}]},"post":{"operationId":"createPublishingConnection","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePublishingConnectionRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishingConnectionEnvelope"}}},"description":"Success"}},"summary":"Create an encrypted publishing connection","tags":["Publishing"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/publishing-connections/official":{"post":{"operationId":"createOfficialPublishingConnection","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOfficialPublishingConnectionRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishingConnectionEnvelope"}}},"description":"Success"}},"summary":"Create a server-owned official publishing connection (OAuth or Telegram bot token)","tags":["Publishing"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/publishing-connections/{connectionId}":{"delete":{"operationId":"revokePublishingConnection","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"connectionId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishingConnectionEnvelope"}}},"description":"Success"}},"summary":"Revoke a publishing credential","tags":["Publishing"],"security":[{"bearerAuth":[]}]},"get":{"operationId":"getPublishingConnection","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"connectionId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishingConnectionEnvelope"}}},"description":"Success"}},"summary":"Get publishing connection metadata","tags":["Publishing"],"security":[{"bearerAuth":[]}]},"patch":{"operationId":"updatePublishingConnection","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"connectionId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonObject"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishingConnectionEnvelope"}}},"description":"Success"}},"summary":"Update or rotate a publishing connection","tags":["Publishing"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/publishing-connections/{connectionId}/certification":{"patch":{"operationId":"certifyPublishingConnection","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"connectionId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePublishingCertificationRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishingConnectionEnvelope"}}},"description":"Success"}},"summary":"Record a publishing certification gate or explicitly enable production","tags":["Publishing"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/publishing-connections/{connectionId}/oauth/start":{"post":{"operationId":"startPublishingOAuth","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"connectionId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishingOAuthStartEnvelope"}}},"description":"Success"}},"summary":"Start the provider-specific official OAuth flow","tags":["Publishing"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/operations":{"get":{"operationId":"getProjectOperations","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectOperationsSummaryEnvelope"}}},"description":"Success"}},"summary":"Get admin cost, cache, provider, and publishing health","tags":["Publishing"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/operations/{operationId}":{"get":{"operationId":"getOperation","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"operationId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationEnvelope"}}},"description":"Success"}},"summary":"Get one long-running operation by its stable ID","tags":["Publishing"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/analytics-connections":{"get":{"operationId":"listAnalyticsConnections","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsConnectionsEnvelope"}}},"description":"Success"}},"summary":"List performance analytics connections","tags":["Analytics"],"security":[{"bearerAuth":[]}]},"post":{"operationId":"createAnalyticsConnection","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAnalyticsConnectionRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsConnectionEnvelope"}}},"description":"Success"}},"summary":"Store an encrypted analytics connection","tags":["Analytics"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/analytics-connections/{connectionId}":{"delete":{"operationId":"revokeAnalyticsConnection","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"connectionId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsConnectionEnvelope"}}},"description":"Success"}},"summary":"Revoke an analytics connection","tags":["Analytics"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/analytics-connections/{connectionId}/sync":{"post":{"operationId":"syncAnalyticsConnection","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"connectionId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsSyncRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsSyncRunEnvelope"}}},"description":"Success"}},"summary":"Queue an idempotent analytics sync","tags":["Analytics"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/analytics-connections/{connectionId}/import":{"post":{"operationId":"importAnalyticsSnapshots","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"connectionId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsManualImportRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsSyncRunEnvelope"}}},"description":"Success"}},"summary":"Import bounded operator-supplied performance snapshots","tags":["Analytics"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/performance":{"get":{"operationId":"getPerformanceDashboard","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"query","name":"rangeStart","schema":{"format":"date-time","type":"string"}},{"in":"query","name":"rangeEnd","schema":{"format":"date-time","type":"string"}},{"in":"query","name":"campaignId","schema":{"type":"string"}},{"in":"query","name":"destination","schema":{"type":"string"}},{"in":"query","name":"format","schema":{"type":"string"}},{"in":"query","name":"market","schema":{"type":"string"}},{"in":"query","name":"topic","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerformanceDashboardEnvelope"}}},"description":"Success"}},"summary":"Get normalized cross-channel performance and reviewable recommendations","tags":["Analytics"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/performance-recommendations/{recommendationId}":{"patch":{"operationId":"updatePerformanceRecommendation","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"recommendationId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePerformanceRecommendationRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerformanceRecommendationEnvelope"}}},"description":"Success"}},"summary":"Approve, dismiss, or apply a recommendation as a recorded influence","tags":["Analytics"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/starter-packs":{"post":{"operationId":"createStarterPack","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StarterPackRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StarterPackResultEnvelope"}}},"description":"Success"}},"summary":"Create a Reel, Carousel, and native destination posts for one Starter credit","tags":["Starter Pack"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/canonical-content":{"post":{"operationId":"createCanonicalContent","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CanonicalContentGenerationRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CanonicalContentGenerationEnvelope"}}},"description":"Success"}},"summary":"Queue destination-native campaign content for up to three canonical destinations","tags":["Outputs"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/starter-packs/{jobId}":{"get":{"operationId":"getStarterPack","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"jobId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StarterPackResultEnvelope"}}},"description":"Success"}},"summary":"Get aggregate Starter Pack progress and outputs","tags":["Starter Pack"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/starter-packs/{jobId}/content/{platform}":{"patch":{"operationId":"updateStarterPackPlatformContent","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"jobId","required":true,"schema":{"type":"string"}},{"in":"path","name":"platform","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"body":{"maxLength":60000,"minLength":1,"type":"string"},"hashtags":{"items":{"type":"string"},"maxItems":12,"type":"array"},"keyTakeaways":{"items":{"type":"string"},"maxItems":12,"type":"array"},"metaDescription":{"maxLength":320,"nullable":true,"type":"string"},"slug":{"maxLength":180,"nullable":true,"type":"string"},"summary":{"maxLength":1200,"nullable":true,"type":"string"},"title":{"maxLength":300,"nullable":true,"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Edit a generated native platform post or article","tags":["Starter Pack"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/settings":{"get":{"operationId":"getProjectSettings","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSettingsEnvelope"}}},"description":"Success"}},"summary":"Get project settings","tags":["Projects"],"security":[{"bearerAuth":[]}]},"patch":{"operationId":"updateProjectSettings","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSettingsUpdateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectSettingsEnvelope"}}},"description":"Success"}},"summary":"Update project settings","tags":["Projects"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/idea-drafts":{"get":{"operationId":"getProjectIdeaDraft","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"query","name":"outputType","required":true,"schema":{"enum":["reel","carousel","content_pack"],"type":"string"}},{"in":"query","name":"avatarId","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectIdeaDraftEnvelope"}}},"description":"Success"}},"summary":"Restore the saved idea for a creator and output type","tags":["Outputs"],"security":[{"bearerAuth":[]}]},"put":{"operationId":"upsertProjectIdeaDraft","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectIdeaDraftUpsertRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectIdeaDraftEnvelope"}}},"description":"Success"}},"summary":"Save the active creator and output idea","tags":["Outputs"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/suggestions/output":{"post":{"operationId":"suggestOutput","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutputSuggestionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutputSuggestionEnvelope"}}},"description":"Success"}},"summary":"Generate a project-aware output idea","tags":["Outputs"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/members":{"post":{"operationId":"shareProject","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectMemberRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Share project access","tags":["Projects"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/members/{membershipId}":{"delete":{"operationId":"removeProjectMember","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"membershipId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Remove a project member","tags":["Projects"],"security":[{"bearerAuth":[]}]},"patch":{"operationId":"updateProjectMember","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"membershipId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectMemberUpdateRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Update a project member","tags":["Projects"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/avatar-agents":{"get":{"operationId":"getAvatarAgents","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvatarAgentsEnvelope"}}},"description":"Success"}},"summary":"List avatar agents","tags":["Avatars"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/avatar-voices/resolve":{"post":{"operationId":"resolveProjectVoice","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectVoiceResolveRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectVoiceIdentityEnvelope"}}},"description":"Success"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorEnvelope"}}},"description":"Success"}},"summary":"Resolve a provider catalog voice to a generation voice ID (project editor required)","tags":["Avatars"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/avatar-voices":{"get":{"operationId":"getAvatarVoiceOptions","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"query","name":"gender","required":true,"schema":{"enum":["female","male"],"type":"string"}},{"in":"query","name":"language","required":true,"schema":{"type":"string"}},{"in":"query","name":"search","schema":{"maxLength":120,"type":"string"}},{"in":"query","name":"accent","schema":{"maxLength":80,"type":"string"}},{"in":"query","name":"age","schema":{"maxLength":80,"type":"string"}},{"in":"query","name":"category","schema":{"enum":["professional","famous","high_quality"],"type":"string"}},{"in":"query","name":"useCases","schema":{"items":{"type":"string"},"maxItems":12,"type":"array"},"style":"form"},{"in":"query","name":"descriptives","schema":{"items":{"type":"string"},"maxItems":12,"type":"array"},"style":"form"},{"in":"query","name":"featured","schema":{"type":"boolean"}},{"in":"query","name":"includeCustomRates","schema":{"type":"boolean"}},{"in":"query","name":"includeLiveModerated","schema":{"type":"boolean"}},{"in":"query","name":"locale","schema":{"maxLength":35,"type":"string"}},{"in":"query","name":"minNoticePeriodDays","schema":{"maximum":730,"minimum":0,"type":"integer"}},{"in":"query","name":"sort","schema":{"enum":["trending","cloned_by_count","usage_character_count_1y","created_date"],"type":"string"}},{"in":"query","name":"page","schema":{"maximum":10000,"minimum":0,"type":"integer"}},{"in":"query","name":"limit","schema":{"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvatarVoiceOptionsEnvelope"}}},"description":"Success"}},"summary":"Browse the live ElevenLabs avatar voice catalog","tags":["Avatars"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/avatar-agents/{avatarId}":{"patch":{"operationId":"updateAvatarAgent","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"avatarId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonObject"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Update an avatar agent","tags":["Avatars"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/avatar-agents/{avatarId}/references":{"put":{"operationId":"replaceAvatarReferences","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"avatarId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvatarReferenceUpdate"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Replace avatar references","tags":["Avatars"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/avatar-agents/{avatarId}/plan":{"post":{"operationId":"planAvatarAgent","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"avatarId","required":true,"schema":{"type":"string"}}],"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Plan the next avatar window","tags":["Avatars"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/editorial-calendars":{"get":{"operationId":"listEditorialCalendars","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"query","name":"from","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"to","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"List SEO editorial calendars","tags":["Planner"],"security":[{"bearerAuth":[]}]},"post":{"operationId":"createEditorialCalendar","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditorialCalendarRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Research and create an SEO editorial calendar","tags":["Planner"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/editorial-calendars/{calendarId}":{"get":{"operationId":"getEditorialCalendar","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"calendarId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Get an SEO editorial calendar","tags":["Planner"],"security":[{"bearerAuth":[]}]},"patch":{"operationId":"updateEditorialCalendar","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"calendarId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonObject"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Activate or update an SEO editorial calendar","tags":["Planner"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/editorial-calendars/{calendarId}/items/{itemId}":{"patch":{"operationId":"updateEditorialCalendarItem","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"calendarId","required":true,"schema":{"type":"string"}},{"in":"path","name":"itemId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonObject"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Update an editorial calendar article","tags":["Planner"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content-plan":{"get":{"operationId":"getContentPlan","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"query","name":"from","schema":{"format":"date","type":"string"}},{"in":"query","name":"to","schema":{"format":"date","type":"string"}},{"in":"query","name":"avatarId","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentPlanEnvelope"}}},"description":"Success"}},"summary":"Get content plan","tags":["Planner"],"security":[{"bearerAuth":[]}]},"post":{"operationId":"createContentPlanItem","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentPlanItemRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Create a content plan item","tags":["Planner"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content-plan/generate":{"post":{"operationId":"generateContentPlan","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentPlanGenerateRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Generate a content plan","tags":["Planner"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content-plan/{itemId}":{"delete":{"operationId":"deleteContentPlanItem","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"itemId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Delete a content plan item","tags":["Planner"],"security":[{"bearerAuth":[]}]},"patch":{"operationId":"updateContentPlanItem","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"itemId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentPlanItemRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Update a content plan item","tags":["Planner"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/content-plan/{itemId}/pregenerate":{"post":{"operationId":"pregenerateContentPlanItem","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"itemId","required":true,"schema":{"type":"string"}}],"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Pregenerate a planned item","tags":["Planner"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/assets":{"get":{"operationId":"listAssets","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"query","name":"query","schema":{"type":"string","maxLength":160}},{"in":"query","name":"type","schema":{"type":"string","enum":["IMAGE","VIDEO","AUDIO","DOCUMENT"]}},{"in":"query","name":"status","schema":{"type":"string","enum":["READY"]}},{"in":"query","name":"ids","schema":{"type":"string"},"description":"Comma-separated exact asset IDs, at most 100, scoped to this project"},{"in":"query","name":"cursor","schema":{"type":"string"}},{"in":"query","name":"limit","schema":{"default":50,"maximum":100,"minimum":1,"type":"integer"}},{"in":"query","name":"purpose","schema":{"enum":["AVATAR_REFERENCE","APP_SCREENSHOT","WEBSITE_SCREENSHOT","PRODUCT_IMAGE","BRAND_ASSET","BROLL_VIDEO","GENERATED_MEDIA","SUBTITLE_STICKER","SUBTITLE_STICKER_ATLAS","RENDER_OUTPUT"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedProjectAssetsResponse"}}},"description":"Success"}},"summary":"List project assets","tags":["Assets"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/assets/generate-image":{"post":{"operationId":"generateProjectImage","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateProjectImageRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueuedProjectImageEnvelope"}}},"description":"Success"}},"summary":"Generate a reusable project image; poll the returned job ID","description":"Uses one generation credit. Optional referenceAssetIds must belong to this project. Reuse idempotencyKey for retries. The completed job result contains assetId. This does not publish content.","tags":["Assets"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/assets/{assetId}":{"delete":{"operationId":"archiveAsset","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetMutationEnvelope"}}},"description":"Success"}},"summary":"Archive a project asset","tags":["Assets"],"security":[{"bearerAuth":[]}]},"patch":{"operationId":"updateAsset","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateProjectAssetRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetMutationEnvelope"}}},"description":"Success"}},"summary":"Update a project asset","tags":["Assets"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/assets/{assetId}/download":{"get":{"operationId":"getAssetDownload","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DownloadDescriptorEnvelope"}}},"description":"Success"}},"summary":"Create a signed asset download","tags":["Assets"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/uploads":{"post":{"operationId":"createUpload","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateUploadRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadReservationEnvelope"}}},"description":"Success"}},"summary":"Create a presigned upload","tags":["Assets"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/uploads/{assetId}/finalize":{"post":{"operationId":"finalizeUpload","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinalizeUploadRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Finalize an upload","tags":["Assets"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/avatars":{"get":{"operationId":"listAvatars","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"List project avatars","tags":["Avatars"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/avatars/generate":{"post":{"operationId":"generateAvatar","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonObject"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Queue avatar generation","tags":["Avatars"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/avatars/ready":{"post":{"operationId":"addReadyCreator","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadyCreatorRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadyCreatorSelectionEnvelope"}}},"description":"Success"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadyCreatorSelectionEnvelope"}}},"description":"Success"}},"summary":"Add a reusable ready creator with cached media","tags":["Avatars"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/reels":{"get":{"operationId":"listReels","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReelResultsEnvelope"}}},"description":"Success"}},"summary":"List project reels","tags":["Outputs"],"security":[{"bearerAuth":[]}]},"post":{"operationId":"createReel","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonObject"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobMutationEnvelope"}}},"description":"Success"}},"summary":"Queue reel generation","tags":["Outputs"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/carousels":{"get":{"operationId":"listCarousels","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarouselResultsEnvelope"}}},"description":"Success"}},"summary":"List project carousels","tags":["Outputs"],"security":[{"bearerAuth":[]}]},"post":{"operationId":"createCarousel","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonObject"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobMutationEnvelope"}}},"description":"Success"}},"summary":"Queue carousel generation","tags":["Outputs"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/render-outputs/{renderOutputId}/download":{"get":{"operationId":"getRenderDownload","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"renderOutputId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DownloadDescriptorEnvelope"}}},"description":"Success"}},"summary":"Create a signed reel download","tags":["Outputs"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/distribution-revisions/{revisionId}/package":{"get":{"operationId":"getDistributionPublishingPackage","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"revisionId","required":true,"schema":{"type":"string"}},{"in":"query","name":"requireApproved","required":false,"schema":{"default":true,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishingPackageEnvelope"}}},"description":"Success"}},"summary":"Get an exact immutable publishing package revision","tags":["Publishing"],"security":[{"bearerAuth":[]}]}},"/api/v1/projects/{projectId}/carousels/{carouselId}/frames/{frameId}/download":{"get":{"operationId":"getCarouselFrameDownload","parameters":[{"in":"path","name":"projectId","required":true,"schema":{"type":"string"}},{"in":"path","name":"carouselId","required":true,"schema":{"type":"string"}},{"in":"path","name":"frameId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DownloadDescriptorEnvelope"}}},"description":"Success"}},"summary":"Create a signed carousel frame download","tags":["Outputs"],"security":[{"bearerAuth":[]}]}},"/api/v1/jobs":{"get":{"operationId":"listJobs","parameters":[{"in":"query","name":"projectId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"List generation jobs","tags":["Jobs"],"security":[{"bearerAuth":[]}]}},"/api/v1/jobs/{jobId}":{"get":{"operationId":"getJob","parameters":[{"in":"path","name":"jobId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerationJobDetailEnvelope"}}},"description":"Success"}},"summary":"Get generation status","tags":["Jobs"],"security":[{"bearerAuth":[]}]}},"/api/v1/jobs/{jobId}/resume":{"post":{"operationId":"resumeJob","parameters":[{"in":"path","name":"jobId","required":true,"schema":{"type":"string"}}],"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericEnvelope"}}},"description":"Success"}},"summary":"Resume a paused generation","tags":["Jobs"],"security":[{"bearerAuth":[]}]}}},"servers":[{"url":"https://api.vibecody.app"}]}