{"openapi":"3.1.0","info":{"title":"Creavily Public API","version":"0.1.0","description":"Public API surface for tenant-scoped brand discovery, asset reads, channel account discovery, analytics, publishing automation, OAuth token exchange, and automation source/run management."},"servers":[{"url":"http://127.0.0.1:4301","description":"Local development API"}],"x-creavily-error-catalog":{"version":"2026-07-26","errors":[{"code":"public_api_disabled","status":403,"category":"feature_gate","summary":"Public API access is disabled by environment configuration."},{"code":"request_origin_not_allowed","status":421,"category":"authorization","summary":"The effective request origin is not permitted by the configured public API origin."},{"code":"public_api_token_required","status":401,"category":"authentication","summary":"A bearer token is required for the protected public route."},{"code":"public_api_token_forbidden","status":401,"category":"authentication","summary":"The supplied bearer credential is not authorized for the protected route."},{"code":"public_api_rate_limited","status":429,"category":"rate_limit","summary":"The public API or public OAuth token exchange rate limit was exceeded."},{"code":"invalid_public_api_rate_limit_store","status":400,"category":"configuration","summary":"The configured public API rate-limit store is unsupported."},{"code":"database_url_required","status":400,"category":"configuration","summary":"The route needs DATABASE_URL but it is not configured."},{"code":"redis_url_required","status":400,"category":"configuration","summary":"The route needs REDIS_URL but it is not configured."},{"code":"invalid_request","status":400,"category":"validation","summary":"A request did not satisfy the route validation contract."},{"code":"internal_server_error","status":500,"category":"server","summary":"The server could not process the request."},{"code":"invalid_oauth_token_request","status":400,"category":"validation","summary":"The OAuth token exchange request body is invalid."},{"code":"invalid_public_oauth_authorize_request","status":400,"category":"validation","summary":"The OAuth authorization request is invalid."},{"code":"public_oauth_disabled","status":403,"category":"feature_gate","summary":"Public OAuth authorize/token exchange is disabled."},{"code":"invalid_client","status":401,"category":"authentication","summary":"OAuth client credentials are invalid."},{"code":"oauth_client_secret_unavailable","status":400,"category":"configuration","summary":"The configured OAuth client secret reference cannot be resolved."},{"code":"oauth_app_not_found","status":404,"category":"not_found","summary":"The OAuth app was not found for the requested client or organization."},{"code":"oauth_redirect_uri_not_registered","status":400,"category":"validation","summary":"The OAuth redirect URI is not registered for the app."},{"code":"oauth_authorization_write_failed","status":500,"category":"server","summary":"The server could not persist an OAuth authorization grant."},{"code":"oauth_authorization_code_write_failed","status":500,"category":"server","summary":"The server could not persist an OAuth authorization code."},{"code":"oauth_authorization_code_invalid","status":400,"category":"validation","summary":"The OAuth authorization code is invalid, expired, consumed, or not valid for the client."},{"code":"oauth_authorization_code_consumed","status":400,"category":"conflict","summary":"The OAuth authorization code was already consumed."},{"code":"oauth_refresh_token_invalid","status":400,"category":"validation","summary":"The OAuth refresh token is invalid, expired, consumed, or not valid for the client."},{"code":"oauth_refresh_token_consumed","status":400,"category":"conflict","summary":"The OAuth refresh token was already consumed."},{"code":"oauth_access_token_write_failed","status":500,"category":"server","summary":"The server could not persist a newly issued OAuth access token."},{"code":"oauth_refresh_token_write_failed","status":500,"category":"server","summary":"The server could not persist a newly issued OAuth refresh token."},{"code":"invalid_public_publish_plan_request","status":400,"category":"validation","summary":"The public publish-plan preview request body is invalid."},{"code":"invalid_public_publish_job_request","status":400,"category":"validation","summary":"The public publish-job creation request body is invalid."},{"code":"invalid_public_publish_job_query","status":400,"category":"validation","summary":"The public publish-job query parameters are invalid."},{"code":"public_publish_job_not_found","status":404,"category":"not_found","summary":"The publish job was not found in the principal organization."},{"code":"publish_plan_validation_failed","status":422,"category":"validation","summary":"The publish plan has blocking platform validation issues."},{"code":"publish_job_write_disabled","status":403,"category":"feature_gate","summary":"Publish job persistence is disabled."},{"code":"invalid_public_publish_enqueue_request","status":400,"category":"validation","summary":"The public publish enqueue request is invalid."},{"code":"invalid_public_analytics_snapshot_query","status":400,"category":"validation","summary":"The public analytics snapshot query parameters are invalid."},{"code":"invalid_public_brand_query","status":400,"category":"validation","summary":"The public brand query parameters are invalid."},{"code":"invalid_public_channel_account_query","status":400,"category":"validation","summary":"The public channel account query parameters are invalid."},{"code":"invalid_public_channel_connect_url_request","status":400,"category":"validation","summary":"The public channel OAuth connect URL request is invalid."},{"code":"channel_oauth_config_missing","status":400,"category":"configuration","summary":"The server-side OAuth configuration for the platform is missing."},{"code":"channel_oauth_redirect_uri_forbidden","status":400,"category":"validation","summary":"The requested redirect URI does not match server configuration."},{"code":"channel_oauth_config_invalid","status":400,"category":"configuration","summary":"The server-side OAuth URL configuration is invalid."},{"code":"invalid_public_media_upload_request","status":400,"category":"validation","summary":"The public media upload request body or multipart fields are invalid."},{"code":"invalid_multipart_media_upload","status":400,"category":"validation","summary":"The media upload request is not multipart/form-data."},{"code":"multipart_media_file_required","status":400,"category":"validation","summary":"The multipart media upload did not include a non-empty file."},{"code":"media_file_too_large","status":400,"category":"validation","summary":"The uploaded media exceeds the configured maximum size."},{"code":"media_upload_write_disabled","status":403,"category":"feature_gate","summary":"Media upload persistence is disabled."},{"code":"publish_enqueue_disabled","status":403,"category":"feature_gate","summary":"Publish queue enqueueing is disabled."},{"code":"invalid_public_publish_slot_query","status":400,"category":"validation","summary":"The public publish slot query parameters are invalid."},{"code":"invalid_public_publish_schedule_request","status":400,"category":"validation","summary":"The public publish schedule request is invalid."},{"code":"publish_schedule_write_disabled","status":403,"category":"feature_gate","summary":"Publish schedule writes are disabled."},{"code":"invalid_public_publish_cancel_request","status":400,"category":"validation","summary":"The public publish cancel request is invalid."},{"code":"publish_cancel_write_disabled","status":403,"category":"feature_gate","summary":"Publish cancellation is disabled."},{"code":"invalid_public_publish_url_reconciliation_request","status":400,"category":"validation","summary":"The public publish URL reconciliation request is invalid."},{"code":"invalid_public_comment_reply_draft_request","status":400,"category":"validation","summary":"The public social comment reply draft request is invalid."},{"code":"invalid_public_social_comment_reply_request","status":400,"category":"validation","summary":"The public social comment reply request is invalid."},{"code":"invalid_public_social_comment_reply_query","status":400,"category":"validation","summary":"The public social comment reply query parameters are invalid."},{"code":"provider_comment_reply_disabled","status":403,"category":"feature_gate","summary":"Live provider comment replies are disabled."},{"code":"social_comment_write_disabled","status":403,"category":"feature_gate","summary":"Social comment persistence or external writes are disabled."},{"code":"social_comment_not_found","status":404,"category":"not_found","summary":"The social comment was not found in the principal organization."},{"code":"provider_comment_reply_unsupported","status":422,"category":"validation","summary":"The provider does not support replying to this social comment."},{"code":"publish_url_reconciliation_disabled","status":403,"category":"feature_gate","summary":"Live publish URL reconciliation writes are disabled."},{"code":"invalid_public_webhook_endpoint_query","status":400,"category":"validation","summary":"The public webhook endpoint query parameters are invalid."},{"code":"invalid_public_webhook_endpoint_create_request","status":400,"category":"validation","summary":"The public webhook endpoint creation request body is invalid."},{"code":"invalid_public_webhook_endpoint_update_request","status":400,"category":"validation","summary":"The public webhook endpoint update request body is invalid."},{"code":"invalid_public_webhook_endpoint_delete_request","status":400,"category":"validation","summary":"The public webhook endpoint delete request is invalid."},{"code":"webhook_url_invalid","status":400,"category":"validation","summary":"The webhook endpoint URL is not safe for outbound delivery."},{"code":"webhook_write_disabled","status":403,"category":"feature_gate","summary":"Webhook endpoint persistence is disabled."},{"code":"webhook_endpoint_not_found","status":404,"category":"not_found","summary":"The webhook endpoint was not found in the principal organization."},{"code":"webhook_endpoint_create_failed","status":500,"category":"server","summary":"The server could not persist a created webhook endpoint."},{"code":"invalid_public_automation_source_query","status":400,"category":"validation","summary":"The public automation source query parameters are invalid."},{"code":"invalid_public_automation_source_create_request","status":400,"category":"validation","summary":"The public automation source creation request body is invalid."},{"code":"invalid_public_automation_source_update_request","status":400,"category":"validation","summary":"The public automation source update request is invalid."},{"code":"invalid_public_automation_source_delete_request","status":400,"category":"validation","summary":"The public automation source delete request is invalid."},{"code":"automation_write_disabled","status":403,"category":"feature_gate","summary":"Automation write operations are disabled."},{"code":"automation_source_create_failed","status":500,"category":"server","summary":"The server could not persist a created automation source."},{"code":"automation_source_not_found","status":404,"category":"not_found","summary":"The automation source was not found in the principal organization."},{"code":"invalid_public_automation_run_query","status":400,"category":"validation","summary":"The public automation run query parameters are invalid."},{"code":"invalid_public_automation_run_create_request","status":400,"category":"validation","summary":"The public automation run creation request is invalid."},{"code":"invalid_public_automation_run_record_request","status":400,"category":"validation","summary":"The public automation run status update request is invalid."},{"code":"automation_source_not_runnable","status":404,"category":"not_found","summary":"The automation source was not found, disabled, or deleted in the principal organization."},{"code":"automation_run_not_found","status":404,"category":"not_found","summary":"The automation run was not found in the principal organization."},{"code":"automation_run_invalid_transition","status":409,"category":"conflict","summary":"The automation run cannot move from its current state to the requested state."}]},"x-creavily-dashboard-permission-policies":[{"id":"workspace.brands.initialize","label":"Initialize the first workspace brand","description":"Create the first brand in an authorized workspace without changing existing brands or enabling provider actions.","minimumRole":"admin","servicePrincipalAllowed":false},{"id":"workspace.brands.create","label":"Create workspace brands","description":"Create additional brand context in a workspace without changing existing brands or enabling provider actions.","minimumRole":"admin","servicePrincipalAllowed":false},{"id":"publishing.drafts.manage","label":"Manage private Create drafts","description":"Read, save, and delete the signed-in member's private brand-scoped Create draft.","minimumRole":"member","servicePrincipalAllowed":false},{"id":"developer.api_keys.manage","label":"Manage developer API keys","description":"Create, list, and revoke organization-scoped public API keys.","minimumRole":"admin","servicePrincipalAllowed":false},{"id":"developer.oauth_apps.manage","label":"Manage OAuth apps","description":"Create, list, update, and revoke organization-scoped OAuth developer apps.","minimumRole":"admin","servicePrincipalAllowed":false},{"id":"developer.oauth_grants.manage","label":"Manage OAuth grants","description":"Create, list, exchange, and revoke organization-scoped OAuth authorization grants.","minimumRole":"admin","servicePrincipalAllowed":false},{"id":"developer.oauth_tokens.exchange","label":"Exchange developer OAuth tokens","description":"Use the dashboard-only OAuth token exchange helper for development and support.","minimumRole":"admin","servicePrincipalAllowed":false},{"id":"publishing.jobs.read","label":"Read publish jobs","description":"List organization-scoped publish jobs, queue status, and target status for the dashboard queue view.","minimumRole":"member","servicePrincipalAllowed":false},{"id":"publishing.batches.manage","label":"Manage publish batches","description":"Preview and apply product-diversified batch rebalance operations for dashboard scheduling.","minimumRole":"admin","servicePrincipalAllowed":false},{"id":"publishing.queue.reconcile","label":"Reconcile publish queue","description":"Inspect and optionally remove non-active queued publish jobs for an organization.","minimumRole":"admin","servicePrincipalAllowed":false},{"id":"publishing.urls.reconcile","label":"Reconcile publish URLs","description":"Write provider release URLs back into publish targets after external execution.","minimumRole":"admin","servicePrincipalAllowed":false},{"id":"publishing.results.manage","label":"Manage publish results","description":"Record provider publish attempts and update aggregate publish execution state.","minimumRole":"admin","servicePrincipalAllowed":false},{"id":"analytics.provider_sync.manage","label":"Sync provider analytics","description":"Fetch post status and analytics from connected provider accounts and persist analytics snapshots.","minimumRole":"admin","servicePrincipalAllowed":false},{"id":"engagement.comments.manage","label":"Manage social comments","description":"Fetch provider comments, persist the comment inbox, and publish comment replies from connected provider accounts.","minimumRole":"admin","servicePrincipalAllowed":false},{"id":"webhooks.endpoints.manage","label":"Manage webhook endpoints","description":"Create, list, update, and delete organization-scoped webhook endpoints.","minimumRole":"admin","servicePrincipalAllowed":false},{"id":"webhooks.deliveries.manage","label":"Manage webhook deliveries","description":"Enqueue, inspect, dispatch, and record attempts for webhook deliveries.","minimumRole":"admin","servicePrincipalAllowed":false},{"id":"automations.sources.manage","label":"Manage automation sources","description":"Create, update, delete, and manually run organization-scoped automation sources.","minimumRole":"admin","servicePrincipalAllowed":false},{"id":"automations.scheduler.enqueue","label":"Enqueue automation scheduler","description":"Find due automation sources, create poll runs, and enqueue scheduler work.","minimumRole":"admin","servicePrincipalAllowed":true},{"id":"admin.db.migrate","label":"Run database migrations","description":"List or execute database migrations for the internal Creavily workspace.","minimumRole":"admin","servicePrincipalAllowed":true,"internalOnly":true},{"id":"admin.provider.webhook.provision","label":"Provision provider webhook bindings","description":"Register server-side provider application identities and bind approved webhook callbacks to existing connected accounts.","minimumRole":"admin","servicePrincipalAllowed":true,"internalOnly":true}],"x-creavily-rate-limits":{"defaultRequests":600,"defaultWindowSeconds":60,"overrideEnv":["CREAVILY_PUBLIC_API_RATE_LIMIT_REQUESTS","CREAVILY_PUBLIC_API_RATE_LIMIT_WINDOW_SECONDS","CREAVILY_PUBLIC_API_RATE_LIMIT_DISABLED","CREAVILY_PUBLIC_API_RATE_LIMIT_STORE","REDIS_URL"],"sharedStoreEnv":"CREAVILY_PUBLIC_API_RATE_LIMIT_STORE=redis","negativeCredentialCache":{"ttlSeconds":30,"disableEnv":"CREAVILY_PUBLIC_API_NEGATIVE_CACHE_DISABLED=true"},"responseHeaders":["RateLimit-Limit","RateLimit-Remaining","RateLimit-Reset","Retry-After","X-RateLimit-Limit","X-RateLimit-Remaining","X-RateLimit-Reset"],"remoteMediaImport":{"sharedStoreEnv":"CREAVILY_REMOTE_MEDIA_IMPORT_BUDGET_STORE=redis","productionStore":"redis","defaults":{"ipRequests":30,"ipWindowSeconds":60,"principalRequests":20,"principalWindowSeconds":3600,"organizationBytes":268435456,"organizationWindowSeconds":3600,"globalConcurrency":8,"organizationConcurrency":2,"leaseSeconds":75,"transportTimeoutSeconds":60,"transportRedirects":5,"transportMaxBytes":33554432}}},"tags":[{"name":"System"},{"name":"Auth"},{"name":"OAuth"},{"name":"Brands"},{"name":"Assets"},{"name":"Channels"},{"name":"Media"},{"name":"Agent"},{"name":"Provider Tools"},{"name":"Publishing"},{"name":"Analytics"},{"name":"Webhooks"},{"name":"Automations"}],"components":{"securitySchemes":{"publicBearer":{"type":"http","scheme":"bearer","description":"Use a Creavily API key or OAuth access token. Public endpoints are scoped to the authenticated principal organization."},"dashboardSession":{"type":"http","scheme":"bearer","description":"Temporary legacy Dashboard session Bearer compatibility. New first-party browser clients use the HttpOnly dashboardSessionCookie and must never send a Dashboard bearer through a URL."},"dashboardSessionCookie":{"type":"apiKey","in":"cookie","name":"creavily_dashboard_session","description":"Host-only HttpOnly Dashboard session cookie issued after the one-time browser-session exchange. Browser clients rely on credentialed requests and an approved Origin; JavaScript does not read this value."},"internalServiceToken":{"type":"apiKey","in":"header","name":"x-creavily-internal-token","description":"Internal service credential for non-public operational routes. It is never exposed to browser or third-party clients."},"servicePrincipalToken":{"type":"apiKey","in":"header","name":"x-creavily-service-principal-token","description":"Server-side service-principal credential accepted by policy-gated admin routes. It is never exposed to browser or third-party clients."},"browserSessionExchangeCookie":{"type":"apiKey","in":"cookie","name":"creavily_browser_session_exchange","description":"Short-lived HttpOnly temporary cookie used only with POST /v1/auth/browser-session/exchange. It is cleared after a successful exchange or logout."}},"schemas":{"ErrorResponse":{"type":"object","properties":{"error":{"type":"string","minLength":1},"message":{"type":"string","minLength":1},"fields":{"type":"array","items":{"type":"object","properties":{"path":{"type":"array","items":{"type":"string"}},"source":{"type":"string","enum":["body","query","params"]}},"required":["path"],"additionalProperties":false}},"requestId":{"type":"string","minLength":1}},"required":["error","message"],"additionalProperties":{}},"SystemReadinessComponent":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"],"additionalProperties":{}},"SystemStorageReadiness":{"type":"object","properties":{"configured":{"type":"boolean"}},"required":["configured"],"additionalProperties":{}},"HealthLivenessResponse":{"type":"object","properties":{"ok":{"type":"boolean","const":true},"service":{"type":"string","const":"creavily-api"},"version":{"type":"string"}},"required":["ok","service","version"],"additionalProperties":false},"HealthReadinessResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string","const":"creavily-api"},"version":{"type":"string"},"components":{"type":"object","properties":{"database":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"],"additionalProperties":{}},"redis":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"],"additionalProperties":{}},"worker":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"],"additionalProperties":{}}},"required":["database","redis","worker"],"additionalProperties":false}},"required":["ok","service","version","components"],"additionalProperties":false},"StorageReadinessResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string","const":"creavily-api"},"mediaStorage":{"type":"object","properties":{"configured":{"type":"boolean"}},"required":["configured"],"additionalProperties":{}}},"required":["ok","service","mediaStorage"],"additionalProperties":false},"Principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"MediaInput":{"type":"object","required":["kind","url"],"properties":{"mediaLibraryItemId":{"type":"string"},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string"},"mimeType":{"type":"string"},"bytes":{"type":"number"},"fileSizeBytes":{"type":"number"},"durationSeconds":{"type":"number"},"thumbnailUrl":{"type":"string"},"altText":{"type":"string"},"metadata":{"type":"object","additionalProperties":true}},"additionalProperties":true},"MediaLibraryItem":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"publicUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentAvailable":{"type":"boolean"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"bytes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lifecycleState":{"type":"string","enum":["active","deleting"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["mediaLibraryItemId","organizationId","brandId","kind","mimeType","publicUrl","contentAvailable","sha256","metadata","createdAt","updatedAt"],"additionalProperties":false},"MediaUploadRequest":{"type":"object","required":["dataBase64"],"properties":{"organizationId":{"type":"string"},"brandId":{"type":"string","nullable":true},"fileName":{"type":"string"},"dataBase64":{"type":"string","description":"Raw base64 or data URL. Supported media: JPEG, PNG, GIF, WebP, AVIF, MP4."},"altText":{"type":"string","nullable":true}},"additionalProperties":false},"MediaImportRequest":{"type":"object","required":["url"],"properties":{"organizationId":{"type":"string"},"brandId":{"type":"string","nullable":true},"url":{"type":"string"},"altText":{"type":"string","nullable":true},"dryRun":{"type":"boolean","default":true},"maxBytes":{"type":"integer","minimum":1,"maximum":33554432}},"additionalProperties":false},"ChannelConnectUrlResponse":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"authorizationUrl":{"type":"string","format":"uri"},"redirectUri":{"type":"string","format":"uri"},"state":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["platform","authorizationUrl","redirectUri","state","scopes"],"additionalProperties":false},"ChannelAccountUpsertRequest":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"platformAppId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"externalAccountId":{"type":"string","minLength":1},"displayName":{"type":"string","minLength":1},"handle":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"state":{"default":"connected","type":"string","enum":["not_connected","connecting","in_between_steps","connected","expiring","refresh_needed","reconnect_required","disabled","deleted"]},"tokenExpiresAt":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"accessTokenRef":{"type":"string","minLength":1},"refreshTokenRef":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"scopes":{"default":[],"type":"array","items":{"type":"string","minLength":1}}},"required":["organizationId","platform","externalAccountId","displayName","accessTokenRef"]},"ChannelAccountPatchRequest":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"displayName":{"type":"string","minLength":1},"handle":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"state":{"type":"string","enum":["not_connected","connecting","in_between_steps","connected","expiring","refresh_needed","reconnect_required","disabled","deleted"]},"tokenExpiresAt":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"additionalSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["organizationId"],"anyOf":[{"required":["brandId"]},{"required":["displayName"]},{"required":["handle"]},{"required":["state"]},{"required":["tokenExpiresAt"]},{"required":["additionalSettings"]}]},"ChannelAccountDeleteRequest":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"reason":{"type":"string","minLength":1,"maxLength":500}},"required":["organizationId"]},"PublishingProfileChannelInput":{"type":"object","properties":{"channelAccountId":{"type":"string","minLength":1},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"position":{"type":"integer","minimum":0,"maximum":1000},"enabled":{"type":"boolean"},"settings":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["channelAccountId","platform"]},"PublishingProfileSaveRequest":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"profileId":{"type":"string","minLength":1},"name":{"type":"string","minLength":1,"maxLength":120},"slug":{"type":"string","minLength":1,"maxLength":120},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"isDefault":{"default":false,"type":"boolean"},"scheduleSettings":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"commentSettings":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"channels":{"default":[],"maxItems":100,"type":"array","items":{"type":"object","properties":{"channelAccountId":{"type":"string","minLength":1},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"position":{"type":"integer","minimum":0,"maximum":1000},"enabled":{"type":"boolean"},"settings":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["channelAccountId","platform"]}}},"required":["organizationId","brandId","name"]},"AgentPublishRequest":{"type":"object","required":["plan"],"properties":{"dryRun":{"type":"boolean","default":true},"enqueue":{"type":"boolean","default":false},"title":{"type":"string"},"idempotencyKey":{"type":"string"},"runAfter":{"type":"string","format":"date-time"},"plan":{"type":"object","required":["brandId","text"],"properties":{"brandId":{"type":"string"},"profileId":{"type":"string","description":"Optional publishing profile. When targets are omitted, Creavily expands enabled connected profile channels into publish targets."},"productId":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"$ref":"#/components/schemas/MediaInput"},"default":[]},"mediaLibraryItemIds":{"type":"array","items":{"type":"string"},"default":[]},"targets":{"type":"array","items":{"$ref":"#/components/schemas/PublishTargetInput"},"default":[]},"scheduleAt":{"type":"string","format":"date-time"}},"additionalProperties":false}},"additionalProperties":false},"PublishBatchPreviewRequest":{"type":"object","required":["brandId","items"],"properties":{"brandId":{"type":"string"},"from":{"type":"string","format":"date-time"},"generatedAt":{"type":"string","format":"date-time"},"productLinkComment":{"$ref":"#/components/schemas/ProductLinkCommentPolicy"},"policy":{"type":"object","description":"Optional when the brand's default Brand Profile has saved scheduleSettings.batchPolicy. Provide explicitly to override the saved brand schedule for this batch.","required":["slots"],"properties":{"id":{"type":"string"},"horizonDays":{"type":"integer","minimum":1,"maximum":60,"default":14},"slots":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/PublishBatchScheduleSlot"}}},"additionalProperties":false},"items":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/PublishBatchItem"}},"existingAssignments":{"type":"array","items":{"type":"object","required":["platform","channelAccountId","scheduledAt"],"properties":{"clientAssetId":{"type":"string"},"productId":{"type":"string"},"platform":{"$ref":"#/components/schemas/PublishTargetInput/properties/platform"},"channelAccountId":{"type":"string"},"scheduledAt":{"type":"string","format":"date-time"}},"additionalProperties":false}}},"additionalProperties":false},"ProductLinkCommentPolicy":{"type":"object","properties":{"enabled":{"type":"boolean","default":false},"template":{"type":"string","description":"Template for platform follow-up comment or reply. Supports {{productUrl}}, {{title}}, and {{platform}}."},"delayMs":{"type":"integer","minimum":0,"maximum":86400000,"default":300000},"appendTracking":{"type":"boolean","default":true},"utmMedium":{"type":"string","default":"organic_social"},"utmCampaign":{"type":"string","default":"creavily_publish"}},"additionalProperties":false},"PublishBatchScheduleSlot":{"type":"object","required":["id","localTime"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"timezone":{"type":"string","default":"UTC"},"localTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":1,"maximum":7}},"platform":{"$ref":"#/components/schemas/PublishTargetInput/properties/platform"},"channelAccountId":{"type":"string"},"jitterSecondsMin":{"type":"integer","minimum":-3600,"maximum":3600,"default":-600},"jitterSecondsMax":{"type":"integer","minimum":-3600,"maximum":3600,"default":600},"minGapMinutes":{"type":"integer","minimum":0,"maximum":1440,"default":120},"productCooldownMinutes":{"type":"integer","minimum":0,"maximum":43200,"default":240}},"additionalProperties":false},"PublishBatchItem":{"type":"object","required":["clientAssetId","productId","text","targets"],"properties":{"clientAssetId":{"type":"string"},"productId":{"type":"string"},"productUrl":{"type":"string"},"title":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"$ref":"#/components/schemas/MediaInput"},"default":[]},"mediaLibraryItemIds":{"type":"array","items":{"type":"string"},"default":[]},"targets":{"type":"array","minItems":1,"items":{"$ref":"#/components/schemas/PublishBatchTarget"}},"priority":{"type":"number"},"manualScheduleAt":{"type":"string","format":"date-time"}},"additionalProperties":false},"PublishBatchTarget":{"type":"object","required":["platform","channelAccountId"],"properties":{"platform":{"$ref":"#/components/schemas/PublishTargetInput/properties/platform"},"channelAccountId":{"type":"string"},"providerType":{"type":"string"},"settings":{"type":"object","additionalProperties":true},"firstComment":{"type":"object","required":["content"],"properties":{"content":{"type":"string"},"delayMs":{"type":"integer","minimum":0,"maximum":86400000}},"additionalProperties":false}},"additionalProperties":false},"PublishBatchCommitRequest":{"allOf":[{"$ref":"#/components/schemas/PublishBatchPreviewRequest"},{"type":"object","properties":{"idempotencyKey":{"type":"string"},"source":{"type":"string","default":"agent_batch"},"freezeHorizonMinutes":{"type":"integer","minimum":0,"maximum":43200,"default":120},"dryRun":{"type":"boolean","default":true}},"additionalProperties":true}]},"PublishBatchStatus":{"type":"object","required":["publishBatchId","organizationId","brandId","status","itemCount","targetCount","items"],"properties":{"publishBatchId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"status":{"type":"string","enum":["empty","unscheduled","scheduled","partially_scheduled","processing","published","partially_published","needs_attention","failed"]},"source":{"type":"string"},"idempotencyKey":{"type":"string","nullable":true},"freezeHorizonMinutes":{"type":"integer"},"schedulePolicy":{"type":"object","additionalProperties":true},"preview":{"type":"object","additionalProperties":true},"itemCount":{"type":"integer","minimum":0},"targetCount":{"type":"integer","minimum":0},"publishedTargetCount":{"type":"integer","minimum":0},"failedTargetCount":{"type":"integer","minimum":0},"queuedTargetCount":{"type":"integer","minimum":0},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"items":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":false},"CommentReplyDraftRequest":{"type":"object","required":["platform","commentText"],"properties":{"dryRun":{"type":"boolean","default":true},"brandId":{"type":"string"},"brandName":{"type":"string"},"productName":{"type":"string"},"productUrl":{"type":"string"},"platform":{"$ref":"#/components/schemas/PublishTargetInput/properties/platform"},"postText":{"type":"string"},"commentText":{"type":"string"},"socialContext":{"type":"string"},"tone":{"type":"string","enum":["helpful","friendly","concise","premium","supportive"],"default":"helpful"},"maxCharacters":{"type":"integer","minimum":80,"maximum":2200}},"additionalProperties":false},"CommentReplyDraftResponse":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"draft":{"type":"object","properties":{"reply":{"type":"string"},"prompt":{"type":"object","properties":{"system":{"type":"string"},"user":{"type":"string"}},"required":["system","user"]},"constraints":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"tone":{"type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"maxCharacters":{"type":"integer","minimum":80,"maximum":2200}},"required":["platform","tone","maxCharacters"]}},"required":["reply","prompt","constraints"]},"requiredEnv":{"type":"array","items":{"type":"string"}}},"required":["mode","draft","requiredEnv"]},{"type":"object","properties":{"mode":{"type":"string","const":"drafted"},"draft":{"type":"object","properties":{"reply":{"type":"string"},"prompt":{"type":"object","properties":{"system":{"type":"string"},"user":{"type":"string"}},"required":["system","user"]},"constraints":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"tone":{"type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"maxCharacters":{"type":"integer","minimum":80,"maximum":2200}},"required":["platform","tone","maxCharacters"]}},"required":["reply","prompt","constraints"]}},"required":["mode","draft"]}]},"SocialComment":{"type":"object","properties":{"socialCommentId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"postTargetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelAccountId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"providerPostId":{"type":"string"},"providerCommentId":{"type":"string"},"parentProviderCommentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorName":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"status":{"type":"string","enum":["needs_reply","replied","drafted"]},"replyStatus":{"type":"string","enum":["none","replied","drafted","failed","needs_reconciliation"]},"permalinkUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"metrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"providerCreatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSyncedAt":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["socialCommentId","organizationId","brandId","postTargetId","channelAccountId","platform","providerPostId","providerCommentId","parentProviderCommentId","authorName","authorHandle","body","status","replyStatus","permalinkUrl","metrics","providerCreatedAt","lastSyncedAt","createdAt","updatedAt"]},"SocialCommentSyncRequest":{"type":"object","required":["organizationId","brandId","platform","providerPostId","channelAccountId"],"properties":{"organizationId":{"type":"string"},"brandId":{"type":"string"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]},"providerPostId":{"type":"string"},"postTargetId":{"type":"string","nullable":true},"channelAccountId":{"type":"string"},"limit":{"type":"integer","minimum":1,"maximum":100,"default":50},"since":{"type":"string","format":"date-time"},"dryRun":{"type":"boolean","default":true}},"additionalProperties":false},"SocialCommentProfileSyncRequest":{"type":"object","required":["organizationId","brandId"],"properties":{"organizationId":{"type":"string"},"brandId":{"type":"string"},"profileId":{"type":"string"},"targetLimit":{"type":"integer","minimum":1,"maximum":25,"default":8},"commentsPerPost":{"type":"integer","minimum":1,"maximum":100,"default":50},"dryRun":{"type":"boolean","default":true}},"additionalProperties":false},"SocialCommentReplyRequest":{"type":"object","required":["organizationId","brandId","body"],"properties":{"organizationId":{"type":"string"},"brandId":{"type":"string"},"body":{"type":"string"},"dryRun":{"type":"boolean","default":true}},"additionalProperties":false},"PublishBatchPreview":{"type":"object","required":["mode","batchPreviewId","organizationId","brandId","assignmentCount","scheduledItemCount","unscheduledItemCount","assignments","warnings"],"properties":{"mode":{"type":"string","enum":["preview"]},"batchPreviewId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"},"from":{"type":"string","format":"date-time"},"policy":{"type":"object","additionalProperties":true},"assignmentCount":{"type":"integer","minimum":0},"scheduledItemCount":{"type":"integer","minimum":0},"unscheduledItemCount":{"type":"integer","minimum":0},"assignments":{"type":"array","items":{"type":"object","additionalProperties":true}},"warnings":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":false},"GoogleCallbackRequest":{"type":"object","required":["code","state"],"properties":{"code":{"type":"string"},"state":{"type":"string"}},"additionalProperties":false},"BrowserSessionStartRequest":{"type":"object","required":["email","password"],"properties":{"email":{"type":"string","format":"email"},"password":{"type":"string","format":"password"}},"additionalProperties":false},"BrowserSessionExchangeRequest":{"type":"object","required":["authorizationCode","nonce"],"properties":{"authorizationCode":{"type":"string","description":"Short-lived, single-use browser authorization code. Do not place this value in a long-lived URL, log, or analytics event."},"nonce":{"type":"string","description":"Short-lived nonce bound to the authorization code, temporary browser cookie, and allowed return origin."}},"additionalProperties":false},"PublishTargetInput":{"type":"object","required":["platform","channelAccountId"],"properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string"},"text":{"type":"string","description":"Optional target body override. Omit to inherit plan.text; an empty string remains empty."},"settings":{"type":"object","additionalProperties":true}},"additionalProperties":false},"PublishSlot":{"type":"object","required":["mode","organizationId","recommendation","checkedSlotCount","policy"],"properties":{"mode":{"type":"string","enum":["preview"]},"organizationId":{"type":"string"},"recommendation":{"type":"object","nullable":true,"properties":{"scheduleAt":{"type":"string","format":"date-time"}},"additionalProperties":false},"checkedSlotCount":{"type":"integer","minimum":0},"policy":{"type":"object","additionalProperties":true},"candidates":{"type":"array","items":{"type":"object","additionalProperties":true}},"conflicts":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":false},"PublicPublishPlanInput":{"type":"object","required":["brandId","text","media","targets"],"properties":{"brandId":{"type":"string"},"productId":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"$ref":"#/components/schemas/MediaInput"}},"targets":{"type":"array","items":{"$ref":"#/components/schemas/PublishTargetInput"}}},"additionalProperties":false},"ProviderAnalyticsSyncRequest":{"type":"object","required":["organizationId","brandId","platform","providerPostId","channelAccountId"],"properties":{"organizationId":{"type":"string"},"brandId":{"type":"string"},"platform":{"type":"string","enum":["x","youtube","facebook_page","pinterest"]},"providerPostId":{"type":"string"},"postTargetId":{"type":"string","nullable":true},"channelAccountId":{"type":"string"},"capturedAt":{"type":"string","format":"date-time","nullable":true},"dryRun":{"type":"boolean","default":true}},"additionalProperties":false},"ProviderSettingRule":{"type":"object","properties":{"field":{"type":"string"},"label":{"type":"string"},"valueType":{"type":"string","enum":["string","boolean","number"]},"required":{"type":"boolean"},"allowedValues":{"type":"array","items":{"type":"string"}}},"required":["field","label","valueType","required"],"additionalProperties":false},"ProviderMediaRule":{"type":"object","properties":{"allowedKinds":{"type":"array","items":{"type":"string","enum":["image","video","gif"]}},"minItems":{"type":"integer","minimum":0,"maximum":9007199254740991},"maxItems":{"type":"integer","minimum":1,"maximum":9007199254740991},"maxImageBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"maxVideoBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"maxGifBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"minVideoDurationSeconds":{"type":"number","minimum":0},"maxVideoDurationSeconds":{"type":"number","minimum":0},"dynamicMaxVideoDurationSetting":{"type":"string"},"requiresVideoThumbnail":{"type":"boolean"},"notes":{"type":"array","items":{"type":"string"}}},"required":["allowedKinds","minItems","maxItems","notes"],"additionalProperties":false},"ProviderCapability":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"displayName":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"}},"maxTextLength":{"type":"integer","minimum":0,"maximum":9007199254740991},"mediaRule":{"type":"object","properties":{"allowedKinds":{"type":"array","items":{"type":"string","enum":["image","video","gif"]}},"minItems":{"type":"integer","minimum":0,"maximum":9007199254740991},"maxItems":{"type":"integer","minimum":1,"maximum":9007199254740991},"maxImageBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"maxVideoBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"maxGifBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"minVideoDurationSeconds":{"type":"number","minimum":0},"maxVideoDurationSeconds":{"type":"number","minimum":0},"dynamicMaxVideoDurationSetting":{"type":"string"},"requiresVideoThumbnail":{"type":"boolean"},"notes":{"type":"array","items":{"type":"string"}}},"required":["allowedKinds","minItems","maxItems","notes"],"additionalProperties":false},"supportsScheduling":{"type":"boolean"},"supportsComments":{"type":"boolean"},"supportsAnalytics":{"type":"boolean"},"supportsDelete":{"type":"boolean"},"supportsUpdate":{"type":"boolean"},"settingsFields":{"type":"array","items":{"type":"string"}},"settingRules":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"label":{"type":"string"},"valueType":{"type":"string","enum":["string","boolean","number"]},"required":{"type":"boolean"},"allowedValues":{"type":"array","items":{"type":"string"}}},"required":["field","label","valueType","required"],"additionalProperties":false}},"toolNames":{"type":"array","items":{"type":"string","enum":["mentionSearch","pageProfile","channelCategories","boardList","privacyOptions","communitySearch"]}},"plugNames":{"type":"array","items":{"type":"string","enum":["firstComment","reply"]}},"rateLimitPolicy":{"type":"string","enum":["low_concurrency","standard","strict"]}},"required":["platform","displayName","requiredScopes","mediaRule","supportsScheduling","supportsComments","supportsAnalytics","supportsDelete","supportsUpdate","settingsFields","toolNames","plugNames","rateLimitPolicy"],"additionalProperties":false},"ProviderToolDefinition":{"type":"object","properties":{"name":{"type":"string","enum":["mentionSearch","pageProfile","channelCategories","boardList","privacyOptions","communitySearch"]},"label":{"type":"string"},"category":{"type":"string","enum":["account_lookup","composer_lookup","publishing_option"]},"description":{"type":"string"},"platforms":{"type":"array","items":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},"inputFields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"label":{"type":"string"},"valueType":{"type":"string","enum":["string","boolean","number"]},"required":{"type":"boolean"},"allowedValues":{"type":"array","items":{"type":"string"}}},"required":["field","label","valueType","required"],"additionalProperties":false}},"outputKind":{"type":"string","enum":["account_reference","profile","category","board","privacy_option","community"]}},"required":["name","label","category","description","platforms","inputFields","outputKind"],"additionalProperties":false},"ProviderPlugDefinition":{"type":"object","properties":{"name":{"type":"string","enum":["firstComment","reply"]},"label":{"type":"string"},"phase":{"type":"string","enum":["post_publish","threading"]},"description":{"type":"string"},"platforms":{"type":"array","items":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},"settingRules":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"label":{"type":"string"},"valueType":{"type":"string","enum":["string","boolean","number"]},"required":{"type":"boolean"},"allowedValues":{"type":"array","items":{"type":"string"}}},"required":["field","label","valueType","required"],"additionalProperties":false}}},"required":["name","label","phase","description","platforms","settingRules"],"additionalProperties":false},"ProviderCapabilitiesResponse":{"type":"object","properties":{"providers":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"displayName":{"type":"string"},"requiredScopes":{"type":"array","items":{"type":"string"}},"maxTextLength":{"type":"integer","minimum":0,"maximum":9007199254740991},"mediaRule":{"type":"object","properties":{"allowedKinds":{"type":"array","items":{"type":"string","enum":["image","video","gif"]}},"minItems":{"type":"integer","minimum":0,"maximum":9007199254740991},"maxItems":{"type":"integer","minimum":1,"maximum":9007199254740991},"maxImageBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"maxVideoBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"maxGifBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"minVideoDurationSeconds":{"type":"number","minimum":0},"maxVideoDurationSeconds":{"type":"number","minimum":0},"dynamicMaxVideoDurationSetting":{"type":"string"},"requiresVideoThumbnail":{"type":"boolean"},"notes":{"type":"array","items":{"type":"string"}}},"required":["allowedKinds","minItems","maxItems","notes"],"additionalProperties":false},"supportsScheduling":{"type":"boolean"},"supportsComments":{"type":"boolean"},"supportsAnalytics":{"type":"boolean"},"supportsDelete":{"type":"boolean"},"supportsUpdate":{"type":"boolean"},"settingsFields":{"type":"array","items":{"type":"string"}},"settingRules":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"label":{"type":"string"},"valueType":{"type":"string","enum":["string","boolean","number"]},"required":{"type":"boolean"},"allowedValues":{"type":"array","items":{"type":"string"}}},"required":["field","label","valueType","required"],"additionalProperties":false}},"toolNames":{"type":"array","items":{"type":"string","enum":["mentionSearch","pageProfile","channelCategories","boardList","privacyOptions","communitySearch"]}},"plugNames":{"type":"array","items":{"type":"string","enum":["firstComment","reply"]}},"rateLimitPolicy":{"type":"string","enum":["low_concurrency","standard","strict"]}},"required":["platform","displayName","requiredScopes","mediaRule","supportsScheduling","supportsComments","supportsAnalytics","supportsDelete","supportsUpdate","settingsFields","toolNames","plugNames","rateLimitPolicy"],"additionalProperties":false}},"tools":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","enum":["mentionSearch","pageProfile","channelCategories","boardList","privacyOptions","communitySearch"]},"label":{"type":"string"},"category":{"type":"string","enum":["account_lookup","composer_lookup","publishing_option"]},"description":{"type":"string"},"platforms":{"type":"array","items":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},"inputFields":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"label":{"type":"string"},"valueType":{"type":"string","enum":["string","boolean","number"]},"required":{"type":"boolean"},"allowedValues":{"type":"array","items":{"type":"string"}}},"required":["field","label","valueType","required"],"additionalProperties":false}},"outputKind":{"type":"string","enum":["account_reference","profile","category","board","privacy_option","community"]}},"required":["name","label","category","description","platforms","inputFields","outputKind"],"additionalProperties":false}},"plugs":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","enum":["firstComment","reply"]},"label":{"type":"string"},"phase":{"type":"string","enum":["post_publish","threading"]},"description":{"type":"string"},"platforms":{"type":"array","items":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},"settingRules":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"label":{"type":"string"},"valueType":{"type":"string","enum":["string","boolean","number"]},"required":{"type":"boolean"},"allowedValues":{"type":"array","items":{"type":"string"}}},"required":["field","label","valueType","required"],"additionalProperties":false}}},"required":["name","label","phase","description","platforms","settingRules"],"additionalProperties":false}}},"required":["providers","tools","plugs"],"additionalProperties":false},"BrandProduct":{"type":"object","properties":{"productId":{"type":"string"},"brandId":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"productUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"shopifyProductId":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["productId","brandId","name","slug","productUrl","shopifyProductId","createdAt","updatedAt"],"additionalProperties":false},"Brand":{"type":"object","properties":{"brandId":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"timezone":{"type":"string"},"productCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"products":{"type":"array","items":{"type":"object","properties":{"productId":{"type":"string"},"brandId":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"productUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"shopifyProductId":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["productId","brandId","name","slug","productUrl","shopifyProductId","createdAt","updatedAt"],"additionalProperties":false}}},"required":["brandId","organizationId","name","slug","timezone","productCount","createdAt","updatedAt"],"additionalProperties":false},"ChannelAccount":{"type":"object","properties":{"channelAccountId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandName":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"platformAppId":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"externalAccountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"state":{"type":"string","enum":["not_connected","connecting","in_between_steps","connected","expiring","refresh_needed","reconnect_required","disabled","deleted"]},"tokenExpiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"disconnectSummary":{"type":"object","properties":{"alreadyDisconnected":{"type":"boolean"},"revokedChannelTokenCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"revokedProviderTokenSecretCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"cancelledPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsReconnectPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsAttentionPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"cancelledBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsReconnectBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsAttentionBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"disabledPublishingProfileChannelCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["alreadyDisconnected","revokedChannelTokenCount","revokedProviderTokenSecretCount","cancelledPostTargetCount","needsReconnectPostTargetCount","needsAttentionPostTargetCount","cancelledBatchTargetCount","needsReconnectBatchTargetCount","needsAttentionBatchTargetCount","disabledPublishingProfileChannelCount"],"additionalProperties":false},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["channelAccountId","organizationId","brandId","brandName","brandSlug","platformAppId","platform","externalAccountId","displayName","handle","state","tokenExpiresAt","createdAt","updatedAt"],"additionalProperties":false},"PublishingProfileChannel":{"type":"object","properties":{"profileChannelId":{"type":"string"},"profileId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"channelAccountId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelDisplayName":{"type":"string"},"channelHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelState":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"enabled":{"type":"boolean"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["profileChannelId","profileId","organizationId","brandId","channelAccountId","platform","channelDisplayName","channelHandle","channelState","position","enabled","settings","createdAt","updatedAt"],"additionalProperties":false},"PublishingProfile":{"type":"object","properties":{"profileId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"brandName":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"slug":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"isDefault":{"type":"boolean"},"scheduleSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"commentSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"channels":{"type":"array","items":{"type":"object","properties":{"profileChannelId":{"type":"string"},"profileId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"channelAccountId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelDisplayName":{"type":"string"},"channelHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelState":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"enabled":{"type":"boolean"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["profileChannelId","profileId","organizationId","brandId","channelAccountId","platform","channelDisplayName","channelHandle","channelState","position","enabled","settings","createdAt","updatedAt"],"additionalProperties":false}}},"required":["profileId","organizationId","brandId","brandName","brandSlug","name","slug","description","isDefault","scheduleSettings","commentSettings","createdAt","updatedAt","channels"],"additionalProperties":false},"AnalyticsSnapshot":{"type":"object","properties":{"analyticsSnapshotId":{"type":"string"},"organizationId":{"type":"string"},"postTargetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelAccountId":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"metrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"capturedAt":{"type":"string"}},"required":["analyticsSnapshotId","organizationId","postTargetId","channelAccountId","platform","metrics","capturedAt"],"additionalProperties":false},"PublishTargetStatus":{"type":"object","required":["postTargetId","channelAccountId","channelDisplayName","platform","status","createdAt","updatedAt"],"properties":{"postTargetId":{"type":"string"},"channelAccountId":{"type":"string"},"text":{"type":"string","description":"Effective body sent to this target."},"firstComment":{"type":"object","description":"Planned first comment, not a delivery receipt.","required":["content"],"properties":{"content":{"type":"string"},"delayMs":{"type":"integer","minimum":0,"maximum":86400000}},"additionalProperties":false},"channelDisplayName":{"type":"string"},"channelHandle":{"type":"string","nullable":true},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"status":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"providerPostId":{"type":"string","nullable":true},"releaseId":{"type":"string","nullable":true},"releaseUrl":{"type":"string","nullable":true},"lastErrorCode":{"type":"string","nullable":true},"lastErrorMessage":{"type":"string","nullable":true},"publishedAt":{"type":"string","format":"date-time","nullable":true},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"additionalProperties":false},"PublishJob":{"type":"object","required":["organizationId","publishJobId","postGroupId","postEntryId","bodyExcerpt","creationMethod","brandId","brandName","brandSlug","status","targetCount","publishedTargetCount","failedTargetCount","createdAt","updatedAt"],"properties":{"organizationId":{"type":"string"},"publishJobId":{"type":"string"},"postGroupId":{"type":"string"},"postEntryId":{"type":"string"},"title":{"type":"string","nullable":true},"bodyExcerpt":{"type":"string"},"creationMethod":{"type":"string"},"brandId":{"type":"string"},"brandName":{"type":"string"},"brandSlug":{"type":"string"},"productId":{"type":"string","nullable":true},"productName":{"type":"string","nullable":true},"productSlug":{"type":"string","nullable":true},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]},"runAfter":{"type":"string","format":"date-time","nullable":true},"scheduleAt":{"type":"string","format":"date-time","nullable":true},"targetCount":{"type":"integer"},"publishedTargetCount":{"type":"integer"},"failedTargetCount":{"type":"integer"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"targets":{"type":"array","items":{"$ref":"#/components/schemas/PublishTargetStatus"}}},"additionalProperties":false},"AutomationSource":{"type":"object","properties":{"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["rss","asset_manager","agent"]},"name":{"type":"string"},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["automationSourceId","organizationId","brandId","type","name","config","state","enabled","createdAt","updatedAt","deletedAt"],"additionalProperties":false},"AutomationRun":{"type":"object","properties":{"automationRunId":{"type":"string"},"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","failed","cancelled"]},"trigger":{"type":"string","enum":["manual","schedule","source_poll","webhook","agent"]},"input":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"output":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["automationRunId","automationSourceId","organizationId","status","trigger","input","output","errorCode","errorMessage","idempotencyKey","startedAt","completedAt","createdAt","updatedAt"],"additionalProperties":false},"WebhookEndpoint":{"type":"object","properties":{"webhookEndpointId":{"type":"string"},"organizationId":{"type":"string"},"url":{"type":"string"},"secretRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"events":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["webhookEndpointId","organizationId","url","secretRef","events","enabled","createdAt","updatedAt","deletedAt"],"additionalProperties":false},"OAuthAuthorizeRequest":{"type":"object","required":["response_type","client_id","redirect_uri"],"properties":{"response_type":{"type":"string","const":"code"},"client_id":{"type":"string"},"redirect_uri":{"type":"string"},"scope":{"type":"string","description":"Space-delimited Creavily public API scopes.","default":"assets:read"},"state":{"type":"string"}},"additionalProperties":false}},"responses":{"BadRequest":{"description":"Invalid request or missing runtime configuration.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Unauthorized":{"description":"Missing or invalid bearer credentials.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Forbidden":{"description":"Feature gate disabled or token missing required scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"NotFound":{"description":"Requested public API resource was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Conflict":{"description":"The request conflicts with current resource state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"UnprocessableEntity":{"description":"The request is valid JSON but violates publish validation rules.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"ServerError":{"description":"The server failed while handling the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"TooManyRequests":{"description":"Public API rate limit exceeded.","headers":{"RateLimit-Limit":{"description":"Configured request limit for the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/v1/public/publishing-profiles/{profileId}/comment-automation":{"get":{"tags":["Engagement","Agent"],"operationId":"publicGetCommentReplyAutomationPolicy","summary":"Read automatic reply settings for a Publishing Setup.","security":[{"publicBearer":[]}],"parameters":[{"name":"profileId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"brandId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Tenant-scoped result.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"policy":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileName":{"type":"string"},"settings":{"type":"object","properties":{"enabled":{"default":false,"type":"boolean"},"mode":{"default":"review","type":"string","enum":["automatic","review"]},"platforms":{"default":["facebook_page","instagram_business","instagram_standalone","threads"],"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]}},"tone":{"default":"friendly","type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"guidance":{"default":"","type":"string","maxLength":4000},"maxCharacters":{"default":500,"type":"integer","minimum":80,"maximum":2200},"hourlyLimit":{"default":20,"type":"integer","minimum":1,"maximum":100},"dailyLimit":{"default":100,"type":"integer","minimum":1,"maximum":1000},"maxCommentAgeHours":{"default":168,"type":"integer","minimum":1,"maximum":720},"replyDelayMs":{"default":60000,"type":"integer","minimum":0,"maximum":86400000},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"enabledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["version","enabledAt"],"additionalProperties":false}},"required":["organizationId","brandId","profileId","profileName","settings"],"additionalProperties":false},"capability":{"type":"object","properties":{"eligible":{"type":"boolean"},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"generationRemaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"sendAttemptRemaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"resetsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["eligible","reasonCode","generationRemaining","sendAttemptRemaining","resetsAt"],"additionalProperties":false}},"required":["principal","policy"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"description":"The record version, lease or reply eligibility changed."},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"description":"Durable comment automation is unavailable."}},"x-required-scopes":["analytics:read"]},"put":{"tags":["Engagement","Agent"],"operationId":"publicSaveCommentReplyAutomationPolicy","summary":"Preview or save automatic reply settings with an expected version.","security":[{"publicBearer":[]}],"parameters":[{"name":"profileId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"description":"Writes default to dryRun=true. Read the current record and expectedVersion first; dryRun=false explicitly commits. X AI replies require prior written approval. Provider sends run in the background.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"settings":{"type":"object","properties":{"enabled":{"default":false,"type":"boolean"},"mode":{"default":"review","type":"string","enum":["automatic","review"]},"platforms":{"default":["facebook_page","instagram_business","instagram_standalone","threads"],"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]}},"tone":{"default":"friendly","type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"guidance":{"default":"","type":"string","maxLength":4000},"maxCharacters":{"default":500,"type":"integer","minimum":80,"maximum":2200},"hourlyLimit":{"default":20,"type":"integer","minimum":1,"maximum":100},"dailyLimit":{"default":100,"type":"integer","minimum":1,"maximum":1000},"maxCommentAgeHours":{"default":168,"type":"integer","minimum":1,"maximum":720},"replyDelayMs":{"default":60000,"type":"integer","minimum":0,"maximum":86400000}},"additionalProperties":false},"dryRun":{"default":true,"type":"boolean"}},"required":["brandId","expectedVersion","settings"],"additionalProperties":false}}}},"x-creavily-gates":["CREAVILY_ALLOW_SOCIAL_COMMENT_WRITE"],"responses":{"200":{"description":"Tenant-scoped result.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"result":{"oneOf":[{"type":"object","properties":{"dryRun":{"type":"boolean","const":true},"preview":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileName":{"type":"string"},"settings":{"type":"object","properties":{"enabled":{"default":false,"type":"boolean"},"mode":{"default":"review","type":"string","enum":["automatic","review"]},"platforms":{"default":["facebook_page","instagram_business","instagram_standalone","threads"],"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]}},"tone":{"default":"friendly","type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"guidance":{"default":"","type":"string","maxLength":4000},"maxCharacters":{"default":500,"type":"integer","minimum":80,"maximum":2200},"hourlyLimit":{"default":20,"type":"integer","minimum":1,"maximum":100},"dailyLimit":{"default":100,"type":"integer","minimum":1,"maximum":1000},"maxCommentAgeHours":{"default":168,"type":"integer","minimum":1,"maximum":720},"replyDelayMs":{"default":60000,"type":"integer","minimum":0,"maximum":86400000},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"enabledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["version","enabledAt"],"additionalProperties":false}},"required":["organizationId","brandId","profileId","profileName","settings"],"additionalProperties":false}},"required":["dryRun","preview"],"additionalProperties":false},{"type":"object","properties":{"dryRun":{"type":"boolean","const":false},"policy":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileName":{"type":"string"},"settings":{"type":"object","properties":{"enabled":{"default":false,"type":"boolean"},"mode":{"default":"review","type":"string","enum":["automatic","review"]},"platforms":{"default":["facebook_page","instagram_business","instagram_standalone","threads"],"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]}},"tone":{"default":"friendly","type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"guidance":{"default":"","type":"string","maxLength":4000},"maxCharacters":{"default":500,"type":"integer","minimum":80,"maximum":2200},"hourlyLimit":{"default":20,"type":"integer","minimum":1,"maximum":100},"dailyLimit":{"default":100,"type":"integer","minimum":1,"maximum":1000},"maxCommentAgeHours":{"default":168,"type":"integer","minimum":1,"maximum":720},"replyDelayMs":{"default":60000,"type":"integer","minimum":0,"maximum":86400000},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"enabledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["version","enabledAt"],"additionalProperties":false}},"required":["organizationId","brandId","profileId","profileName","settings"],"additionalProperties":false}},"required":["dryRun","policy"],"additionalProperties":false}]}},"required":["principal","result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"description":"The record version, lease or reply eligibility changed."},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"description":"Durable comment automation is unavailable."}},"x-required-scopes":["analytics:read","publishing:write"],"x-scope-modes":[{"when":"body.dryRun=true","scopes":["analytics:read"]},{"when":"body.dryRun!=true","scopes":["publishing:write"]}],"x-dry-run-default":true}},"/v1/public/publishing-profiles/{profileId}/comment-automation/sync-comments":{"post":{"tags":["Engagement","Agent"],"operationId":"publicSyncCommentReplyAutomationComments","summary":"Preview or fetch a bounded number of comment pages; continue persisted cursors.","security":[{"publicBearer":[]}],"parameters":[{"name":"profileId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"description":"Writes default to dryRun=true. Read the current record and expectedVersion first; dryRun=false explicitly commits. X AI replies require prior written approval. Provider sends run in the background.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"targetLimit":{"default":10,"type":"integer","minimum":1,"maximum":25},"maxPages":{"default":2,"type":"integer","minimum":1,"maximum":5},"commentsPerPage":{"default":25,"type":"integer","minimum":10,"maximum":100},"dryRun":{"default":true,"type":"boolean"}},"required":["brandId"],"additionalProperties":false}}}},"x-creavily-gates":["CREAVILY_ALLOW_SOCIAL_COMMENT_WRITE","CREAVILY_ALLOW_PROVIDER_COMMENT_SYNC"],"responses":{"200":{"description":"Tenant-scoped result.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"result":{"oneOf":[{"type":"object","properties":{"dryRun":{"type":"boolean","const":true},"preview":{"type":"object","properties":{"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"targetLimit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maxPages":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"commentsPerPage":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["profileId","targetLimit","maxPages","commentsPerPage"],"additionalProperties":false}},"required":["dryRun","preview"],"additionalProperties":false},{"type":"object","properties":{"dryRun":{"type":"boolean","const":false},"sync":{"type":"object","properties":{"targetsVisited":{"type":"integer","minimum":0,"maximum":9007199254740991},"commentsSynced":{"type":"integer","minimum":0,"maximum":9007199254740991},"pagesFetched":{"type":"integer","minimum":0,"maximum":9007199254740991},"hasMore":{"type":"boolean"},"failures":{"type":"array","items":{"type":"object","properties":{"postTargetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"errorCode":{"type":"string"},"retryAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["postTargetId","errorCode"],"additionalProperties":false}}},"required":["targetsVisited","commentsSynced","pagesFetched","hasMore","failures"],"additionalProperties":false}},"required":["dryRun","sync"],"additionalProperties":false}]}},"required":["principal","result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"description":"The record version, lease or reply eligibility changed."},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"description":"Durable comment automation is unavailable."}},"x-required-scopes":["analytics:read","publishing:write"],"x-scope-modes":[{"when":"body.dryRun=true","scopes":["analytics:read"]},{"when":"body.dryRun!=true","scopes":["publishing:write"]}],"x-dry-run-default":true}},"/v1/public/social-comment-automation/jobs":{"get":{"tags":["Engagement","Agent"],"operationId":"publicListCommentReplyAutomationJobs","summary":"List automatic reply decisions, drafts and provider receipts.","security":[{"publicBearer":[]}],"parameters":[{"name":"brandId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"profileId","in":"query","required":false,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["pending","processing","ready","needs_review","sent","ignored","failed","needs_reconciliation","cancelled"]}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Tenant-scoped result.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"jobs":{"type":"array","items":{"type":"object","properties":{"automationJobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]},"policyVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","processing","ready","needs_review","sent","ignored","failed","needs_reconciliation","cancelled"]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"nextAttemptAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["automationJobId","organizationId","brandId","profileId","socialCommentId","channelAccountId","platform","policyVersion","status","body","reasonCode","errorCode","attemptCount","nextAttemptAt","providerReplyId","approvedAt","version","createdAt","updatedAt"],"additionalProperties":false}}},"required":["principal","jobs"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"description":"The record version, lease or reply eligibility changed."},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"description":"Durable comment automation is unavailable."}},"x-required-scopes":["analytics:read"]}},"/v1/public/social-comment-automation/jobs/{jobId}":{"get":{"tags":["Engagement","Agent"],"operationId":"publicGetCommentReplyAutomationJob","summary":"Read one automatic reply job.","security":[{"publicBearer":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"brandId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Tenant-scoped result.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"job":{"type":"object","properties":{"automationJobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]},"policyVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","processing","ready","needs_review","sent","ignored","failed","needs_reconciliation","cancelled"]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"nextAttemptAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["automationJobId","organizationId","brandId","profileId","socialCommentId","channelAccountId","platform","policyVersion","status","body","reasonCode","errorCode","attemptCount","nextAttemptAt","providerReplyId","approvedAt","version","createdAt","updatedAt"],"additionalProperties":false}},"required":["principal","job"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"description":"The record version, lease or reply eligibility changed."},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"description":"Durable comment automation is unavailable."}},"x-required-scopes":["analytics:read"]}},"/v1/public/social-comment-automation/jobs/{jobId}/approve":{"post":{"tags":["Engagement","Agent"],"operationId":"publicApproveCommentReplyAutomationJob","summary":"Preview or approve a stored draft for the background reply worker.","security":[{"publicBearer":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"description":"Writes default to dryRun=true. Read the current record and expectedVersion first; dryRun=false explicitly commits. X AI replies require prior written approval. Provider sends run in the background.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"body":{"type":"string","minLength":1,"maxLength":2200},"dryRun":{"default":true,"type":"boolean"}},"required":["brandId","expectedVersion"],"additionalProperties":false}}}},"x-creavily-gates":["CREAVILY_ALLOW_SOCIAL_COMMENT_WRITE","CREAVILY_ALLOW_PROVIDER_COMMENT_REPLY"],"responses":{"200":{"description":"Tenant-scoped result.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"result":{"oneOf":[{"type":"object","properties":{"dryRun":{"type":"boolean","const":true},"preview":{"type":"object","properties":{"action":{"type":"string","enum":["approve","cancel"]},"job":{"type":"object","properties":{"automationJobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]},"policyVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","processing","ready","needs_review","sent","ignored","failed","needs_reconciliation","cancelled"]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"nextAttemptAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["automationJobId","organizationId","brandId","profileId","socialCommentId","channelAccountId","platform","policyVersion","status","body","reasonCode","errorCode","attemptCount","nextAttemptAt","providerReplyId","approvedAt","version","createdAt","updatedAt"],"additionalProperties":false},"body":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["action","job","body"],"additionalProperties":false}},"required":["dryRun","preview"],"additionalProperties":false},{"type":"object","properties":{"dryRun":{"type":"boolean","const":false},"job":{"type":"object","properties":{"automationJobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]},"policyVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","processing","ready","needs_review","sent","ignored","failed","needs_reconciliation","cancelled"]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"nextAttemptAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["automationJobId","organizationId","brandId","profileId","socialCommentId","channelAccountId","platform","policyVersion","status","body","reasonCode","errorCode","attemptCount","nextAttemptAt","providerReplyId","approvedAt","version","createdAt","updatedAt"],"additionalProperties":false}},"required":["dryRun","job"],"additionalProperties":false}]}},"required":["principal","result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"description":"The record version, lease or reply eligibility changed."},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"description":"Durable comment automation is unavailable."}},"x-required-scopes":["analytics:read","publishing:write"],"x-scope-modes":[{"when":"body.dryRun=true","scopes":["analytics:read"]},{"when":"body.dryRun!=true","scopes":["publishing:write"]}],"x-dry-run-default":true}},"/v1/public/social-comment-automation/jobs/{jobId}/cancel":{"post":{"tags":["Engagement","Agent"],"operationId":"publicCancelCommentReplyAutomationJob","summary":"Preview or cancel a reply which has not started sending.","security":[{"publicBearer":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"description":"Writes default to dryRun=true. Read the current record and expectedVersion first; dryRun=false explicitly commits. X AI replies require prior written approval. Provider sends run in the background.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"dryRun":{"default":true,"type":"boolean"}},"required":["brandId","expectedVersion"],"additionalProperties":false}}}},"x-creavily-gates":["CREAVILY_ALLOW_SOCIAL_COMMENT_WRITE"],"responses":{"200":{"description":"Tenant-scoped result.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"result":{"oneOf":[{"type":"object","properties":{"dryRun":{"type":"boolean","const":true},"preview":{"type":"object","properties":{"action":{"type":"string","enum":["approve","cancel"]},"job":{"type":"object","properties":{"automationJobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]},"policyVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","processing","ready","needs_review","sent","ignored","failed","needs_reconciliation","cancelled"]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"nextAttemptAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["automationJobId","organizationId","brandId","profileId","socialCommentId","channelAccountId","platform","policyVersion","status","body","reasonCode","errorCode","attemptCount","nextAttemptAt","providerReplyId","approvedAt","version","createdAt","updatedAt"],"additionalProperties":false},"body":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["action","job","body"],"additionalProperties":false}},"required":["dryRun","preview"],"additionalProperties":false},{"type":"object","properties":{"dryRun":{"type":"boolean","const":false},"job":{"type":"object","properties":{"automationJobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]},"policyVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","processing","ready","needs_review","sent","ignored","failed","needs_reconciliation","cancelled"]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"nextAttemptAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["automationJobId","organizationId","brandId","profileId","socialCommentId","channelAccountId","platform","policyVersion","status","body","reasonCode","errorCode","attemptCount","nextAttemptAt","providerReplyId","approvedAt","version","createdAt","updatedAt"],"additionalProperties":false}},"required":["dryRun","job"],"additionalProperties":false}]}},"required":["principal","result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"description":"The record version, lease or reply eligibility changed."},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"description":"Durable comment automation is unavailable."}},"x-required-scopes":["analytics:read","publishing:write"],"x-scope-modes":[{"when":"body.dryRun=true","scopes":["analytics:read"]},{"when":"body.dryRun!=true","scopes":["publishing:write"]}],"x-dry-run-default":true}},"/v1/publishing-profiles/{profileId}/comment-automation":{"get":{"tags":["Engagement"],"operationId":"dashboardGetCommentReplyAutomationPolicy","summary":"Read automatic reply settings for a Publishing Setup.","security":[{"dashboardSessionCookie":[]},{"dashboardSession":[]}],"parameters":[{"name":"profileId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"brandId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Tenant-scoped result.","content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"policy":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileName":{"type":"string"},"settings":{"type":"object","properties":{"enabled":{"default":false,"type":"boolean"},"mode":{"default":"review","type":"string","enum":["automatic","review"]},"platforms":{"default":["facebook_page","instagram_business","instagram_standalone","threads"],"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]}},"tone":{"default":"friendly","type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"guidance":{"default":"","type":"string","maxLength":4000},"maxCharacters":{"default":500,"type":"integer","minimum":80,"maximum":2200},"hourlyLimit":{"default":20,"type":"integer","minimum":1,"maximum":100},"dailyLimit":{"default":100,"type":"integer","minimum":1,"maximum":1000},"maxCommentAgeHours":{"default":168,"type":"integer","minimum":1,"maximum":720},"replyDelayMs":{"default":60000,"type":"integer","minimum":0,"maximum":86400000},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"enabledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["version","enabledAt"],"additionalProperties":false}},"required":["organizationId","brandId","profileId","profileName","settings"],"additionalProperties":false},"capability":{"type":"object","properties":{"eligible":{"type":"boolean"},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"generationRemaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"sendAttemptRemaining":{"type":"integer","minimum":0,"maximum":9007199254740991},"resetsAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["eligible","reasonCode","generationRemaining","sendAttemptRemaining","resetsAt"],"additionalProperties":false}},"required":["organizationId","brandId","policy"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"description":"The record version, lease or reply eligibility changed."},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"description":"Durable comment automation is unavailable."}}},"put":{"tags":["Engagement"],"operationId":"dashboardSaveCommentReplyAutomationPolicy","summary":"Preview or save automatic reply settings with an expected version.","security":[{"dashboardSessionCookie":[]},{"dashboardSession":[]}],"parameters":[{"name":"profileId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"description":"Writes default to dryRun=true. Read the current record and expectedVersion first; dryRun=false explicitly commits. X AI replies require prior written approval. Provider sends run in the background.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"settings":{"type":"object","properties":{"enabled":{"default":false,"type":"boolean"},"mode":{"default":"review","type":"string","enum":["automatic","review"]},"platforms":{"default":["facebook_page","instagram_business","instagram_standalone","threads"],"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]}},"tone":{"default":"friendly","type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"guidance":{"default":"","type":"string","maxLength":4000},"maxCharacters":{"default":500,"type":"integer","minimum":80,"maximum":2200},"hourlyLimit":{"default":20,"type":"integer","minimum":1,"maximum":100},"dailyLimit":{"default":100,"type":"integer","minimum":1,"maximum":1000},"maxCommentAgeHours":{"default":168,"type":"integer","minimum":1,"maximum":720},"replyDelayMs":{"default":60000,"type":"integer","minimum":0,"maximum":86400000}},"additionalProperties":false},"dryRun":{"default":true,"type":"boolean"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["brandId","expectedVersion","settings","organizationId"],"additionalProperties":false}}}},"x-creavily-gates":["CREAVILY_ALLOW_SOCIAL_COMMENT_WRITE"],"responses":{"200":{"description":"Tenant-scoped result.","content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"result":{"oneOf":[{"type":"object","properties":{"dryRun":{"type":"boolean","const":true},"preview":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileName":{"type":"string"},"settings":{"type":"object","properties":{"enabled":{"default":false,"type":"boolean"},"mode":{"default":"review","type":"string","enum":["automatic","review"]},"platforms":{"default":["facebook_page","instagram_business","instagram_standalone","threads"],"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]}},"tone":{"default":"friendly","type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"guidance":{"default":"","type":"string","maxLength":4000},"maxCharacters":{"default":500,"type":"integer","minimum":80,"maximum":2200},"hourlyLimit":{"default":20,"type":"integer","minimum":1,"maximum":100},"dailyLimit":{"default":100,"type":"integer","minimum":1,"maximum":1000},"maxCommentAgeHours":{"default":168,"type":"integer","minimum":1,"maximum":720},"replyDelayMs":{"default":60000,"type":"integer","minimum":0,"maximum":86400000},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"enabledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["version","enabledAt"],"additionalProperties":false}},"required":["organizationId","brandId","profileId","profileName","settings"],"additionalProperties":false}},"required":["dryRun","preview"],"additionalProperties":false},{"type":"object","properties":{"dryRun":{"type":"boolean","const":false},"policy":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileName":{"type":"string"},"settings":{"type":"object","properties":{"enabled":{"default":false,"type":"boolean"},"mode":{"default":"review","type":"string","enum":["automatic","review"]},"platforms":{"default":["facebook_page","instagram_business","instagram_standalone","threads"],"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]}},"tone":{"default":"friendly","type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"guidance":{"default":"","type":"string","maxLength":4000},"maxCharacters":{"default":500,"type":"integer","minimum":80,"maximum":2200},"hourlyLimit":{"default":20,"type":"integer","minimum":1,"maximum":100},"dailyLimit":{"default":100,"type":"integer","minimum":1,"maximum":1000},"maxCommentAgeHours":{"default":168,"type":"integer","minimum":1,"maximum":720},"replyDelayMs":{"default":60000,"type":"integer","minimum":0,"maximum":86400000},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"enabledAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["version","enabledAt"],"additionalProperties":false}},"required":["organizationId","brandId","profileId","profileName","settings"],"additionalProperties":false}},"required":["dryRun","policy"],"additionalProperties":false}]}},"required":["organizationId","brandId","result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"description":"The record version, lease or reply eligibility changed."},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"description":"Durable comment automation is unavailable."}}}},"/v1/publishing-profiles/{profileId}/comment-automation/sync-comments":{"post":{"tags":["Engagement"],"operationId":"dashboardSyncCommentReplyAutomationComments","summary":"Preview or fetch a bounded number of comment pages; continue persisted cursors.","security":[{"dashboardSessionCookie":[]},{"dashboardSession":[]}],"parameters":[{"name":"profileId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"description":"Writes default to dryRun=true. Read the current record and expectedVersion first; dryRun=false explicitly commits. X AI replies require prior written approval. Provider sends run in the background.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"targetLimit":{"default":10,"type":"integer","minimum":1,"maximum":25},"maxPages":{"default":2,"type":"integer","minimum":1,"maximum":5},"commentsPerPage":{"default":25,"type":"integer","minimum":10,"maximum":100},"dryRun":{"default":true,"type":"boolean"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["brandId","organizationId"],"additionalProperties":false}}}},"x-creavily-gates":["CREAVILY_ALLOW_SOCIAL_COMMENT_WRITE","CREAVILY_ALLOW_PROVIDER_COMMENT_SYNC"],"responses":{"200":{"description":"Tenant-scoped result.","content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"result":{"oneOf":[{"type":"object","properties":{"dryRun":{"type":"boolean","const":true},"preview":{"type":"object","properties":{"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"targetLimit":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"maxPages":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"commentsPerPage":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["profileId","targetLimit","maxPages","commentsPerPage"],"additionalProperties":false}},"required":["dryRun","preview"],"additionalProperties":false},{"type":"object","properties":{"dryRun":{"type":"boolean","const":false},"sync":{"type":"object","properties":{"targetsVisited":{"type":"integer","minimum":0,"maximum":9007199254740991},"commentsSynced":{"type":"integer","minimum":0,"maximum":9007199254740991},"pagesFetched":{"type":"integer","minimum":0,"maximum":9007199254740991},"hasMore":{"type":"boolean"},"failures":{"type":"array","items":{"type":"object","properties":{"postTargetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"errorCode":{"type":"string"},"retryAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["postTargetId","errorCode"],"additionalProperties":false}}},"required":["targetsVisited","commentsSynced","pagesFetched","hasMore","failures"],"additionalProperties":false}},"required":["dryRun","sync"],"additionalProperties":false}]}},"required":["organizationId","brandId","result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"description":"The record version, lease or reply eligibility changed."},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"description":"Durable comment automation is unavailable."}}}},"/v1/social-comment-automation/jobs":{"get":{"tags":["Engagement"],"operationId":"dashboardListCommentReplyAutomationJobs","summary":"List automatic reply decisions, drafts and provider receipts.","security":[{"dashboardSessionCookie":[]},{"dashboardSession":[]}],"parameters":[{"name":"brandId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"profileId","in":"query","required":false,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["pending","processing","ready","needs_review","sent","ignored","failed","needs_reconciliation","cancelled"]}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Tenant-scoped result.","content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"jobs":{"type":"array","items":{"type":"object","properties":{"automationJobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]},"policyVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","processing","ready","needs_review","sent","ignored","failed","needs_reconciliation","cancelled"]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"nextAttemptAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["automationJobId","organizationId","brandId","profileId","socialCommentId","channelAccountId","platform","policyVersion","status","body","reasonCode","errorCode","attemptCount","nextAttemptAt","providerReplyId","approvedAt","version","createdAt","updatedAt"],"additionalProperties":false}}},"required":["organizationId","brandId","jobs"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"description":"The record version, lease or reply eligibility changed."},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"description":"Durable comment automation is unavailable."}}}},"/v1/social-comment-automation/jobs/{jobId}":{"get":{"tags":["Engagement"],"operationId":"dashboardGetCommentReplyAutomationJob","summary":"Read one automatic reply job.","security":[{"dashboardSessionCookie":[]},{"dashboardSession":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"brandId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Tenant-scoped result.","content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"job":{"type":"object","properties":{"automationJobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]},"policyVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","processing","ready","needs_review","sent","ignored","failed","needs_reconciliation","cancelled"]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"nextAttemptAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["automationJobId","organizationId","brandId","profileId","socialCommentId","channelAccountId","platform","policyVersion","status","body","reasonCode","errorCode","attemptCount","nextAttemptAt","providerReplyId","approvedAt","version","createdAt","updatedAt"],"additionalProperties":false}},"required":["organizationId","brandId","job"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"description":"The record version, lease or reply eligibility changed."},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"description":"Durable comment automation is unavailable."}}}},"/v1/social-comment-automation/jobs/{jobId}/approve":{"post":{"tags":["Engagement"],"operationId":"dashboardApproveCommentReplyAutomationJob","summary":"Preview or approve a stored draft for the background reply worker.","security":[{"dashboardSessionCookie":[]},{"dashboardSession":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"description":"Writes default to dryRun=true. Read the current record and expectedVersion first; dryRun=false explicitly commits. X AI replies require prior written approval. Provider sends run in the background.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"body":{"type":"string","minLength":1,"maxLength":2200},"dryRun":{"default":true,"type":"boolean"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["brandId","expectedVersion","organizationId"],"additionalProperties":false}}}},"x-creavily-gates":["CREAVILY_ALLOW_SOCIAL_COMMENT_WRITE","CREAVILY_ALLOW_PROVIDER_COMMENT_REPLY"],"responses":{"200":{"description":"Tenant-scoped result.","content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"result":{"oneOf":[{"type":"object","properties":{"dryRun":{"type":"boolean","const":true},"preview":{"type":"object","properties":{"action":{"type":"string","enum":["approve","cancel"]},"job":{"type":"object","properties":{"automationJobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]},"policyVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","processing","ready","needs_review","sent","ignored","failed","needs_reconciliation","cancelled"]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"nextAttemptAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["automationJobId","organizationId","brandId","profileId","socialCommentId","channelAccountId","platform","policyVersion","status","body","reasonCode","errorCode","attemptCount","nextAttemptAt","providerReplyId","approvedAt","version","createdAt","updatedAt"],"additionalProperties":false},"body":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["action","job","body"],"additionalProperties":false}},"required":["dryRun","preview"],"additionalProperties":false},{"type":"object","properties":{"dryRun":{"type":"boolean","const":false},"job":{"type":"object","properties":{"automationJobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]},"policyVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","processing","ready","needs_review","sent","ignored","failed","needs_reconciliation","cancelled"]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"nextAttemptAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["automationJobId","organizationId","brandId","profileId","socialCommentId","channelAccountId","platform","policyVersion","status","body","reasonCode","errorCode","attemptCount","nextAttemptAt","providerReplyId","approvedAt","version","createdAt","updatedAt"],"additionalProperties":false}},"required":["dryRun","job"],"additionalProperties":false}]}},"required":["organizationId","brandId","result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"description":"The record version, lease or reply eligibility changed."},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"description":"Durable comment automation is unavailable."}}}},"/v1/social-comment-automation/jobs/{jobId}/cancel":{"post":{"tags":["Engagement"],"operationId":"dashboardCancelCommentReplyAutomationJob","summary":"Preview or cancel a reply which has not started sending.","security":[{"dashboardSessionCookie":[]},{"dashboardSession":[]}],"parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"description":"Writes default to dryRun=true. Read the current record and expectedVersion first; dryRun=false explicitly commits. X AI replies require prior written approval. Provider sends run in the background.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"dryRun":{"default":true,"type":"boolean"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["brandId","expectedVersion","organizationId"],"additionalProperties":false}}}},"x-creavily-gates":["CREAVILY_ALLOW_SOCIAL_COMMENT_WRITE"],"responses":{"200":{"description":"Tenant-scoped result.","content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"result":{"oneOf":[{"type":"object","properties":{"dryRun":{"type":"boolean","const":true},"preview":{"type":"object","properties":{"action":{"type":"string","enum":["approve","cancel"]},"job":{"type":"object","properties":{"automationJobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]},"policyVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","processing","ready","needs_review","sent","ignored","failed","needs_reconciliation","cancelled"]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"nextAttemptAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["automationJobId","organizationId","brandId","profileId","socialCommentId","channelAccountId","platform","policyVersion","status","body","reasonCode","errorCode","attemptCount","nextAttemptAt","providerReplyId","approvedAt","version","createdAt","updatedAt"],"additionalProperties":false},"body":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["action","job","body"],"additionalProperties":false}},"required":["dryRun","preview"],"additionalProperties":false},{"type":"object","properties":{"dryRun":{"type":"boolean","const":false},"job":{"type":"object","properties":{"automationJobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]},"policyVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"status":{"type":"string","enum":["pending","processing","ready","needs_review","sent","ignored","failed","needs_reconciliation","cancelled"]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"nextAttemptAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"approvedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["automationJobId","organizationId","brandId","profileId","socialCommentId","channelAccountId","platform","policyVersion","status","body","reasonCode","errorCode","attemptCount","nextAttemptAt","providerReplyId","approvedAt","version","createdAt","updatedAt"],"additionalProperties":false}},"required":["dryRun","job"],"additionalProperties":false}]}},"required":["organizationId","brandId","result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"description":"The record version, lease or reply eligibility changed."},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"description":"Durable comment automation is unavailable."}}}},"/v1/public/social-comment-reply-runs":{"post":{"tags":["Engagement","Agent"],"operationId":"publicCreateCommentReplyRun","summary":"Preview or execute a bounded reply run for selected saved comments.","description":"Requests default to dryRun=true. The server processes at most ten explicitly selected comments and never refreshes provider comments as part of this operation.","security":[{"publicBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"commentIds":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"mode":{"type":"string","enum":["draft","review","send"]},"confirmedSend":{"default":false,"type":"boolean"},"dryRun":{"default":true,"type":"boolean"},"settings":{"default":{"tone":"friendly","guidance":""},"type":"object","properties":{"tone":{"default":"friendly","type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"guidance":{"default":"","type":"string","maxLength":4000}},"additionalProperties":false},"idempotencyKey":{"type":"string","minLength":1,"maxLength":200}},"required":["brandId","profileId","commentIds","mode"],"additionalProperties":false}}}},"x-env-gates":["CREAVILY_ALLOW_AI_COMMENT_REPLY=true","CREAVILY_ALLOW_SOCIAL_COMMENT_WRITE=true","CREAVILY_ALLOW_PROVIDER_COMMENT_REPLY=true"],"x-required-scopes":["analytics:read","publishing:write"],"responses":{"200":{"description":"Preview or completed bounded reply run.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"principal":{},"dryRun":{"type":"boolean","const":true},"preview":{"type":"object","properties":{"mode":{"type":"string","enum":["draft","review","send"]},"confirmedSend":{"type":"boolean"},"selectedCount":{"type":"integer","minimum":1,"maximum":10},"items":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"disposition":{"type":"string","enum":["ignored","needs_review","would_draft","would_send","confirmation_required"]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["socialCommentId","platform","disposition","reasonCode"],"additionalProperties":false}},"requiredGates":{"type":"array","items":{"type":"string"}}},"required":["mode","confirmedSend","selectedCount","items","requiredGates"],"additionalProperties":false}},"required":["principal","dryRun","preview"],"additionalProperties":false},{"type":"object","properties":{"principal":{},"dryRun":{"type":"boolean","const":false},"replayed":{"type":"boolean"},"run":{"type":"object","properties":{"runId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"mode":{"type":"string","enum":["draft","review","send"]},"status":{"type":"string","enum":["queued","in_progress","completed","partial","needs_reconciliation"]},"confirmedSend":{"type":"boolean"},"settings":{"type":"object","properties":{"tone":{"default":"friendly","type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"guidance":{"default":"","type":"string","maxLength":4000}},"additionalProperties":false},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"items":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"runItemId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"position":{"type":"integer","minimum":0,"maximum":9},"status":{"type":"string","enum":["pending","processing","draft","needs_review","ignored","sent","failed","needs_reconciliation"]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"receipt":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"sendStartedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["runItemId","socialCommentId","channelAccountId","platform","position","status","body","reasonCode","errorCode","providerReplyId","releaseUrl","receipt","attemptCount","sendStartedAt","createdAt","updatedAt"],"additionalProperties":false}},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"completedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["runId","organizationId","brandId","profileId","mode","status","confirmedSend","settings","attemptCount","items","createdAt","updatedAt","completedAt"],"additionalProperties":false}},"required":["principal","dryRun","replayed","run"],"additionalProperties":false}]}}}},"202":{"description":"Durable run accepted and still processing.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"principal":{},"dryRun":{"type":"boolean","const":true},"preview":{"type":"object","properties":{"mode":{"type":"string","enum":["draft","review","send"]},"confirmedSend":{"type":"boolean"},"selectedCount":{"type":"integer","minimum":1,"maximum":10},"items":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"disposition":{"type":"string","enum":["ignored","needs_review","would_draft","would_send","confirmation_required"]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["socialCommentId","platform","disposition","reasonCode"],"additionalProperties":false}},"requiredGates":{"type":"array","items":{"type":"string"}}},"required":["mode","confirmedSend","selectedCount","items","requiredGates"],"additionalProperties":false}},"required":["principal","dryRun","preview"],"additionalProperties":false},{"type":"object","properties":{"principal":{},"dryRun":{"type":"boolean","const":false},"replayed":{"type":"boolean"},"run":{"type":"object","properties":{"runId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"mode":{"type":"string","enum":["draft","review","send"]},"status":{"type":"string","enum":["queued","in_progress","completed","partial","needs_reconciliation"]},"confirmedSend":{"type":"boolean"},"settings":{"type":"object","properties":{"tone":{"default":"friendly","type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"guidance":{"default":"","type":"string","maxLength":4000}},"additionalProperties":false},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"items":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"runItemId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"position":{"type":"integer","minimum":0,"maximum":9},"status":{"type":"string","enum":["pending","processing","draft","needs_review","ignored","sent","failed","needs_reconciliation"]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"receipt":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"sendStartedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["runItemId","socialCommentId","channelAccountId","platform","position","status","body","reasonCode","errorCode","providerReplyId","releaseUrl","receipt","attemptCount","sendStartedAt","createdAt","updatedAt"],"additionalProperties":false}},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"completedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["runId","organizationId","brandId","profileId","mode","status","confirmedSend","settings","attemptCount","items","createdAt","updatedAt","completedAt"],"additionalProperties":false}},"required":["principal","dryRun","replayed","run"],"additionalProperties":false}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"description":"Durable comment reply execution is unavailable."}},"x-scope-modes":[{"when":"body.dryRun=true","scopes":["analytics:read"]},{"when":"body.dryRun!=true","scopes":["publishing:write"]}],"x-dry-run-default":true}},"/v1/public/social-comment-reply-runs/{runId}":{"get":{"tags":["Engagement","Agent"],"operationId":"publicGetCommentReplyRun","summary":"Read one tenant-scoped bounded reply run.","security":[{"publicBearer":[]}],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"brandId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Tenant-scoped reply run.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{},"run":{"type":"object","properties":{"runId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"mode":{"type":"string","enum":["draft","review","send"]},"status":{"type":"string","enum":["queued","in_progress","completed","partial","needs_reconciliation"]},"confirmedSend":{"type":"boolean"},"settings":{"type":"object","properties":{"tone":{"default":"friendly","type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"guidance":{"default":"","type":"string","maxLength":4000}},"additionalProperties":false},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"items":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"runItemId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"position":{"type":"integer","minimum":0,"maximum":9},"status":{"type":"string","enum":["pending","processing","draft","needs_review","ignored","sent","failed","needs_reconciliation"]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"receipt":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"sendStartedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["runItemId","socialCommentId","channelAccountId","platform","position","status","body","reasonCode","errorCode","providerReplyId","releaseUrl","receipt","attemptCount","sendStartedAt","createdAt","updatedAt"],"additionalProperties":false}},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"completedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["runId","organizationId","brandId","profileId","mode","status","confirmedSend","settings","attemptCount","items","createdAt","updatedAt","completedAt"],"additionalProperties":false}},"required":["principal","run"],"additionalProperties":false}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/social-comment-reply-runs":{"post":{"tags":["Engagement"],"operationId":"dashboardCreateCommentReplyRun","summary":"Preview or execute a bounded reply run for selected saved comments.","description":"Requests default to dryRun=true. The server processes at most ten explicitly selected comments and never refreshes provider comments as part of this operation.","security":[{"dashboardSession":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string","maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"commentIds":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"mode":{"type":"string","enum":["draft","review","send"]},"confirmedSend":{"default":false,"type":"boolean"},"dryRun":{"default":true,"type":"boolean"},"settings":{"default":{"tone":"friendly","guidance":""},"type":"object","properties":{"tone":{"default":"friendly","type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"guidance":{"default":"","type":"string","maxLength":4000}},"additionalProperties":false},"idempotencyKey":{"type":"string","minLength":1,"maxLength":200},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["brandId","profileId","commentIds","mode","organizationId"],"additionalProperties":false}}}},"x-env-gates":["CREAVILY_ALLOW_AI_COMMENT_REPLY=true","CREAVILY_ALLOW_SOCIAL_COMMENT_WRITE=true","CREAVILY_ALLOW_PROVIDER_COMMENT_REPLY=true"],"responses":{"200":{"description":"Preview or completed bounded reply run.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"dryRun":{"type":"boolean","const":true},"preview":{"type":"object","properties":{"mode":{"type":"string","enum":["draft","review","send"]},"confirmedSend":{"type":"boolean"},"selectedCount":{"type":"integer","minimum":1,"maximum":10},"items":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"disposition":{"type":"string","enum":["ignored","needs_review","would_draft","would_send","confirmation_required"]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["socialCommentId","platform","disposition","reasonCode"],"additionalProperties":false}},"requiredGates":{"type":"array","items":{"type":"string"}}},"required":["mode","confirmedSend","selectedCount","items","requiredGates"],"additionalProperties":false}},"required":["organizationId","brandId","dryRun","preview"],"additionalProperties":false},{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"dryRun":{"type":"boolean","const":false},"replayed":{"type":"boolean"},"run":{"type":"object","properties":{"runId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"mode":{"type":"string","enum":["draft","review","send"]},"status":{"type":"string","enum":["queued","in_progress","completed","partial","needs_reconciliation"]},"confirmedSend":{"type":"boolean"},"settings":{"type":"object","properties":{"tone":{"default":"friendly","type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"guidance":{"default":"","type":"string","maxLength":4000}},"additionalProperties":false},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"items":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"runItemId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"position":{"type":"integer","minimum":0,"maximum":9},"status":{"type":"string","enum":["pending","processing","draft","needs_review","ignored","sent","failed","needs_reconciliation"]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"receipt":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"sendStartedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["runItemId","socialCommentId","channelAccountId","platform","position","status","body","reasonCode","errorCode","providerReplyId","releaseUrl","receipt","attemptCount","sendStartedAt","createdAt","updatedAt"],"additionalProperties":false}},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"completedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["runId","organizationId","brandId","profileId","mode","status","confirmedSend","settings","attemptCount","items","createdAt","updatedAt","completedAt"],"additionalProperties":false}},"required":["organizationId","brandId","dryRun","replayed","run"],"additionalProperties":false}]}}}},"202":{"description":"Durable run accepted and still processing.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"dryRun":{"type":"boolean","const":true},"preview":{"type":"object","properties":{"mode":{"type":"string","enum":["draft","review","send"]},"confirmedSend":{"type":"boolean"},"selectedCount":{"type":"integer","minimum":1,"maximum":10},"items":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"disposition":{"type":"string","enum":["ignored","needs_review","would_draft","would_send","confirmation_required"]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["socialCommentId","platform","disposition","reasonCode"],"additionalProperties":false}},"requiredGates":{"type":"array","items":{"type":"string"}}},"required":["mode","confirmedSend","selectedCount","items","requiredGates"],"additionalProperties":false}},"required":["organizationId","brandId","dryRun","preview"],"additionalProperties":false},{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"dryRun":{"type":"boolean","const":false},"replayed":{"type":"boolean"},"run":{"type":"object","properties":{"runId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"mode":{"type":"string","enum":["draft","review","send"]},"status":{"type":"string","enum":["queued","in_progress","completed","partial","needs_reconciliation"]},"confirmedSend":{"type":"boolean"},"settings":{"type":"object","properties":{"tone":{"default":"friendly","type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"guidance":{"default":"","type":"string","maxLength":4000}},"additionalProperties":false},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"items":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"runItemId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"position":{"type":"integer","minimum":0,"maximum":9},"status":{"type":"string","enum":["pending","processing","draft","needs_review","ignored","sent","failed","needs_reconciliation"]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"receipt":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"sendStartedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["runItemId","socialCommentId","channelAccountId","platform","position","status","body","reasonCode","errorCode","providerReplyId","releaseUrl","receipt","attemptCount","sendStartedAt","createdAt","updatedAt"],"additionalProperties":false}},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"completedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["runId","organizationId","brandId","profileId","mode","status","confirmedSend","settings","attemptCount","items","createdAt","updatedAt","completedAt"],"additionalProperties":false}},"required":["organizationId","brandId","dryRun","replayed","run"],"additionalProperties":false}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"description":"Durable comment reply execution is unavailable."}}}},"/v1/social-comment-reply-runs/{runId}":{"get":{"tags":["Engagement"],"operationId":"dashboardGetCommentReplyRun","summary":"Read one tenant-scoped bounded reply run.","security":[{"dashboardSession":[]}],"parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"brandId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Tenant-scoped reply run.","content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"run":{"type":"object","properties":{"runId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"profileId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"mode":{"type":"string","enum":["draft","review","send"]},"status":{"type":"string","enum":["queued","in_progress","completed","partial","needs_reconciliation"]},"confirmedSend":{"type":"boolean"},"settings":{"type":"object","properties":{"tone":{"default":"friendly","type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"guidance":{"default":"","type":"string","maxLength":4000}},"additionalProperties":false},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"items":{"maxItems":10,"type":"array","items":{"type":"object","properties":{"runItemId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"socialCommentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"position":{"type":"integer","minimum":0,"maximum":9},"status":{"type":"string","enum":["pending","processing","draft","needs_review","ignored","sent","failed","needs_reconciliation"]},"body":{"anyOf":[{"type":"string"},{"type":"null"}]},"reasonCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"receipt":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"sendStartedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["runItemId","socialCommentId","channelAccountId","platform","position","status","body","reasonCode","errorCode","providerReplyId","releaseUrl","receipt","attemptCount","sendStartedAt","createdAt","updatedAt"],"additionalProperties":false}},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"completedAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["runId","organizationId","brandId","profileId","mode","status","confirmedSend","settings","attemptCount","items","createdAt","updatedAt","completedAt"],"additionalProperties":false}},"required":["organizationId","brandId","run"],"additionalProperties":false}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/health":{"get":{"tags":["System"],"operationId":"routeContractGETHealth","summary":"Return the public API liveness status.","responses":{"200":{"description":"API process is live.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthLivenessResponse"}}}}}}},"/health/live":{"get":{"tags":["System"],"operationId":"routeContractGETHealthLive","summary":"Return the public API liveness status for orchestrators.","responses":{"200":{"description":"API process is live.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthLivenessResponse"}}}}}}},"/health/ready":{"get":{"tags":["System"],"operationId":"routeContractGETHealthReady","summary":"Return API dependency readiness for orchestrators.","responses":{"200":{"description":"All required dependencies are ready.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthReadinessResponse"}}}},"503":{"description":"One or more required dependencies are not ready.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthReadinessResponse"}}}}}}},"/ready":{"get":{"tags":["System"],"operationId":"routeContractGETReady","summary":"Return configured media-storage readiness for orchestrators.","responses":{"200":{"description":"Media storage is configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorageReadinessResponse"}}}},"503":{"description":"Media storage is not configured.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorageReadinessResponse"}}}}}}},"/v1/auth/google/start":{"get":{"tags":["Auth"],"operationId":"startGoogleSignIn","summary":"Redirect an invited dashboard user to Google OAuth.","responses":{"302":{"description":"Redirect to Google OAuth consent and set a short-lived HttpOnly browser state cookie."},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/v1/auth/google/callback":{"get":{"tags":["Auth"],"operationId":"completeGoogleSignInBrowser","summary":"Complete Google OAuth in the browser and return to the dashboard with a session.","parameters":[{"name":"code","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"state","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"302":{"description":"Redirect to the allowed dashboard completion URL with only a short-lived one-time code and nonce. The Dashboard session bearer is never placed in the URL."},"400":{"$ref":"#/components/responses/BadRequest"},"403":{"$ref":"#/components/responses/Forbidden"}}},"post":{"tags":["Auth"],"operationId":"completeGoogleSignInJson","summary":"Complete Google OAuth and return the dashboard session as JSON.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","minLength":1},"state":{"type":"string","minLength":1}},"required":["code","state"]}}}},"responses":{"200":{"description":"One-time browser session code and nonce.","content":{"application/json":{"schema":{"type":"object","properties":{"authorizationCode":{"type":"string"},"nonce":{"type":"string"},"expiresAt":{"type":"string"}},"required":["authorizationCode","nonce","expiresAt"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/auth/browser-session/start":{"post":{"tags":["Auth"],"operationId":"startDashboardBrowserSession","summary":"Start a password-based Dashboard browser session without returning a bearer credential.","description":"Requires an approved browser Origin. Sets a short-lived HttpOnly temporary cookie and returns a one-time code and nonce for the exchange endpoint. The returned code and nonce are not Dashboard session credentials.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"password":{"type":"string","minLength":1}},"required":["email","password"]}}}},"responses":{"200":{"description":"One-time browser session code and nonce; the temporary HttpOnly exchange cookie is set.","content":{"application/json":{"schema":{"type":"object","properties":{"authorizationCode":{"type":"string"},"nonce":{"type":"string"},"expiresAt":{"type":"string"}},"required":["authorizationCode","nonce","expiresAt"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/auth/browser-session/exchange":{"post":{"tags":["Auth"],"operationId":"exchangeDashboardBrowserSession","summary":"Exchange a one-time browser code for an HttpOnly Dashboard cookie.","description":"Requires the short-lived browserSessionExchangeCookie, matching code and nonce, and an approved Origin. A successful exchange consumes the code, rotates the temporary session, clears the temporary cookie, and sets dashboardSessionCookie. No session bearer is returned in JSON.","security":[{"browserSessionExchangeCookie":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"authorizationCode":{"type":"string","minLength":24,"maxLength":256},"nonce":{"type":"string","minLength":24,"maxLength":256}},"required":["authorizationCode","nonce"]}}}},"responses":{"200":{"description":"Dashboard account context and a rotated HttpOnly dashboardSessionCookie; no session bearer is included in the response body.","content":{"application/json":{"schema":{"type":"object","properties":{"session":{"type":"object","properties":{"sessionId":{"type":"string"},"userId":{"type":"string"},"expiresAt":{"type":"string"},"lastSeenAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"}},"required":["sessionId","userId","expiresAt","lastSeenAt","revokedAt","createdAt"],"additionalProperties":false},"account":{"type":"object","properties":{"user":{"type":"object","properties":{"userId":{"type":"string"},"email":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["userId","email","name"],"additionalProperties":false},"workspaces":{"type":"array","items":{"type":"object","properties":{"organizationId":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"timezone":{"type":"string"},"role":{"type":"string"},"brands":{"type":"array","items":{"type":"object","properties":{"brandId":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"timezone":{"type":"string"}},"required":["brandId","organizationId","name","slug","timezone"],"additionalProperties":false}}},"required":["organizationId","name","slug","timezone","role","brands"],"additionalProperties":false}}},"required":["user","workspaces"],"additionalProperties":false}},"required":["session","account"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/auth/login":{"post":{"tags":["Auth"],"operationId":"loginDashboardSession","summary":"Create a legacy dashboard session with email and password.","description":"No existing dashboard session is required. Requests are subject to the dashboard login rate limit.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"password":{"type":"string","minLength":1}},"required":["email","password"]}}}},"responses":{"200":{"description":"Legacy Dashboard session and account context.","content":{"application/json":{"schema":{"type":"object","properties":{"session":{"type":"object","properties":{"sessionId":{"type":"string"},"userId":{"type":"string"},"expiresAt":{"type":"string"},"lastSeenAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"}},"required":["sessionId","userId","expiresAt","lastSeenAt","revokedAt","createdAt"],"additionalProperties":false},"account":{"type":"object","properties":{"user":{"type":"object","properties":{"userId":{"type":"string"},"email":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["userId","email","name"],"additionalProperties":false},"workspaces":{"type":"array","items":{"type":"object","properties":{"organizationId":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"timezone":{"type":"string"},"role":{"type":"string"},"brands":{"type":"array","items":{"type":"object","properties":{"brandId":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"timezone":{"type":"string"}},"required":["brandId","organizationId","name","slug","timezone"],"additionalProperties":false}}},"required":["organizationId","name","slug","timezone","role","brands"],"additionalProperties":false}}},"required":["user","workspaces"],"additionalProperties":false},"sessionToken":{"type":"string"},"sessionPreview":{"type":"string"}},"required":["session","account","sessionToken","sessionPreview"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/brands/first":{"post":{"tags":["Auth"],"operationId":"initializeFirstWorkspaceBrand","summary":"Initialize an authorized owner's or administrator's empty workspace with its first brand.","description":"Dashboard-only. The request UUID is scoped to the current actor and workspace; identical retries return the same record. Existing brands and handles are never modified. This operation grants no provider or billing permissions.","security":[{"dashboardSessionCookie":[]},{"dashboardSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\u0000-\\u001f\\u007f]+$"}},"required":["organizationId","requestId","name"],"additionalProperties":false}}}},"responses":{"200":{"description":"Created first brand or an identical completed request.","content":{"application/json":{"schema":{"type":"object","properties":{"brand":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"slug":{"type":"string"},"timezone":{"type":"string"}},"required":["brandId","organizationId","name","slug","timezone"]},"created":{"type":"boolean"}},"required":["brand","created"]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/brands":{"post":{"tags":["Auth"],"operationId":"createWorkspaceBrand","summary":"Create an additional brand in an authorized workspace.","description":"Dashboard-only. Owners and administrators can add brand context without changing existing brands, handles, URLs, accounts, publishing setups, posts, or jobs. The request UUID is scoped to the current actor and workspace; identical retries return the same brand.","security":[{"dashboardSessionCookie":[]},{"dashboardSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"requestId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":1,"maxLength":120,"pattern":"^[^\\p{Cc}\\p{Cf}]+$"}},"required":["organizationId","requestId","name"],"additionalProperties":false}}}},"responses":{"200":{"description":"Created additional brand or an identical completed request.","content":{"application/json":{"schema":{"type":"object","properties":{"brand":{"type":"object","properties":{"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"slug":{"type":"string"},"timezone":{"type":"string"}},"required":["brandId","organizationId","name","slug","timezone"],"additionalProperties":false},"created":{"type":"boolean"}},"required":["brand","created"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/composer-drafts/current":{"get":{"tags":["Publishing"],"operationId":"getCurrentComposerDraft","summary":"Read the signed-in member's private Create draft for one brand.","description":"Dashboard-only. Drafts are author-private, tenant- and brand-scoped, and never grant publishing or provider permissions.","security":[{"dashboardSessionCookie":[]},{"dashboardSession":[]}],"parameters":[{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"brandId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Current private draft, or null when no workspace copy exists.","content":{"application/json":{"schema":{"type":"object","properties":{"draft":{"anyOf":[{"type":"object","properties":{"draftId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"authorUserId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"visibility":{"type":"string","const":"private"},"schemaVersion":{"type":"number","const":2},"contentVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"payload":{"type":"object","properties":{"caption":{"type":"string","maxLength":50000},"title":{"type":"string","maxLength":500},"content":{"type":"object","properties":{"bodyMode":{"type":"string","enum":["shared","platform"]},"bodies":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"string","maxLength":50000}},"commentsEnabled":{"type":"boolean"},"commentMode":{"type":"string","enum":["shared","platform"]},"sharedComment":{"type":"string","maxLength":50000},"comments":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"string","maxLength":50000}},"commentEnabledByPlatform":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"boolean"}},"commentDelayMs":{"type":"integer","minimum":0,"maximum":86400000},"commentDelays":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"integer","minimum":0,"maximum":86400000}},"pinTitle":{"type":"string","maxLength":500},"pinLink":{"type":"string","maxLength":2048},"productUrl":{"type":"string","maxLength":2048}},"required":["bodyMode","bodies","commentsEnabled","commentMode","sharedComment","comments","commentEnabledByPlatform","commentDelayMs","commentDelays","pinTitle","pinLink","productUrl"],"additionalProperties":false},"selectedPlatforms":{"maxItems":8,"type":"array","items":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},"selectedChannelAccountIds":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"string","maxLength":200}},"selectedPublishingProfileId":{"type":"string","maxLength":200},"selectedMediaId":{"type":"string","maxLength":200},"publishMode":{"type":"string","enum":["now","schedule"]},"scheduleAt":{"type":"string","maxLength":100}},"required":["caption","title","content","selectedPlatforms","selectedChannelAccountIds","selectedPublishingProfileId","selectedMediaId","publishMode","scheduleAt"],"additionalProperties":false},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["draftId","organizationId","brandId","authorUserId","visibility","schemaVersion","contentVersion","payload","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]}},"required":["draft"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}},"put":{"tags":["Publishing"],"operationId":"saveCurrentComposerDraft","summary":"Create or update the signed-in member's private Create draft.","description":"Uses optimistic content versions. A conflicting browser copy is returned with 409 and is never overwritten silently.","security":[{"dashboardSessionCookie":[]},{"dashboardSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"schemaVersion":{"type":"number","const":2},"expectedContentVersion":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]},"payload":{"type":"object","properties":{"caption":{"type":"string","maxLength":50000},"title":{"type":"string","maxLength":500},"content":{"type":"object","properties":{"bodyMode":{"type":"string","enum":["shared","platform"]},"bodies":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"string","maxLength":50000}},"commentsEnabled":{"type":"boolean"},"commentMode":{"type":"string","enum":["shared","platform"]},"sharedComment":{"type":"string","maxLength":50000},"comments":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"string","maxLength":50000}},"commentEnabledByPlatform":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"boolean"}},"commentDelayMs":{"type":"integer","minimum":0,"maximum":86400000},"commentDelays":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"integer","minimum":0,"maximum":86400000}},"pinTitle":{"type":"string","maxLength":500},"pinLink":{"type":"string","maxLength":2048},"productUrl":{"type":"string","maxLength":2048}},"required":["bodyMode","bodies","commentsEnabled","commentMode","sharedComment","comments","commentEnabledByPlatform","commentDelayMs","commentDelays","pinTitle","pinLink","productUrl"],"additionalProperties":false},"selectedPlatforms":{"maxItems":8,"type":"array","items":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},"selectedChannelAccountIds":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"string","maxLength":200}},"selectedPublishingProfileId":{"type":"string","maxLength":200},"selectedMediaId":{"type":"string","maxLength":200},"publishMode":{"type":"string","enum":["now","schedule"]},"scheduleAt":{"type":"string","maxLength":100}},"required":["caption","title","content","selectedPlatforms","selectedChannelAccountIds","selectedPublishingProfileId","selectedMediaId","publishMode","scheduleAt"],"additionalProperties":false}},"required":["organizationId","brandId","schemaVersion","expectedContentVersion","payload"],"additionalProperties":false}}}},"responses":{"200":{"description":"Saved private Create draft.","content":{"application/json":{"schema":{"type":"object","properties":{"draft":{"type":"object","properties":{"draftId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"authorUserId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"visibility":{"type":"string","const":"private"},"schemaVersion":{"type":"number","const":2},"contentVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"payload":{"type":"object","properties":{"caption":{"type":"string","maxLength":50000},"title":{"type":"string","maxLength":500},"content":{"type":"object","properties":{"bodyMode":{"type":"string","enum":["shared","platform"]},"bodies":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"string","maxLength":50000}},"commentsEnabled":{"type":"boolean"},"commentMode":{"type":"string","enum":["shared","platform"]},"sharedComment":{"type":"string","maxLength":50000},"comments":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"string","maxLength":50000}},"commentEnabledByPlatform":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"boolean"}},"commentDelayMs":{"type":"integer","minimum":0,"maximum":86400000},"commentDelays":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"integer","minimum":0,"maximum":86400000}},"pinTitle":{"type":"string","maxLength":500},"pinLink":{"type":"string","maxLength":2048},"productUrl":{"type":"string","maxLength":2048}},"required":["bodyMode","bodies","commentsEnabled","commentMode","sharedComment","comments","commentEnabledByPlatform","commentDelayMs","commentDelays","pinTitle","pinLink","productUrl"],"additionalProperties":false},"selectedPlatforms":{"maxItems":8,"type":"array","items":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},"selectedChannelAccountIds":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"string","maxLength":200}},"selectedPublishingProfileId":{"type":"string","maxLength":200},"selectedMediaId":{"type":"string","maxLength":200},"publishMode":{"type":"string","enum":["now","schedule"]},"scheduleAt":{"type":"string","maxLength":100}},"required":["caption","title","content","selectedPlatforms","selectedChannelAccountIds","selectedPublishingProfileId","selectedMediaId","publishMode","scheduleAt"],"additionalProperties":false},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["draftId","organizationId","brandId","authorUserId","visibility","schemaVersion","contentVersion","payload","createdAt","updatedAt"],"additionalProperties":false}},"required":["draft"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"description":"The workspace draft changed in another browser.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","const":"composer_draft_conflict"},"message":{"type":"string"},"currentDraft":{"anyOf":[{"type":"object","properties":{"draftId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"authorUserId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"visibility":{"type":"string","const":"private"},"schemaVersion":{"type":"number","const":2},"contentVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"payload":{"type":"object","properties":{"caption":{"type":"string","maxLength":50000},"title":{"type":"string","maxLength":500},"content":{"type":"object","properties":{"bodyMode":{"type":"string","enum":["shared","platform"]},"bodies":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"string","maxLength":50000}},"commentsEnabled":{"type":"boolean"},"commentMode":{"type":"string","enum":["shared","platform"]},"sharedComment":{"type":"string","maxLength":50000},"comments":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"string","maxLength":50000}},"commentEnabledByPlatform":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"boolean"}},"commentDelayMs":{"type":"integer","minimum":0,"maximum":86400000},"commentDelays":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"integer","minimum":0,"maximum":86400000}},"pinTitle":{"type":"string","maxLength":500},"pinLink":{"type":"string","maxLength":2048},"productUrl":{"type":"string","maxLength":2048}},"required":["bodyMode","bodies","commentsEnabled","commentMode","sharedComment","comments","commentEnabledByPlatform","commentDelayMs","commentDelays","pinTitle","pinLink","productUrl"],"additionalProperties":false},"selectedPlatforms":{"maxItems":8,"type":"array","items":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},"selectedChannelAccountIds":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"string","maxLength":200}},"selectedPublishingProfileId":{"type":"string","maxLength":200},"selectedMediaId":{"type":"string","maxLength":200},"publishMode":{"type":"string","enum":["now","schedule"]},"scheduleAt":{"type":"string","maxLength":100}},"required":["caption","title","content","selectedPlatforms","selectedChannelAccountIds","selectedPublishingProfileId","selectedMediaId","publishMode","scheduleAt"],"additionalProperties":false},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["draftId","organizationId","brandId","authorUserId","visibility","schemaVersion","contentVersion","payload","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]}},"required":["error","message","currentDraft"],"additionalProperties":false}}}},"413":{"description":"Draft payload exceeds the bounded storage contract."}}},"delete":{"tags":["Publishing"],"operationId":"deleteCurrentComposerDraft","summary":"Delete the exact private Create draft version after a saved post succeeds.","description":"The version precondition preserves a newer browser's workspace copy instead of deleting it after another browser publishes.","security":[{"dashboardSessionCookie":[]},{"dashboardSession":[]}],"parameters":[{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"brandId","in":"query","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"expectedContentVersion","in":"query","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Exact draft version was deleted, or no draft remained.","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean"},"contentVersion":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["deleted","contentVersion"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"description":"A newer workspace draft exists and was preserved.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","const":"composer_draft_conflict"},"message":{"type":"string"},"currentDraft":{"anyOf":[{"type":"object","properties":{"draftId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"authorUserId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"visibility":{"type":"string","const":"private"},"schemaVersion":{"type":"number","const":2},"contentVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"payload":{"type":"object","properties":{"caption":{"type":"string","maxLength":50000},"title":{"type":"string","maxLength":500},"content":{"type":"object","properties":{"bodyMode":{"type":"string","enum":["shared","platform"]},"bodies":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"string","maxLength":50000}},"commentsEnabled":{"type":"boolean"},"commentMode":{"type":"string","enum":["shared","platform"]},"sharedComment":{"type":"string","maxLength":50000},"comments":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"string","maxLength":50000}},"commentEnabledByPlatform":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"boolean"}},"commentDelayMs":{"type":"integer","minimum":0,"maximum":86400000},"commentDelays":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"integer","minimum":0,"maximum":86400000}},"pinTitle":{"type":"string","maxLength":500},"pinLink":{"type":"string","maxLength":2048},"productUrl":{"type":"string","maxLength":2048}},"required":["bodyMode","bodies","commentsEnabled","commentMode","sharedComment","comments","commentEnabledByPlatform","commentDelayMs","commentDelays","pinTitle","pinLink","productUrl"],"additionalProperties":false},"selectedPlatforms":{"maxItems":8,"type":"array","items":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},"selectedChannelAccountIds":{"type":"object","propertyNames":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"additionalProperties":{"type":"string","maxLength":200}},"selectedPublishingProfileId":{"type":"string","maxLength":200},"selectedMediaId":{"type":"string","maxLength":200},"publishMode":{"type":"string","enum":["now","schedule"]},"scheduleAt":{"type":"string","maxLength":100}},"required":["caption","title","content","selectedPlatforms","selectedChannelAccountIds","selectedPublishingProfileId","selectedMediaId","publishMode","scheduleAt"],"additionalProperties":false},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["draftId","organizationId","brandId","authorUserId","visibility","schemaVersion","contentVersion","payload","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]}},"required":["error","message","currentDraft"],"additionalProperties":false}}}}}}},"/v1/auth/me":{"get":{"tags":["Auth"],"operationId":"getDashboardBrowserSession","summary":"Read the current Dashboard browser-session context.","security":[{"dashboardSessionCookie":[]},{"dashboardSession":[]}],"responses":{"200":{"description":"Current Dashboard session and account context.","content":{"application/json":{"schema":{"type":"object","properties":{"session":{"type":"object","properties":{"sessionId":{"type":"string"},"userId":{"type":"string"},"expiresAt":{"type":"string"},"lastSeenAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"}},"required":["sessionId","userId","expiresAt","lastSeenAt","revokedAt","createdAt"],"additionalProperties":false},"account":{"type":"object","properties":{"user":{"type":"object","properties":{"userId":{"type":"string"},"email":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["userId","email","name"],"additionalProperties":false},"workspaces":{"type":"array","items":{"type":"object","properties":{"organizationId":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"timezone":{"type":"string"},"role":{"type":"string"},"brands":{"type":"array","items":{"type":"object","properties":{"brandId":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"timezone":{"type":"string"}},"required":["brandId","organizationId","name","slug","timezone"],"additionalProperties":false}}},"required":["organizationId","name","slug","timezone","role","brands"],"additionalProperties":false}}},"required":["user","workspaces"],"additionalProperties":false}},"required":["session","account"],"additionalProperties":false}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/auth/logout":{"post":{"tags":["Auth"],"operationId":"logoutDashboardBrowserSession","summary":"Revoke the current Dashboard session and clear its cookie.","security":[{"dashboardSessionCookie":[]},{"dashboardSession":[]}],"responses":{"200":{"description":"Current Dashboard session was revoked when active.","content":{"application/json":{"schema":{"type":"object","properties":{"revoked":{"type":"boolean"},"session":{"anyOf":[{"type":"object","properties":{"sessionId":{"type":"string"},"userId":{"type":"string"},"expiresAt":{"type":"string"},"lastSeenAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"}},"required":["sessionId","userId","expiresAt","lastSeenAt","revokedAt","createdAt"],"additionalProperties":false},{"type":"null"}]}},"required":["revoked","session"],"additionalProperties":false}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/auth/logout-all":{"post":{"tags":["Auth"],"operationId":"logoutAllDashboardBrowserSessions","summary":"Revoke all active Dashboard sessions for the current user.","security":[{"dashboardSessionCookie":[]},{"dashboardSession":[]}],"responses":{"200":{"description":"All active Dashboard sessions for the user were revoked.","content":{"application/json":{"schema":{"type":"object","properties":{"revokedSessionCount":{"type":"number"}},"required":["revokedSessionCount"],"additionalProperties":false}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/admin/bootstrap/first-admin":{"post":{"tags":["Auth"],"operationId":"bootstrapFirstAdmin","summary":"Create the first invited owner, organization, optional brand, and one Asset Manager API key.","security":[{"dashboardSession":[]}],"x-required-policy":"admin.db.migrate","x-env-gates":["CREAVILY_ALLOW_FIRST_ADMIN_BOOTSTRAP=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"name":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"googleProviderUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"organizationSlug":{"default":"ecom-stack","type":"string","minLength":1},"organizationName":{"default":"Ecom Stack","type":"string","minLength":1},"brandSlug":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"brandName":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"timezone":{"default":"America/Toronto","type":"string","minLength":1},"apiKeyName":{"default":"Asset Manager Agent","type":"string","minLength":1},"apiKeyScopes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["email"]}}}},"responses":{"200":{"description":"Created first admin resources and one-time API key.","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"userId":{"type":"string"},"membershipRole":{"type":"string"},"apiKey":{"type":"object","properties":{"apiKeyId":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"lastUsedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"apiKey":{"type":"string"},"preview":{"type":"string"}},"required":["apiKeyId","organizationId","name","scopes","lastUsedAt","createdAt","revokedAt","apiKey","preview"],"additionalProperties":false}},"required":["organizationId","brandId","userId","membershipRole","apiKey"],"additionalProperties":false}},"required":["result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/admin/db/migrate":{"post":{"tags":["Admin"],"operationId":"runDatabaseMigrations","summary":"Dry-run or apply the database migration inventory.","security":[{"dashboardSession":[]}],"x-required-policy":"admin.db.migrate","x-env-gates":["CREAVILY_ALLOW_DB_MIGRATIONS=true","CREAVILY_RELEASE_MIGRATION_APPROVED=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dryRun":{"default":true,"type":"boolean"}}}}}},"responses":{"200":{"description":"Dry-run migration inventory or applied migration result.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"migrations":{"type":"array","items":{"type":"object","properties":{"executionMode":{"type":"string","enum":["transactional","non_transactional","online"]},"lockRisk":{"type":"string","enum":["low","medium","high"]},"compatibility":{"type":"string","enum":["backward-compatible","expand-contract"]},"recovery":{"type":"string","enum":["transactional-rollback","retry-safe","manual-recovery"]},"id":{"type":"string"},"filePath":{"type":"string"},"checksum":{"type":"string"}},"required":["executionMode","lockRisk","compatibility","recovery","id","filePath","checksum"],"additionalProperties":false}}},"required":["mode","migrations"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"applied"},"result":{"type":"object","properties":{"migrations":{"type":"array","items":{"type":"object","properties":{"executionMode":{"type":"string","enum":["transactional","non_transactional","online"]},"lockRisk":{"type":"string","enum":["low","medium","high"]},"compatibility":{"type":"string","enum":["backward-compatible","expand-contract"]},"recovery":{"type":"string","enum":["transactional-rollback","retry-safe","manual-recovery"]},"schemaPhase":{"anyOf":[{"type":"string","enum":["expand","contract","none"]},{"type":"null"}]},"minimumAppVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"previousAppCompatible":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"destructive":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"requiresManualApproval":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"id":{"type":"string"},"checksum":{"type":"string"},"ledgerChecksum":{"anyOf":[{"type":"string"},{"type":"null"}]},"applied":{"type":"boolean"},"durationMs":{"anyOf":[{"type":"number"},{"type":"null"}]},"toolVersion":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["executionMode","lockRisk","compatibility","recovery","schemaPhase","minimumAppVersion","previousAppCompatible","destructive","requiresManualApproval","id","checksum","ledgerChecksum","applied","durationMs","toolVersion"],"additionalProperties":false}},"appliedCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["migrations","appliedCount"],"additionalProperties":false}},"required":["mode","result"],"additionalProperties":false}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/admin/provider-comment-webhooks/provision":{"post":{"tags":["Admin"],"operationId":"provisionProviderCommentWebhooks","summary":"Register provider app identities, webhook bindings, and explicit connected-account links.","security":[{"dashboardSession":[]},{"servicePrincipalToken":[]}],"x-required-policy":"admin.provider.webhook.provision","x-env-gates":["CREAVILY_ALLOW_PROVIDER_WEBHOOK_PROVISIONING=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"apps":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]},"name":{"type":"string","minLength":1,"maxLength":200},"clientId":{"type":"string","minLength":1,"maxLength":200},"secretRef":{"type":"string","pattern":"^(?:env|secret-manager|sm):[A-Za-z0-9._:/-]+$"}},"required":["platform","name","clientId","secretRef"],"additionalProperties":false}},"channelAccountIds":{"default":[],"maxItems":100,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["organizationId","apps"],"additionalProperties":false}}}},"responses":{"200":{"description":"Provisioned provider apps and webhook bindings.","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"apps":{"minItems":1,"type":"array","items":{"type":"object","properties":{"platformAppId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","threads","x"]},"name":{"type":"string"},"clientId":{"type":"string"},"bindingId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["platformAppId","platform","name","clientId","bindingId"],"additionalProperties":false}},"linkedChannelAccountIds":{"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}},"required":["apps","linkedChannelAccountIds"],"additionalProperties":false}},"required":["result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/webhooks/deliveries":{"post":{"tags":["Webhooks"],"operationId":"deliverInternalWebhook","summary":"Dry-run or deliver one internal webhook payload.","security":[{"internalServiceToken":[]}],"x-env-gates":["CREAVILY_ALLOW_WEBHOOK_DELIVERY=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"endpointId":{"type":"string","minLength":1},"organizationId":{"type":"string","minLength":1},"url":{"type":"string","minLength":1},"eventType":{"type":"string","minLength":1},"payload":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"secret":{"type":"string","minLength":1},"timeoutMs":{"default":10000,"type":"integer","minimum":100,"maximum":30000},"dryRun":{"default":true,"type":"boolean"}},"required":["endpointId","organizationId","url","eventType"]}}}},"responses":{"200":{"description":"Dry-run safety result or webhook delivery result.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"safe":{"type":"boolean","const":true},"url":{"type":"string"},"hostname":{"type":"string"},"protocol":{"type":"string"},"resolvedAddressCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["mode","safe","url","hostname","protocol","resolvedAddressCount"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"delivered"},"result":{"type":"object","properties":{"endpointId":{"type":"string"},"organizationId":{"type":"string"},"eventType":{"type":"string"},"targetUrl":{"type":"string"},"status":{"type":"string","enum":["delivered","failed"]},"responseStatus":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"responseBodyExcerpt":{"type":"string"},"deliveredAt":{"type":"string"}},"required":["endpointId","organizationId","eventType","targetUrl","status","responseStatus","responseBodyExcerpt","deliveredAt"],"additionalProperties":false}},"required":["mode","result"],"additionalProperties":false}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/automations/sources/due/enqueue":{"post":{"tags":["Automations"],"operationId":"enqueueInternalDueAutomationSources","summary":"Dry-run or enqueue due automation source polls for an internal caller.","security":[{"internalServiceToken":[]}],"x-required-policy":"automations.scheduler.enqueue","x-env-gates":["CREAVILY_ALLOW_AUTOMATION_POLL_ENQUEUE=true","CREAVILY_ALLOW_AUTOMATION_WRITE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"type":{"default":"rss","type":"string","enum":["rss","asset_manager","agent"]},"limit":{"default":100,"type":"integer","minimum":1,"maximum":500},"dryRun":{"default":true,"type":"boolean"},"createPublishJobs":{"default":false,"type":"boolean"},"enqueuePublishJobs":{"default":false,"type":"boolean"},"actorUserId":{"type":"string","minLength":1},"now":{"type":"string","minLength":1}},"required":["organizationId"]}}}},"responses":{"200":{"description":"Dry-run source list or queued automation run result.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"sourceCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sources":{"type":"array","items":{"type":"object","properties":{"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["rss","asset_manager","agent"]},"name":{"type":"string"},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"pollIntervalMinutes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"lastCheckedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"nextPollAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["automationSourceId","organizationId","brandId","type","name","config","state","enabled","createdAt","updatedAt","deletedAt","pollIntervalMinutes","lastCheckedAt","nextPollAt"],"additionalProperties":false}}},"required":["mode","sourceCount","sources"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"enqueued"},"sourceCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"runCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sources":{"type":"array","items":{"type":"object","properties":{"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["rss","asset_manager","agent"]},"name":{"type":"string"},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"pollIntervalMinutes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"lastCheckedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"nextPollAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["automationSourceId","organizationId","brandId","type","name","config","state","enabled","createdAt","updatedAt","deletedAt","pollIntervalMinutes","lastCheckedAt","nextPollAt"],"additionalProperties":false}},"runs":{"type":"array","items":{"type":"object","properties":{"automationRunId":{"type":"string"},"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","failed","cancelled"]},"trigger":{"type":"string","enum":["manual","schedule","source_poll","webhook","agent"]},"input":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"output":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["automationRunId","automationSourceId","organizationId","status","trigger","input","output","errorCode","errorMessage","idempotencyKey","startedAt","completedAt","createdAt","updatedAt"],"additionalProperties":false}},"enqueued":{"type":"array","items":{"type":"object","properties":{"automationRunId":{"type":"string"},"queueJobId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["automationRunId","queueJobId"],"additionalProperties":false}}},"required":["mode","sourceCount","runCount","sources","runs","enqueued"],"additionalProperties":false}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/bridges/postiz/handoff/preview":{"post":{"tags":["Bridges"],"operationId":"previewInternalPostizHandoff","summary":"Preview a Postiz handoff for an internal caller.","security":[{"internalServiceToken":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"plan":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"productId":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"targets":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"text":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["platform","channelAccountId"]}},"scheduleAt":{"type":"string"}},"required":["organizationId","brandId","text","media","targets"]},"uploadedMedia":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"path":{"type":"string","minLength":1},"name":{"type":"string"}},"required":["id","path"]}},"integrationMappings":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"postizIntegrationId":{"type":"string","minLength":1}},"required":["platform","channelAccountId","postizIntegrationId"]}},"mode":{"type":"string","enum":["draft","now","schedule"]},"shortLink":{"type":"boolean"},"date":{"type":"string"},"tags":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","minLength":1},"label":{"type":"string","minLength":1}},"required":["value","label"]}}},"required":["plan","uploadedMedia","integrationMappings"]}}}},"responses":{"200":{"description":"Postiz handoff preview.","content":{"application/json":{"schema":{"type":"object","properties":{"payload":{"type":"object","properties":{"type":{"type":"string","enum":["draft","now","schedule"]},"shortLink":{"type":"boolean"},"date":{"type":"string"},"tags":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"}},"required":["value","label"],"additionalProperties":false}},"posts":{"type":"array","items":{"type":"object","properties":{"integration":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false},"value":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"path":{"type":"string"},"name":{"type":"string"},"size":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","path"],"additionalProperties":false}}},"required":["content","image"],"additionalProperties":false}},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["integration","value","settings"],"additionalProperties":false}}},"required":["type","shortLink","date","tags","posts"],"additionalProperties":false},"readyTargets":{"type":"array","items":{"type":"object","properties":{"targetId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string"},"postizIntegrationId":{"type":"string"}},"required":["targetId","platform","channelAccountId","postizIntegrationId"],"additionalProperties":false}},"blockedTargets":{"type":"array","items":{"type":"object","properties":{"targetId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string"},"reason":{"type":"string","enum":["missing_integration_mapping","validation_error"]},"message":{"type":"string"}},"required":["targetId","platform","channelAccountId","reason","message"],"additionalProperties":false}}},"required":["payload","readyTargets","blockedTargets"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/bridges/postiz/execute":{"post":{"tags":["Bridges"],"operationId":"executeInternalPostizHandoff","summary":"Dry-run a Postiz handoff for an internal caller.","security":[{"internalServiceToken":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"plan":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"productId":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"targets":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"text":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["platform","channelAccountId"]}},"scheduleAt":{"type":"string"}},"required":["organizationId","brandId","text","media","targets"]},"localMedia":{"type":"array","items":{"type":"object","properties":{"filePath":{"type":"string","minLength":1},"mimeType":{"type":"string","minLength":1},"fileName":{"type":"string","minLength":1}},"required":["filePath","mimeType"]}},"integrationMappings":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"postizIntegrationId":{"type":"string","minLength":1}},"required":["platform","channelAccountId","postizIntegrationId"]}},"mode":{"type":"string","enum":["draft","now","schedule"]},"shortLink":{"type":"boolean"},"date":{"type":"string"},"tags":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string","minLength":1},"label":{"type":"string","minLength":1}},"required":["value","label"]}},"dryRun":{"default":true,"type":"boolean"}},"required":["plan","localMedia","integrationMappings"]}}}},"responses":{"200":{"description":"Dry-run Postiz handoff result.","content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"uploadedMedia":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"path":{"type":"string"},"name":{"type":"string"},"size":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","path"],"additionalProperties":false}},"preview":{"type":"object","properties":{"payload":{"type":"object","properties":{"type":{"type":"string","enum":["draft","now","schedule"]},"shortLink":{"type":"boolean"},"date":{"type":"string"},"tags":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"label":{"type":"string"}},"required":["value","label"],"additionalProperties":false}},"posts":{"type":"array","items":{"type":"object","properties":{"integration":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"],"additionalProperties":false},"value":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string"},"image":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"path":{"type":"string"},"name":{"type":"string"},"size":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","path"],"additionalProperties":false}}},"required":["content","image"],"additionalProperties":false}},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["integration","value","settings"],"additionalProperties":false}}},"required":["type","shortLink","date","tags","posts"],"additionalProperties":false},"readyTargets":{"type":"array","items":{"type":"object","properties":{"targetId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string"},"postizIntegrationId":{"type":"string"}},"required":["targetId","platform","channelAccountId","postizIntegrationId"],"additionalProperties":false}},"blockedTargets":{"type":"array","items":{"type":"object","properties":{"targetId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string"},"reason":{"type":"string","enum":["missing_integration_mapping","validation_error"]},"message":{"type":"string"}},"required":["targetId","platform","channelAccountId","reason","message"],"additionalProperties":false}}},"required":["payload","readyTargets","blockedTargets"],"additionalProperties":false},"createPostResponse":{"type":"null"}},"required":["mode","uploadedMedia","preview","createPostResponse"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/developer/api-keys":{"get":{"tags":["Developer"],"operationId":"listDashboardDeveloperApiKeys","summary":"List API keys for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"developer.api_keys.manage","x-env-gates":["CREAVILY_ALLOW_API_KEY_WRITE=true"],"parameters":[{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"includeRevoked","in":"query","required":false,"schema":{"default":false,"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Workspace API keys without secret material.","content":{"application/json":{"schema":{"type":"object","properties":{"apiKeys":{"type":"array","items":{"type":"object","properties":{"apiKeyId":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"lastUsedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["apiKeyId","organizationId","name","scopes","lastUsedAt","createdAt","revokedAt"],"additionalProperties":false}}},"required":["apiKeys"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/ServerError"}}},"post":{"tags":["Developer"],"operationId":"createDashboardDeveloperApiKey","summary":"Create an API key for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"developer.api_keys.manage","x-env-gates":["CREAVILY_ALLOW_API_KEY_WRITE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"scopes":{"default":["assets:read"],"type":"array","items":{"type":"string","enum":["*","assets:read","assets:write","brands:read","channels:read","channels:write","media:read","media:write","publishing:read","publishing:write","agent:publish","webhooks:read","webhooks:write","analytics:read","automation:read","automation:write","admin:write"]}},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId","name"]}}}},"responses":{"200":{"description":"Created API key with its one-time secret.","content":{"application/json":{"schema":{"type":"object","properties":{"apiKey":{"type":"object","properties":{"apiKeyId":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"lastUsedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"apiKey":{"type":"string"},"preview":{"type":"string"}},"required":["apiKeyId","organizationId","name","scopes","lastUsedAt","createdAt","revokedAt","apiKey","preview"],"additionalProperties":false}},"required":["apiKey"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/developer/api-keys/{apiKeyId}":{"delete":{"tags":["Developer"],"operationId":"revokeDashboardDeveloperApiKey","summary":"Revoke an API key for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"developer.api_keys.manage","x-env-gates":["CREAVILY_ALLOW_API_KEY_WRITE=true"],"parameters":[{"name":"apiKeyId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId"]}}}},"responses":{"200":{"description":"Revoked API key.","content":{"application/json":{"schema":{"type":"object","properties":{"apiKey":{"type":"object","properties":{"apiKeyId":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"lastUsedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["apiKeyId","organizationId","name","scopes","lastUsedAt","createdAt","revokedAt"],"additionalProperties":false}},"required":["apiKey"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/developer/oauth-apps":{"get":{"tags":["Developer"],"operationId":"listDashboardDeveloperOAuthApps","summary":"List OAuth apps for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"developer.oauth_apps.manage","x-env-gates":["CREAVILY_ALLOW_OAUTH_APP_WRITE=true"],"parameters":[{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"includeRevoked","in":"query","required":false,"schema":{"default":false,"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Workspace OAuth apps without client secrets.","content":{"application/json":{"schema":{"type":"object","properties":{"oauthApps":{"type":"array","items":{"type":"object","properties":{"oauthAppId":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"clientId":{"type":"string"},"clientSecretRef":{"type":"string"},"redirectUris":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["oauthAppId","organizationId","name","clientId","clientSecretRef","redirectUris","createdAt","updatedAt","revokedAt"],"additionalProperties":false}}},"required":["oauthApps"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/ServerError"}}},"post":{"tags":["Developer"],"operationId":"createDashboardDeveloperOAuthApp","summary":"Create an OAuth app for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"developer.oauth_apps.manage","x-env-gates":["CREAVILY_ALLOW_OAUTH_APP_WRITE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"clientSecretRef":{"type":"string","minLength":1},"redirectUris":{"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId","name","clientSecretRef","redirectUris"]}}}},"responses":{"200":{"description":"Created OAuth app.","content":{"application/json":{"schema":{"type":"object","properties":{"oauthApp":{"type":"object","properties":{"oauthAppId":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"clientId":{"type":"string"},"clientSecretRef":{"type":"string"},"redirectUris":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["oauthAppId","organizationId","name","clientId","clientSecretRef","redirectUris","createdAt","updatedAt","revokedAt"],"additionalProperties":false}},"required":["oauthApp"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/developer/oauth-apps/{oauthAppId}":{"patch":{"tags":["Developer"],"operationId":"updateDashboardDeveloperOAuthApp","summary":"Update an OAuth app for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"developer.oauth_apps.manage","x-env-gates":["CREAVILY_ALLOW_OAUTH_APP_WRITE=true"],"parameters":[{"name":"oauthAppId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"clientSecretRef":{"type":"string","minLength":1},"redirectUris":{"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId"],"anyOf":[{"required":["name"]},{"required":["clientSecretRef"]},{"required":["redirectUris"]}]}}}},"responses":{"200":{"description":"Updated OAuth app.","content":{"application/json":{"schema":{"type":"object","properties":{"oauthApp":{"type":"object","properties":{"oauthAppId":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"clientId":{"type":"string"},"clientSecretRef":{"type":"string"},"redirectUris":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["oauthAppId","organizationId","name","clientId","clientSecretRef","redirectUris","createdAt","updatedAt","revokedAt"],"additionalProperties":false}},"required":["oauthApp"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServerError"}}},"delete":{"tags":["Developer"],"operationId":"revokeDashboardDeveloperOAuthApp","summary":"Revoke an OAuth app for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"developer.oauth_apps.manage","x-env-gates":["CREAVILY_ALLOW_OAUTH_APP_WRITE=true"],"parameters":[{"name":"oauthAppId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId"]}}}},"responses":{"200":{"description":"Revoked OAuth app.","content":{"application/json":{"schema":{"type":"object","properties":{"oauthApp":{"type":"object","properties":{"oauthAppId":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"clientId":{"type":"string"},"clientSecretRef":{"type":"string"},"redirectUris":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["oauthAppId","organizationId","name","clientId","clientSecretRef","redirectUris","createdAt","updatedAt","revokedAt"],"additionalProperties":false}},"required":["oauthApp"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/developer/oauth-authorizations":{"get":{"tags":["Developer"],"operationId":"listDashboardDeveloperOAuthAuthorizations","summary":"List OAuth authorization grants for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"developer.oauth_grants.manage","x-env-gates":["CREAVILY_ALLOW_OAUTH_TOKEN_WRITE=true"],"parameters":[{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"includeRevoked","in":"query","required":false,"schema":{"default":false,"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Workspace OAuth authorization grants.","content":{"application/json":{"schema":{"type":"object","properties":{"oauthAuthorizations":{"type":"array","items":{"type":"object","properties":{"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"organizationId":{"type":"string"},"userId":{"type":"string"},"appName":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["authorizationId","oauthAppId","organizationId","userId","appName","clientId","scopes","createdAt","revokedAt"],"additionalProperties":false}}},"required":["oauthAuthorizations"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/ServerError"}}},"post":{"tags":["Developer"],"operationId":"createDashboardDeveloperOAuthAuthorization","summary":"Create an OAuth authorization grant for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"developer.oauth_grants.manage","x-env-gates":["CREAVILY_ALLOW_OAUTH_TOKEN_WRITE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"oauthAppId":{"type":"string","minLength":1},"userId":{"type":"string","minLength":1},"redirectUri":{"type":"string","minLength":1},"scopes":{"default":["assets:read"],"type":"array","items":{"type":"string","enum":["*","assets:read","assets:write","brands:read","channels:read","channels:write","media:read","media:write","publishing:read","publishing:write","agent:publish","webhooks:read","webhooks:write","analytics:read","automation:read","automation:write","admin:write"]}},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"codeExpiresInSeconds":{"default":600,"type":"integer","minimum":60,"maximum":3600}},"required":["organizationId","oauthAppId","userId","redirectUri"]}}}},"responses":{"200":{"description":"Created OAuth authorization grant.","content":{"application/json":{"schema":{"type":"object","properties":{"oauthAuthorization":{"type":"object","properties":{"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"organizationId":{"type":"string"},"userId":{"type":"string"},"appName":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorizationCode":{"type":"string"},"codeExpiresAt":{"type":"string"},"redirectUri":{"type":"string"}},"required":["authorizationId","oauthAppId","organizationId","userId","appName","clientId","scopes","createdAt","revokedAt","authorizationCode","codeExpiresAt","redirectUri"],"additionalProperties":false}},"required":["oauthAuthorization"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/developer/oauth-authorizations/{authorizationId}":{"delete":{"tags":["Developer"],"operationId":"revokeDashboardDeveloperOAuthAuthorization","summary":"Revoke an OAuth authorization grant for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"developer.oauth_grants.manage","x-env-gates":["CREAVILY_ALLOW_OAUTH_TOKEN_WRITE=true"],"parameters":[{"name":"authorizationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId"]}}}},"responses":{"200":{"description":"Revoked OAuth authorization grant.","content":{"application/json":{"schema":{"type":"object","properties":{"oauthAuthorization":{"type":"object","properties":{"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"organizationId":{"type":"string"},"userId":{"type":"string"},"appName":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["authorizationId","oauthAppId","organizationId","userId","appName","clientId","scopes","createdAt","revokedAt"],"additionalProperties":false}},"required":["oauthAuthorization"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/developer/oauth-tokens/exchange":{"post":{"tags":["Developer"],"operationId":"exchangeDashboardDeveloperOAuthToken","summary":"Exchange a dashboard-managed OAuth authorization code.","security":[{"dashboardSession":[]}],"x-required-policy":"developer.oauth_tokens.exchange","x-env-gates":["CREAVILY_ALLOW_OAUTH_TOKEN_WRITE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"clientId":{"type":"string","minLength":1},"authorizationCode":{"type":"string","minLength":1},"redirectUri":{"type":"string","minLength":1},"accessTokenExpiresInSeconds":{"default":3600,"type":"integer","minimum":300,"maximum":86400},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId","clientId","authorizationCode","redirectUri"]}}}},"responses":{"200":{"description":"OAuth access and refresh token result.","content":{"application/json":{"schema":{"type":"object","properties":{"oauthToken":{"type":"object","properties":{"accessToken":{"type":"string"},"tokenType":{"type":"string","const":"Bearer"},"expiresInSeconds":{"type":"number"},"expiresAt":{"type":"string"},"refreshToken":{"type":"string"},"refreshExpiresInSeconds":{"type":"number"},"refreshExpiresAt":{"type":"string"},"authorization":{"type":"object","properties":{"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"organizationId":{"type":"string"},"userId":{"type":"string"},"appName":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"createdAt":{"type":"string"},"revokedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["authorizationId","oauthAppId","organizationId","userId","appName","clientId","scopes","createdAt","revokedAt"],"additionalProperties":false}},"required":["accessToken","tokenType","expiresInSeconds","expiresAt","refreshToken","refreshExpiresInSeconds","refreshExpiresAt","authorization"],"additionalProperties":false}},"required":["oauthToken"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/webhooks/endpoints":{"get":{"tags":["Webhooks"],"operationId":"listDashboardWebhookEndpoints","summary":"List webhook endpoints for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"webhooks.endpoints.manage","x-env-gates":["CREAVILY_ALLOW_WEBHOOK_WRITE=true"],"parameters":[{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"includeDisabled","in":"query","required":false,"schema":{"default":true,"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Workspace webhook endpoints without secret material.","content":{"application/json":{"schema":{"type":"object","properties":{"endpoints":{"type":"array","items":{"type":"object","properties":{"webhookEndpointId":{"type":"string"},"organizationId":{"type":"string"},"url":{"type":"string"},"secretRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"events":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["webhookEndpointId","organizationId","url","secretRef","events","enabled","createdAt","updatedAt","deletedAt"],"additionalProperties":false}}},"required":["endpoints"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/ServerError"}}},"post":{"tags":["Webhooks"],"operationId":"createDashboardWebhookEndpoint","summary":"Create a webhook endpoint for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"webhooks.endpoints.manage","x-env-gates":["CREAVILY_ALLOW_WEBHOOK_WRITE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"url":{"type":"string","minLength":1},"secretRef":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"events":{"default":[],"type":"array","items":{"type":"string","minLength":1}},"enabled":{"default":true,"type":"boolean"},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId","url"]}}}},"responses":{"200":{"description":"Created webhook endpoint.","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"object","properties":{"webhookEndpointId":{"type":"string"},"organizationId":{"type":"string"},"url":{"type":"string"},"secretRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"events":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["webhookEndpointId","organizationId","url","secretRef","events","enabled","createdAt","updatedAt","deletedAt"],"additionalProperties":false}},"required":["endpoint"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/webhooks/endpoints/{endpointId}":{"patch":{"tags":["Webhooks"],"operationId":"updateDashboardWebhookEndpoint","summary":"Update a webhook endpoint for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"webhooks.endpoints.manage","x-env-gates":["CREAVILY_ALLOW_WEBHOOK_WRITE=true"],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"url":{"type":"string","minLength":1},"secretRef":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"events":{"type":"array","items":{"type":"string","minLength":1}},"enabled":{"type":"boolean"},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId"]}}}},"responses":{"200":{"description":"Updated webhook endpoint.","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"object","properties":{"webhookEndpointId":{"type":"string"},"organizationId":{"type":"string"},"url":{"type":"string"},"secretRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"events":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["webhookEndpointId","organizationId","url","secretRef","events","enabled","createdAt","updatedAt","deletedAt"],"additionalProperties":false}},"required":["endpoint"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServerError"}}},"delete":{"tags":["Webhooks"],"operationId":"deleteDashboardWebhookEndpoint","summary":"Delete a webhook endpoint for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"webhooks.endpoints.manage","x-env-gates":["CREAVILY_ALLOW_WEBHOOK_WRITE=true"],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId"]}}}},"responses":{"200":{"description":"Deleted webhook endpoint.","content":{"application/json":{"schema":{"type":"object","properties":{"endpoint":{"type":"object","properties":{"webhookEndpointId":{"type":"string"},"organizationId":{"type":"string"},"url":{"type":"string"},"secretRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"events":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["webhookEndpointId","organizationId","url","secretRef","events","enabled","createdAt","updatedAt","deletedAt"],"additionalProperties":false}},"required":["endpoint"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/webhooks/deliveries/enqueue":{"post":{"tags":["Webhooks"],"operationId":"enqueueDashboardWebhookDeliveries","summary":"Create delivery targets for a dashboard webhook event.","security":[{"dashboardSession":[]}],"x-required-policy":"webhooks.deliveries.manage","x-env-gates":["CREAVILY_ALLOW_WEBHOOK_WRITE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"eventType":{"type":"string","minLength":1},"payload":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId","eventType"]}}}},"responses":{"200":{"description":"Created webhook delivery targets.","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"deliveryIds":{"type":"array","items":{"type":"string"}},"endpointCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["deliveryIds","endpointCount"],"additionalProperties":false}},"required":["result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/webhooks/deliveries/queued":{"get":{"tags":["Webhooks"],"operationId":"listDashboardQueuedWebhookDeliveries","summary":"List queued webhook deliveries for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"webhooks.deliveries.manage","x-env-gates":["CREAVILY_ALLOW_WEBHOOK_WRITE=true"],"parameters":[{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"maxAttempts","in":"query","required":false,"schema":{"default":3,"type":"integer","minimum":1,"maximum":10}}],"responses":{"200":{"description":"Queued webhook deliveries.","content":{"application/json":{"schema":{"type":"object","properties":{"deliveries":{"type":"array","items":{"type":"object","properties":{"deliveryId":{"type":"string"},"endpointId":{"type":"string"},"organizationId":{"type":"string"},"url":{"type":"string"},"secretRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"eventType":{"type":"string"},"payload":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"attempts":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["deliveryId","endpointId","organizationId","url","secretRef","eventType","payload","attempts"],"additionalProperties":false}}},"required":["deliveries"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/webhooks/deliveries/queued/enqueue":{"post":{"tags":["Webhooks"],"operationId":"enqueueDashboardQueuedWebhookDeliveries","summary":"Enqueue queued webhook deliveries for background dispatch.","security":[{"dashboardSession":[]}],"x-required-policy":"webhooks.deliveries.manage","x-env-gates":["CREAVILY_ALLOW_WEBHOOK_ENQUEUE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"actorUserId":{"type":"string","minLength":1},"limit":{"default":100,"type":"integer","minimum":1,"maximum":500},"maxAttempts":{"default":3,"type":"integer","minimum":1,"maximum":10}},"required":["organizationId"]}}}},"responses":{"200":{"description":"Enqueued queued webhook deliveries.","content":{"application/json":{"schema":{"type":"object","properties":{"targetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"enqueued":{"type":"array","items":{"type":"object","properties":{"deliveryId":{"type":"string"},"endpointId":{"type":"string"},"eventType":{"type":"string"},"queueJobId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["deliveryId","endpointId","eventType","queueJobId"],"additionalProperties":false}}},"required":["targetCount","enqueued"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/webhooks/deliveries/{deliveryId}/attempts":{"post":{"tags":["Webhooks"],"operationId":"recordDashboardWebhookDeliveryAttempt","summary":"Record a webhook delivery attempt for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"webhooks.deliveries.manage","x-env-gates":["CREAVILY_ALLOW_WEBHOOK_WRITE=true"],"parameters":[{"name":"deliveryId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"executionId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["delivered","failed"]},"errorCode":{"anyOf":[{"type":"string","pattern":"^[a-z][a-z0-9_]{2,95}$"},{"type":"null"}]},"responseStatus":{"anyOf":[{"type":"integer","minimum":100,"maximum":599},{"type":"null"}]},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId","executionId","status"]}}}},"responses":{"200":{"description":"Recorded webhook delivery attempt.","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"deliveryId":{"type":"string"},"status":{"type":"string","enum":["delivered","failed"]},"attempts":{"type":"integer","minimum":0,"maximum":9007199254740991},"lastError":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"}},"required":["deliveryId","status","attempts","lastError","updatedAt"],"additionalProperties":false}},"required":["result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/assets/scorecard/preview":{"post":{"tags":["Assets"],"operationId":"previewDashboardAssetScorecard","summary":"Preview an asset scorecard from CSV input.","security":[{"dashboardSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"csvText":{"type":"string","minLength":1},"productSlug":{"type":"string"},"preferredMode":{"type":"string","enum":["portrait_4x5","square_1x1"]}},"required":["csvText"]}}}},"responses":{"200":{"description":"Asset scorecard preview.","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer","minimum":0,"maximum":9007199254740991},"queueEligible":{"type":"integer","minimum":0,"maximum":9007199254740991},"alreadyPublished":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"array","items":{"type":"object","properties":{"rowNumber":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"imageId":{"type":"string"},"productSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"variantLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"adminRating":{"anyOf":[{"type":"string","enum":["bad","ok","good","awesome"]},{"type":"null"}]},"agentRating":{"anyOf":[{"type":"string"},{"type":"null"}]},"autoPublishEligible":{"type":"boolean"},"queueEligible":{"type":"boolean"},"socialSwitch":{"type":"string","enum":["on","off"]},"publishEvidence":{"anyOf":[{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"targetStatus":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"providerPostId":{"type":"string"},"releaseId":{"type":"string"},"releaseUrl":{"type":"string"},"publishedAt":{"type":"string"}},"required":["platform","targetStatus"],"additionalProperties":false},{"type":"null"}]},"raw":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"files":{"type":"array","items":{"type":"object","properties":{"mode":{"type":"string","enum":["portrait_4x5","square_1x1"]},"role":{"type":"string","enum":["original","webp","processed","processed_webp"]},"path":{"type":"string"}},"required":["mode","role","path"],"additionalProperties":false}}},"required":["rowNumber","imageId","productSlug","variantLabel","adminRating","agentRating","autoPublishEligible","queueEligible","socialSwitch","publishEvidence","raw","files"],"additionalProperties":false}}},"required":["total","queueEligible","alreadyPublished","assets"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/assets/asset-manager/scan":{"get":{"tags":["Assets"],"operationId":"scanDashboardAssetManager","summary":"Scan an Asset Manager source root without importing assets.","security":[{"dashboardSession":[]}],"parameters":[{"name":"maxProducts","in":"query","required":false,"schema":{"default":25,"type":"integer","minimum":1,"maximum":200}},{"name":"maxAssetsPerProduct","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"organizationSlug","in":"query","required":false,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Asset Manager scan result.","content":{"application/json":{"schema":{"type":"object","properties":{"root":{"type":"string"},"scannedAt":{"type":"string"},"totalProducts":{"type":"integer","minimum":0,"maximum":9007199254740991},"totalAssets":{"type":"integer","minimum":0,"maximum":9007199254740991},"queueEligibleAssets":{"type":"integer","minimum":0,"maximum":9007199254740991},"alreadyPublishedAssets":{"type":"integer","minimum":0,"maximum":9007199254740991},"missingFileCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"products":{"type":"array","items":{"type":"object","properties":{"brandName":{"type":"string"},"productName":{"type":"string"},"productSlug":{"type":"string"},"productRoot":{"type":"string"},"scorecardPath":{"type":"string"},"analysisPath":{"anyOf":[{"type":"string"},{"type":"null"}]},"analysisExcerpt":{"anyOf":[{"type":"string"},{"type":"null"}]},"totalAssets":{"type":"integer","minimum":0,"maximum":9007199254740991},"queueEligibleAssets":{"type":"integer","minimum":0,"maximum":9007199254740991},"alreadyPublishedAssets":{"type":"integer","minimum":0,"maximum":9007199254740991},"missingFileCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"duplicateImageIds":{"type":"array","items":{"type":"string"}},"assets":{"type":"array","items":{"type":"object","properties":{"rowNumber":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"imageId":{"type":"string"},"productSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"variantLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"adminRating":{"anyOf":[{"type":"string","enum":["bad","ok","good","awesome"]},{"type":"null"}]},"agentRating":{"anyOf":[{"type":"string"},{"type":"null"}]},"autoPublishEligible":{"type":"boolean"},"queueEligible":{"type":"boolean"},"socialSwitch":{"type":"string","enum":["on","off"]},"publishEvidence":{"anyOf":[{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"targetStatus":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"providerPostId":{"type":"string"},"releaseId":{"type":"string"},"releaseUrl":{"type":"string"},"publishedAt":{"type":"string"}},"required":["platform","targetStatus"],"additionalProperties":false},{"type":"null"}]},"raw":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"files":{"type":"array","items":{"type":"object","properties":{"mode":{"type":"string","enum":["portrait_4x5","square_1x1"]},"role":{"type":"string","enum":["original","webp","processed","processed_webp"]},"path":{"type":"string"},"absolutePath":{"type":"string"},"exists":{"type":"boolean"},"bytes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["mode","role","path","absolutePath","exists","bytes","sha256"],"additionalProperties":false}}},"required":["rowNumber","imageId","productSlug","variantLabel","adminRating","agentRating","autoPublishEligible","queueEligible","socialSwitch","publishEvidence","raw","files"],"additionalProperties":false}}},"required":["brandName","productName","productSlug","productRoot","scorecardPath","analysisPath","analysisExcerpt","totalAssets","queueEligibleAssets","alreadyPublishedAssets","missingFileCount","duplicateImageIds","assets"],"additionalProperties":false}}},"required":["root","scannedAt","totalProducts","totalAssets","queueEligibleAssets","alreadyPublishedAssets","missingFileCount","products"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/assets/asset-manager/import":{"post":{"tags":["Assets"],"operationId":"importDashboardAssetManager","summary":"Preview or import an Asset Manager batch for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-env-gates":["CREAVILY_ALLOW_DB_IMPORT=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"maxProducts":{"default":25,"type":"integer","minimum":1,"maximum":200},"maxAssetsPerProduct":{"default":100,"type":"integer","minimum":1,"maximum":500},"organizationSlug":{"default":"ecom-stack","type":"string","minLength":1},"organizationName":{"type":"string","minLength":1},"timezone":{"default":"UTC","type":"string","minLength":1},"persist":{"default":false,"type":"boolean"}}}}}},"responses":{"200":{"description":"Asset Manager import preview or result.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"scan":{"type":"object","properties":{"root":{"type":"string"},"totalProducts":{"type":"integer","minimum":0,"maximum":9007199254740991},"totalAssets":{"type":"integer","minimum":0,"maximum":9007199254740991},"queueEligibleAssets":{"type":"integer","minimum":0,"maximum":9007199254740991},"alreadyPublishedAssets":{"type":"integer","minimum":0,"maximum":9007199254740991},"missingFileCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["root","totalProducts","totalAssets","queueEligibleAssets","alreadyPublishedAssets","missingFileCount"],"additionalProperties":false},"batch":{"type":"object","properties":{"organization":{"type":"object","properties":{"key":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"timezone":{"type":"string"}},"required":["key","slug","name","timezone"],"additionalProperties":false},"brands":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"organizationKey":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"}},"required":["key","organizationKey","slug","name"],"additionalProperties":false}},"products":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"brandKey":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"productRoot":{"type":"string"},"scorecardPath":{"type":"string"},"analysisPath":{"anyOf":[{"type":"string"},{"type":"null"}]},"analysisExcerpt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["key","brandKey","slug","name","productRoot","scorecardPath","analysisPath","analysisExcerpt"],"additionalProperties":false}},"assets":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"organizationKey":{"type":"string"},"brandKey":{"type":"string"},"productKey":{"type":"string"},"externalImageId":{"type":"string"},"sourceRowNumber":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sourceScorecardPath":{"type":"string"},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["key","organizationKey","brandKey","productKey","externalImageId","sourceRowNumber","sourceScorecardPath","metadata"],"additionalProperties":false}},"assetFiles":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"assetKey":{"type":"string"},"mode":{"type":"string","enum":["portrait_4x5","square_1x1"]},"role":{"type":"string","enum":["original","webp","processed","processed_webp"]},"originalPath":{"type":"string"},"bytes":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["key","assetKey","mode","role","originalPath","bytes","sha256","metadata"],"additionalProperties":false}},"assetReviews":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"assetKey":{"type":"string"},"state":{"type":"string","enum":["planned","generated","needs_review","approved","rejected","needs_regeneration"]},"adminRating":{"anyOf":[{"type":"string","enum":["bad","ok","good","awesome"]},{"type":"null"}]},"agentRating":{"anyOf":[{"type":"string"},{"type":"null"}]},"safeZonePassed":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["key","assetKey","state","adminRating","agentRating","safeZonePassed","notes"],"additionalProperties":false}},"assetPublishEvidence":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"assetKey":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"targetStatus":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"providerPostId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["key","assetKey","platform","targetStatus","providerPostId","releaseId","releaseUrl","publishedAt","metadata"],"additionalProperties":false}},"summary":{"type":"object","properties":{"brands":{"type":"integer","minimum":0,"maximum":9007199254740991},"products":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"integer","minimum":0,"maximum":9007199254740991},"assetFiles":{"type":"integer","minimum":0,"maximum":9007199254740991},"assetReviews":{"type":"integer","minimum":0,"maximum":9007199254740991},"assetPublishEvidence":{"type":"integer","minimum":0,"maximum":9007199254740991},"duplicateImageIds":{"type":"integer","minimum":0,"maximum":9007199254740991},"missingFiles":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["brands","products","assets","assetFiles","assetReviews","assetPublishEvidence","duplicateImageIds","missingFiles"],"additionalProperties":false}},"required":["organization","brands","products","assets","assetFiles","assetReviews","assetPublishEvidence","summary"],"additionalProperties":false}},"required":["mode","scan","batch"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"persisted"},"scan":{"type":"object","properties":{"root":{"type":"string"},"totalProducts":{"type":"integer","minimum":0,"maximum":9007199254740991},"totalAssets":{"type":"integer","minimum":0,"maximum":9007199254740991},"queueEligibleAssets":{"type":"integer","minimum":0,"maximum":9007199254740991},"alreadyPublishedAssets":{"type":"integer","minimum":0,"maximum":9007199254740991},"missingFileCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["root","totalProducts","totalAssets","queueEligibleAssets","alreadyPublishedAssets","missingFileCount"],"additionalProperties":false},"result":{"type":"object","properties":{"organizationId":{"type":"string"},"brandIds":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"productIds":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"assetIds":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"counts":{"type":"object","properties":{"brands":{"type":"integer","minimum":0,"maximum":9007199254740991},"products":{"type":"integer","minimum":0,"maximum":9007199254740991},"assets":{"type":"integer","minimum":0,"maximum":9007199254740991},"assetFiles":{"type":"integer","minimum":0,"maximum":9007199254740991},"assetReviews":{"type":"integer","minimum":0,"maximum":9007199254740991},"assetPublishEvidence":{"type":"integer","minimum":0,"maximum":9007199254740991},"duplicateImageIds":{"type":"integer","minimum":0,"maximum":9007199254740991},"missingFiles":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["brands","products","assets","assetFiles","assetReviews","assetPublishEvidence","duplicateImageIds","missingFiles"],"additionalProperties":false}},"required":["organizationId","brandIds","productIds","assetIds","counts"],"additionalProperties":false}},"required":["mode","scan","result"],"additionalProperties":false}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/assets/imported":{"get":{"tags":["Assets"],"operationId":"listDashboardImportedAssets","summary":"List imported assets for a dashboard workspace.","security":[{"dashboardSession":[]}],"parameters":[{"name":"organizationSlug","in":"query","required":false,"schema":{"default":"ecom-stack","type":"string","minLength":1}},{"name":"brandSlug","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"productSlug","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":200}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Imported asset inventory.","content":{"application/json":{"schema":{"type":"object","properties":{"assets":{"type":"array","items":{"type":"object","properties":{"assetId":{"type":"string"},"brandName":{"type":"string"},"brandSlug":{"type":"string"},"productName":{"type":"string"},"productSlug":{"type":"string"},"externalImageId":{"type":"string"},"sourceRowNumber":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"adminRating":{"anyOf":[{"type":"string"},{"type":"null"}]},"agentRating":{"anyOf":[{"type":"string"},{"type":"null"}]},"reviewState":{"anyOf":[{"type":"string"},{"type":"null"}]},"fileCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"publishEvidenceCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["assetId","brandName","brandSlug","productName","productSlug","externalImageId","sourceRowNumber","adminRating","agentRating","reviewState","fileCount","publishEvidenceCount","createdAt","updatedAt"],"additionalProperties":false}}},"required":["assets"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/assets/{assetId}/review":{"put":{"tags":["Assets"],"operationId":"reviewDashboardImportedAsset","summary":"Create or update a review for an imported asset.","security":[{"dashboardSession":[]}],"x-env-gates":["CREAVILY_ALLOW_ASSET_REVIEW_WRITE=true"],"parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"state":{"type":"string","enum":["planned","generated","needs_review","approved","rejected","needs_regeneration"]},"adminRating":{"anyOf":[{"type":"string","enum":["bad","ok","good","awesome"]},{"type":"null"}]},"agentRating":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"safeZonePassed":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId","state"]}}}},"responses":{"200":{"description":"Imported asset review.","content":{"application/json":{"schema":{"type":"object","properties":{"review":{"type":"object","properties":{"assetReviewId":{"type":"string"},"assetId":{"type":"string"},"state":{"type":"string","enum":["planned","generated","needs_review","approved","rejected","needs_regeneration"]},"adminRating":{"anyOf":[{"type":"string","enum":["bad","ok","good","awesome"]},{"type":"null"}]},"agentRating":{"anyOf":[{"type":"string"},{"type":"null"}]},"safeZonePassed":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"notes":{"anyOf":[{"type":"string"},{"type":"null"}]},"reviewerUserId":{"anyOf":[{"type":"string"},{"type":"null"}]},"updatedAt":{"type":"string"}},"required":["assetReviewId","assetId","state","adminRating","agentRating","safeZonePassed","notes","reviewerUserId","updatedAt"],"additionalProperties":false}},"required":["review"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/media":{"get":{"tags":["Media"],"operationId":"listDashboardMedia","summary":"List media library items visible to a dashboard workspace user.","security":[{"dashboardSession":[]}],"parameters":[{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"brandId","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Media library items.","content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"publicUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentAvailable":{"type":"boolean"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"bytes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lifecycleState":{"type":"string","enum":["active","deleting"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["mediaLibraryItemId","organizationId","brandId","kind","mimeType","publicUrl","contentAvailable","sha256","metadata","createdAt","updatedAt"],"additionalProperties":false}}},"required":["media"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/media/upload":{"post":{"tags":["Media"],"operationId":"uploadDashboardMedia","summary":"Persist a dashboard JSON/base64 media upload into Creavily media storage.","security":[{"dashboardSession":[]}],"x-env-gates":["CREAVILY_ALLOW_MEDIA_UPLOAD_WRITE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"fileName":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"dataBase64":{"type":"string","minLength":1},"altText":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId","dataBase64"]}}}},"responses":{"200":{"description":"Stored media object and media library record.","content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"publicUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentAvailable":{"type":"boolean"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"bytes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lifecycleState":{"type":"string","enum":["active","deleting"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["mediaLibraryItemId","organizationId","brandId","kind","mimeType","publicUrl","contentAvailable","sha256","metadata","createdAt","updatedAt"],"additionalProperties":false},"stored":{"type":"object","properties":{"provider":{"type":"string"},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"type":"string"},"bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sha256":{"type":"string"},"originalName":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","kind","mimeType","bytes","sha256","originalName"],"additionalProperties":false}},"required":["media","stored"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/media/upload-multipart":{"post":{"tags":["Media"],"operationId":"uploadDashboardMediaMultipart","summary":"Stream one dashboard media file after validated fields and bounded upload-budget reservation.","security":[{"dashboardSession":[]}],"x-env-gates":["CREAVILY_ALLOW_MEDIA_UPLOAD_WRITE=true"],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"fileName":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"altText":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"file":{"type":"string","format":"binary","description":"Supported media: JPEG, PNG, GIF, WebP, AVIF, MP4. Multipart fields must precede the file."}},"required":["organizationId","file"]}}}},"responses":{"200":{"description":"Stored media object and media library record.","content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"publicUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentAvailable":{"type":"boolean"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"bytes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lifecycleState":{"type":"string","enum":["active","deleting"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["mediaLibraryItemId","organizationId","brandId","kind","mimeType","publicUrl","contentAvailable","sha256","metadata","createdAt","updatedAt"],"additionalProperties":false},"stored":{"type":"object","properties":{"provider":{"type":"string"},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"type":"string"},"bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sha256":{"type":"string"},"originalName":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","kind","mimeType","bytes","sha256","originalName"],"additionalProperties":false}},"required":["media","stored"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"413":{"description":"Uploaded media exceeds a configured size or workspace budget."},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/media/import-from-url":{"post":{"tags":["Media"],"operationId":"importDashboardMediaFromUrl","summary":"Dry-run or fetch a remote media URL with shared IP, principal, workspace-byte, and concurrency budgets.","security":[{"dashboardSession":[]}],"x-env-gates":["CREAVILY_ALLOW_MEDIA_UPLOAD_WRITE=true","CREAVILY_ALLOW_REMOTE_MEDIA_FETCH=true","CREAVILY_REMOTE_MEDIA_IMPORT_BUDGET_STORE=redis (production)"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"url":{"type":"string","minLength":1},"dryRun":{"default":true,"type":"boolean"},"maxBytes":{"default":26214400,"type":"integer","minimum":1,"maximum":33554432},"altText":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId","url"]}}}},"responses":{"200":{"description":"Dry-run URL safety result or stored media record.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"media":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"publicUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentAvailable":{"type":"boolean"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"bytes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lifecycleState":{"type":"string","enum":["active","deleting"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["mediaLibraryItemId","organizationId","brandId","kind","mimeType","publicUrl","contentAvailable","sha256","metadata","createdAt","updatedAt"],"additionalProperties":false},"stored":{"type":"object","properties":{"provider":{"type":"string"},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"type":"string"},"bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sha256":{"type":"string"},"originalName":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","kind","mimeType","bytes","sha256","originalName"],"additionalProperties":false}},"required":["media","stored"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"safe":{"type":"boolean","const":true},"url":{"type":"string"},"hostname":{"type":"string"},"resolvedAddressCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["mode","safe","url","hostname","resolvedAddressCount"],"additionalProperties":false}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"413":{"description":"Requested media size exceeds the workspace import budget."},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/media/{mediaLibraryItemId}":{"patch":{"tags":["Media"],"operationId":"updateDashboardMedia","summary":"Update dashboard-visible media library metadata.","security":[{"dashboardSession":[]}],"x-env-gates":["CREAVILY_ALLOW_MEDIA_UPLOAD_WRITE=true"],"parameters":[{"name":"mediaLibraryItemId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"name":{"anyOf":[{"type":"string","minLength":1,"maxLength":160},{"type":"null"}]},"altText":{"anyOf":[{"type":"string","minLength":1,"maxLength":500},{"type":"null"}]}},"required":["organizationId"]}}}},"responses":{"200":{"description":"Updated media library item.","content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"publicUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentAvailable":{"type":"boolean"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"bytes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lifecycleState":{"type":"string","enum":["active","deleting"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["mediaLibraryItemId","organizationId","brandId","kind","mimeType","publicUrl","contentAvailable","sha256","metadata","createdAt","updatedAt"],"additionalProperties":false}},"required":["media"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["Media"],"operationId":"deleteDashboardMedia","summary":"Soft-delete a dashboard media library item and queue storage cleanup.","security":[{"dashboardSession":[]}],"x-env-gates":["CREAVILY_ALLOW_MEDIA_UPLOAD_WRITE=true"],"parameters":[{"name":"mediaLibraryItemId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1}},"required":["organizationId"]}}}},"responses":{"200":{"description":"Deleted media library item and cleanup status.","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"organizationId":{"type":"string"},"mediaLibraryItemId":{"type":"string"},"deleted":{"type":"boolean","const":true},"status":{"type":"string","enum":["deleting","deleted"]},"mediaStorageOperationId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["organizationId","mediaLibraryItemId","deleted"],"additionalProperties":false}},"required":["result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/media/{mediaLibraryItemId}/content":{"get":{"tags":["Media"],"operationId":"previewDashboardMedia","summary":"Stream a private media object to an authenticated dashboard operator.","security":[{"dashboardSession":[]}],"parameters":[{"name":"mediaLibraryItemId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Binary media content."},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/media/delivery/{mediaLibraryItemId}":{"get":{"tags":["Media"],"operationId":"deliverSignedMedia","summary":"Stream private media through a short-lived purpose-bound signature.","parameters":[{"name":"mediaLibraryItemId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"purpose","in":"query","required":true,"schema":{"type":"string","enum":["operator_preview","provider"]}},{"name":"expires","in":"query","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},{"name":"signature","in":"query","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}],"responses":{"200":{"description":"Binary media content."},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/media/storage-operations/{mediaStorageOperationId}/requeue":{"post":{"tags":["Media"],"operationId":"requeueDashboardMediaStorageOperation","summary":"Requeue a dead media storage cleanup operation for a workspace admin.","security":[{"dashboardSession":[]}],"x-required-role":"admin","x-env-gates":["CREAVILY_ALLOW_MEDIA_STORAGE_DELETE=true"],"parameters":[{"name":"mediaStorageOperationId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1}},"required":["organizationId"]}}}},"responses":{"200":{"description":"Requeued media storage operation.","content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"type":"object","properties":{"mediaStorageOperationId":{"type":"string"},"organizationId":{"type":"string"},"mediaLibraryItemId":{"anyOf":[{"type":"string"},{"type":"null"}]},"provider":{"type":"string"},"namespaceId":{"type":"string"},"storageKey":{"type":"string"},"storageVersion":{"anyOf":[{"type":"string"},{"type":"null"}]},"operation":{"type":"string","const":"delete"},"status":{"type":"string","enum":["pending","claimed","completed","dead"]},"attempts":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"availableAt":{"type":"string"},"claimId":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedBy":{"anyOf":[{"type":"string"},{"type":"null"}]},"claimedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["mediaStorageOperationId","organizationId","mediaLibraryItemId","provider","namespaceId","storageKey","storageVersion","operation","status","attempts","availableAt","claimId","claimedBy","claimedAt","lastErrorCode","completedAt","createdAt","updatedAt"],"additionalProperties":false}},"required":["operation"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/channel-accounts":{"get":{"tags":["Channels"],"operationId":"listDashboardChannelAccounts","summary":"List dashboard channel accounts for an organization or brand.","security":[{"dashboardSession":[]}],"parameters":[{"name":"brandId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"brandSlug","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"platform","in":"query","required":false,"schema":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},{"name":"state","in":"query","required":false,"schema":{"type":"string","enum":["not_connected","connecting","in_between_steps","connected","expiring","refresh_needed","reconnect_required","disabled","deleted"]}},{"name":"includeDeleted","in":"query","required":false,"schema":{"default":false,"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Dashboard channel accounts.","content":{"application/json":{"schema":{"type":"object","properties":{"channelAccounts":{"type":"array","items":{"type":"object","properties":{"channelAccountId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandName":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"platformAppId":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"externalAccountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"state":{"type":"string","enum":["not_connected","connecting","in_between_steps","connected","expiring","refresh_needed","reconnect_required","disabled","deleted"]},"tokenExpiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"disconnectSummary":{"type":"object","properties":{"alreadyDisconnected":{"type":"boolean"},"revokedChannelTokenCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"revokedProviderTokenSecretCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"cancelledPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsReconnectPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsAttentionPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"cancelledBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsReconnectBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsAttentionBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"disabledPublishingProfileChannelCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["alreadyDisconnected","revokedChannelTokenCount","revokedProviderTokenSecretCount","cancelledPostTargetCount","needsReconnectPostTargetCount","needsAttentionPostTargetCount","cancelledBatchTargetCount","needsReconnectBatchTargetCount","needsAttentionBatchTargetCount","disabledPublishingProfileChannelCount"],"additionalProperties":false},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["channelAccountId","organizationId","brandId","brandName","brandSlug","platformAppId","platform","externalAccountId","displayName","handle","state","tokenExpiresAt","createdAt","updatedAt"],"additionalProperties":false}}},"required":["channelAccounts"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}},"post":{"tags":["Channels"],"operationId":"upsertDashboardChannelAccount","summary":"Create or update a channel account and token references.","security":[{"dashboardSession":[]}],"x-required-policy":"developer.api_keys.manage","x-env-gates":["CREAVILY_ALLOW_CHANNEL_ACCOUNT_WRITE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChannelAccountUpsertRequest"}}}},"responses":{"200":{"description":"Upserted channel account and token ref summary.","content":{"application/json":{"schema":{"type":"object","properties":{"channelAccount":{"type":"object","properties":{"channelAccountId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandName":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"platformAppId":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"externalAccountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"state":{"type":"string","enum":["not_connected","connecting","in_between_steps","connected","expiring","refresh_needed","reconnect_required","disabled","deleted"]},"tokenExpiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"disconnectSummary":{"type":"object","properties":{"alreadyDisconnected":{"type":"boolean"},"revokedChannelTokenCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"revokedProviderTokenSecretCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"cancelledPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsReconnectPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsAttentionPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"cancelledBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsReconnectBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsAttentionBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"disabledPublishingProfileChannelCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["alreadyDisconnected","revokedChannelTokenCount","revokedProviderTokenSecretCount","cancelledPostTargetCount","needsReconnectPostTargetCount","needsAttentionPostTargetCount","cancelledBatchTargetCount","needsReconnectBatchTargetCount","needsAttentionBatchTargetCount","disabledPublishingProfileChannelCount"],"additionalProperties":false},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["channelAccountId","organizationId","brandId","brandName","brandSlug","platformAppId","platform","externalAccountId","displayName","handle","state","tokenExpiresAt","createdAt","updatedAt"],"additionalProperties":false}},"required":["channelAccount"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/channel-accounts/{channelAccountId}":{"patch":{"tags":["Channels"],"operationId":"updateDashboardChannelAccount","summary":"Update dashboard channel account metadata, status, and settings without exposing provider tokens.","security":[{"dashboardSession":[]}],"x-required-policy":"developer.api_keys.manage","x-env-gates":["CREAVILY_ALLOW_CHANNEL_ACCOUNT_WRITE=true"],"parameters":[{"name":"channelAccountId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChannelAccountPatchRequest"}}}},"responses":{"200":{"description":"Updated channel account.","content":{"application/json":{"schema":{"type":"object","properties":{"channelAccount":{"type":"object","properties":{"channelAccountId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandName":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"platformAppId":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"externalAccountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"state":{"type":"string","enum":["not_connected","connecting","in_between_steps","connected","expiring","refresh_needed","reconnect_required","disabled","deleted"]},"tokenExpiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"disconnectSummary":{"type":"object","properties":{"alreadyDisconnected":{"type":"boolean"},"revokedChannelTokenCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"revokedProviderTokenSecretCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"cancelledPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsReconnectPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsAttentionPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"cancelledBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsReconnectBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsAttentionBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"disabledPublishingProfileChannelCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["alreadyDisconnected","revokedChannelTokenCount","revokedProviderTokenSecretCount","cancelledPostTargetCount","needsReconnectPostTargetCount","needsAttentionPostTargetCount","cancelledBatchTargetCount","needsReconnectBatchTargetCount","needsAttentionBatchTargetCount","disabledPublishingProfileChannelCount"],"additionalProperties":false},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["channelAccountId","organizationId","brandId","brandName","brandSlug","platformAppId","platform","externalAccountId","displayName","handle","state","tokenExpiresAt","createdAt","updatedAt"],"additionalProperties":false}},"required":["channelAccount"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["Channels"],"operationId":"deleteDashboardChannelAccount","summary":"Disconnect a channel account, revoke credentials, and block unfinished publishing while preserving history.","security":[{"dashboardSession":[]}],"x-required-policy":"developer.api_keys.manage","x-env-gates":["CREAVILY_ALLOW_CHANNEL_ACCOUNT_WRITE=true"],"parameters":[{"name":"channelAccountId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChannelAccountDeleteRequest"}}}},"responses":{"200":{"description":"Disconnected channel account with revocation summary.","content":{"application/json":{"schema":{"type":"object","properties":{"channelAccount":{"type":"object","properties":{"channelAccountId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandName":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"platformAppId":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"externalAccountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"state":{"type":"string","enum":["not_connected","connecting","in_between_steps","connected","expiring","refresh_needed","reconnect_required","disabled","deleted"]},"tokenExpiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"disconnectSummary":{"type":"object","properties":{"alreadyDisconnected":{"type":"boolean"},"revokedChannelTokenCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"revokedProviderTokenSecretCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"cancelledPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsReconnectPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsAttentionPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"cancelledBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsReconnectBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsAttentionBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"disabledPublishingProfileChannelCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["alreadyDisconnected","revokedChannelTokenCount","revokedProviderTokenSecretCount","cancelledPostTargetCount","needsReconnectPostTargetCount","needsAttentionPostTargetCount","cancelledBatchTargetCount","needsReconnectBatchTargetCount","needsAttentionBatchTargetCount","disabledPublishingProfileChannelCount"],"additionalProperties":false},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["channelAccountId","organizationId","brandId","brandName","brandSlug","platformAppId","platform","externalAccountId","displayName","handle","state","tokenExpiresAt","createdAt","updatedAt"],"additionalProperties":false}},"required":["channelAccount"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/publishing-profiles":{"get":{"tags":["Channels"],"operationId":"listDashboardPublishingProfiles","summary":"List brand publishing profiles, including their selected social channel accounts.","security":[{"dashboardSession":[]}],"parameters":[{"name":"brandId","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"includeDisabledChannels","in":"query","required":false,"schema":{"default":false,"type":"boolean"}},{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Brand publishing profiles.","content":{"application/json":{"schema":{"type":"object","properties":{"profiles":{"type":"array","items":{"type":"object","properties":{"profileId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"brandName":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"slug":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"isDefault":{"type":"boolean"},"scheduleSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"commentSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"channels":{"type":"array","items":{"type":"object","properties":{"profileChannelId":{"type":"string"},"profileId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"channelAccountId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelDisplayName":{"type":"string"},"channelHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelState":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"enabled":{"type":"boolean"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["profileChannelId","profileId","organizationId","brandId","channelAccountId","platform","channelDisplayName","channelHandle","channelState","position","enabled","settings","createdAt","updatedAt"],"additionalProperties":false}}},"required":["profileId","organizationId","brandId","brandName","brandSlug","name","slug","description","isDefault","scheduleSettings","commentSettings","createdAt","updatedAt","channels"],"additionalProperties":false}}},"required":["profiles"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}},"post":{"tags":["Channels"],"operationId":"saveDashboardPublishingProfile","summary":"Save a brand release profile and its selected publishing destinations.","security":[{"dashboardSession":[]}],"x-env-gates":["CREAVILY_ALLOW_PUBLISHING_PROFILE_WRITE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishingProfileSaveRequest"}}}},"responses":{"200":{"description":"Saved publishing profile.","content":{"application/json":{"schema":{"type":"object","properties":{"profile":{"type":"object","properties":{"profileId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"brandName":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"slug":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"isDefault":{"type":"boolean"},"scheduleSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"commentSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"channels":{"type":"array","items":{"type":"object","properties":{"profileChannelId":{"type":"string"},"profileId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"channelAccountId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelDisplayName":{"type":"string"},"channelHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelState":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"enabled":{"type":"boolean"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["profileChannelId","profileId","organizationId","brandId","channelAccountId","platform","channelDisplayName","channelHandle","channelState","position","enabled","settings","createdAt","updatedAt"],"additionalProperties":false}}},"required":["profileId","organizationId","brandId","brandName","brandSlug","name","slug","description","isDefault","scheduleSettings","commentSettings","createdAt","updatedAt","channels"],"additionalProperties":false}},"required":["profile"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/UnprocessableEntity"}}}},"/v1/channel-accounts/connect-url":{"post":{"tags":["Channels"],"operationId":"createDashboardChannelConnectUrl","summary":"Create a provider OAuth authorization URL for an administrator-managed social account connection.","security":[{"dashboardSession":[]}],"x-required-role":"admin","x-env-config":["CREAVILY_CHANNEL_OAUTH_<PLATFORM>_CLIENT_ID","CREAVILY_CHANNEL_OAUTH_<PLATFORM>_AUTHORIZE_URL","CREAVILY_CHANNEL_OAUTH_<PLATFORM>_REDIRECT_URI or CREAVILY_CHANNEL_OAUTH_REDIRECT_URI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"state":{"type":"string","minLength":1,"maxLength":2000},"redirectUri":{"type":"string","format":"uri"},"scopes":{"type":"array","items":{"type":"string","minLength":1}},"organizationId":{"type":"string","minLength":1},"brandId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"profileId":{"type":"string","minLength":1}},"required":["platform","organizationId"]}}}},"responses":{"200":{"description":"OAuth connection URL.","content":{"application/json":{"schema":{"type":"object","properties":{"connect":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"authorizationUrl":{"type":"string","format":"uri"},"redirectUri":{"type":"string","format":"uri"},"state":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["platform","authorizationUrl","redirectUri","state","scopes"],"additionalProperties":false}},"required":["connect"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/channel-accounts/oauth/callback":{"get":{"tags":["Channels"],"operationId":"completeChannelOAuthCallback","summary":"Complete provider OAuth, discover channel accounts, and either persist one account or create a secure account picker selection.","x-env-gates":["CREAVILY_ALLOW_CHANNEL_OAUTH_CALLBACK=true","CREAVILY_ALLOW_CHANNEL_ACCOUNT_WRITE=true"],"x-env-config":["CREAVILY_CHANNEL_OAUTH_STATE_SECRET or JWT_SECRET","CREAVILY_PROVIDER_TOKEN_ENCRYPTION_KEY with optional versioned previous-key configuration","CREAVILY_CHANNEL_OAUTH_REDIRECT_URI or CREAVILY_CHANNEL_OAUTH_<PLATFORM>_REDIRECT_URI"],"parameters":[{"name":"code","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"state","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"error","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"error_description","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"error_reason","in":"query","required":false,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"HTML completion page that returns the browser to Creavily."},"400":{"description":"HTML error page for invalid callback, denied authorization, or provider response issues."},"403":{"description":"HTML error page when channel OAuth writes are disabled."},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/channel-accounts/oauth/selections/{selectionId}":{"get":{"tags":["Channels"],"operationId":"getChannelOAuthAccountSelection","summary":"Read a secure pending provider account selection after a multi-account OAuth callback.","security":[{"dashboardSession":[]}],"parameters":[{"name":"selectionId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Pending selection with safe account display fields only.","content":{"application/json":{"schema":{"type":"object","properties":{"selection":{"type":"object","properties":{"selectionId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"callerState":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"type":"string"},"status":{"type":"string","enum":["pending","completed","cancelled"]},"createdAt":{"type":"string"},"accounts":{"type":"array","items":{"type":"object","properties":{"accountKey":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"externalAccountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"tokenExpiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"scopes":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["accountKey","platform","externalAccountId","displayName","handle","tokenExpiresAt","scopes","metadata"],"additionalProperties":false}}},"required":["selectionId","organizationId","brandId","platform","callerState","expiresAt","status","createdAt","accounts"],"additionalProperties":false}},"required":["selection"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"description":"Selection was already completed or cancelled."},"410":{"description":"Selection expired."}}}},"/v1/channel-accounts/oauth/selections/{selectionId}/complete":{"post":{"tags":["Channels"],"operationId":"completeChannelOAuthAccountSelection","summary":"Persist selected provider accounts from a pending multi-account OAuth selection.","security":[{"dashboardSession":[]}],"x-required-role":"admin","x-env-gates":["CREAVILY_ALLOW_CHANNEL_ACCOUNT_WRITE=true"],"parameters":[{"name":"selectionId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"profileId":{"type":"string","minLength":1},"selectedAccountKeys":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"string","minLength":1}}},"required":["organizationId","selectedAccountKeys"]}}}},"responses":{"200":{"description":"Selected channel accounts were connected.","content":{"application/json":{"schema":{"type":"object","properties":{"channelAccounts":{"type":"array","items":{"type":"object","properties":{"channelAccountId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandName":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"platformAppId":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"externalAccountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"state":{"type":"string","enum":["not_connected","connecting","in_between_steps","connected","expiring","refresh_needed","reconnect_required","disabled","deleted"]},"tokenExpiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"disconnectSummary":{"type":"object","properties":{"alreadyDisconnected":{"type":"boolean"},"revokedChannelTokenCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"revokedProviderTokenSecretCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"cancelledPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsReconnectPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsAttentionPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"cancelledBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsReconnectBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsAttentionBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"disabledPublishingProfileChannelCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["alreadyDisconnected","revokedChannelTokenCount","revokedProviderTokenSecretCount","cancelledPostTargetCount","needsReconnectPostTargetCount","needsAttentionPostTargetCount","cancelledBatchTargetCount","needsReconnectBatchTargetCount","needsAttentionBatchTargetCount","disabledPublishingProfileChannelCount"],"additionalProperties":false},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["channelAccountId","organizationId","brandId","brandName","brandSlug","platformAppId","platform","externalAccountId","displayName","handle","state","tokenExpiresAt","createdAt","updatedAt"],"additionalProperties":false}},"profile":{"type":"object","properties":{"profileId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"brandName":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"slug":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"isDefault":{"type":"boolean"},"scheduleSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"commentSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"channels":{"type":"array","items":{"type":"object","properties":{"profileChannelId":{"type":"string"},"profileId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"channelAccountId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelDisplayName":{"type":"string"},"channelHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelState":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"enabled":{"type":"boolean"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["profileChannelId","profileId","organizationId","brandId","channelAccountId","platform","channelDisplayName","channelHandle","channelState","position","enabled","settings","createdAt","updatedAt"],"additionalProperties":false}}},"required":["profileId","organizationId","brandId","brandName","brandSlug","name","slug","description","isDefault","scheduleSettings","commentSettings","createdAt","updatedAt","channels"],"additionalProperties":false}},"required":["channelAccounts"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"description":"Selection was already consumed."},"410":{"description":"Selection expired or pending tokens are gone."}}}},"/v1/channel-accounts/oauth/selections/{selectionId}/cancel":{"post":{"tags":["Channels"],"operationId":"cancelChannelOAuthAccountSelection","summary":"Cancel a pending multi-account OAuth selection and remove its temporary provider token references.","security":[{"dashboardSession":[]}],"x-required-role":"admin","parameters":[{"name":"selectionId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1}},"required":["organizationId"]}}}},"responses":{"200":{"description":"Selection was cancelled, including a repeated cancel request.","content":{"application/json":{"schema":{"type":"object","properties":{"selection":{"type":"object","properties":{"selectionId":{"type":"string"},"status":{"type":"string","enum":["pending","completed","cancelled"]}},"required":["selectionId","status"],"additionalProperties":false}},"required":["selection"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"description":"Selection was already completed."},"410":{"description":"Selection expired."}}}},"/v1/provider-capabilities":{"get":{"tags":["Provider Tools"],"operationId":"listProviderCapabilities","summary":"List public provider capability, tool, and plug metadata for platform-aware clients.","responses":{"200":{"description":"Public provider capability catalog for rendering provider settings, tools, and plugs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderCapabilitiesResponse"}}}},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/oauth/authorize":{"get":{"tags":["OAuth"],"operationId":"previewOAuthAuthorization","summary":"Preview a dashboard-user OAuth authorization request before consent.","security":[{"dashboardSession":[]}],"parameters":[{"name":"response_type","in":"query","required":true,"schema":{"type":"string","const":"code"}},{"name":"client_id","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"redirect_uri","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"scope","in":"query","required":false,"schema":{"default":"assets:read","type":"string"}},{"name":"state","in":"query","required":false,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"OAuth authorization request preview.","content":{"application/json":{"schema":{"type":"object","properties":{"authorization":{"type":"object","properties":{"responseType":{"type":"string","const":"code"},"clientId":{"type":"string"},"redirectUri":{"type":"string"},"state":{"anyOf":[{"type":"string"},{"type":"null"}]},"scopes":{"type":"array","items":{"type":"string"}},"app":{"type":"object","properties":{"oauthAppId":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"clientId":{"type":"string"}},"required":["oauthAppId","organizationId","name","clientId"],"additionalProperties":false},"user":{"type":"object","properties":{"userId":{"type":"string"},"email":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["userId","email","name"],"additionalProperties":false},"workspace":{"type":"object","properties":{"organizationId":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"timezone":{"type":"string"},"role":{"type":"string"},"brands":{"type":"array","items":{"type":"object","properties":{"brandId":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"timezone":{"type":"string"}},"required":["brandId","organizationId","name","slug","timezone"],"additionalProperties":false}}},"required":["organizationId","name","slug","timezone","role","brands"],"additionalProperties":false}},"required":["responseType","clientId","redirectUri","state","scopes","app","user","workspace"],"additionalProperties":false}},"required":["authorization"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/ServerError"}}},"post":{"tags":["OAuth"],"operationId":"approveOAuthAuthorization","summary":"Approve a dashboard-user OAuth authorization request and issue a short-lived authorization code.","security":[{"dashboardSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"response_type":{"type":"string","const":"code"},"client_id":{"type":"string","minLength":1},"redirect_uri":{"type":"string","minLength":1},"scope":{"default":"assets:read","type":"string"},"state":{"type":"string","minLength":1}},"required":["response_type","client_id","redirect_uri"]}}}},"responses":{"200":{"description":"OAuth authorization code result.","content":{"application/json":{"schema":{"type":"object","properties":{"authorization":{"type":"object","properties":{"responseType":{"type":"string","const":"code"},"clientId":{"type":"string"},"redirectUri":{"type":"string"},"state":{"anyOf":[{"type":"string"},{"type":"null"}]},"scopes":{"type":"array","items":{"type":"string"}},"app":{"type":"object","properties":{"oauthAppId":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"clientId":{"type":"string"}},"required":["oauthAppId","organizationId","name","clientId"],"additionalProperties":false},"user":{"type":"object","properties":{"userId":{"type":"string"},"email":{"type":"string"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["userId","email","name"],"additionalProperties":false},"workspace":{"type":"object","properties":{"organizationId":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"timezone":{"type":"string"},"role":{"type":"string"},"brands":{"type":"array","items":{"type":"object","properties":{"brandId":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"timezone":{"type":"string"}},"required":["brandId","organizationId","name","slug","timezone"],"additionalProperties":false}}},"required":["organizationId","name","slug","timezone","role","brands"],"additionalProperties":false}},"required":["responseType","clientId","redirectUri","state","scopes","app","user","workspace"],"additionalProperties":false},"result":{"type":"object","properties":{"code":{"type":"string"},"codeExpiresAt":{"type":"string"},"redirectUri":{"type":"string"},"state":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorizationId":{"type":"string"}},"required":["code","codeExpiresAt","redirectUri","state","authorizationId"],"additionalProperties":false}},"required":["authorization","result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/oauth/token":{"post":{"tags":["OAuth"],"operationId":"exchangeOAuthToken","summary":"Exchange an OAuth authorization code or refresh token.","requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"grant_type":{"type":"string","const":"authorization_code"},"client_id":{"type":"string","minLength":1},"client_secret":{"type":"string","minLength":1},"code":{"type":"string","minLength":1},"redirect_uri":{"type":"string","minLength":1}},"required":["grant_type","client_id","client_secret","code","redirect_uri"]},{"type":"object","properties":{"grant_type":{"type":"string","const":"refresh_token"},"client_id":{"type":"string","minLength":1},"client_secret":{"type":"string","minLength":1},"refresh_token":{"type":"string","minLength":1}},"required":["grant_type","client_id","client_secret","refresh_token"]}]}}}},"responses":{"200":{"description":"OAuth token response.","content":{"application/json":{"schema":{"type":"object","properties":{"access_token":{"type":"string"},"token_type":{"type":"string","const":"Bearer"},"expires_in":{"type":"number"},"expires_at":{"type":"string"},"refresh_token":{"type":"string"},"refresh_expires_in":{"type":"number"},"refresh_expires_at":{"type":"string"},"scope":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"authorization":{"type":"object","properties":{"authorization_id":{"type":"string"},"organization_id":{"type":"string"},"user_id":{"type":"string"},"client_id":{"type":"string"},"app_name":{"type":"string"}},"required":["authorization_id","organization_id","user_id","client_id","app_name"],"additionalProperties":false}},"required":["access_token","token_type","expires_in","expires_at","refresh_token","refresh_expires_in","refresh_expires_at","scope","scopes","authorization"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/analytics/snapshots":{"get":{"tags":["Analytics"],"operationId":"listAnalyticsSnapshots","summary":"List persisted analytics snapshots for a dashboard workspace.","security":[{"dashboardSession":[]}],"parameters":[{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"platform","in":"query","required":false,"schema":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},{"name":"postTargetId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"channelAccountId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"from","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"to","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Analytics snapshots.","content":{"application/json":{"schema":{"type":"object","properties":{"snapshots":{"type":"array","items":{"type":"object","properties":{"analyticsSnapshotId":{"type":"string"},"organizationId":{"type":"string"},"postTargetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelAccountId":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"metrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"capturedAt":{"type":"string"}},"required":["analyticsSnapshotId","organizationId","postTargetId","channelAccountId","platform","metrics","capturedAt"],"additionalProperties":false}}},"required":["snapshots"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/ServerError"}}},"post":{"tags":["Analytics"],"operationId":"recordAnalyticsSnapshot","summary":"Record an analytics snapshot for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-env-gates":["CREAVILY_ALLOW_ANALYTICS_WRITE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"postTargetId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"channelAccountId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"metrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"capturedAt":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId","platform","metrics"]}}}},"responses":{"200":{"description":"Recorded analytics snapshot.","content":{"application/json":{"schema":{"type":"object","properties":{"snapshot":{"type":"object","properties":{"analyticsSnapshotId":{"type":"string"},"organizationId":{"type":"string"},"postTargetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelAccountId":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"metrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"capturedAt":{"type":"string"}},"required":["analyticsSnapshotId","organizationId","postTargetId","channelAccountId","platform","metrics","capturedAt"],"additionalProperties":false}},"required":["snapshot"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/analytics/provider-sync":{"post":{"tags":["Analytics"],"operationId":"syncProviderPostAnalytics","summary":"Dry-run or execute dashboard-triggered provider post analytics sync.","security":[{"dashboardSession":[]}],"x-required-policy":"analytics.provider_sync.manage","x-env-gates":["CREAVILY_ALLOW_PROVIDER_ANALYTICS_SYNC=true","CREAVILY_ALLOW_ANALYTICS_WRITE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"providerPostId":{"type":"string","minLength":1},"postTargetId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"channelAccountId":{"type":"string","minLength":1},"capturedAt":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"dryRun":{"default":true,"type":"boolean"}},"required":["organizationId","brandId","platform","providerPostId","channelAccountId"]}}}},"responses":{"200":{"description":"Dry-run plan, or synced provider status, metrics, and persisted snapshot.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"dryRun":{"type":"boolean","const":true},"target":{"type":"object","properties":{"organizationId":{"type":"string"},"brandId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"providerPostId":{"type":"string"},"postTargetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelAccountId":{"type":"string"}},"required":["organizationId","brandId","platform","providerPostId","postTargetId","channelAccountId"],"additionalProperties":false},"wouldFetchProvider":{"type":"boolean","const":true},"wouldRecordSnapshot":{"type":"boolean","const":true},"requiredEnv":{"type":"array","items":{"type":"string"}}},"required":["mode","dryRun","target","wouldFetchProvider","wouldRecordSnapshot","requiredEnv"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"synced"},"dryRun":{"type":"boolean","const":false},"status":{"anyOf":[{"type":"object","properties":{"providerPostId":{"type":"string"},"releaseId":{"type":"string"},"releaseUrl":{"type":"string"}},"required":["providerPostId"]},{"type":"null"}]},"metrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"snapshot":{"type":"object","properties":{"analyticsSnapshotId":{"type":"string"},"organizationId":{"type":"string"},"postTargetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelAccountId":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"metrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"capturedAt":{"type":"string"}},"required":["analyticsSnapshotId","organizationId","postTargetId","channelAccountId","platform","metrics","capturedAt"],"additionalProperties":false}},"required":["mode","dryRun","status","metrics","snapshot"],"additionalProperties":false}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/social-comments":{"get":{"tags":["Engagement"],"operationId":"listSocialComments","summary":"List persisted provider social comments for the dashboard inbox.","security":[{"dashboardSession":[]}],"parameters":[{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"brandId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"platform","in":"query","required":false,"schema":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},{"name":"postTargetId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"providerPostId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"status","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Social comments scoped to the dashboard workspace.","content":{"application/json":{"schema":{"type":"object","properties":{"comments":{"type":"array","items":{"type":"object","properties":{"socialCommentId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"postTargetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelAccountId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"providerPostId":{"type":"string"},"providerCommentId":{"type":"string"},"parentProviderCommentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorName":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"status":{"type":"string","enum":["needs_reply","replied","drafted"]},"replyStatus":{"type":"string","enum":["none","replied","drafted","failed","needs_reconciliation"]},"permalinkUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"metrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"providerCreatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSyncedAt":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["socialCommentId","organizationId","brandId","postTargetId","channelAccountId","platform","providerPostId","providerCommentId","parentProviderCommentId","authorName","authorHandle","body","status","replyStatus","permalinkUrl","metrics","providerCreatedAt","lastSyncedAt","createdAt","updatedAt"]}}},"required":["comments"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/social-comments/sync":{"post":{"tags":["Engagement"],"operationId":"syncProviderPostComments","summary":"Dry-run or execute provider comment sync into the dashboard inbox.","security":[{"dashboardSession":[]}],"x-required-policy":"engagement.comments.manage","x-env-gates":["CREAVILY_ALLOW_PROVIDER_COMMENT_SYNC=true","CREAVILY_ALLOW_SOCIAL_COMMENT_WRITE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"providerPostId":{"type":"string","minLength":1},"postTargetId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"channelAccountId":{"type":"string","minLength":1},"limit":{"default":50,"type":"integer","minimum":1,"maximum":100},"since":{"type":"string","minLength":1},"dryRun":{"default":true,"type":"boolean"}},"required":["organizationId","brandId","platform","providerPostId","channelAccountId"]}}}},"responses":{"200":{"description":"Dry-run plan, or fetched and persisted social comments.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"dryRun":{"type":"boolean","const":true},"target":{"type":"object","properties":{"organizationId":{"type":"string"},"brandId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"providerPostId":{"type":"string"},"postTargetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelAccountId":{"type":"string"}},"required":["organizationId","brandId","platform","providerPostId","postTargetId","channelAccountId"],"additionalProperties":false},"wouldLoadChannelTokenRef":{"type":"boolean","const":true},"wouldFetchProvider":{"type":"boolean","const":true},"wouldPersistComments":{"type":"boolean","const":true},"requiredEnv":{"type":"array","items":{"type":"string"}}},"required":["mode","dryRun","target","wouldLoadChannelTokenRef","wouldFetchProvider","wouldPersistComments","requiredEnv"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"synced"},"dryRun":{"type":"boolean","const":false},"target":{"type":"object","properties":{"organizationId":{"type":"string"},"brandId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"providerPostId":{"type":"string"},"postTargetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelAccountId":{"type":"string"}},"required":["organizationId","brandId","platform","providerPostId","postTargetId","channelAccountId"],"additionalProperties":false},"fetchedCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"comments":{"type":"array","items":{"type":"object","properties":{"socialCommentId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"postTargetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelAccountId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"providerPostId":{"type":"string"},"providerCommentId":{"type":"string"},"parentProviderCommentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorName":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"status":{"type":"string","enum":["needs_reply","replied","drafted"]},"replyStatus":{"type":"string","enum":["none","replied","drafted","failed","needs_reconciliation"]},"permalinkUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"metrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"providerCreatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSyncedAt":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["socialCommentId","organizationId","brandId","postTargetId","channelAccountId","platform","providerPostId","providerCommentId","parentProviderCommentId","authorName","authorHandle","body","status","replyStatus","permalinkUrl","metrics","providerCreatedAt","lastSyncedAt","createdAt","updatedAt"]}}},"required":["mode","dryRun","target","fetchedCount","comments"],"additionalProperties":false}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/social-comments/sync-profile":{"post":{"tags":["Engagement"],"operationId":"syncPublishingProfileComments","summary":"Refresh comments for recent published posts in a brand publishing profile.","description":"Dashboard route for operator-friendly comment refresh. The server finds recent published targets from the selected brand profile and uses stored channel credentials; callers do not provide platform post ids in the normal workflow.","security":[{"dashboardSession":[]}],"x-required-policy":"engagement.comments.manage","x-env-gates":["CREAVILY_ALLOW_PROVIDER_COMMENT_SYNC=true","CREAVILY_ALLOW_SOCIAL_COMMENT_WRITE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"profileId":{"type":"string","minLength":1},"targetLimit":{"default":8,"type":"integer","minimum":1,"maximum":25},"commentsPerPost":{"default":50,"type":"integer","minimum":1,"maximum":100},"dryRun":{"default":true,"type":"boolean"}},"required":["organizationId","brandId"]}}}},"responses":{"200":{"description":"Dry-run profile refresh plan, or per-target comment sync results.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"dryRun":{"type":"boolean","const":true},"profileId":{"anyOf":[{"type":"string"},{"type":"null"}]},"profileName":{"anyOf":[{"type":"string"},{"type":"null"}]},"targetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"supportedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"targets":{"type":"array","items":{"type":"object","properties":{"target":{"type":"object","properties":{"profileId":{"type":"string"},"profileName":{"type":"string"},"publishJobId":{"anyOf":[{"type":"string"},{"type":"null"}]},"postTargetId":{"type":"string"},"channelAccountId":{"type":"string"},"channelDisplayName":{"type":"string"},"channelHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"providerPostId":{"type":"string"},"postTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSyncedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastProviderCreatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastFetchedCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["profileId","profileName","publishJobId","postTargetId","channelAccountId","channelDisplayName","channelHandle","platform","providerPostId","postTitle","publishedAt","lastSyncedAt","lastProviderCreatedAt","lastFetchedCount"],"additionalProperties":false},"status":{"type":"string","enum":["ready","unsupported"]},"since":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["target","status","since"],"additionalProperties":false}},"wouldLoadChannelTokenRef":{"type":"boolean"},"wouldFetchProvider":{"type":"boolean"},"wouldPersistComments":{"type":"boolean"},"requiredEnv":{"type":"array","items":{"type":"string"}}},"required":["mode","dryRun","profileId","profileName","targetCount","supportedTargetCount","targets","wouldLoadChannelTokenRef","wouldFetchProvider","wouldPersistComments","requiredEnv"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"synced"},"dryRun":{"type":"boolean","const":false},"profileId":{"anyOf":[{"type":"string"},{"type":"null"}]},"profileName":{"anyOf":[{"type":"string"},{"type":"null"}]},"targetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"supportedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"syncedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"fetchedCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"results":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"target":{"type":"object","properties":{"profileId":{"type":"string"},"profileName":{"type":"string"},"publishJobId":{"anyOf":[{"type":"string"},{"type":"null"}]},"postTargetId":{"type":"string"},"channelAccountId":{"type":"string"},"channelDisplayName":{"type":"string"},"channelHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"providerPostId":{"type":"string"},"postTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSyncedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastProviderCreatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastFetchedCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["profileId","profileName","publishJobId","postTargetId","channelAccountId","channelDisplayName","channelHandle","platform","providerPostId","postTitle","publishedAt","lastSyncedAt","lastProviderCreatedAt","lastFetchedCount"],"additionalProperties":false},"status":{"type":"string","const":"unsupported"},"fetchedCount":{"type":"number","const":0}},"required":["target","status","fetchedCount"],"additionalProperties":false},{"type":"object","properties":{"target":{"type":"object","properties":{"profileId":{"type":"string"},"profileName":{"type":"string"},"publishJobId":{"anyOf":[{"type":"string"},{"type":"null"}]},"postTargetId":{"type":"string"},"channelAccountId":{"type":"string"},"channelDisplayName":{"type":"string"},"channelHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"providerPostId":{"type":"string"},"postTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSyncedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastProviderCreatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastFetchedCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["profileId","profileName","publishJobId","postTargetId","channelAccountId","channelDisplayName","channelHandle","platform","providerPostId","postTitle","publishedAt","lastSyncedAt","lastProviderCreatedAt","lastFetchedCount"],"additionalProperties":false},"status":{"type":"string","const":"missing_channel"},"fetchedCount":{"type":"number","const":0}},"required":["target","status","fetchedCount"],"additionalProperties":false},{"type":"object","properties":{"target":{"type":"object","properties":{"profileId":{"type":"string"},"profileName":{"type":"string"},"publishJobId":{"anyOf":[{"type":"string"},{"type":"null"}]},"postTargetId":{"type":"string"},"channelAccountId":{"type":"string"},"channelDisplayName":{"type":"string"},"channelHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"providerPostId":{"type":"string"},"postTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSyncedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastProviderCreatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastFetchedCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["profileId","profileName","publishJobId","postTargetId","channelAccountId","channelDisplayName","channelHandle","platform","providerPostId","postTitle","publishedAt","lastSyncedAt","lastProviderCreatedAt","lastFetchedCount"],"additionalProperties":false},"status":{"type":"string","const":"synced"},"fetchedCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"comments":{"type":"array","items":{"type":"object","properties":{"socialCommentId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"postTargetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelAccountId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"providerPostId":{"type":"string"},"providerCommentId":{"type":"string"},"parentProviderCommentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorName":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"status":{"type":"string","enum":["needs_reply","replied","drafted"]},"replyStatus":{"type":"string","enum":["none","replied","drafted","failed","needs_reconciliation"]},"permalinkUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"metrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"providerCreatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSyncedAt":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["socialCommentId","organizationId","brandId","postTargetId","channelAccountId","platform","providerPostId","providerCommentId","parentProviderCommentId","authorName","authorHandle","body","status","replyStatus","permalinkUrl","metrics","providerCreatedAt","lastSyncedAt","createdAt","updatedAt"]}}},"required":["target","status","fetchedCount","comments"],"additionalProperties":false},{"type":"object","properties":{"target":{"type":"object","properties":{"profileId":{"type":"string"},"profileName":{"type":"string"},"publishJobId":{"anyOf":[{"type":"string"},{"type":"null"}]},"postTargetId":{"type":"string"},"channelAccountId":{"type":"string"},"channelDisplayName":{"type":"string"},"channelHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"providerPostId":{"type":"string"},"postTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSyncedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastProviderCreatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastFetchedCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["profileId","profileName","publishJobId","postTargetId","channelAccountId","channelDisplayName","channelHandle","platform","providerPostId","postTitle","publishedAt","lastSyncedAt","lastProviderCreatedAt","lastFetchedCount"],"additionalProperties":false},"status":{"type":"string","const":"failed"},"fetchedCount":{"type":"number","const":0},"error":{"type":"string"},"message":{"type":"string"},"retryAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["target","status","fetchedCount","error","message"],"additionalProperties":false}]}}},"required":["mode","dryRun","profileId","profileName","targetCount","supportedTargetCount","syncedTargetCount","fetchedCount","results"],"additionalProperties":false}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/social-comments/reply-drafts":{"post":{"tags":["Engagement"],"operationId":"createDashboardCommentReplyDraft","summary":"Create a dry-run or live AI-assisted social comment reply draft for dashboard users.","security":[{"dashboardSession":[]}],"x-env-gates":["CREAVILY_ALLOW_AI_COMMENT_REPLY=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dryRun":{"default":true,"type":"boolean"},"brandId":{"type":"string","minLength":1},"brandName":{"type":"string","minLength":1},"productName":{"type":"string","minLength":1},"productUrl":{"type":"string","minLength":1},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"postText":{"type":"string"},"commentText":{"type":"string","minLength":1},"socialContext":{"type":"string"},"tone":{"default":"helpful","type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"maxCharacters":{"type":"integer","minimum":80,"maximum":2200},"organizationId":{"type":"string","minLength":1}},"required":["platform","commentText","organizationId"]}}}},"responses":{"200":{"description":"Reply draft, prompt, and constraints.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"draft":{"type":"object","properties":{"reply":{"type":"string"},"prompt":{"type":"object","properties":{"system":{"type":"string"},"user":{"type":"string"}},"required":["system","user"]},"constraints":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"tone":{"type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"maxCharacters":{"type":"integer","minimum":80,"maximum":2200}},"required":["platform","tone","maxCharacters"]}},"required":["reply","prompt","constraints"]},"requiredEnv":{"type":"array","items":{"type":"string"}}},"required":["mode","draft","requiredEnv"]},{"type":"object","properties":{"mode":{"type":"string","const":"drafted"},"draft":{"type":"object","properties":{"reply":{"type":"string"},"prompt":{"type":"object","properties":{"system":{"type":"string"},"user":{"type":"string"}},"required":["system","user"]},"constraints":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"tone":{"type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"maxCharacters":{"type":"integer","minimum":80,"maximum":2200}},"required":["platform","tone","maxCharacters"]}},"required":["reply","prompt","constraints"]}},"required":["mode","draft"]}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/social-comments/{socialCommentId}/replies":{"post":{"tags":["Engagement"],"operationId":"replyToSocialComment","summary":"Dry-run or publish a provider comment reply and record reply evidence.","security":[{"dashboardSession":[]}],"x-required-policy":"engagement.comments.manage","x-env-gates":["CREAVILY_ALLOW_PROVIDER_COMMENT_REPLY=true","CREAVILY_ALLOW_SOCIAL_COMMENT_WRITE=true"],"parameters":[{"name":"socialCommentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"body":{"type":"string","minLength":1},"dryRun":{"default":true,"type":"boolean"}},"required":["organizationId","brandId","body"]}}}},"responses":{"200":{"description":"Dry-run plan, or provider reply result and persisted reply record.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"dryRun":{"type":"boolean","const":true},"target":{"type":"object","properties":{"organizationId":{"type":"string"},"brandId":{"type":"string"},"socialCommentId":{"type":"string"}},"required":["organizationId","brandId","socialCommentId"],"additionalProperties":false},"wouldLoadChannelTokenRef":{"type":"boolean","const":true},"wouldReplyToProvider":{"type":"boolean","const":true},"wouldRecordReply":{"type":"boolean","const":true},"requiredEnv":{"type":"array","items":{"type":"string"}}},"required":["mode","dryRun","target","wouldLoadChannelTokenRef","wouldReplyToProvider","wouldRecordReply","requiredEnv"]},{"type":"object","properties":{"mode":{"type":"string","const":"replied"},"status":{"type":"string","enum":["sent","already_sent"]},"dryRun":{"type":"boolean","const":false},"target":{"type":"object","properties":{"organizationId":{"type":"string"},"brandId":{"type":"string"},"socialCommentId":{"type":"string"}},"required":["organizationId","brandId","socialCommentId"],"additionalProperties":false},"operation":{"type":"object","properties":{"socialCommentReplyId":{"type":"string"},"socialCommentId":{"type":"string"},"channelAccountId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"status":{"type":"string","enum":["claimed","provider_call_started","sent","failed","needs_reconciliation"]},"outcomeCertainty":{"anyOf":[{"type":"string","enum":["confirmed","unknown"]},{"type":"null"}]},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["socialCommentReplyId","socialCommentId","channelAccountId","platform","status","outcomeCertainty","providerReplyId","releaseUrl","errorCode","attemptCount","createdAt","updatedAt"]},"reply":{"type":"object","properties":{"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["providerReplyId","releaseUrl"]}},"required":["mode","status","dryRun","target","operation","reply"]}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/provider-tools/execute":{"post":{"tags":["Provider Tools"],"operationId":"executeProviderTool","summary":"Dry-run or execute a dashboard provider account/composer lookup tool.","security":[{"dashboardSession":[]}],"x-env-gates":["CREAVILY_ALLOW_PROVIDER_TOOL_EXECUTION=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"name":{"type":"string","enum":["mentionSearch","pageProfile","channelCategories","boardList","privacyOptions","communitySearch"]},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"dryRun":{"default":true,"type":"boolean"}},"required":["organizationId","brandId","platform","channelAccountId","name"]}}}},"responses":{"200":{"description":"Dry-run plan, or executed provider tool result with redacted provider output.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"dryRun":{"type":"boolean","const":true},"target":{"type":"object","properties":{"organizationId":{"type":"string"},"brandId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string"},"toolName":{"type":"string","enum":["mentionSearch","pageProfile","channelCategories","boardList","privacyOptions","communitySearch"]}},"required":["organizationId","brandId","platform","channelAccountId","toolName"],"additionalProperties":false},"wouldLoadChannelTokenRef":{"type":"boolean","const":true},"wouldFetchProvider":{"type":"boolean","const":true},"requiredEnv":{"type":"array","items":{"type":"string"}}},"required":["mode","dryRun","target","wouldLoadChannelTokenRef","wouldFetchProvider","requiredEnv"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"executed"},"dryRun":{"type":"boolean","const":false},"target":{"type":"object","properties":{"organizationId":{"type":"string"},"brandId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string"},"toolName":{"type":"string","enum":["mentionSearch","pageProfile","channelCategories","boardList","privacyOptions","communitySearch"]}},"required":["organizationId","brandId","platform","channelAccountId","toolName"],"additionalProperties":false},"result":{"type":"object","properties":{"name":{"type":"string","enum":["mentionSearch","pageProfile","channelCategories","boardList","privacyOptions","communitySearch"]},"outputKind":{"type":"string","enum":["account_reference","profile","category","board","privacy_option","community"]},"items":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"profile":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"pagination":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["name","outputKind","items"]}},"required":["mode","dryRun","target","result"],"additionalProperties":false}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/public/assets/imported":{"get":{"tags":["Assets"],"operationId":"listImportedAssets","summary":"List imported creative assets scoped to the bearer principal organization.","security":[{"publicBearer":[]}],"x-required-scopes":["assets:read"],"parameters":[{"name":"brandSlug","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"productSlug","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":200}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Imported assets.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"assets":{"type":"array","items":{"type":"object","properties":{"assetId":{"type":"string"},"brandName":{"type":"string"},"brandSlug":{"type":"string"},"productName":{"type":"string"},"productSlug":{"type":"string"},"externalImageId":{"type":"string"},"sourceRowNumber":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"adminRating":{"anyOf":[{"type":"string"},{"type":"null"}]},"agentRating":{"anyOf":[{"type":"string"},{"type":"null"}]},"reviewState":{"anyOf":[{"type":"string"},{"type":"null"}]},"fileCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"publishEvidenceCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["assetId","brandName","brandSlug","productName","productSlug","externalImageId","sourceRowNumber","adminRating","agentRating","reviewState","fileCount","publishEvidenceCount","createdAt","updatedAt"],"additionalProperties":false}}},"required":["principal","assets"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/brands":{"get":{"tags":["Brands"],"operationId":"listPublicBrands","summary":"List brands and optional product IDs scoped to the bearer principal organization.","security":[{"publicBearer":[]}],"x-required-scopes":["brands:read"],"parameters":[{"name":"brandSlug","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"includeProducts","in":"query","required":false,"schema":{"default":false,"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Brands.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"brands":{"type":"array","items":{"type":"object","properties":{"brandId":{"type":"string"},"organizationId":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"timezone":{"type":"string"},"productCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"products":{"type":"array","items":{"type":"object","properties":{"productId":{"type":"string"},"brandId":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"},"productUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"shopifyProductId":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["productId","brandId","name","slug","productUrl","shopifyProductId","createdAt","updatedAt"],"additionalProperties":false}}},"required":["brandId","organizationId","name","slug","timezone","productCount","createdAt","updatedAt"],"additionalProperties":false}}},"required":["principal","brands"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/channel-accounts":{"get":{"tags":["Channels"],"operationId":"listPublicChannelAccounts","summary":"List connected channel accounts scoped to the bearer principal organization.","security":[{"publicBearer":[]}],"x-required-scopes":["channels:read"],"parameters":[{"name":"brandId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"brandSlug","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"platform","in":"query","required":false,"schema":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},{"name":"state","in":"query","required":false,"schema":{"type":"string","enum":["not_connected","connecting","in_between_steps","connected","expiring","refresh_needed","reconnect_required","disabled","deleted"]}},{"name":"includeDeleted","in":"query","required":false,"schema":{"default":false,"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Channel accounts.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"channelAccounts":{"type":"array","items":{"type":"object","properties":{"channelAccountId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandName":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"platformAppId":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"externalAccountId":{"type":"string"},"displayName":{"type":"string"},"handle":{"anyOf":[{"type":"string"},{"type":"null"}]},"state":{"type":"string","enum":["not_connected","connecting","in_between_steps","connected","expiring","refresh_needed","reconnect_required","disabled","deleted"]},"tokenExpiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"disconnectSummary":{"type":"object","properties":{"alreadyDisconnected":{"type":"boolean"},"revokedChannelTokenCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"revokedProviderTokenSecretCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"cancelledPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsReconnectPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsAttentionPostTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"cancelledBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsReconnectBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"needsAttentionBatchTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"disabledPublishingProfileChannelCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["alreadyDisconnected","revokedChannelTokenCount","revokedProviderTokenSecretCount","cancelledPostTargetCount","needsReconnectPostTargetCount","needsAttentionPostTargetCount","cancelledBatchTargetCount","needsReconnectBatchTargetCount","needsAttentionBatchTargetCount","disabledPublishingProfileChannelCount"],"additionalProperties":false},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["channelAccountId","organizationId","brandId","brandName","brandSlug","platformAppId","platform","externalAccountId","displayName","handle","state","tokenExpiresAt","createdAt","updatedAt"],"additionalProperties":false}}},"required":["principal","channelAccounts"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/publishing-profiles":{"get":{"tags":["Channels"],"operationId":"listPublicPublishingProfiles","summary":"List brand publishing profiles and their saved channel account selections.","security":[{"publicBearer":[]}],"x-required-scopes":["brands:read","channels:read"],"parameters":[{"name":"brandId","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"includeDisabledChannels","in":"query","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"description":"Brand publishing profiles.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"profiles":{"type":"array","items":{"type":"object","properties":{"profileId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"brandName":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"slug":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"isDefault":{"type":"boolean"},"scheduleSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"commentSettings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"channels":{"type":"array","items":{"type":"object","properties":{"profileChannelId":{"type":"string"},"profileId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"channelAccountId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelDisplayName":{"type":"string"},"channelHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelState":{"type":"string"},"position":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"enabled":{"type":"boolean"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["profileChannelId","profileId","organizationId","brandId","channelAccountId","platform","channelDisplayName","channelHandle","channelState","position","enabled","settings","createdAt","updatedAt"],"additionalProperties":false}}},"required":["profileId","organizationId","brandId","brandName","brandSlug","name","slug","description","isDefault","scheduleSettings","commentSettings","createdAt","updatedAt","channels"],"additionalProperties":false}}},"required":["principal","profiles"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/channel-accounts/connect-url":{"post":{"tags":["Channels"],"operationId":"createPublicChannelConnectUrl","summary":"Create a provider OAuth authorization URL from server-side platform configuration.","security":[{"publicBearer":[]}],"x-required-scopes":["channels:write"],"x-env-config":["CREAVILY_CHANNEL_OAUTH_<PLATFORM>_CLIENT_ID","CREAVILY_CHANNEL_OAUTH_<PLATFORM>_AUTHORIZE_URL","CREAVILY_CHANNEL_OAUTH_<PLATFORM>_REDIRECT_URI or CREAVILY_CHANNEL_OAUTH_REDIRECT_URI"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"state":{"type":"string","minLength":1,"maxLength":2000},"redirectUri":{"type":"string","format":"uri"},"scopes":{"type":"array","items":{"type":"string","minLength":1}}},"required":["platform"]}}}},"responses":{"200":{"description":"OAuth connection URL.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"connect":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"authorizationUrl":{"type":"string","format":"uri"},"redirectUri":{"type":"string","format":"uri"},"state":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["platform","authorizationUrl","redirectUri","state","scopes"],"additionalProperties":false}},"required":["principal","connect"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/media":{"get":{"tags":["Media"],"operationId":"listPublicMedia","summary":"List media library items scoped to the bearer principal organization.","security":[{"publicBearer":[]}],"x-required-scopes":["media:read"],"parameters":[{"name":"brandId","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Media library items.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"publicUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentAvailable":{"type":"boolean"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"bytes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lifecycleState":{"type":"string","enum":["active","deleting"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["mediaLibraryItemId","organizationId","brandId","kind","mimeType","publicUrl","contentAvailable","sha256","metadata","createdAt","updatedAt"],"additionalProperties":false}}},"required":["principal","media"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/media/{mediaLibraryItemId}/content":{"get":{"tags":["Media"],"operationId":"previewPublicMedia","summary":"Stream a private media object to an authenticated API principal.","security":[{"publicBearer":[]}],"x-required-scopes":["media:read"],"parameters":[{"name":"mediaLibraryItemId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Binary media content."},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/media/upload":{"post":{"tags":["Media"],"operationId":"uploadPublicMedia","summary":"Upload JSON/base64 media from an external agent into Creavily storage.","security":[{"publicBearer":[]}],"x-required-scopes":["media:write"],"x-env-gates":["CREAVILY_ALLOW_MEDIA_UPLOAD_WRITE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"fileName":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"dataBase64":{"type":"string","minLength":1},"altText":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["dataBase64"]}}}},"responses":{"200":{"description":"Stored media object and media library record.","content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"publicUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentAvailable":{"type":"boolean"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"bytes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lifecycleState":{"type":"string","enum":["active","deleting"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["mediaLibraryItemId","organizationId","brandId","kind","mimeType","publicUrl","contentAvailable","sha256","metadata","createdAt","updatedAt"],"additionalProperties":false},"stored":{"type":"object","properties":{"provider":{"type":"string"},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"type":"string"},"bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sha256":{"type":"string"},"originalName":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","kind","mimeType","bytes","sha256","originalName"],"additionalProperties":false},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]}},"required":["media","stored","principal"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/media/upload-multipart":{"post":{"tags":["Media"],"operationId":"uploadPublicMediaMultipart","summary":"Upload multipart/form-data media from an external agent into Creavily storage; fields must precede the file and shared stream budgets apply.","security":[{"publicBearer":[]}],"x-required-scopes":["media:write"],"x-env-gates":["CREAVILY_ALLOW_MEDIA_UPLOAD_WRITE=true","CREAVILY_MEDIA_UPLOAD_BUDGET_STORE=redis (production)"],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"brandId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"fileName":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"altText":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"file":{"type":"string","format":"binary","description":"Supported media: JPEG, PNG, GIF, WebP, AVIF, MP4. Multipart fields must precede the file."}},"required":["file"]}}}},"responses":{"200":{"description":"Stored media object and media library record.","content":{"application/json":{"schema":{"type":"object","properties":{"media":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"publicUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentAvailable":{"type":"boolean"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"bytes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lifecycleState":{"type":"string","enum":["active","deleting"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["mediaLibraryItemId","organizationId","brandId","kind","mimeType","publicUrl","contentAvailable","sha256","metadata","createdAt","updatedAt"],"additionalProperties":false},"stored":{"type":"object","properties":{"provider":{"type":"string"},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"type":"string"},"bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sha256":{"type":"string"},"originalName":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","kind","mimeType","bytes","sha256","originalName"],"additionalProperties":false},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]}},"required":["media","stored","principal"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"413":{"description":"Multipart request exceeds its configured envelope or workspace daily upload quota."},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/public/media/import-from-url":{"post":{"tags":["Media"],"operationId":"importPublicMediaFromUrl","summary":"Dry-run or fetch remote media from an external agent with shared IP, principal, workspace-byte, and concurrency budgets.","security":[{"publicBearer":[]}],"x-required-scopes":["media:write"],"x-env-gates":["CREAVILY_ALLOW_MEDIA_UPLOAD_WRITE=true","CREAVILY_ALLOW_REMOTE_MEDIA_FETCH=true","CREAVILY_REMOTE_MEDIA_IMPORT_BUDGET_STORE=redis (production)"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"url":{"type":"string","minLength":1},"dryRun":{"default":true,"type":"boolean"},"maxBytes":{"default":26214400,"type":"integer","minimum":1,"maximum":33554432},"altText":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"organizationId":{"type":"string","minLength":1}},"required":["url"]}}}},"responses":{"200":{"description":"Dry-run URL safety result or stored media record.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"media":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"publicUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentAvailable":{"type":"boolean"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"bytes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lifecycleState":{"type":"string","enum":["active","deleting"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["mediaLibraryItemId","organizationId","brandId","kind","mimeType","publicUrl","contentAvailable","sha256","metadata","createdAt","updatedAt"],"additionalProperties":false},"stored":{"type":"object","properties":{"provider":{"type":"string"},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"type":"string"},"bytes":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sha256":{"type":"string"},"originalName":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["provider","kind","mimeType","bytes","sha256","originalName"],"additionalProperties":false},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]}},"required":["media","stored","principal"],"additionalProperties":false},{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"mode":{"type":"string","const":"dry_run"},"safe":{"type":"boolean","const":true},"url":{"type":"string"},"hostname":{"type":"string"},"resolvedAddressCount":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["principal","mode","safe","url","hostname","resolvedAddressCount"],"additionalProperties":false}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"413":{"description":"Requested media size exceeds the workspace import budget."},"429":{"$ref":"#/components/responses/TooManyRequests"},"503":{"$ref":"#/components/responses/ServerError"}}}},"/v1/public/analytics/snapshots":{"get":{"tags":["Analytics"],"operationId":"listPublicAnalyticsSnapshots","summary":"List analytics snapshots scoped to the bearer principal organization.","security":[{"publicBearer":[]}],"x-required-scopes":["analytics:read"],"parameters":[{"name":"platform","in":"query","required":false,"schema":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},{"name":"postTargetId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"channelAccountId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"from","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"to","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Analytics snapshots.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"snapshots":{"type":"array","items":{"type":"object","properties":{"analyticsSnapshotId":{"type":"string"},"organizationId":{"type":"string"},"postTargetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelAccountId":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"metrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"capturedAt":{"type":"string"}},"required":["analyticsSnapshotId","organizationId","postTargetId","channelAccountId","platform","metrics","capturedAt"],"additionalProperties":false}}},"required":["principal","snapshots"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/publishing/plans/preview":{"post":{"tags":["Publishing"],"operationId":"previewPublishPlan","summary":"Validate a public publish plan without persisting work.","security":[{"publicBearer":[]}],"x-required-scopes":["publishing:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"type":"string","minLength":1},"productId":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"targets":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"text":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["platform","channelAccountId"]}},"scheduleAt":{"type":"string"},"organizationId":{"type":"string","minLength":1}},"required":["brandId","text","media","targets"]}}}},"responses":{"200":{"description":"Publish-plan readiness summary.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"plan":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"productId":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"targets":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"text":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"id":{"type":"string"},"status":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"validationIssues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["error","warning"]},"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["severity","code","message"],"additionalProperties":false}}},"required":["platform","channelAccountId","id","status","validationIssues"],"additionalProperties":false}},"scheduleAt":{"type":"string"},"id":{"type":"string"},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]}},"required":["organizationId","brandId","text","media","targets","id","status"],"additionalProperties":false},"readyTargets":{"type":"integer","minimum":0,"maximum":9007199254740991},"blockedTargets":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["principal","plan","readyTargets","blockedTargets"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/agent/publish-requests":{"post":{"tags":["Agent"],"operationId":"createAgentPublishRequest","summary":"Preview, persist, or enqueue an agent-created publish request for the bearer organization.","security":[{"publicBearer":[]}],"x-required-scopes":["agent:publish","publishing:write"],"x-env-gates":["CREAVILY_ALLOW_PUBLISH_JOB_WRITE=true for live persistence","CREAVILY_ALLOW_PUBLISH_ENQUEUE=true for live enqueue"],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"plan":{"type":"object","properties":{"brandId":{"type":"string","minLength":1},"productId":{"type":"string"},"text":{"type":"string"},"scheduleAt":{"type":"string"},"organizationId":{"type":"string","minLength":1},"profileId":{"type":"string","minLength":1},"targets":{"default":[],"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"text":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["platform","channelAccountId"]}},"media":{"default":[],"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"mediaLibraryItemIds":{"default":[],"type":"array","items":{"type":"string","minLength":1}}},"required":["brandId","text"]},"title":{"type":"string","minLength":1},"idempotencyKey":{"type":"string","minLength":1},"runAfter":{"type":"string"},"dryRun":{"default":true,"type":"boolean"},"enqueue":{"default":false,"type":"boolean"}},"required":["plan"]}}}},"responses":{"200":{"description":"Dry-run readiness summary, persisted publish job, or enqueue summary.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"plan":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"productId":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"targets":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"text":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"id":{"type":"string"},"status":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"validationIssues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["error","warning"]},"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["severity","code","message"],"additionalProperties":false}}},"required":["platform","channelAccountId","id","status","validationIssues"],"additionalProperties":false}},"scheduleAt":{"type":"string"},"id":{"type":"string"},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]}},"required":["organizationId","brandId","text","media","targets","id","status"],"additionalProperties":false},"readyTargets":{"type":"integer","minimum":0,"maximum":9007199254740991},"blockedTargets":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["mode","principal","plan","readyTargets","blockedTargets"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"persisted"},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"plan":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"productId":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"targets":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"text":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"id":{"type":"string"},"status":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"validationIssues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["error","warning"]},"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["severity","code","message"],"additionalProperties":false}}},"required":["platform","channelAccountId","id","status","validationIssues"],"additionalProperties":false}},"scheduleAt":{"type":"string"},"id":{"type":"string"},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]}},"required":["organizationId","brandId","text","media","targets","id","status"],"additionalProperties":false},"result":{"type":"object","properties":{"postGroupId":{"type":"string"},"postEntryId":{"type":"string"},"publishJobId":{"type":"string"},"postTargetIds":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"mediaLibraryItemIds":{"type":"array","items":{"type":"string"}}},"required":["postGroupId","postEntryId","publishJobId","postTargetIds","mediaLibraryItemIds"],"additionalProperties":false}},"required":["mode","principal","plan","result"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"enqueued"},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"plan":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"productId":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"targets":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"text":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"id":{"type":"string"},"status":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"validationIssues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["error","warning"]},"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["severity","code","message"],"additionalProperties":false}}},"required":["platform","channelAccountId","id","status","validationIssues"],"additionalProperties":false}},"scheduleAt":{"type":"string"},"id":{"type":"string"},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]}},"required":["organizationId","brandId","text","media","targets","id","status"],"additionalProperties":false},"result":{"type":"object","properties":{"postGroupId":{"type":"string"},"postEntryId":{"type":"string"},"publishJobId":{"type":"string"},"postTargetIds":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"mediaLibraryItemIds":{"type":"array","items":{"type":"string"}}},"required":["postGroupId","postEntryId","publishJobId","postTargetIds","mediaLibraryItemIds"],"additionalProperties":false},"enqueue":{"type":"object","properties":{"publishJobId":{"type":"string"},"targetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"enqueued":{"type":"array","items":{"type":"object","properties":{"publishJobId":{"type":"string"},"postTargetId":{"type":"string"},"platform":{"type":"string"},"queueJobId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["publishJobId","postTargetId","platform","queueJobId"],"additionalProperties":false}}},"required":["publishJobId","targetCount","enqueued"],"additionalProperties":false}},"required":["mode","principal","plan","result","enqueue"],"additionalProperties":false}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/publishing/batches/preview":{"post":{"tags":["Publishing","Agent"],"operationId":"previewPublishBatch","summary":"Preview a product-diversified batch schedule for Asset Manager or agent-created social publishing.","security":[{"publicBearer":[]}],"x-required-scopes":["agent:publish","publishing:write"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"type":"string","minLength":1},"from":{"type":"string","minLength":1},"generatedAt":{"type":"string","minLength":1},"productLinkComment":{"type":"object","properties":{"enabled":{"default":false,"type":"boolean"},"template":{"type":"string","minLength":1},"delayMs":{"type":"integer","minimum":0,"maximum":86400000},"appendTracking":{"default":true,"type":"boolean"},"utmMedium":{"type":"string","minLength":1},"utmCampaign":{"type":"string","minLength":1}}},"policy":{"type":"object","properties":{"id":{"type":"string","minLength":1},"horizonDays":{"default":14,"type":"integer","minimum":1,"maximum":60},"slots":{"minItems":1,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"timezone":{"default":"UTC","type":"string","minLength":1},"localTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":1,"maximum":7}},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"jitterSecondsMin":{"default":-600,"type":"integer","minimum":-3600,"maximum":3600},"jitterSecondsMax":{"default":600,"type":"integer","minimum":-3600,"maximum":3600},"minGapMinutes":{"default":120,"type":"integer","minimum":0,"maximum":1440},"productCooldownMinutes":{"default":240,"type":"integer","minimum":0,"maximum":43200}},"required":["id","localTime"]}}},"required":["slots"]},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"clientAssetId":{"type":"string","minLength":1},"productId":{"type":"string","minLength":1},"productUrl":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"text":{"type":"string"},"media":{"default":[],"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"mediaLibraryItemIds":{"default":[],"type":"array","items":{"type":"string","minLength":1}},"targets":{"minItems":1,"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"providerType":{"type":"string","minLength":1},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"firstComment":{"type":"object","properties":{"content":{"type":"string","minLength":1},"delayMs":{"type":"integer","minimum":0,"maximum":86400000}},"required":["content"]}},"required":["platform","channelAccountId"]}},"priority":{"type":"number"},"manualScheduleAt":{"type":"string","minLength":1}},"required":["clientAssetId","productId","text","targets"]}},"existingAssignments":{"type":"array","items":{"type":"object","properties":{"clientAssetId":{"type":"string","minLength":1},"productId":{"type":"string","minLength":1},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"scheduledAt":{"type":"string","minLength":1}},"required":["platform","channelAccountId","scheduledAt"]}}},"required":["brandId","items"]}}}},"responses":{"200":{"description":"Batch schedule preview with target-level assignments and warnings.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"batch":{"type":"object","properties":{"mode":{"type":"string","const":"preview"},"batchPreviewId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"generatedAt":{"type":"string"},"from":{"type":"string"},"policy":{"type":"object","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"horizonDays":{"type":"number"},"slotCount":{"type":"number"}},"required":["id","horizonDays","slotCount"],"additionalProperties":false},"assignmentCount":{"type":"number"},"scheduledItemCount":{"type":"number"},"unscheduledItemCount":{"type":"number"},"assignments":{"type":"array","items":{"type":"object","properties":{"clientAssetId":{"type":"string"},"productId":{"type":"string"},"productUrl":{"type":"string"},"title":{"type":"string"},"text":{"type":"string"},"slotId":{"anyOf":[{"type":"string"},{"type":"null"}]},"slotLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduledAt":{"type":"string"},"jitterSeconds":{"type":"number"},"scheduleOwner":{"type":"string","enum":["auto","manual"]},"reason":{"type":"string"},"target":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string"},"providerType":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"firstComment":{"type":"object","properties":{"content":{"type":"string"},"delayMs":{"type":"number"}},"required":["content"],"additionalProperties":false}},"required":["platform","channelAccountId"],"additionalProperties":false}},"required":["clientAssetId","productId","text","slotId","slotLabel","scheduledAt","jitterSeconds","scheduleOwner","reason","target"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"clientAssetId":{"type":"string"},"productId":{"type":"string"},"slotId":{"type":"string"}},"required":["code","message"],"additionalProperties":false}}},"required":["mode","batchPreviewId","organizationId","brandId","generatedAt","from","policy","assignmentCount","scheduledItemCount","unscheduledItemCount","assignments","warnings"],"additionalProperties":false}},"required":["principal","batch"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/publishing/batches":{"get":{"tags":["Publishing","Agent"],"operationId":"listPublishBatches","summary":"List publish batches for Asset Manager and agent status discovery.","security":[{"publicBearer":[]}],"x-required-scopes":["publishing:read"],"parameters":[{"name":"brandId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"status","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512}}],"responses":{"200":{"description":"Publish batches with item and target summaries.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"batches":{"type":"array","items":{"type":"object","properties":{"publishBatchId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"status":{"type":"string","enum":["empty","unscheduled","scheduled","partially_scheduled","processing","published","partially_published","needs_attention","failed"]},"source":{"type":"string"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"freezeHorizonMinutes":{"type":"number"},"schedulePolicy":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"preview":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"itemCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"targetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"publishedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"failedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"queuedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"publishBatchItemId":{"type":"string"},"clientAssetId":{"type":"string"},"productId":{"anyOf":[{"type":"string"},{"type":"null"}]},"clientProductId":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishJobId":{"anyOf":[{"type":"string"},{"type":"null"}]},"postGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduleOwner":{"type":"string","enum":["auto","manual"]},"scheduledAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["scheduled","unscheduled"]},"publishJobStatus":{"anyOf":[{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]},{"type":"null"}]},"targets":{"type":"array","items":{"type":"object","properties":{"publishBatchTargetId":{"type":"string"},"postTargetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string"},"scheduledAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"providerPostId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["publishBatchTargetId","postTargetId","platform","channelAccountId","scheduledAt","status","providerPostId","releaseId","releaseUrl","publishedAt"],"additionalProperties":false}}},"required":["publishBatchItemId","clientAssetId","productId","clientProductId","title","publishJobId","postGroupId","scheduleOwner","scheduledAt","status","publishJobStatus","targets"],"additionalProperties":false}}},"required":["publishBatchId","organizationId","brandId","status","source","idempotencyKey","freezeHorizonMinutes","schedulePolicy","preview","itemCount","targetCount","publishedTargetCount","failedTargetCount","queuedTargetCount","createdAt","updatedAt","items"],"additionalProperties":false}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["principal","batches"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"tags":["Publishing","Agent"],"operationId":"createPublishBatch","summary":"Persist an Asset Manager or agent-created publish batch after preview approval.","security":[{"publicBearer":[]}],"x-required-scopes":["agent:publish","publishing:write"],"x-creavily-gates":["CREAVILY_ALLOW_PUBLISH_BATCH_WRITE","CREAVILY_ALLOW_PUBLISH_JOB_WRITE"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"type":"string","minLength":1},"from":{"type":"string","minLength":1},"generatedAt":{"type":"string","minLength":1},"productLinkComment":{"type":"object","properties":{"enabled":{"default":false,"type":"boolean"},"template":{"type":"string","minLength":1},"delayMs":{"type":"integer","minimum":0,"maximum":86400000},"appendTracking":{"default":true,"type":"boolean"},"utmMedium":{"type":"string","minLength":1},"utmCampaign":{"type":"string","minLength":1}}},"policy":{"type":"object","properties":{"id":{"type":"string","minLength":1},"horizonDays":{"default":14,"type":"integer","minimum":1,"maximum":60},"slots":{"minItems":1,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"timezone":{"default":"UTC","type":"string","minLength":1},"localTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":1,"maximum":7}},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"jitterSecondsMin":{"default":-600,"type":"integer","minimum":-3600,"maximum":3600},"jitterSecondsMax":{"default":600,"type":"integer","minimum":-3600,"maximum":3600},"minGapMinutes":{"default":120,"type":"integer","minimum":0,"maximum":1440},"productCooldownMinutes":{"default":240,"type":"integer","minimum":0,"maximum":43200}},"required":["id","localTime"]}}},"required":["slots"]},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"clientAssetId":{"type":"string","minLength":1},"productId":{"type":"string","minLength":1},"productUrl":{"type":"string","minLength":1},"title":{"type":"string","minLength":1},"text":{"type":"string"},"media":{"default":[],"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"mediaLibraryItemIds":{"default":[],"type":"array","items":{"type":"string","minLength":1}},"targets":{"minItems":1,"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"providerType":{"type":"string","minLength":1},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"firstComment":{"type":"object","properties":{"content":{"type":"string","minLength":1},"delayMs":{"type":"integer","minimum":0,"maximum":86400000}},"required":["content"]}},"required":["platform","channelAccountId"]}},"priority":{"type":"number"},"manualScheduleAt":{"type":"string","minLength":1}},"required":["clientAssetId","productId","text","targets"]}},"existingAssignments":{"type":"array","items":{"type":"object","properties":{"clientAssetId":{"type":"string","minLength":1},"productId":{"type":"string","minLength":1},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"scheduledAt":{"type":"string","minLength":1}},"required":["platform","channelAccountId","scheduledAt"]}},"idempotencyKey":{"type":"string","minLength":1},"source":{"default":"agent_batch","type":"string","minLength":1},"freezeHorizonMinutes":{"default":120,"type":"integer","minimum":0,"maximum":43200},"dryRun":{"default":true,"type":"boolean"}},"required":["brandId","items"]}}}},"responses":{"200":{"description":"Dry-run preview or persisted batch mapped to publish jobs.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"batch":{"type":"object","properties":{"mode":{"type":"string","const":"preview"},"batchPreviewId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"generatedAt":{"type":"string"},"from":{"type":"string"},"policy":{"type":"object","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"horizonDays":{"type":"number"},"slotCount":{"type":"number"}},"required":["id","horizonDays","slotCount"],"additionalProperties":false},"assignmentCount":{"type":"number"},"scheduledItemCount":{"type":"number"},"unscheduledItemCount":{"type":"number"},"assignments":{"type":"array","items":{"type":"object","properties":{"clientAssetId":{"type":"string"},"productId":{"type":"string"},"productUrl":{"type":"string"},"title":{"type":"string"},"text":{"type":"string"},"slotId":{"anyOf":[{"type":"string"},{"type":"null"}]},"slotLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduledAt":{"type":"string"},"jitterSeconds":{"type":"number"},"scheduleOwner":{"type":"string","enum":["auto","manual"]},"reason":{"type":"string"},"target":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string"},"providerType":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"firstComment":{"type":"object","properties":{"content":{"type":"string"},"delayMs":{"type":"number"}},"required":["content"],"additionalProperties":false}},"required":["platform","channelAccountId"],"additionalProperties":false}},"required":["clientAssetId","productId","text","slotId","slotLabel","scheduledAt","jitterSeconds","scheduleOwner","reason","target"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"clientAssetId":{"type":"string"},"productId":{"type":"string"},"slotId":{"type":"string"}},"required":["code","message"],"additionalProperties":false}}},"required":["mode","batchPreviewId","organizationId","brandId","generatedAt","from","policy","assignmentCount","scheduledItemCount","unscheduledItemCount","assignments","warnings"],"additionalProperties":false}},"required":["mode","principal","batch"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"persisted"},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"result":{"type":"object","properties":{"publishBatchId":{"type":"string"},"status":{"type":"string","enum":["empty","unscheduled","scheduled","partially_scheduled","processing","published","partially_published","needs_attention","failed"]},"preview":{"type":"object","properties":{"mode":{"type":"string","const":"preview"},"batchPreviewId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"generatedAt":{"type":"string"},"from":{"type":"string"},"policy":{"type":"object","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"horizonDays":{"type":"number"},"slotCount":{"type":"number"}},"required":["id","horizonDays","slotCount"],"additionalProperties":false},"assignmentCount":{"type":"number"},"scheduledItemCount":{"type":"number"},"unscheduledItemCount":{"type":"number"},"assignments":{"type":"array","items":{"type":"object","properties":{"clientAssetId":{"type":"string"},"productId":{"type":"string"},"productUrl":{"type":"string"},"title":{"type":"string"},"text":{"type":"string"},"slotId":{"anyOf":[{"type":"string"},{"type":"null"}]},"slotLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduledAt":{"type":"string"},"jitterSeconds":{"type":"number"},"scheduleOwner":{"type":"string","enum":["auto","manual"]},"reason":{"type":"string"},"target":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string"},"providerType":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"firstComment":{"type":"object","properties":{"content":{"type":"string"},"delayMs":{"type":"number"}},"required":["content"],"additionalProperties":false}},"required":["platform","channelAccountId"],"additionalProperties":false}},"required":["clientAssetId","productId","text","slotId","slotLabel","scheduledAt","jitterSeconds","scheduleOwner","reason","target"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"clientAssetId":{"type":"string"},"productId":{"type":"string"},"slotId":{"type":"string"}},"required":["code","message"],"additionalProperties":false}}},"required":["mode","batchPreviewId","organizationId","brandId","generatedAt","from","policy","assignmentCount","scheduledItemCount","unscheduledItemCount","assignments","warnings"],"additionalProperties":false},"jobCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"targetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"items":{"type":"array","items":{"type":"object","properties":{"publishBatchItemId":{"type":"string"},"clientAssetId":{"type":"string"},"productId":{"type":"string"},"scheduleOwner":{"anyOf":[{"type":"string","enum":["auto","manual"]},{"type":"null"}]},"scheduledAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishJobId":{"anyOf":[{"type":"string"},{"type":"null"}]},"postGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"postTargetIds":{"type":"array","items":{"type":"string"}},"status":{"type":"string","enum":["scheduled","unscheduled"]}},"required":["publishBatchItemId","clientAssetId","productId","scheduleOwner","scheduledAt","publishJobId","postGroupId","postTargetIds","status"],"additionalProperties":false}}},"required":["publishBatchId","status","preview","jobCount","targetCount","items"],"additionalProperties":false}},"required":["mode","principal","result"],"additionalProperties":false}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/publishing/batches/{publishBatchId}":{"get":{"tags":["Publishing","Agent"],"operationId":"getPublishBatch","summary":"Read batch-level status for Asset Manager or agent polling.","security":[{"publicBearer":[]}],"x-required-scopes":["publishing:read"],"parameters":[{"name":"publishBatchId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Batch status with item and target summaries.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"batch":{"type":"object","properties":{"publishBatchId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"status":{"type":"string","enum":["empty","unscheduled","scheduled","partially_scheduled","processing","published","partially_published","needs_attention","failed"]},"source":{"type":"string"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"freezeHorizonMinutes":{"type":"number"},"schedulePolicy":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"preview":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"itemCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"targetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"publishedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"failedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"queuedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"publishBatchItemId":{"type":"string"},"clientAssetId":{"type":"string"},"productId":{"anyOf":[{"type":"string"},{"type":"null"}]},"clientProductId":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishJobId":{"anyOf":[{"type":"string"},{"type":"null"}]},"postGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduleOwner":{"type":"string","enum":["auto","manual"]},"scheduledAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["scheduled","unscheduled"]},"publishJobStatus":{"anyOf":[{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]},{"type":"null"}]},"targets":{"type":"array","items":{"type":"object","properties":{"publishBatchTargetId":{"type":"string"},"postTargetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string"},"scheduledAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"providerPostId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["publishBatchTargetId","postTargetId","platform","channelAccountId","scheduledAt","status","providerPostId","releaseId","releaseUrl","publishedAt"],"additionalProperties":false}}},"required":["publishBatchItemId","clientAssetId","productId","clientProductId","title","publishJobId","postGroupId","scheduleOwner","scheduledAt","status","publishJobStatus","targets"],"additionalProperties":false}}},"required":["publishBatchId","organizationId","brandId","status","source","idempotencyKey","freezeHorizonMinutes","schedulePolicy","preview","itemCount","targetCount","publishedTargetCount","failedTargetCount","queuedTargetCount","createdAt","updatedAt","items"],"additionalProperties":false}},"required":["principal","batch"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/publishing/batches/{publishBatchId}/enqueue-due":{"post":{"tags":["Publishing","Agent"],"operationId":"enqueueDuePublishBatchTargets","summary":"Dry-run or enqueue due batch targets into the existing publish worker queue.","security":[{"publicBearer":[]}],"x-required-scopes":["agent:publish","publishing:write"],"x-creavily-gates":["CREAVILY_ALLOW_PUBLISH_BATCH_DUE_ENQUEUE","CREAVILY_ALLOW_PUBLISH_ENQUEUE"],"parameters":[{"name":"publishBatchId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"dryRun":{"default":true,"type":"boolean"},"now":{"type":"string","minLength":1},"limit":{"default":100,"type":"integer","minimum":1,"maximum":500}}}}}},"responses":{"200":{"description":"Due targets or enqueue result.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"publishBatchId":{"type":"string"},"targetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"targets":{"type":"array","items":{"type":"object","properties":{"organizationId":{"type":"string"},"publishBatchId":{"type":"string"},"publishBatchItemId":{"type":"string"},"publishBatchTargetId":{"type":"string"},"publishJobId":{"type":"string"},"postTargetId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"scheduledAt":{"type":"string"}},"required":["organizationId","publishBatchId","publishBatchItemId","publishBatchTargetId","publishJobId","postTargetId","platform","scheduledAt"],"additionalProperties":false}}},"required":["mode","principal","publishBatchId","targetCount","targets"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"enqueued"},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"publishBatchId":{"type":"string"},"targetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"enqueue":{"anyOf":[{"type":"array","items":{"type":"object","properties":{"publishJobId":{"type":"string"},"targetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"enqueued":{"type":"array","items":{"type":"object","properties":{"publishJobId":{"type":"string"},"postTargetId":{"type":"string"},"platform":{"type":"string"},"queueJobId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["publishJobId","postTargetId","platform","queueJobId"],"additionalProperties":false}}},"required":["publishJobId","targetCount","enqueued"],"additionalProperties":false}},{"type":"object","properties":{"enqueued":{"type":"array","items":{"type":"object","properties":{"publishJobId":{"type":"string"},"postTargetId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"queueJobId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["publishJobId","postTargetId","platform","queueJobId"],"additionalProperties":false}}},"required":["enqueued"],"additionalProperties":false}]}},"required":["mode","principal","publishBatchId","targetCount","enqueue"],"additionalProperties":false}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/publishing/batches/{publishBatchId}/rebalance":{"post":{"tags":["Publishing","Agent"],"operationId":"rebalancePublishBatch","summary":"Rebalance auto-scheduled batch rows outside the freeze horizon.","security":[{"publicBearer":[]}],"x-required-scopes":["agent:publish","publishing:write"],"x-creavily-gates":["CREAVILY_ALLOW_PUBLISH_BATCH_REBALANCE"],"parameters":[{"name":"publishBatchId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dryRun":{"default":true,"type":"boolean"},"from":{"type":"string","minLength":1},"generatedAt":{"type":"string","minLength":1},"freezeHorizonMinutes":{"type":"integer","minimum":0,"maximum":43200},"productLinkComment":{"type":"object","properties":{"enabled":{"default":false,"type":"boolean"},"template":{"type":"string","minLength":1},"delayMs":{"type":"integer","minimum":0,"maximum":86400000},"appendTracking":{"default":true,"type":"boolean"},"utmMedium":{"type":"string","minLength":1},"utmCampaign":{"type":"string","minLength":1}}},"policy":{"type":"object","properties":{"id":{"type":"string","minLength":1},"horizonDays":{"default":14,"type":"integer","minimum":1,"maximum":60},"slots":{"minItems":1,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"timezone":{"default":"UTC","type":"string","minLength":1},"localTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":1,"maximum":7}},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"jitterSecondsMin":{"default":-600,"type":"integer","minimum":-3600,"maximum":3600},"jitterSecondsMax":{"default":600,"type":"integer","minimum":-3600,"maximum":3600},"minGapMinutes":{"default":120,"type":"integer","minimum":0,"maximum":1440},"productCooldownMinutes":{"default":240,"type":"integer","minimum":0,"maximum":43200}},"required":["id","localTime"]}}},"required":["slots"]}},"required":["policy"]}}}},"responses":{"200":{"description":"Rebalance result and updated preview.","content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string","const":"rebalanced"},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"result":{"type":"object","properties":{"publishBatchId":{"type":"string"},"freezeHorizonMinutes":{"type":"number"},"freezeCutoff":{"type":"string"},"eligibleItemCount":{"type":"number"},"rescheduledItemCount":{"type":"number"},"preview":{"type":"object","properties":{"mode":{"type":"string","const":"preview"},"batchPreviewId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"generatedAt":{"type":"string"},"from":{"type":"string"},"policy":{"type":"object","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"horizonDays":{"type":"number"},"slotCount":{"type":"number"}},"required":["id","horizonDays","slotCount"],"additionalProperties":false},"assignmentCount":{"type":"number"},"scheduledItemCount":{"type":"number"},"unscheduledItemCount":{"type":"number"},"assignments":{"type":"array","items":{"type":"object","properties":{"clientAssetId":{"type":"string"},"productId":{"type":"string"},"productUrl":{"type":"string"},"title":{"type":"string"},"text":{"type":"string"},"slotId":{"anyOf":[{"type":"string"},{"type":"null"}]},"slotLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduledAt":{"type":"string"},"jitterSeconds":{"type":"number"},"scheduleOwner":{"type":"string","enum":["auto","manual"]},"reason":{"type":"string"},"target":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string"},"providerType":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"firstComment":{"type":"object","properties":{"content":{"type":"string"},"delayMs":{"type":"number"}},"required":["content"],"additionalProperties":false}},"required":["platform","channelAccountId"],"additionalProperties":false}},"required":["clientAssetId","productId","text","slotId","slotLabel","scheduledAt","jitterSeconds","scheduleOwner","reason","target"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"clientAssetId":{"type":"string"},"productId":{"type":"string"},"slotId":{"type":"string"}},"required":["code","message"],"additionalProperties":false}}},"required":["mode","batchPreviewId","organizationId","brandId","generatedAt","from","policy","assignmentCount","scheduledItemCount","unscheduledItemCount","assignments","warnings"],"additionalProperties":false}},"required":["publishBatchId","freezeHorizonMinutes","freezeCutoff","eligibleItemCount","rescheduledItemCount","preview"],"additionalProperties":false}},"required":["mode","principal","result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/publishing/post-comments":{"post":{"tags":["Publishing","Agent"],"operationId":"schedulePostPublishComment","summary":"Preview or schedule a comment on an organization's own published post.","description":"dryRun=true is read-only and requires publishing:read. Omitting dryRun or setting it false commits and requires publishing:write, an idempotency key, and CREAVILY_ALLOW_POST_PUBLISH_COMMENT_WRITE=true.","security":[{"publicBearer":[]}],"x-required-scopes":["publishing:read","publishing:write"],"x-scope-modes":[{"when":"body.dryRun=true","scopes":["publishing:read"]},{"when":"body.dryRun!=true","scopes":["publishing:write"]}],"x-creavily-gates":["CREAVILY_ALLOW_POST_PUBLISH_COMMENT_WRITE"],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"postTargetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"content":{"type":"string","minLength":1,"maxLength":10000},"delayMs":{"default":300000,"type":"integer","minimum":0,"maximum":86400000},"notBefore":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"idempotencyKey":{"type":"string","minLength":8,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"dryRun":{"default":false,"type":"boolean"}},"required":["postTargetId","content"],"additionalProperties":false}}}},"responses":{"200":{"description":"Read-only preview or durable scheduled comment record.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"result":{"oneOf":[{"type":"object","properties":{"dryRun":{"type":"boolean","const":true},"preview":{"type":"object","properties":{"postTargetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","x","threads"]},"content":{"type":"string"},"delayMs":{"type":"integer","minimum":0,"maximum":86400000},"notBefore":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"runAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"state":{"type":"string","enum":["waiting_for_post","scheduled"]}},"required":["postTargetId","brandId","channelAccountId","platform","content","delayMs","notBefore","runAt","state"],"additionalProperties":false}},"required":["dryRun","preview"],"additionalProperties":false},{"type":"object","properties":{"dryRun":{"type":"boolean","const":false},"commentJob":{"type":"object","properties":{"commentJobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"postTargetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","x","threads"]},"content":{"type":"string"},"delayMs":{"type":"integer","minimum":0,"maximum":86400000},"notBefore":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"runAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"state":{"type":"string","enum":["waiting_for_post","scheduled","claimed","sending","sent","needs_attention","cancelled"]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"providerCommentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["commentJobId","organizationId","brandId","postTargetId","channelAccountId","platform","content","delayMs","notBefore","runAt","state","version","providerCommentId","lastErrorCode","lastErrorMessage","createdAt","updatedAt"],"additionalProperties":false}},"required":["dryRun","commentJob"],"additionalProperties":false}]}},"required":["principal","result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"get":{"tags":["Publishing","Agent"],"operationId":"listPostPublishComments","summary":"List durable post-publish comments for the bearer organization.","security":[{"publicBearer":[]}],"x-required-scopes":["publishing:read"],"parameters":[{"name":"brandId","in":"query","required":false,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"postTargetId","in":"query","required":false,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"channelAccountId","in":"query","required":false,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},{"name":"platform","in":"query","required":false,"schema":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","x","threads"]}},{"name":"state","in":"query","required":false,"schema":{"type":"string","enum":["waiting_for_post","scheduled","claimed","sending","sent","needs_attention","cancelled"]}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":1000000}}],"responses":{"200":{"description":"Tenant-scoped post-publish comment records.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"commentJobs":{"type":"array","items":{"type":"object","properties":{"commentJobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"postTargetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","x","threads"]},"content":{"type":"string"},"delayMs":{"type":"integer","minimum":0,"maximum":86400000},"notBefore":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"runAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"state":{"type":"string","enum":["waiting_for_post","scheduled","claimed","sending","sent","needs_attention","cancelled"]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"providerCommentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["commentJobId","organizationId","brandId","postTargetId","channelAccountId","platform","content","delayMs","notBefore","runAt","state","version","providerCommentId","lastErrorCode","lastErrorMessage","createdAt","updatedAt"],"additionalProperties":false}}},"required":["principal","commentJobs"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/publishing/post-comments/{commentJobId}":{"get":{"tags":["Publishing","Agent"],"operationId":"getPostPublishComment","summary":"Read one tenant-scoped post-publish comment.","security":[{"publicBearer":[]}],"x-required-scopes":["publishing:read"],"parameters":[{"name":"commentJobId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"responses":{"200":{"description":"Post-publish comment record.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"commentJob":{"type":"object","properties":{"commentJobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"postTargetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","x","threads"]},"content":{"type":"string"},"delayMs":{"type":"integer","minimum":0,"maximum":86400000},"notBefore":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"runAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"state":{"type":"string","enum":["waiting_for_post","scheduled","claimed","sending","sent","needs_attention","cancelled"]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"providerCommentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["commentJobId","organizationId","brandId","postTargetId","channelAccountId","platform","content","delayMs","notBefore","runAt","state","version","providerCommentId","lastErrorCode","lastErrorMessage","createdAt","updatedAt"],"additionalProperties":false}},"required":["principal","commentJob"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"patch":{"tags":["Publishing","Agent"],"operationId":"updatePostPublishComment","summary":"Edit a pending post-publish comment with optimistic version checking.","security":[{"publicBearer":[]}],"x-required-scopes":["publishing:write"],"x-creavily-gates":["CREAVILY_ALLOW_POST_PUBLISH_COMMENT_WRITE"],"parameters":[{"name":"commentJobId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"content":{"type":"string","minLength":1,"maxLength":10000},"delayMs":{"type":"integer","minimum":0,"maximum":86400000},"notBefore":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Updated post-publish comment record.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"commentJob":{"type":"object","properties":{"commentJobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"postTargetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","x","threads"]},"content":{"type":"string"},"delayMs":{"type":"integer","minimum":0,"maximum":86400000},"notBefore":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"runAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"state":{"type":"string","enum":["waiting_for_post","scheduled","claimed","sending","sent","needs_attention","cancelled"]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"providerCommentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["commentJobId","organizationId","brandId","postTargetId","channelAccountId","platform","content","delayMs","notBefore","runAt","state","version","providerCommentId","lastErrorCode","lastErrorMessage","createdAt","updatedAt"],"additionalProperties":false}},"required":["principal","commentJob"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/publishing/post-comments/{commentJobId}/cancel":{"post":{"tags":["Publishing","Agent"],"operationId":"cancelPostPublishComment","summary":"Cancel a pending post-publish comment with optimistic version checking.","security":[{"publicBearer":[]}],"x-required-scopes":["publishing:write"],"x-creavily-gates":["CREAVILY_ALLOW_POST_PUBLISH_COMMENT_WRITE"],"parameters":[{"name":"commentJobId","in":"path","required":true,"schema":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expectedVersion":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["expectedVersion"],"additionalProperties":false}}}},"responses":{"200":{"description":"Cancelled post-publish comment record.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"commentJob":{"type":"object","properties":{"commentJobId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"organizationId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"brandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"postTargetId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"channelAccountId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"platform":{"type":"string","enum":["facebook_page","instagram_business","instagram_standalone","x","threads"]},"content":{"type":"string"},"delayMs":{"type":"integer","minimum":0,"maximum":86400000},"notBefore":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"runAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},{"type":"null"}]},"state":{"type":"string","enum":["waiting_for_post","scheduled","claimed","sending","sent","needs_attention","cancelled"]},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"providerCommentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["commentJobId","organizationId","brandId","postTargetId","channelAccountId","platform","content","delayMs","notBefore","runAt","state","version","providerCommentId","lastErrorCode","lastErrorMessage","createdAt","updatedAt"],"additionalProperties":false}},"required":["principal","commentJob"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/social-comments":{"get":{"tags":["Analytics","Agent"],"operationId":"listPublicSocialComments","summary":"List stored social comments for agent Inbox discovery and reply workflows.","security":[{"publicBearer":[]}],"x-required-scopes":["analytics:read"],"parameters":[{"name":"brandId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"platform","in":"query","required":false,"schema":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},{"name":"postTargetId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"providerPostId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"status","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Tenant-scoped stored social comments without raw provider payloads.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"comments":{"type":"array","items":{"type":"object","properties":{"socialCommentId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"postTargetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"channelAccountId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"providerPostId":{"type":"string"},"providerCommentId":{"type":"string"},"parentProviderCommentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorName":{"anyOf":[{"type":"string"},{"type":"null"}]},"authorHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"status":{"type":"string","enum":["needs_reply","replied","drafted"]},"replyStatus":{"type":"string","enum":["none","replied","drafted","failed","needs_reconciliation"]},"permalinkUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"metrics":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"providerCreatedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastSyncedAt":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["socialCommentId","organizationId","brandId","postTargetId","channelAccountId","platform","providerPostId","providerCommentId","parentProviderCommentId","authorName","authorHandle","body","status","replyStatus","permalinkUrl","metrics","providerCreatedAt","lastSyncedAt","createdAt","updatedAt"]}}},"required":["principal","comments"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/social-comments/{socialCommentId}/replies":{"get":{"tags":["Analytics","Agent"],"operationId":"listPublicSocialCommentReplies","summary":"List durable reply evidence for one stored social comment.","description":"Returns tenant-scoped execution status and safe provider evidence without reply bodies, raw provider payloads, token references, or sensitive error text.","security":[{"publicBearer":[]}],"x-required-scopes":["analytics:read"],"parameters":[{"name":"socialCommentId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"brandId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":50,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Safe durable reply records ordered newest first.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"socialCommentId":{"type":"string"},"replies":{"type":"array","items":{"type":"object","properties":{"socialCommentReplyId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"socialCommentId":{"type":"string"},"channelAccountId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"status":{"type":"string","enum":["draft","claimed","provider_call_started","sent","failed","needs_reconciliation"]},"outcomeCertainty":{"anyOf":[{"type":"string","enum":["confirmed","unknown"]},{"type":"null"}]},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"providerCallStartedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"terminalAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["socialCommentReplyId","organizationId","brandId","socialCommentId","channelAccountId","platform","status","outcomeCertainty","providerReplyId","releaseUrl","errorCode","attemptCount","providerCallStartedAt","terminalAt","createdAt","updatedAt"],"additionalProperties":false}}},"required":["principal","socialCommentId","replies"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"tags":["Publishing","Agent"],"operationId":"replyToPublicSocialComment","summary":"Preview or publish an agent-approved reply to a synced social comment.","description":"Uses the authenticated public principal organization, a brand id, and a stored socialCommentId. Dry-run returns the provider/write plan. Live replies require CREAVILY_ALLOW_PROVIDER_COMMENT_REPLY=true and CREAVILY_ALLOW_SOCIAL_COMMENT_WRITE=true.","security":[{"publicBearer":[]}],"x-required-scopes":["agent:publish","publishing:write"],"x-creavily-gates":["CREAVILY_ALLOW_PROVIDER_COMMENT_REPLY","CREAVILY_ALLOW_SOCIAL_COMMENT_WRITE"],"parameters":[{"name":"socialCommentId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"type":"string","minLength":1},"body":{"type":"string","minLength":1},"dryRun":{"default":true,"type":"boolean"}},"required":["brandId","body"]}}}},"responses":{"200":{"description":"Dry-run plan or recorded provider reply evidence.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"dryRun":{"type":"boolean","const":true},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"target":{"type":"object","properties":{"organizationId":{"type":"string"},"brandId":{"type":"string"},"socialCommentId":{"type":"string"}},"required":["organizationId","brandId","socialCommentId"],"additionalProperties":false},"wouldLoadChannelTokenRef":{"type":"boolean","const":true},"wouldReplyToProvider":{"type":"boolean","const":true},"wouldRecordReply":{"type":"boolean","const":true},"requiredEnv":{"type":"array","items":{"type":"string"}}},"required":["mode","dryRun","principal","target","wouldLoadChannelTokenRef","wouldReplyToProvider","wouldRecordReply","requiredEnv"]},{"type":"object","properties":{"mode":{"type":"string","const":"replied"},"status":{"type":"string","enum":["sent","already_sent"]},"dryRun":{"type":"boolean","const":false},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"target":{"type":"object","properties":{"organizationId":{"type":"string"},"brandId":{"type":"string"},"socialCommentId":{"type":"string"}},"required":["organizationId","brandId","socialCommentId"],"additionalProperties":false},"operation":{"type":"object","properties":{"socialCommentReplyId":{"type":"string"},"socialCommentId":{"type":"string"},"channelAccountId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"status":{"type":"string","enum":["claimed","provider_call_started","sent","failed","needs_reconciliation"]},"outcomeCertainty":{"anyOf":[{"type":"string","enum":["confirmed","unknown"]},{"type":"null"}]},"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"attemptCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["socialCommentReplyId","socialCommentId","channelAccountId","platform","status","outcomeCertainty","providerReplyId","releaseUrl","errorCode","attemptCount","createdAt","updatedAt"]},"reply":{"type":"object","properties":{"providerReplyId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["providerReplyId","releaseUrl"]}},"required":["mode","status","dryRun","principal","target","operation","reply"]}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"},"502":{"$ref":"#/components/responses/ServerError"}}}},"/v1/public/social-comments/reply-drafts":{"post":{"tags":["Publishing","Agent"],"operationId":"createPublicCommentReplyDraft","summary":"Create a dry-run or live AI-assisted social comment reply draft.","description":"Combines product context, platform limits, original post text, and customer comment text. Live model calls require CREAVILY_ALLOW_AI_COMMENT_REPLY=true and OpenAI-compatible text env vars.","x-required-scopes":["agent:publish","publishing:write"],"x-creavily-gates":["CREAVILY_ALLOW_AI_COMMENT_REPLY"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dryRun":{"default":true,"type":"boolean"},"brandId":{"type":"string","minLength":1},"brandName":{"type":"string","minLength":1},"productName":{"type":"string","minLength":1},"productUrl":{"type":"string","minLength":1},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"postText":{"type":"string"},"commentText":{"type":"string","minLength":1},"socialContext":{"type":"string"},"tone":{"default":"helpful","type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"maxCharacters":{"type":"integer","minimum":80,"maximum":2200}},"required":["platform","commentText"]}}}},"responses":{"200":{"description":"Reply draft, prompt, and constraints.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"draft":{"type":"object","properties":{"reply":{"type":"string"},"prompt":{"type":"object","properties":{"system":{"type":"string"},"user":{"type":"string"}},"required":["system","user"]},"constraints":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"tone":{"type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"maxCharacters":{"type":"integer","minimum":80,"maximum":2200}},"required":["platform","tone","maxCharacters"]}},"required":["reply","prompt","constraints"]},"requiredEnv":{"type":"array","items":{"type":"string"}}},"required":["mode","principal","draft","requiredEnv"]},{"type":"object","properties":{"mode":{"type":"string","const":"drafted"},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"draft":{"type":"object","properties":{"reply":{"type":"string"},"prompt":{"type":"object","properties":{"system":{"type":"string"},"user":{"type":"string"}},"required":["system","user"]},"constraints":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"tone":{"type":"string","enum":["helpful","friendly","concise","premium","supportive"]},"maxCharacters":{"type":"integer","minimum":80,"maximum":2200}},"required":["platform","tone","maxCharacters"]}},"required":["reply","prompt","constraints"]}},"required":["mode","principal","draft"]}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/publishing/slots/find":{"get":{"tags":["Publishing"],"operationId":"findPublicPublishSlot","summary":"Preview the next available publish slot for an agent or external scheduler.","security":[{"publicBearer":[]}],"x-required-scopes":["publishing:read"],"parameters":[{"name":"brandId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"brandSlug","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"platform","in":"query","required":false,"schema":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},{"name":"channelAccountId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"productId","in":"query","required":false,"schema":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},{"name":"from","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"horizonHours","in":"query","required":false,"schema":{"default":168,"type":"integer","minimum":1,"maximum":720}},{"name":"intervalMinutes","in":"query","required":false,"schema":{"default":240,"type":"integer","minimum":5,"maximum":1440}},{"name":"windowStartHour","in":"query","required":false,"schema":{"default":9,"type":"integer","minimum":0,"maximum":23}},{"name":"windowEndHour","in":"query","required":false,"schema":{"default":18,"type":"integer","minimum":1,"maximum":24}},{"name":"productCooldownMinutes","in":"query","required":false,"schema":{"default":1440,"type":"integer","minimum":0,"maximum":43200}},{"name":"maxCandidates","in":"query","required":false,"schema":{"default":5,"type":"integer","minimum":1,"maximum":20}}],"responses":{"200":{"description":"Slot preview.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"slot":{"type":"object","properties":{"mode":{"type":"string","const":"preview"},"organizationId":{"type":"string"},"recommendation":{"anyOf":[{"type":"object","properties":{"scheduleAt":{"type":"string"}},"required":["scheduleAt"],"additionalProperties":false},{"type":"null"}]},"checkedSlotCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"policy":{"type":"object","properties":{"from":{"type":"string"},"horizonHours":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"intervalMinutes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"windowStartHour":{"type":"integer","minimum":0,"maximum":9007199254740991},"windowEndHour":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"productCooldownMinutes":{"type":"integer","minimum":0,"maximum":9007199254740991},"platform":{"anyOf":[{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},{"type":"null"}]},"channelAccountId":{"anyOf":[{"type":"string"},{"type":"null"}]},"productId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["from","horizonHours","intervalMinutes","windowStartHour","windowEndHour","productCooldownMinutes","platform","channelAccountId","productId"],"additionalProperties":false},"candidates":{"type":"array","items":{"type":"object","properties":{"scheduleAt":{"type":"string"},"available":{"type":"boolean"},"blockedReasons":{"type":"array","items":{"type":"string","enum":["same_interval","product_cooldown"]}}},"required":["scheduleAt","available","blockedReasons"],"additionalProperties":false}},"conflicts":{"type":"array","items":{"type":"object","properties":{"publishJobId":{"type":"string"},"brandId":{"type":"string"},"brandSlug":{"type":"string"},"productId":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string"},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]},"scheduledAt":{"type":"string"},"reason":{"type":"string","enum":["same_interval","product_cooldown"]}},"required":["publishJobId","brandId","brandSlug","productId","platform","channelAccountId","status","scheduledAt","reason"],"additionalProperties":false}}},"required":["mode","organizationId","recommendation","checkedSlotCount","policy","candidates","conflicts"],"additionalProperties":false}},"required":["principal","slot"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/publishing/jobs":{"get":{"tags":["Publishing"],"operationId":"listPublicPublishJobs","summary":"List publish jobs and optional target statuses for the bearer principal organization.","security":[{"publicBearer":[]}],"x-required-scopes":["publishing:read"],"parameters":[{"name":"brandId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"brandSlug","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]}},{"name":"platform","in":"query","required":false,"schema":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},{"name":"includeTargets","in":"query","required":false,"schema":{"default":false,"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Publish jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"jobs":{"type":"array","items":{"type":"object","properties":{"organizationId":{"type":"string"},"publishJobId":{"type":"string"},"postGroupId":{"type":"string"},"postEntryId":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"bodyExcerpt":{"type":"string"},"creationMethod":{"type":"string"},"brandId":{"type":"string"},"brandName":{"type":"string"},"brandSlug":{"type":"string"},"productId":{"anyOf":[{"type":"string"},{"type":"null"}]},"productName":{"anyOf":[{"type":"string"},{"type":"null"}]},"productSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]},"runAfter":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduleAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"targetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"publishedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"failedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"media":{"anyOf":[{"type":"object","properties":{"mediaLibraryItemId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"publicUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentAvailable":{"type":"boolean"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"bytes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lifecycleState":{"type":"string","enum":["active","deleting"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["mediaLibraryItemId","organizationId","brandId","kind","mimeType","publicUrl","contentAvailable","sha256","metadata","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"targets":{"type":"array","items":{"type":"object","properties":{"postTargetId":{"type":"string"},"channelAccountId":{"type":"string"},"channelDisplayName":{"type":"string"},"channelHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"text":{"type":"string"},"firstComment":{"type":"object","properties":{"content":{"type":"string"},"delayMs":{"type":"integer","minimum":0,"maximum":86400000}},"required":["content"],"additionalProperties":false},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"status":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"providerPostId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastAttemptStatus":{"anyOf":[{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},{"type":"null"}]},"lastAttemptOutcomeCertainty":{"anyOf":[{"type":"string","enum":["confirmed","unknown"]},{"type":"null"}]},"providerExecutionState":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerAttemptOutcome":{"anyOf":[{"type":"string"},{"type":"null"}]},"recoveryAction":{"type":"string","enum":["retry","reconnect","reconcile","none"]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["postTargetId","channelAccountId","channelDisplayName","channelHandle","platform","status","providerPostId","releaseId","releaseUrl","publishedAt","createdAt","updatedAt"],"additionalProperties":false}}},"required":["organizationId","publishJobId","postGroupId","postEntryId","title","body","bodyExcerpt","creationMethod","brandId","brandName","brandSlug","productId","productName","productSlug","status","runAfter","scheduleAt","targetCount","publishedTargetCount","failedTargetCount","media","createdAt","updatedAt"],"additionalProperties":false}}},"required":["principal","jobs"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"tags":["Publishing"],"operationId":"createPublishJob","summary":"Persist a publish job from a ready public publish plan.","security":[{"publicBearer":[]}],"x-required-scopes":["publishing:write"],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Optional organization-scoped idempotency key for publish job creation. A body idempotencyKey value takes precedence when both are supplied.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"plan":{"type":"object","properties":{"brandId":{"type":"string","minLength":1},"productId":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"targets":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"text":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["platform","channelAccountId"]}},"scheduleAt":{"type":"string"},"organizationId":{"type":"string","minLength":1}},"required":["brandId","text","media","targets"]},"title":{"type":"string","minLength":1},"creationMethod":{"default":"public_api","type":"string","minLength":1},"idempotencyKey":{"type":"string","minLength":1},"runAfter":{"type":"string"}},"required":["plan"]}}}},"responses":{"200":{"description":"Persisted publish job.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"plan":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"productId":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"targets":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"text":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"id":{"type":"string"},"status":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"validationIssues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["error","warning"]},"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["severity","code","message"],"additionalProperties":false}}},"required":["platform","channelAccountId","id","status","validationIssues"],"additionalProperties":false}},"scheduleAt":{"type":"string"},"id":{"type":"string"},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]}},"required":["organizationId","brandId","text","media","targets","id","status"],"additionalProperties":false},"result":{"type":"object","properties":{"postGroupId":{"type":"string"},"postEntryId":{"type":"string"},"publishJobId":{"type":"string"},"postTargetIds":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"mediaLibraryItemIds":{"type":"array","items":{"type":"string"}}},"required":["postGroupId","postEntryId","publishJobId","postTargetIds","mediaLibraryItemIds"],"additionalProperties":false}},"required":["principal","plan","result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/publishing/jobs/{publishJobId}":{"get":{"tags":["Publishing"],"operationId":"getPublicPublishJob","summary":"Read a single publish job and optional target statuses for the bearer principal organization.","security":[{"publicBearer":[]}],"x-required-scopes":["publishing:read"],"parameters":[{"name":"publishJobId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"includeTargets","in":"query","required":false,"schema":{"default":true,"type":"boolean"}}],"responses":{"200":{"description":"Publish job.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"job":{"type":"object","properties":{"organizationId":{"type":"string"},"publishJobId":{"type":"string"},"postGroupId":{"type":"string"},"postEntryId":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"bodyExcerpt":{"type":"string"},"creationMethod":{"type":"string"},"brandId":{"type":"string"},"brandName":{"type":"string"},"brandSlug":{"type":"string"},"productId":{"anyOf":[{"type":"string"},{"type":"null"}]},"productName":{"anyOf":[{"type":"string"},{"type":"null"}]},"productSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]},"runAfter":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduleAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"targetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"publishedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"failedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"media":{"anyOf":[{"type":"object","properties":{"mediaLibraryItemId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"publicUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentAvailable":{"type":"boolean"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"bytes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lifecycleState":{"type":"string","enum":["active","deleting"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["mediaLibraryItemId","organizationId","brandId","kind","mimeType","publicUrl","contentAvailable","sha256","metadata","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"targets":{"type":"array","items":{"type":"object","properties":{"postTargetId":{"type":"string"},"channelAccountId":{"type":"string"},"channelDisplayName":{"type":"string"},"channelHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"text":{"type":"string"},"firstComment":{"type":"object","properties":{"content":{"type":"string"},"delayMs":{"type":"integer","minimum":0,"maximum":86400000}},"required":["content"],"additionalProperties":false},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"status":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"providerPostId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastAttemptStatus":{"anyOf":[{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},{"type":"null"}]},"lastAttemptOutcomeCertainty":{"anyOf":[{"type":"string","enum":["confirmed","unknown"]},{"type":"null"}]},"providerExecutionState":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerAttemptOutcome":{"anyOf":[{"type":"string"},{"type":"null"}]},"recoveryAction":{"type":"string","enum":["retry","reconnect","reconcile","none"]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["postTargetId","channelAccountId","channelDisplayName","channelHandle","platform","status","providerPostId","releaseId","releaseUrl","publishedAt","createdAt","updatedAt"],"additionalProperties":false}}},"required":["organizationId","publishJobId","postGroupId","postEntryId","title","body","bodyExcerpt","creationMethod","brandId","brandName","brandSlug","productId","productName","productSlug","status","runAfter","scheduleAt","targetCount","publishedTargetCount","failedTargetCount","media","createdAt","updatedAt"],"additionalProperties":false}},"required":["principal","job"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/publishing/jobs/{publishJobId}/schedule":{"patch":{"tags":["Publishing"],"operationId":"schedulePublicPublishJob","summary":"Reschedule a draft, validating, or queued publish job.","security":[{"publicBearer":[]}],"x-required-scopes":["publishing:write"],"x-env-gates":["CREAVILY_ALLOW_PUBLISH_SCHEDULE_WRITE=true"],"parameters":[{"name":"publishJobId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scheduleAt":{"type":"string","minLength":1}},"required":["scheduleAt"]}}}},"responses":{"200":{"description":"Reschedule result.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"result":{"type":"object","properties":{"organizationId":{"type":"string"},"publishJobId":{"type":"string"},"postGroupId":{"type":"string"},"previousStatus":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]},"previousRunAfter":{"anyOf":[{"type":"string"},{"type":"null"}]},"previousScheduleAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"runAfter":{"type":"string"},"scheduleAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["organizationId","publishJobId","postGroupId","previousStatus","status","previousRunAfter","previousScheduleAt","runAfter","scheduleAt","updatedAt"],"additionalProperties":false}},"required":["principal","result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/publishing/jobs/{publishJobId}/cancel":{"post":{"tags":["Publishing"],"operationId":"cancelPublicPublishJob","summary":"Cancel a draft, validating, or queued publish job.","security":[{"publicBearer":[]}],"x-required-scopes":["publishing:write"],"x-env-gates":["CREAVILY_ALLOW_PUBLISH_CANCEL_WRITE=true"],"parameters":[{"name":"publishJobId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}}}}}},"responses":{"200":{"description":"Cancel result.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"result":{"type":"object","properties":{"organizationId":{"type":"string"},"publishJobId":{"type":"string"},"postGroupId":{"type":"string"},"previousStatus":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]},"cancelledTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"updatedAt":{"type":"string"}},"required":["organizationId","publishJobId","postGroupId","previousStatus","status","cancelledTargetCount","updatedAt"],"additionalProperties":false}},"required":["principal","result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/publishing/jobs/{publishJobId}/enqueue":{"post":{"tags":["Publishing"],"operationId":"enqueuePublishJob","summary":"Enqueue queued targets for a persisted publish job.","security":[{"publicBearer":[]}],"x-required-scopes":["publishing:write"],"parameters":[{"name":"publishJobId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"limit":{"default":100,"type":"integer","minimum":1,"maximum":500}}}}}},"responses":{"200":{"description":"Enqueue summary.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"publishJobId":{"type":"string"},"targetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"enqueued":{"type":"array","items":{"type":"object","properties":{"publishJobId":{"type":"string"},"postTargetId":{"type":"string"},"platform":{"type":"string"},"queueJobId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["publishJobId","postTargetId","platform","queueJobId"],"additionalProperties":false}}},"required":["principal","publishJobId","targetCount","enqueued"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/publishing/jobs/{publishJobId}/targets/{postTargetId}/recover":{"post":{"tags":["Publishing"],"operationId":"recoverPublicPublishTarget","summary":"Preview or create a replacement job for one failed target when the recorded provider outcome is confirmed safe to retry.","security":[{"publicBearer":[]}],"x-required-scopes":["publishing:write"],"x-env-gates":["CREAVILY_ALLOW_PUBLISH_JOB_WRITE=true when dryRun=false","CREAVILY_ALLOW_PUBLISH_ENQUEUE=true when enqueue=true"],"parameters":[{"name":"publishJobId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"postTargetId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"dryRun":{"default":true,"type":"boolean"},"enqueue":{"default":false,"type":"boolean"},"idempotencyKey":{"type":"string","minLength":1},"runAfter":{"type":"string","minLength":1}}}}}},"responses":{"200":{"description":"Recovery eligibility, preview, or replacement job result.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"blocked"},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"recovery":{"type":"object","properties":{"sourcePublishJobId":{"type":"string"},"sourcePostTargetId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"action":{"type":"string","enum":["retry","reconnect","reconcile","none"]},"eligible":{"type":"boolean"},"lastErrorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastAttemptOutcomeCertainty":{"anyOf":[{"type":"string","enum":["confirmed","unknown"]},{"type":"null"}]},"providerExecutionState":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerAttemptOutcome":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["sourcePublishJobId","sourcePostTargetId","platform","action","eligible","lastErrorCode","lastErrorMessage","lastAttemptOutcomeCertainty","providerExecutionState","providerAttemptOutcome"],"additionalProperties":false}},"required":["mode","principal","recovery"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"recovery":{"type":"object","properties":{"sourcePublishJobId":{"type":"string"},"sourcePostTargetId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"action":{"type":"string","enum":["retry","reconnect","reconcile","none"]},"eligible":{"type":"boolean"},"lastErrorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastAttemptOutcomeCertainty":{"anyOf":[{"type":"string","enum":["confirmed","unknown"]},{"type":"null"}]},"providerExecutionState":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerAttemptOutcome":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["sourcePublishJobId","sourcePostTargetId","platform","action","eligible","lastErrorCode","lastErrorMessage","lastAttemptOutcomeCertainty","providerExecutionState","providerAttemptOutcome"],"additionalProperties":false},"plan":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"productId":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"targets":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"text":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"id":{"type":"string"},"status":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"validationIssues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["error","warning"]},"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["severity","code","message"],"additionalProperties":false}}},"required":["platform","channelAccountId","id","status","validationIssues"],"additionalProperties":false}},"scheduleAt":{"type":"string"},"id":{"type":"string"},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]}},"required":["organizationId","brandId","text","media","targets","id","status"],"additionalProperties":false}},"required":["mode","principal","recovery","plan"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"persisted"},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"recovery":{"type":"object","properties":{"sourcePublishJobId":{"type":"string"},"sourcePostTargetId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"action":{"type":"string","enum":["retry","reconnect","reconcile","none"]},"eligible":{"type":"boolean"},"lastErrorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastAttemptOutcomeCertainty":{"anyOf":[{"type":"string","enum":["confirmed","unknown"]},{"type":"null"}]},"providerExecutionState":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerAttemptOutcome":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["sourcePublishJobId","sourcePostTargetId","platform","action","eligible","lastErrorCode","lastErrorMessage","lastAttemptOutcomeCertainty","providerExecutionState","providerAttemptOutcome"],"additionalProperties":false},"plan":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"productId":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"targets":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"text":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"id":{"type":"string"},"status":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"validationIssues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["error","warning"]},"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["severity","code","message"],"additionalProperties":false}}},"required":["platform","channelAccountId","id","status","validationIssues"],"additionalProperties":false}},"scheduleAt":{"type":"string"},"id":{"type":"string"},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]}},"required":["organizationId","brandId","text","media","targets","id","status"],"additionalProperties":false},"result":{"type":"object","properties":{"postGroupId":{"type":"string"},"postEntryId":{"type":"string"},"publishJobId":{"type":"string"},"postTargetIds":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"mediaLibraryItemIds":{"type":"array","items":{"type":"string"}}},"required":["postGroupId","postEntryId","publishJobId","postTargetIds","mediaLibraryItemIds"],"additionalProperties":false}},"required":["mode","principal","recovery","plan","result"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"enqueued"},"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"recovery":{"type":"object","properties":{"sourcePublishJobId":{"type":"string"},"sourcePostTargetId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"action":{"type":"string","enum":["retry","reconnect","reconcile","none"]},"eligible":{"type":"boolean"},"lastErrorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastAttemptOutcomeCertainty":{"anyOf":[{"type":"string","enum":["confirmed","unknown"]},{"type":"null"}]},"providerExecutionState":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerAttemptOutcome":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["sourcePublishJobId","sourcePostTargetId","platform","action","eligible","lastErrorCode","lastErrorMessage","lastAttemptOutcomeCertainty","providerExecutionState","providerAttemptOutcome"],"additionalProperties":false},"plan":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"productId":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"targets":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"text":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"id":{"type":"string"},"status":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"validationIssues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["error","warning"]},"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["severity","code","message"],"additionalProperties":false}}},"required":["platform","channelAccountId","id","status","validationIssues"],"additionalProperties":false}},"scheduleAt":{"type":"string"},"id":{"type":"string"},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]}},"required":["organizationId","brandId","text","media","targets","id","status"],"additionalProperties":false},"result":{"type":"object","properties":{"postGroupId":{"type":"string"},"postEntryId":{"type":"string"},"publishJobId":{"type":"string"},"postTargetIds":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"mediaLibraryItemIds":{"type":"array","items":{"type":"string"}}},"required":["postGroupId","postEntryId","publishJobId","postTargetIds","mediaLibraryItemIds"],"additionalProperties":false},"enqueue":{"type":"object","properties":{"publishJobId":{"type":"string"},"targetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"enqueued":{"type":"array","items":{"type":"object","properties":{"publishJobId":{"type":"string"},"postTargetId":{"type":"string"},"platform":{"type":"string"},"queueJobId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["publishJobId","postTargetId","platform","queueJobId"],"additionalProperties":false}}},"required":["publishJobId","targetCount","enqueued"],"additionalProperties":false}},"required":["mode","principal","recovery","plan","result","enqueue"],"additionalProperties":false}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/publishing/reconcile-urls":{"post":{"tags":["Publishing"],"operationId":"reconcilePublicPublishUrls","summary":"Dry-run or apply publish URL/release id reconciliation from recorded publish attempts.","security":[{"publicBearer":[]}],"x-required-scopes":["publishing:write"],"x-env-gates":["CREAVILY_ALLOW_PUBLISH_URL_RECONCILE=true when dryRun=false"],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"publishJobId":{"type":"string","minLength":1},"postTargetId":{"type":"string","minLength":1},"dryRun":{"default":true,"type":"boolean"},"limit":{"default":100,"type":"integer","minimum":1,"maximum":500}}}}}},"responses":{"200":{"description":"URL reconciliation result.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"result":{"type":"object","properties":{"organizationId":{"type":"string"},"dryRun":{"type":"boolean"},"inspected":{"type":"integer","minimum":0,"maximum":9007199254740991},"reconciled":{"type":"integer","minimum":0,"maximum":9007199254740991},"skipped":{"type":"array","items":{"type":"object","properties":{"publishJobId":{"type":"string"},"postTargetId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"sourceAttemptId":{"type":"string"},"reason":{"type":"string","const":"no_reconcilable_fields"}},"required":["publishJobId","postTargetId","platform","sourceAttemptId","reason"],"additionalProperties":false}},"updates":{"type":"array","items":{"type":"object","properties":{"publishJobId":{"type":"string"},"postTargetId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"sourceAttemptId":{"type":"string"},"fields":{"type":"object","properties":{"providerPostId":{"type":"string"},"releaseId":{"type":"string"},"releaseUrl":{"type":"string"},"publishedAt":{"type":"string"}},"additionalProperties":false},"existing":{"type":"object","properties":{"providerPostId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["providerPostId","releaseId","releaseUrl","publishedAt"],"additionalProperties":false}},"required":["publishJobId","postTargetId","platform","sourceAttemptId","fields","existing"],"additionalProperties":false}}},"required":["organizationId","dryRun","inspected","reconciled","skipped","updates"],"additionalProperties":false}},"required":["principal","result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/webhooks/endpoints":{"get":{"tags":["Webhooks"],"operationId":"listWebhookEndpoints","summary":"List webhook endpoints for the bearer principal organization.","security":[{"publicBearer":[]}],"x-required-scopes":["webhooks:read"],"parameters":[{"name":"includeDisabled","in":"query","required":false,"schema":{"default":true,"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Webhook endpoints.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"endpoints":{"type":"array","items":{"type":"object","properties":{"webhookEndpointId":{"type":"string"},"organizationId":{"type":"string"},"url":{"type":"string"},"secretRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"events":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["webhookEndpointId","organizationId","url","secretRef","events","enabled","createdAt","updatedAt","deletedAt"],"additionalProperties":false}}},"required":["principal","endpoints"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"tags":["Webhooks"],"operationId":"createWebhookEndpoint","summary":"Create a webhook endpoint.","security":[{"publicBearer":[]}],"x-required-scopes":["webhooks:write"],"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string"},"description":"Optional idempotency key for webhook endpoint creation. A body idempotencyKey value takes precedence when both are supplied."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","minLength":1},"secretRef":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"events":{"default":[],"type":"array","items":{"type":"string","minLength":1}},"enabled":{"default":true,"type":"boolean"},"idempotencyKey":{"type":"string","minLength":1}},"required":["url"]}}}},"responses":{"200":{"description":"Created webhook endpoint.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"endpoint":{"type":"object","properties":{"webhookEndpointId":{"type":"string"},"organizationId":{"type":"string"},"url":{"type":"string"},"secretRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"events":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["webhookEndpointId","organizationId","url","secretRef","events","enabled","createdAt","updatedAt","deletedAt"],"additionalProperties":false}},"required":["principal","endpoint"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/public/webhooks/endpoints/{endpointId}":{"patch":{"tags":["Webhooks"],"operationId":"updateWebhookEndpoint","summary":"Update a webhook endpoint.","security":[{"publicBearer":[]}],"x-required-scopes":["webhooks:write"],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","minLength":1},"secretRef":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"events":{"type":"array","items":{"type":"string","minLength":1}},"enabled":{"type":"boolean"}},"anyOf":[{"required":["url"]},{"required":["secretRef"]},{"required":["events"]},{"required":["enabled"]}]}}}},"responses":{"200":{"description":"Updated webhook endpoint.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"endpoint":{"type":"object","properties":{"webhookEndpointId":{"type":"string"},"organizationId":{"type":"string"},"url":{"type":"string"},"secretRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"events":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["webhookEndpointId","organizationId","url","secretRef","events","enabled","createdAt","updatedAt","deletedAt"],"additionalProperties":false}},"required":["principal","endpoint"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"delete":{"tags":["Webhooks"],"operationId":"deleteWebhookEndpoint","summary":"Soft-delete a webhook endpoint.","security":[{"publicBearer":[]}],"x-required-scopes":["webhooks:write"],"parameters":[{"name":"endpointId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Deleted webhook endpoint.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"endpoint":{"type":"object","properties":{"webhookEndpointId":{"type":"string"},"organizationId":{"type":"string"},"url":{"type":"string"},"secretRef":{"anyOf":[{"type":"string"},{"type":"null"}]},"events":{"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["webhookEndpointId","organizationId","url","secretRef","events","enabled","createdAt","updatedAt","deletedAt"],"additionalProperties":false}},"required":["principal","endpoint"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/publishing/validate":{"post":{"tags":["Publishing"],"operationId":"validateDashboardPublishPost","summary":"Validate a dashboard publish post against provider capabilities.","security":[{"dashboardSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["platform","text","media"]}}}},"responses":{"200":{"description":"Provider capability validation result.","content":{"application/json":{"schema":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"issues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["error","warning"]},"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["severity","code","message"],"additionalProperties":false}}},"required":["platform","issues"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/publishing/plans":{"post":{"tags":["Publishing"],"operationId":"previewDashboardPublishPlan","summary":"Preview a publish plan for a dashboard workspace.","security":[{"dashboardSession":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"productId":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"targets":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"text":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["platform","channelAccountId"]}},"scheduleAt":{"type":"string"}},"required":["organizationId","brandId","text","media","targets"]}}}},"responses":{"200":{"description":"Publish plan preview.","content":{"application/json":{"schema":{"type":"object","properties":{"plan":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"productId":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"targets":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"text":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"id":{"type":"string"},"status":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"validationIssues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["error","warning"]},"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["severity","code","message"],"additionalProperties":false}}},"required":["platform","channelAccountId","id","status","validationIssues"],"additionalProperties":false}},"scheduleAt":{"type":"string"},"id":{"type":"string"},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]}},"required":["organizationId","brandId","text","media","targets","id","status"],"additionalProperties":false},"readyTargets":{"type":"integer","minimum":0,"maximum":9007199254740991},"blockedTargets":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["plan","readyTargets","blockedTargets"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/publishing/calendar":{"get":{"tags":["Publishing"],"operationId":"listDashboardPublishCalendar","summary":"List publish calendar items for a dashboard workspace.","security":[{"dashboardSession":[]}],"parameters":[{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","minLength":1}},{"name":"from","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"to","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}}],"responses":{"200":{"description":"Publish calendar items.","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"organizationId":{"type":"string"},"publishJobId":{"type":"string"},"postGroupId":{"type":"string"},"postEntryId":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"bodyExcerpt":{"type":"string"},"creationMethod":{"type":"string"},"brandId":{"type":"string"},"productId":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]},"calendarAt":{"type":"string"},"runAfter":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduleAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"targetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"queuedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"publishedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"failedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"platforms":{"type":"array","items":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},"targets":{"type":"array","items":{"type":"object","properties":{"postTargetId":{"type":"string"},"channelAccountId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"text":{"type":"string"},"firstComment":{"type":"object","properties":{"content":{"type":"string"},"delayMs":{"type":"integer","minimum":0,"maximum":86400000}},"required":["content"],"additionalProperties":false}},"required":["postTargetId","channelAccountId","platform","text"],"additionalProperties":false}},"media":{"anyOf":[{"type":"object","properties":{"mediaLibraryItemId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"publicUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentAvailable":{"type":"boolean"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"bytes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lifecycleState":{"type":"string","enum":["active","deleting"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["mediaLibraryItemId","organizationId","brandId","kind","mimeType","publicUrl","contentAvailable","sha256","metadata","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["organizationId","publishJobId","postGroupId","postEntryId","title","body","bodyExcerpt","creationMethod","brandId","productId","status","calendarAt","runAfter","scheduleAt","targetCount","queuedTargetCount","publishedTargetCount","failedTargetCount","platforms","media","createdAt","updatedAt"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/publishing/jobs":{"get":{"tags":["Publishing"],"operationId":"listDashboardPublishJobs","summary":"List publish jobs for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"publishing.jobs.read","parameters":[{"name":"brandId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"brandSlug","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]}},{"name":"platform","in":"query","required":false,"schema":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]}},{"name":"includeTargets","in":"query","required":false,"schema":{"default":false,"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Publish jobs.","content":{"application/json":{"schema":{"type":"object","properties":{"jobs":{"type":"array","items":{"type":"object","properties":{"organizationId":{"type":"string"},"publishJobId":{"type":"string"},"postGroupId":{"type":"string"},"postEntryId":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"body":{"type":"string"},"bodyExcerpt":{"type":"string"},"creationMethod":{"type":"string"},"brandId":{"type":"string"},"brandName":{"type":"string"},"brandSlug":{"type":"string"},"productId":{"anyOf":[{"type":"string"},{"type":"null"}]},"productName":{"anyOf":[{"type":"string"},{"type":"null"}]},"productSlug":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]},"runAfter":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduleAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"targetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"publishedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"failedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"media":{"anyOf":[{"type":"object","properties":{"mediaLibraryItemId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"kind":{"type":"string","enum":["image","video","gif"]},"mimeType":{"anyOf":[{"type":"string"},{"type":"null"}]},"publicUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"contentAvailable":{"type":"boolean"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}]},"bytes":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}]},"lifecycleState":{"type":"string","enum":["active","deleting"]},"metadata":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["mediaLibraryItemId","organizationId","brandId","kind","mimeType","publicUrl","contentAvailable","sha256","metadata","createdAt","updatedAt"],"additionalProperties":false},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"targets":{"type":"array","items":{"type":"object","properties":{"postTargetId":{"type":"string"},"channelAccountId":{"type":"string"},"channelDisplayName":{"type":"string"},"channelHandle":{"anyOf":[{"type":"string"},{"type":"null"}]},"text":{"type":"string"},"firstComment":{"type":"object","properties":{"content":{"type":"string"},"delayMs":{"type":"integer","minimum":0,"maximum":86400000}},"required":["content"],"additionalProperties":false},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"status":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"providerPostId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastErrorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"lastAttemptStatus":{"anyOf":[{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},{"type":"null"}]},"lastAttemptOutcomeCertainty":{"anyOf":[{"type":"string","enum":["confirmed","unknown"]},{"type":"null"}]},"providerExecutionState":{"anyOf":[{"type":"string"},{"type":"null"}]},"providerAttemptOutcome":{"anyOf":[{"type":"string"},{"type":"null"}]},"recoveryAction":{"type":"string","enum":["retry","reconnect","reconcile","none"]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["postTargetId","channelAccountId","channelDisplayName","channelHandle","platform","status","providerPostId","releaseId","releaseUrl","publishedAt","createdAt","updatedAt"],"additionalProperties":false}}},"required":["organizationId","publishJobId","postGroupId","postEntryId","title","body","bodyExcerpt","creationMethod","brandId","brandName","brandSlug","productId","productName","productSlug","status","runAfter","scheduleAt","targetCount","publishedTargetCount","failedTargetCount","media","createdAt","updatedAt"],"additionalProperties":false}}},"required":["jobs"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}},"post":{"tags":["Publishing"],"operationId":"createDashboardPublishJob","summary":"Create a publish job for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-env-gates":["CREAVILY_ALLOW_PUBLISH_JOB_WRITE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"plan":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"productId":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"targets":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"text":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["platform","channelAccountId"]}},"scheduleAt":{"type":"string"}},"required":["organizationId","brandId","text","media","targets"]},"title":{"type":"string","minLength":1},"creationMethod":{"default":"composer","type":"string","minLength":1},"requestedByUserId":{"type":"string","minLength":1},"idempotencyKey":{"type":"string","minLength":1},"runAfter":{"type":"string"}},"required":["plan"]}}}},"responses":{"200":{"description":"Created publish job.","content":{"application/json":{"schema":{"type":"object","properties":{"plan":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"brandId":{"type":"string","minLength":1},"productId":{"type":"string"},"text":{"type":"string"},"media":{"type":"array","items":{"type":"object","properties":{"mediaLibraryItemId":{"type":"string","minLength":1},"kind":{"type":"string","enum":["image","video","gif"]},"url":{"type":"string","minLength":1},"mimeType":{"type":"string"},"bytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"durationSeconds":{"type":"number","exclusiveMinimum":0},"altText":{"type":"string"},"thumbnailUrl":{"type":"string"}},"required":["kind","url"]}},"targets":{"type":"array","items":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"text":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"id":{"type":"string"},"status":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"validationIssues":{"type":"array","items":{"type":"object","properties":{"severity":{"type":"string","enum":["error","warning"]},"code":{"type":"string"},"message":{"type":"string"},"field":{"type":"string"}},"required":["severity","code","message"],"additionalProperties":false}}},"required":["platform","channelAccountId","id","status","validationIssues"],"additionalProperties":false}},"scheduleAt":{"type":"string"},"id":{"type":"string"},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]}},"required":["organizationId","brandId","text","media","targets","id","status"],"additionalProperties":false},"result":{"type":"object","properties":{"postGroupId":{"type":"string"},"postEntryId":{"type":"string"},"publishJobId":{"type":"string"},"postTargetIds":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"mediaLibraryItemIds":{"type":"array","items":{"type":"string"}}},"required":["postGroupId","postEntryId","publishJobId","postTargetIds","mediaLibraryItemIds"],"additionalProperties":false}},"required":["plan","result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"422":{"$ref":"#/components/responses/UnprocessableEntity"}}}},"/v1/publishing/batches":{"get":{"tags":["Publishing"],"operationId":"listDashboardPublishBatches","summary":"List publish batches for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"publishing.jobs.read","parameters":[{"name":"brandId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"status","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":512}},{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Publish batches.","content":{"application/json":{"schema":{"type":"object","properties":{"batches":{"type":"array","items":{"type":"object","properties":{"publishBatchId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"status":{"type":"string","enum":["empty","unscheduled","scheduled","partially_scheduled","processing","published","partially_published","needs_attention","failed"]},"source":{"type":"string"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"freezeHorizonMinutes":{"type":"number"},"schedulePolicy":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"preview":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"itemCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"targetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"publishedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"failedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"queuedTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"publishBatchItemId":{"type":"string"},"clientAssetId":{"type":"string"},"productId":{"anyOf":[{"type":"string"},{"type":"null"}]},"clientProductId":{"anyOf":[{"type":"string"},{"type":"null"}]},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishJobId":{"anyOf":[{"type":"string"},{"type":"null"}]},"postGroupId":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduleOwner":{"type":"string","enum":["auto","manual"]},"scheduledAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["scheduled","unscheduled"]},"publishJobStatus":{"anyOf":[{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]},{"type":"null"}]},"targets":{"type":"array","items":{"type":"object","properties":{"publishBatchTargetId":{"type":"string"},"postTargetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string"},"scheduledAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"providerPostId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["publishBatchTargetId","postTargetId","platform","channelAccountId","scheduledAt","status","providerPostId","releaseId","releaseUrl","publishedAt"],"additionalProperties":false}}},"required":["publishBatchItemId","clientAssetId","productId","clientProductId","title","publishJobId","postGroupId","scheduleOwner","scheduledAt","status","publishJobStatus","targets"],"additionalProperties":false}}},"required":["publishBatchId","organizationId","brandId","status","source","idempotencyKey","freezeHorizonMinutes","schedulePolicy","preview","itemCount","targetCount","publishedTargetCount","failedTargetCount","queuedTargetCount","createdAt","updatedAt","items"],"additionalProperties":false}},"nextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["batches"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/publishing/batches/{publishBatchId}/rebalance":{"post":{"tags":["Publishing"],"operationId":"rebalanceDashboardPublishBatch","summary":"Preview or apply a dashboard publish-batch rebalance.","security":[{"dashboardSession":[]}],"x-required-policy":"publishing.batches.manage","x-env-gates":["CREAVILY_ALLOW_PUBLISH_BATCH_REBALANCE=true"],"parameters":[{"name":"publishBatchId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dryRun":{"default":true,"type":"boolean"},"from":{"type":"string","minLength":1},"generatedAt":{"type":"string","minLength":1},"freezeHorizonMinutes":{"type":"integer","minimum":0,"maximum":43200},"productLinkComment":{"type":"object","properties":{"enabled":{"default":false,"type":"boolean"},"template":{"type":"string","minLength":1},"delayMs":{"type":"integer","minimum":0,"maximum":86400000},"appendTracking":{"default":true,"type":"boolean"},"utmMedium":{"type":"string","minLength":1},"utmCampaign":{"type":"string","minLength":1}}},"policy":{"type":"object","properties":{"id":{"type":"string","minLength":1},"horizonDays":{"default":14,"type":"integer","minimum":1,"maximum":60},"slots":{"minItems":1,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1},"label":{"type":"string","minLength":1},"timezone":{"default":"UTC","type":"string","minLength":1},"localTime":{"type":"string","pattern":"^([01]\\d|2[0-3]):([0-5]\\d)$"},"weekdays":{"type":"array","items":{"type":"integer","minimum":1,"maximum":7}},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string","minLength":1},"jitterSecondsMin":{"default":-600,"type":"integer","minimum":-3600,"maximum":3600},"jitterSecondsMax":{"default":600,"type":"integer","minimum":-3600,"maximum":3600},"minGapMinutes":{"default":120,"type":"integer","minimum":0,"maximum":1440},"productCooldownMinutes":{"default":240,"type":"integer","minimum":0,"maximum":43200}},"required":["id","localTime"]}}},"required":["slots"]},"organizationId":{"type":"string","minLength":1}},"required":["policy","organizationId"]}}}},"responses":{"200":{"description":"Publish-batch rebalance result.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","const":"dry_run"},"result":{"type":"object","properties":{"publishBatchId":{"type":"string"},"freezeHorizonMinutes":{"type":"number"},"freezeCutoff":{"type":"string"},"eligibleItemCount":{"type":"number"},"reschedulableItemCount":{"type":"number"},"preview":{"type":"object","properties":{"mode":{"type":"string","const":"preview"},"batchPreviewId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"generatedAt":{"type":"string"},"from":{"type":"string"},"policy":{"type":"object","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"horizonDays":{"type":"number"},"slotCount":{"type":"number"}},"required":["id","horizonDays","slotCount"],"additionalProperties":false},"assignmentCount":{"type":"number"},"scheduledItemCount":{"type":"number"},"unscheduledItemCount":{"type":"number"},"assignments":{"type":"array","items":{"type":"object","properties":{"clientAssetId":{"type":"string"},"productId":{"type":"string"},"productUrl":{"type":"string"},"title":{"type":"string"},"text":{"type":"string"},"slotId":{"anyOf":[{"type":"string"},{"type":"null"}]},"slotLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduledAt":{"type":"string"},"jitterSeconds":{"type":"number"},"scheduleOwner":{"type":"string","enum":["auto","manual"]},"reason":{"type":"string"},"target":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string"},"providerType":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"firstComment":{"type":"object","properties":{"content":{"type":"string"},"delayMs":{"type":"number"}},"required":["content"],"additionalProperties":false}},"required":["platform","channelAccountId"],"additionalProperties":false}},"required":["clientAssetId","productId","text","slotId","slotLabel","scheduledAt","jitterSeconds","scheduleOwner","reason","target"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"clientAssetId":{"type":"string"},"productId":{"type":"string"},"slotId":{"type":"string"}},"required":["code","message"],"additionalProperties":false}}},"required":["mode","batchPreviewId","organizationId","brandId","generatedAt","from","policy","assignmentCount","scheduledItemCount","unscheduledItemCount","assignments","warnings"],"additionalProperties":false}},"required":["publishBatchId","freezeHorizonMinutes","freezeCutoff","eligibleItemCount","reschedulableItemCount","preview"],"additionalProperties":false}},"required":["mode","result"],"additionalProperties":false},{"type":"object","properties":{"mode":{"type":"string","const":"rebalanced"},"result":{"type":"object","properties":{"publishBatchId":{"type":"string"},"freezeHorizonMinutes":{"type":"number"},"freezeCutoff":{"type":"string"},"eligibleItemCount":{"type":"number"},"rescheduledItemCount":{"type":"number"},"preview":{"type":"object","properties":{"mode":{"type":"string","const":"preview"},"batchPreviewId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"type":"string"},"generatedAt":{"type":"string"},"from":{"type":"string"},"policy":{"type":"object","properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"horizonDays":{"type":"number"},"slotCount":{"type":"number"}},"required":["id","horizonDays","slotCount"],"additionalProperties":false},"assignmentCount":{"type":"number"},"scheduledItemCount":{"type":"number"},"unscheduledItemCount":{"type":"number"},"assignments":{"type":"array","items":{"type":"object","properties":{"clientAssetId":{"type":"string"},"productId":{"type":"string"},"productUrl":{"type":"string"},"title":{"type":"string"},"text":{"type":"string"},"slotId":{"anyOf":[{"type":"string"},{"type":"null"}]},"slotLabel":{"anyOf":[{"type":"string"},{"type":"null"}]},"scheduledAt":{"type":"string"},"jitterSeconds":{"type":"number"},"scheduleOwner":{"type":"string","enum":["auto","manual"]},"reason":{"type":"string"},"target":{"type":"object","properties":{"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"channelAccountId":{"type":"string"},"providerType":{"type":"string"},"settings":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"firstComment":{"type":"object","properties":{"content":{"type":"string"},"delayMs":{"type":"number"}},"required":["content"],"additionalProperties":false}},"required":["platform","channelAccountId"],"additionalProperties":false}},"required":["clientAssetId","productId","text","slotId","slotLabel","scheduledAt","jitterSeconds","scheduleOwner","reason","target"],"additionalProperties":false}},"warnings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"clientAssetId":{"type":"string"},"productId":{"type":"string"},"slotId":{"type":"string"}},"required":["code","message"],"additionalProperties":false}}},"required":["mode","batchPreviewId","organizationId","brandId","generatedAt","from","policy","assignmentCount","scheduledItemCount","unscheduledItemCount","assignments","warnings"],"additionalProperties":false}},"required":["publishBatchId","freezeHorizonMinutes","freezeCutoff","eligibleItemCount","rescheduledItemCount","preview"],"additionalProperties":false}},"required":["mode","result"],"additionalProperties":false}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/publishing/jobs/{publishJobId}/schedule":{"patch":{"tags":["Publishing"],"operationId":"scheduleDashboardPublishJob","summary":"Schedule a publish job for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-env-gates":["CREAVILY_ALLOW_PUBLISH_SCHEDULE_WRITE=true"],"parameters":[{"name":"publishJobId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"scheduleAt":{"type":"string","minLength":1},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId","scheduleAt"]}}}},"responses":{"200":{"description":"Scheduled publish job.","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"organizationId":{"type":"string"},"publishJobId":{"type":"string"},"postGroupId":{"type":"string"},"previousStatus":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]},"previousRunAfter":{"anyOf":[{"type":"string"},{"type":"null"}]},"previousScheduleAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"runAfter":{"type":"string"},"scheduleAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["organizationId","publishJobId","postGroupId","previousStatus","status","previousRunAfter","previousScheduleAt","runAfter","scheduleAt","updatedAt"],"additionalProperties":false}},"required":["result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/publishing/jobs/{publishJobId}/cancel":{"post":{"tags":["Publishing"],"operationId":"cancelDashboardPublishJob","summary":"Cancel a publish job for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-env-gates":["CREAVILY_ALLOW_PUBLISH_CANCEL_WRITE=true"],"parameters":[{"name":"publishJobId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"reason":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId"]}}}},"responses":{"200":{"description":"Cancelled publish job.","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"organizationId":{"type":"string"},"publishJobId":{"type":"string"},"postGroupId":{"type":"string"},"previousStatus":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]},"status":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]},"cancelledTargetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"updatedAt":{"type":"string"}},"required":["organizationId","publishJobId","postGroupId","previousStatus","status","cancelledTargetCount","updatedAt"],"additionalProperties":false}},"required":["result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/publishing/jobs/{publishJobId}/queue/reconcile":{"post":{"tags":["Publishing"],"operationId":"reconcileDashboardPublishJobQueue","summary":"Dry-run or reconcile queued targets for a dashboard publish job.","security":[{"dashboardSession":[]}],"x-required-policy":"publishing.queue.reconcile","x-env-gates":["CREAVILY_ALLOW_PUBLISH_QUEUE_RECONCILE=true"],"parameters":[{"name":"publishJobId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"dryRun":{"default":true,"type":"boolean"},"maxJobs":{"default":1000,"type":"integer","minimum":1,"maximum":5000}},"required":["organizationId"]}}}},"responses":{"200":{"description":"Publish queue reconciliation result.","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"organizationId":{"type":"string"},"publishJobId":{"type":"string"},"dryRun":{"type":"boolean"},"states":{"type":"array","items":{"type":"string","enum":["waiting","delayed","prioritized","paused","waiting-children"]}},"scannedJobCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"matchedJobCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"removedJobCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"failedRemoveCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"jobs":{"type":"array","items":{"type":"object","properties":{"queueJobId":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"type":"string"},"postTargetId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"removed":{"type":"boolean"},"error":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["queueJobId","name","postTargetId","platform","removed","error"],"additionalProperties":false}}},"required":["organizationId","publishJobId","dryRun","states","scannedJobCount","matchedJobCount","removedJobCount","failedRemoveCount","jobs"],"additionalProperties":false}},"required":["result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/publishing/reconcile-urls":{"post":{"tags":["Publishing"],"operationId":"reconcileDashboardPublishUrls","summary":"Dry-run or reconcile published URLs for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"publishing.urls.reconcile","x-env-gates":["CREAVILY_ALLOW_PUBLISH_URL_RECONCILE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"publishJobId":{"type":"string","minLength":1},"postTargetId":{"type":"string","minLength":1},"dryRun":{"default":true,"type":"boolean"},"limit":{"default":100,"type":"integer","minimum":1,"maximum":500},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId"]}}}},"responses":{"200":{"description":"Publish URL reconciliation result.","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"organizationId":{"type":"string"},"dryRun":{"type":"boolean"},"inspected":{"type":"integer","minimum":0,"maximum":9007199254740991},"reconciled":{"type":"integer","minimum":0,"maximum":9007199254740991},"skipped":{"type":"array","items":{"type":"object","properties":{"publishJobId":{"type":"string"},"postTargetId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"sourceAttemptId":{"type":"string"},"reason":{"type":"string","const":"no_reconcilable_fields"}},"required":["publishJobId","postTargetId","platform","sourceAttemptId","reason"],"additionalProperties":false}},"updates":{"type":"array","items":{"type":"object","properties":{"publishJobId":{"type":"string"},"postTargetId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"sourceAttemptId":{"type":"string"},"fields":{"type":"object","properties":{"providerPostId":{"type":"string"},"releaseId":{"type":"string"},"releaseUrl":{"type":"string"},"publishedAt":{"type":"string"}},"additionalProperties":false},"existing":{"type":"object","properties":{"providerPostId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseId":{"anyOf":[{"type":"string"},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["providerPostId","releaseId","releaseUrl","publishedAt"],"additionalProperties":false}},"required":["publishJobId","postTargetId","platform","sourceAttemptId","fields","existing"],"additionalProperties":false}}},"required":["organizationId","dryRun","inspected","reconciled","skipped","updates"],"additionalProperties":false}},"required":["result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/publishing/jobs/{publishJobId}/targets/{postTargetId}/attempts":{"post":{"tags":["Publishing"],"operationId":"recordDashboardPublishTargetAttempt","summary":"Record a publish-target execution result for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"publishing.results.manage","x-env-gates":["CREAVILY_ALLOW_PUBLISH_RESULT_WRITE=true"],"parameters":[{"name":"publishJobId","in":"path","required":true,"schema":{"type":"string","minLength":1}},{"name":"postTargetId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"status":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"requestSummary":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"redactedResponse":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"errorCode":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"errorMessage":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"providerPostId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"releaseId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"releaseUrl":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"actorUserId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["organizationId","platform","status"]}}}},"responses":{"200":{"description":"Recorded publish-target attempt.","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"publishAttemptId":{"type":"string"},"publishJobId":{"type":"string"},"postTargetId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"attemptNumber":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"targetStatus":{"type":"string","enum":["draft","queued","uploading_media","publishing","published","failed","cancelled","removed","needs_reconnect","needs_attention"]},"publishJobStatus":{"type":"string","enum":["draft","validating","queued","processing","partially_published","published","failed","cancelled","needs_attention"]}},"required":["publishAttemptId","publishJobId","postTargetId","platform","attemptNumber","targetStatus","publishJobStatus"],"additionalProperties":false}},"required":["result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/publishing/jobs/{publishJobId}/enqueue":{"post":{"tags":["Publishing"],"operationId":"enqueueDashboardPublishJob","summary":"Enqueue a publish job for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-env-gates":["CREAVILY_ALLOW_PUBLISH_ENQUEUE=true"],"parameters":[{"name":"publishJobId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1},"actorUserId":{"type":"string","minLength":1},"limit":{"default":100,"type":"integer","minimum":1,"maximum":500}},"required":["organizationId"]}}}},"responses":{"200":{"description":"Enqueued publish job.","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"publishJobId":{"type":"string"},"targetCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"enqueuedCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"skippedCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"enqueued":{"type":"array","items":{"type":"object","properties":{"publishJobId":{"type":"string"},"postTargetId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"queueJobId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["publishJobId","postTargetId","platform","queueJobId"],"additionalProperties":false}},"skipped":{"type":"array","items":{"type":"object","properties":{"publishJobId":{"type":"string"},"postTargetId":{"type":"string"},"platform":{"type":"string","enum":["instagram_business","instagram_standalone","facebook_page","threads","youtube","pinterest","tiktok","x"]},"queueJobId":{"anyOf":[{"type":"string"},{"type":"null"}]},"reason":{"type":"string","enum":["already_enqueued"]}},"required":["publishJobId","postTargetId","platform","queueJobId","reason"],"additionalProperties":false}}},"required":["publishJobId","targetCount","enqueuedCount","skippedCount","enqueued","skipped"],"additionalProperties":false}},"required":["result"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}}},"/v1/automations/sources":{"get":{"tags":["Automations"],"operationId":"listDashboardAutomationSources","summary":"List automation sources for a dashboard workspace.","security":[{"dashboardSession":[]}],"parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["rss","asset_manager","agent"]}},{"name":"includeDisabled","in":"query","required":false,"schema":{"default":false,"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Automation sources.","content":{"application/json":{"schema":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"object","properties":{"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["rss","asset_manager","agent"]},"name":{"type":"string"},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["automationSourceId","organizationId","brandId","type","name","config","state","enabled","createdAt","updatedAt","deletedAt"],"additionalProperties":false}}},"required":["sources"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}},"post":{"tags":["Automations"],"operationId":"createDashboardAutomationSource","summary":"Create an automation source for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"automations.sources.manage","x-env-gates":["CREAVILY_ALLOW_AUTOMATION_WRITE=true"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"type":{"type":"string","enum":["rss","asset_manager","agent"]},"name":{"type":"string","minLength":1},"config":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"state":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"enabled":{"default":true,"type":"boolean"},"idempotencyKey":{"type":"string","minLength":1},"organizationId":{"type":"string","minLength":1}},"required":["type","name","organizationId"]}}}},"responses":{"200":{"description":"Created automation source.","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"object","properties":{"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["rss","asset_manager","agent"]},"name":{"type":"string"},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["automationSourceId","organizationId","brandId","type","name","config","state","enabled","createdAt","updatedAt","deletedAt"],"additionalProperties":false}},"required":["source"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/automations/sources/{automationSourceId}":{"patch":{"tags":["Automations"],"operationId":"updateDashboardAutomationSource","summary":"Update an automation source for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"automations.sources.manage","x-env-gates":["CREAVILY_ALLOW_AUTOMATION_WRITE=true"],"parameters":[{"name":"automationSourceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"type":{"type":"string","enum":["rss","asset_manager","agent"]},"name":{"type":"string","minLength":1},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"enabled":{"type":"boolean"},"organizationId":{"type":"string","minLength":1}},"required":["organizationId"],"anyOf":[{"required":["brandId"]},{"required":["type"]},{"required":["name"]},{"required":["config"]},{"required":["state"]},{"required":["enabled"]}]}}}},"responses":{"200":{"description":"Updated automation source.","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"object","properties":{"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["rss","asset_manager","agent"]},"name":{"type":"string"},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["automationSourceId","organizationId","brandId","type","name","config","state","enabled","createdAt","updatedAt","deletedAt"],"additionalProperties":false}},"required":["source"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["Automations"],"operationId":"deleteDashboardAutomationSource","summary":"Soft-delete an automation source for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"automations.sources.manage","x-env-gates":["CREAVILY_ALLOW_AUTOMATION_WRITE=true"],"parameters":[{"name":"automationSourceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"organizationId":{"type":"string","minLength":1}},"required":["organizationId"]}}}},"responses":{"200":{"description":"Deleted automation source.","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"object","properties":{"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["rss","asset_manager","agent"]},"name":{"type":"string"},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["automationSourceId","organizationId","brandId","type","name","config","state","enabled","createdAt","updatedAt","deletedAt"],"additionalProperties":false}},"required":["source"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/automations/runs":{"get":{"tags":["Automations"],"operationId":"listDashboardAutomationRuns","summary":"List automation runs for a dashboard workspace.","security":[{"dashboardSession":[]}],"parameters":[{"name":"automationSourceId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["queued","running","succeeded","failed","cancelled"]}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}},{"name":"organizationId","in":"query","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Automation runs.","content":{"application/json":{"schema":{"type":"object","properties":{"runs":{"type":"array","items":{"type":"object","properties":{"automationRunId":{"type":"string"},"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","failed","cancelled"]},"trigger":{"type":"string","enum":["manual","schedule","source_poll","webhook","agent"]},"input":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"output":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["automationRunId","automationSourceId","organizationId","status","trigger","input","output","errorCode","errorMessage","idempotencyKey","startedAt","completedAt","createdAt","updatedAt"],"additionalProperties":false}}},"required":["runs"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/automations/sources/{automationSourceId}/runs":{"post":{"tags":["Automations"],"operationId":"createDashboardAutomationRun","summary":"Request an automation run for a dashboard source.","security":[{"dashboardSession":[]}],"x-required-policy":"automations.sources.manage","x-env-gates":["CREAVILY_ALLOW_AUTOMATION_WRITE=true"],"parameters":[{"name":"automationSourceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"trigger":{"default":"manual","type":"string","enum":["manual","schedule","source_poll","webhook","agent"]},"input":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"idempotencyKey":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"organizationId":{"type":"string","minLength":1}},"required":["organizationId"]}}}},"responses":{"200":{"description":"Created automation run.","content":{"application/json":{"schema":{"type":"object","properties":{"run":{"type":"object","properties":{"automationRunId":{"type":"string"},"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","failed","cancelled"]},"trigger":{"type":"string","enum":["manual","schedule","source_poll","webhook","agent"]},"input":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"output":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["automationRunId","automationSourceId","organizationId","status","trigger","input","output","errorCode","errorMessage","idempotencyKey","startedAt","completedAt","createdAt","updatedAt"],"additionalProperties":false}},"required":["run"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/automations/runs/{automationRunId}":{"patch":{"tags":["Automations"],"operationId":"recordDashboardAutomationRun","summary":"Record an automation run result for a dashboard workspace.","security":[{"dashboardSession":[]}],"x-required-policy":"automations.sources.manage","x-env-gates":["CREAVILY_ALLOW_AUTOMATION_WRITE=true"],"parameters":[{"name":"automationRunId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["queued","running","succeeded","failed","cancelled"]},"output":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"errorCode":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"errorMessage":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"organizationId":{"type":"string","minLength":1}},"required":["status","organizationId"]}}}},"responses":{"200":{"description":"Recorded automation run.","content":{"application/json":{"schema":{"type":"object","properties":{"run":{"type":"object","properties":{"automationRunId":{"type":"string"},"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","failed","cancelled"]},"trigger":{"type":"string","enum":["manual","schedule","source_poll","webhook","agent"]},"input":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"output":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["automationRunId","automationSourceId","organizationId","status","trigger","input","output","errorCode","errorMessage","idempotencyKey","startedAt","completedAt","createdAt","updatedAt"],"additionalProperties":false}},"required":["run"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/public/automations/sources":{"get":{"tags":["Automations"],"operationId":"listAutomationSources","summary":"List automation sources.","security":[{"publicBearer":[]}],"x-required-scopes":["automation:read"],"parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["rss","asset_manager","agent"]}},{"name":"includeDisabled","in":"query","required":false,"schema":{"default":false,"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Automation sources.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"sources":{"type":"array","items":{"type":"object","properties":{"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["rss","asset_manager","agent"]},"name":{"type":"string"},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["automationSourceId","organizationId","brandId","type","name","config","state","enabled","createdAt","updatedAt","deletedAt"],"additionalProperties":false}}},"required":["principal","sources"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"post":{"tags":["Automations"],"operationId":"createAutomationSource","summary":"Create an automation source.","security":[{"publicBearer":[]}],"x-required-scopes":["automation:write"],"parameters":[{"name":"Idempotency-Key","in":"header","schema":{"type":"string"},"description":"Optional idempotency key for automation source creation. A body idempotencyKey value takes precedence when both are supplied."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"type":{"type":"string","enum":["rss","asset_manager","agent"]},"name":{"type":"string","minLength":1},"config":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"state":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"enabled":{"default":true,"type":"boolean"},"idempotencyKey":{"type":"string","minLength":1}},"required":["type","name"]}}}},"responses":{"200":{"description":"Created automation source.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"source":{"type":"object","properties":{"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["rss","asset_manager","agent"]},"name":{"type":"string"},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["automationSourceId","organizationId","brandId","type","name","config","state","enabled","createdAt","updatedAt","deletedAt"],"additionalProperties":false}},"required":["principal","source"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/ServerError"}}}},"/v1/public/automations/sources/{automationSourceId}":{"patch":{"tags":["Automations"],"operationId":"updateAutomationSource","summary":"Update an automation source.","security":[{"publicBearer":[]}],"x-required-scopes":["automation:write"],"parameters":[{"name":"automationSourceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brandId":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"type":{"type":"string","enum":["rss","asset_manager","agent"]},"name":{"type":"string","minLength":1},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"enabled":{"type":"boolean"}},"anyOf":[{"required":["brandId"]},{"required":["type"]},{"required":["name"]},{"required":["config"]},{"required":["state"]},{"required":["enabled"]}]}}}},"responses":{"200":{"description":"Updated automation source.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"source":{"type":"object","properties":{"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["rss","asset_manager","agent"]},"name":{"type":"string"},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["automationSourceId","organizationId","brandId","type","name","config","state","enabled","createdAt","updatedAt","deletedAt"],"additionalProperties":false}},"required":["principal","source"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}},"delete":{"tags":["Automations"],"operationId":"deleteAutomationSource","summary":"Soft-delete an automation source.","security":[{"publicBearer":[]}],"x-required-scopes":["automation:write"],"parameters":[{"name":"automationSourceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Deleted automation source.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"source":{"type":"object","properties":{"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"brandId":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":{"type":"string","enum":["rss","asset_manager","agent"]},"name":{"type":"string"},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"enabled":{"type":"boolean"},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"deletedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["automationSourceId","organizationId","brandId","type","name","config","state","enabled","createdAt","updatedAt","deletedAt"],"additionalProperties":false}},"required":["principal","source"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/automations/runs":{"get":{"tags":["Automations"],"operationId":"listAutomationRuns","summary":"List automation runs.","security":[{"publicBearer":[]}],"x-required-scopes":["automation:read"],"parameters":[{"name":"automationSourceId","in":"query","required":false,"schema":{"type":"string","minLength":1}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["queued","running","succeeded","failed","cancelled"]}},{"name":"limit","in":"query","required":false,"schema":{"default":100,"type":"integer","minimum":1,"maximum":500}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Automation runs.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"runs":{"type":"array","items":{"type":"object","properties":{"automationRunId":{"type":"string"},"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","failed","cancelled"]},"trigger":{"type":"string","enum":["manual","schedule","source_poll","webhook","agent"]},"input":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"output":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["automationRunId","automationSourceId","organizationId","status","trigger","input","output","errorCode","errorMessage","idempotencyKey","startedAt","completedAt","createdAt","updatedAt"],"additionalProperties":false}}},"required":["principal","runs"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/automations/sources/{automationSourceId}/runs":{"post":{"tags":["Automations"],"operationId":"createAutomationRun","summary":"Request an automation run for a source.","security":[{"publicBearer":[]}],"x-required-scopes":["automation:write"],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Optional idempotency key for automation run requests. A body idempotencyKey value takes precedence when both are supplied.","schema":{"type":"string"}},{"name":"automationSourceId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"trigger":{"default":"manual","type":"string","enum":["manual","schedule","source_poll","webhook","agent"]},"input":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"idempotencyKey":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}}}}}},"responses":{"200":{"description":"Created automation run.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"run":{"type":"object","properties":{"automationRunId":{"type":"string"},"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","failed","cancelled"]},"trigger":{"type":"string","enum":["manual","schedule","source_poll","webhook","agent"]},"input":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"output":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["automationRunId","automationSourceId","organizationId","status","trigger","input","output","errorCode","errorMessage","idempotencyKey","startedAt","completedAt","createdAt","updatedAt"],"additionalProperties":false}},"required":["principal","run"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/public/automations/runs/{automationRunId}":{"patch":{"tags":["Automations"],"operationId":"recordAutomationRun","summary":"Record automation run status or output.","security":[{"publicBearer":[]}],"x-required-scopes":["automation:write"],"parameters":[{"name":"automationRunId","in":"path","required":true,"schema":{"type":"string","minLength":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["queued","running","succeeded","failed","cancelled"]},"output":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"errorCode":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]},"errorMessage":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}]}},"required":["status"]}}}},"responses":{"200":{"description":"Recorded automation run.","content":{"application/json":{"schema":{"type":"object","properties":{"principal":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"api_key"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","scopes"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"oauth_access_token"},"organizationId":{"type":"string"},"subjectId":{"type":"string"},"authorizationId":{"type":"string"},"oauthAppId":{"type":"string"},"userId":{"type":"string"},"clientId":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}}},"required":["kind","organizationId","subjectId","authorizationId","oauthAppId","userId","clientId","scopes"],"additionalProperties":false}]},"run":{"type":"object","properties":{"automationRunId":{"type":"string"},"automationSourceId":{"type":"string"},"organizationId":{"type":"string"},"status":{"type":"string","enum":["queued","running","succeeded","failed","cancelled"]},"trigger":{"type":"string","enum":["manual","schedule","source_poll","webhook","agent"]},"input":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"output":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"errorCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"errorMessage":{"anyOf":[{"type":"string"},{"type":"null"}]},"idempotencyKey":{"anyOf":[{"type":"string"},{"type":"null"}]},"startedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"completedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["automationRunId","automationSourceId","organizationId","status","trigger","input","output","errorCode","errorMessage","idempotencyKey","startedAt","completedAt","createdAt","updatedAt"],"additionalProperties":false}},"required":["principal","run"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}}}}