{ "openapi": "3.1.0", "info": { "title": "Comet Creator Publishing API", "version": "2026-09-24", "description": "Server-to-server partner page authoring and creator media API, alongside the existing Publisher GraphQL API. Implementation defaults disabled; obtain the approved environment origin, IAM APP_CLIENT credential and scoped grant from Comet. Do not send Authorization headers or browser credentials. This spec covers authoring, media upload/library, deletion and event polling; public reader/operator endpoints and signup delivery are outside its scope. Content schema versions 1 and 2 are supported; the outer response envelope remains schemaVersion 1." }, "servers": [ { "url": "https://{cometOrigin}", "description": "Replace the reserved placeholder with your operator-provided integration origin. No live host is implied.", "variables": { "cometOrigin": { "default": "comet-api.example.invalid" } } } ], "tags": [ { "name": "Creator publishing" } ], "security": [ { "CometAppKey": [] } ], "paths": { "/v1/partners/{partnerId}/creators/{externalCreatorId}": { "put": { "operationId": "bindCreator", "tags": [ "Creator publishing" ], "summary": "Bind an already verified creator", "description": "Requires creator:bind. No request body is needed. Does not provision a grant or create a global creator identity.", "parameters": [ { "$ref": "#/components/parameters/partnerId" }, { "$ref": "#/components/parameters/externalCreatorId" }, { "$ref": "#/components/parameters/GrantGeneration" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "description": "Successful operation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Binding" } } } }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "404": { "$ref": "#/components/responses/404" }, "409": { "$ref": "#/components/responses/409" }, "413": { "$ref": "#/components/responses/413" }, "422": { "$ref": "#/components/responses/422" }, "503": { "$ref": "#/components/responses/503" } }, "x-required-capability": "creator:bind" } }, "/v1/partners/{partnerId}/creators/{externalCreatorId}/capabilities": { "get": { "operationId": "getPublishingCapabilities", "tags": [ "Creator publishing" ], "summary": "Discover current operations and content versions", "description": "Requires page:read. May be called before binding. The legacy content descriptor is v1; contentVersions also advertises v2, currently preferred.", "parameters": [ { "$ref": "#/components/parameters/partnerId" }, { "$ref": "#/components/parameters/externalCreatorId" }, { "$ref": "#/components/parameters/GrantGeneration" } ], "responses": { "200": { "description": "Successful operation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Capabilities" } } } }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "404": { "$ref": "#/components/responses/404" }, "409": { "$ref": "#/components/responses/409" }, "413": { "$ref": "#/components/responses/413" }, "422": { "$ref": "#/components/responses/422" }, "503": { "$ref": "#/components/responses/503" } }, "x-required-capability": "page:read" } }, "/v1/partners/{partnerId}/creators/{externalCreatorId}/pages": { "get": { "operationId": "listCreatorPages", "tags": [ "Creator publishing" ], "summary": "List persisted pages", "description": "Requires page:read. Requires active binding. IDs sort lexicographically, not chronologically. Start a fresh listing to discover concurrent insertions before a cursor.", "parameters": [ { "$ref": "#/components/parameters/partnerId" }, { "$ref": "#/components/parameters/externalCreatorId" }, { "$ref": "#/components/parameters/GrantGeneration" }, { "name": "after", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, "description": "Exclusive page ID cursor; use the prior nextCursor." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } } ], "responses": { "200": { "description": "Successful operation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PageList" } } } }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "404": { "$ref": "#/components/responses/404" }, "409": { "$ref": "#/components/responses/409" }, "413": { "$ref": "#/components/responses/413" }, "422": { "$ref": "#/components/responses/422" }, "503": { "$ref": "#/components/responses/503" } }, "x-required-capability": "page:read" }, "post": { "operationId": "createCreatorPage", "tags": [ "Creator publishing" ], "summary": "Create a draft", "description": "Requires page:edit. ", "parameters": [ { "$ref": "#/components/parameters/partnerId" }, { "$ref": "#/components/parameters/externalCreatorId" }, { "$ref": "#/components/parameters/GrantGeneration" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "201": { "description": "Successful operation. POST operations use HTTP 201, including idempotent retries.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Page" } } } }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "404": { "$ref": "#/components/responses/404" }, "409": { "$ref": "#/components/responses/409" }, "413": { "$ref": "#/components/responses/413" }, "422": { "$ref": "#/components/responses/422" }, "503": { "$ref": "#/components/responses/503" } }, "x-required-capability": "page:edit", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePage" } } } } } }, "/v1/partners/{partnerId}/creators/{externalCreatorId}/pages/{pageId}": { "get": { "operationId": "getCreatorPage", "tags": [ "Creator publishing" ], "summary": "Read draft and current public URL", "description": "Requires page:read. ", "parameters": [ { "$ref": "#/components/parameters/partnerId" }, { "$ref": "#/components/parameters/externalCreatorId" }, { "$ref": "#/components/parameters/GrantGeneration" }, { "$ref": "#/components/parameters/pageId" } ], "responses": { "200": { "description": "Successful operation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PageRead" } } } }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "404": { "$ref": "#/components/responses/404" }, "409": { "$ref": "#/components/responses/409" }, "413": { "$ref": "#/components/responses/413" }, "422": { "$ref": "#/components/responses/422" }, "503": { "$ref": "#/components/responses/503" } }, "x-required-capability": "page:read" }, "put": { "operationId": "saveCreatorPage", "tags": [ "Creator publishing" ], "summary": "Save a draft with version checks", "description": "Requires page:edit. ", "parameters": [ { "$ref": "#/components/parameters/partnerId" }, { "$ref": "#/components/parameters/externalCreatorId" }, { "$ref": "#/components/parameters/GrantGeneration" }, { "$ref": "#/components/parameters/pageId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "description": "Successful operation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Page" } } } }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "404": { "$ref": "#/components/responses/404" }, "409": { "$ref": "#/components/responses/409" }, "413": { "$ref": "#/components/responses/413" }, "422": { "$ref": "#/components/responses/422" }, "503": { "$ref": "#/components/responses/503" } }, "x-required-capability": "page:edit", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SavePage" } } } } }, "delete": { "operationId": "deleteCreatorPage", "tags": [ "Creator publishing" ], "summary": "Delete a page using exact reviewed versions", "description": "Requires page:edit and, when expectedActiveRevision is nonnull, page:publish. Comet compares all three expected values with current state, so a false null cannot bypass publish authority. Retains a tombstone/history, clears the active publication, increments publicationVersion and emits page.deleted. Deleted pages disappear from author/public reads and page lists. Uploaded media and workspace are retained; no restore endpoint. Retry an unknown outcome with the identical key and body.", "parameters": [ { "$ref": "#/components/parameters/partnerId" }, { "$ref": "#/components/parameters/externalCreatorId" }, { "$ref": "#/components/parameters/GrantGeneration" }, { "$ref": "#/components/parameters/pageId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "200": { "description": "Successful operation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeletionReceipt" } } } }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "404": { "$ref": "#/components/responses/404" }, "409": { "$ref": "#/components/responses/409" }, "413": { "$ref": "#/components/responses/413" }, "422": { "$ref": "#/components/responses/422" }, "503": { "$ref": "#/components/responses/503" } }, "x-required-capability": "page:edit; additionally page:publish when expectedActiveRevision is nonnull", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeletePage" } } } } } }, "/v1/partners/{partnerId}/creators/{externalCreatorId}/pages/{pageId}/preview": { "get": { "operationId": "previewCreatorPage", "tags": [ "Creator publishing" ], "summary": "Read an exact saved draft preview", "description": "Requires page:read. Rejects stale versions. Returns content and digest, not an HTML preview, public URL or credential.", "parameters": [ { "$ref": "#/components/parameters/partnerId" }, { "$ref": "#/components/parameters/externalCreatorId" }, { "$ref": "#/components/parameters/GrantGeneration" }, { "$ref": "#/components/parameters/pageId" }, { "name": "draftVersion", "in": "query", "required": true, "schema": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } } ], "responses": { "200": { "description": "Successful operation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Page" } } } }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "404": { "$ref": "#/components/responses/404" }, "409": { "$ref": "#/components/responses/409" }, "413": { "$ref": "#/components/responses/413" }, "422": { "$ref": "#/components/responses/422" }, "503": { "$ref": "#/components/responses/503" } }, "x-required-capability": "page:read" } }, "/v1/partners/{partnerId}/creators/{externalCreatorId}/pages/{pageId}/publish": { "post": { "operationId": "publishCreatorPage", "tags": [ "Creator publishing" ], "summary": "Publish the exact reviewed draft", "description": "Requires page:publish. Requires exact draft, active revision, publication version and digest. Publication readiness is enforced. Hosting registration is separate; reread GET page for publicUrl.", "parameters": [ { "$ref": "#/components/parameters/partnerId" }, { "$ref": "#/components/parameters/externalCreatorId" }, { "$ref": "#/components/parameters/GrantGeneration" }, { "$ref": "#/components/parameters/pageId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "201": { "description": "Successful operation. POST operations use HTTP 201, including idempotent retries.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicationReceipt" } } } }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "404": { "$ref": "#/components/responses/404" }, "409": { "$ref": "#/components/responses/409" }, "413": { "$ref": "#/components/responses/413" }, "422": { "$ref": "#/components/responses/422" }, "503": { "$ref": "#/components/responses/503" } }, "x-required-capability": "page:publish", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublishPage" } } } } } }, "/v1/partners/{partnerId}/creators/{externalCreatorId}/pages/{pageId}/unpublish": { "post": { "operationId": "unpublishCreatorPage", "tags": [ "Creator publishing" ], "summary": "Clear the active publication", "description": "Requires page:publish. Retains immutable history and increments publicationVersion. Digest is not required.", "parameters": [ { "$ref": "#/components/parameters/partnerId" }, { "$ref": "#/components/parameters/externalCreatorId" }, { "$ref": "#/components/parameters/GrantGeneration" }, { "$ref": "#/components/parameters/pageId" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "201": { "description": "Successful operation. POST operations use HTTP 201, including idempotent retries.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicationReceipt" } } } }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "404": { "$ref": "#/components/responses/404" }, "409": { "$ref": "#/components/responses/409" }, "413": { "$ref": "#/components/responses/413" }, "422": { "$ref": "#/components/responses/422" }, "503": { "$ref": "#/components/responses/503" } }, "x-required-capability": "page:publish", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnpublishPage" } } } } } }, "/v1/partners/{partnerId}/creators/{externalCreatorId}/pages/{pageId}/revisions/{revisionId}": { "get": { "operationId": "getCreatorRevision", "tags": [ "Creator publishing" ], "summary": "Read the still-current immutable revision", "description": "Requires page:read. Only the current active revision is readable here. This authenticated route does not provide public hosting or arbitrary history access.", "parameters": [ { "$ref": "#/components/parameters/partnerId" }, { "$ref": "#/components/parameters/externalCreatorId" }, { "$ref": "#/components/parameters/GrantGeneration" }, { "$ref": "#/components/parameters/pageId" }, { "$ref": "#/components/parameters/revisionId" } ], "responses": { "200": { "description": "Successful operation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Revision" } } } }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "404": { "$ref": "#/components/responses/404" }, "409": { "$ref": "#/components/responses/409" }, "413": { "$ref": "#/components/responses/413" }, "422": { "$ref": "#/components/responses/422" }, "503": { "$ref": "#/components/responses/503" } }, "x-required-capability": "page:read" } }, "/v1/partners/{partnerId}/creators/{externalCreatorId}/events": { "get": { "operationId": "listCreatorEvents", "tags": [ "Creator publishing" ], "summary": "Poll durable lifecycle and publication events", "description": "Requires events:read. Returns a raw array, ascending realm-local sequence. Persist event IDs and cursor with consumer updates. No server acknowledgement endpoint. Separate event-reader grant supports terminal lifecycle reads while a realm is inactive.", "parameters": [ { "$ref": "#/components/parameters/partnerId" }, { "$ref": "#/components/parameters/externalCreatorId" }, { "$ref": "#/components/parameters/GrantGeneration" }, { "name": "after", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "maximum": 9007199254740991, "default": 0 } } ], "responses": { "200": { "description": "Successful operation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Event" }, "maxItems": 100 } } } }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "404": { "$ref": "#/components/responses/404" }, "409": { "$ref": "#/components/responses/409" }, "413": { "$ref": "#/components/responses/413" }, "422": { "$ref": "#/components/responses/422" }, "503": { "$ref": "#/components/responses/503" } }, "x-required-capability": "events:read" } }, "/v1/partners/{partnerId}/creators/{externalCreatorId}/media": { "get": { "operationId": "listCreatorMedia", "tags": [ "Creator publishing" ], "summary": "List ready creator media", "description": "Requires page:read and configured media. Only ready assets in the current verified binding are returned, newest ready timestamp first with descending ID as tiebreaker. Does not browse legacy organization-wide media.", "parameters": [ { "$ref": "#/components/parameters/partnerId" }, { "$ref": "#/components/parameters/externalCreatorId" }, { "$ref": "#/components/parameters/GrantGeneration" }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 88, "pattern": "^[0-9]{1,16}_upload_[a-f0-9]{64}$", "description": "Opaque ready-time/upload-ID cursor. Use the exact nextCursor; server also validates its timestamp." } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 24 } } ], "responses": { "200": { "description": "Successful operation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MediaList" } } } }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "404": { "$ref": "#/components/responses/404" }, "409": { "$ref": "#/components/responses/409" }, "413": { "$ref": "#/components/responses/413" }, "422": { "$ref": "#/components/responses/422" }, "503": { "$ref": "#/components/responses/503" } }, "x-required-capability": "page:read" }, "post": { "operationId": "uploadCreatorMedia", "tags": [ "Creator publishing" ], "summary": "Upload a creator image or video", "description": "Requires page:edit and configured media. JSON proxy upload: JPEG/PNG/WebP <=5 MiB; MP4/WebM <=20 MiB decoded. Only this route permits 28 MiB JSON. Preserve original key and bytes after unknown outcomes. UPLOAD_IN_PROGRESS means retry the same command after the active lease (60 seconds image / 150 seconds video). Current authority is checked again before finalization and replay. Cancellation cannot guarantee rollback of provider upload.", "parameters": [ { "$ref": "#/components/parameters/partnerId" }, { "$ref": "#/components/parameters/externalCreatorId" }, { "$ref": "#/components/parameters/GrantGeneration" }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "responses": { "201": { "description": "Successful operation. POST operations use HTTP 201, including idempotent retries.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MediaUploaded" } } } }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "403": { "$ref": "#/components/responses/403" }, "404": { "$ref": "#/components/responses/404" }, "409": { "$ref": "#/components/responses/409" }, "413": { "$ref": "#/components/responses/413" }, "422": { "$ref": "#/components/responses/422" }, "503": { "$ref": "#/components/responses/503" } }, "x-required-capability": "page:edit", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MediaUpload" } } } }, "x-max-body-bytes": 29360128 } } }, "components": { "securitySchemes": { "CometAppKey": { "type": "apiKey", "in": "header", "name": "x-api-key", "description": "Server-held IAM APP_CLIENT API key with an explicit scoped grant. JWT/Authorization headers are rejected." } }, "parameters": { "partnerId": { "name": "partnerId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" } }, "externalCreatorId": { "name": "externalCreatorId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" } }, "pageId": { "name": "pageId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" } }, "revisionId": { "name": "revisionId", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" } }, "GrantGeneration": { "name": "x-grant-generation", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[0-9]+$" }, "description": "Current operator-provisioned grant generation; numeric value must be a nonnegative safe integer." }, "IdempotencyKey": { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, "description": "Reuse the exact key and payload after an ambiguous write. Scoped to principal, realm, operation and page; current authority is rechecked." } }, "schemas": { "Identifier": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, "Version": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "Digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "Realm": { "type": "object", "properties": { "environment": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, "partnerId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, "externalCreatorId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" } }, "required": [ "environment", "partnerId", "externalCreatorId" ], "additionalProperties": false }, "HeaderV1": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, "type": { "const": "header" }, "showSection": { "type": "boolean" }, "layout": { "enum": [ "left", "center" ] }, "titleLocales": { "type": "object", "minProperties": 1, "maxProperties": 10, "propertyNames": { "pattern": "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$" }, "additionalProperties": { "type": "string", "maxLength": 500, "pattern": "^[^<>\\u0000-\\u0008]*$", "description": "Server measures length in UTF-16 code units; JSON Schema maxLength is only a structural approximation for supplementary Unicode characters." } }, "subtitleLocales": { "type": "object", "minProperties": 1, "maxProperties": 10, "propertyNames": { "pattern": "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$" }, "additionalProperties": { "type": "string", "maxLength": 500, "pattern": "^[^<>\\u0000-\\u0008]*$", "description": "Server measures length in UTF-16 code units; JSON Schema maxLength is only a structural approximation for supplementary Unicode characters." } } }, "required": [ "id", "type", "showSection", "layout", "titleLocales", "subtitleLocales" ], "additionalProperties": false }, "LinksV1": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, "type": { "const": "links" }, "showSection": { "type": "boolean" }, "heading": { "type": "string", "maxLength": 500, "pattern": "^[^<>\\u0000-\\u0008]*$", "description": "Server measures length in UTF-16 code units; JSON Schema maxLength is only a structural approximation for supplementary Unicode characters." }, "appearance": { "enum": [ "solid", "outline", "minimal" ] }, "links": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, "label": { "type": "string", "maxLength": 500, "pattern": "^[^<>\\u0000-\\u0008]*$", "description": "Server measures length in UTF-16 code units; JSON Schema maxLength is only a structural approximation for supplementary Unicode characters." }, "url": { "type": "string", "maxLength": 2048, "pattern": "^[^<>\\u0000-\\u0008]*$", "description": "Server measures length in UTF-16 code units; JSON Schema maxLength is only a structural approximation for supplementary Unicode characters." } }, "required": [ "id", "label", "url" ], "additionalProperties": false }, "maxItems": 50, "description": "Row IDs must be unique within this section." } }, "required": [ "id", "type", "showSection", "heading", "appearance", "links" ], "additionalProperties": false }, "ContentV1": { "type": "object", "properties": { "schemaVersion": { "type": "integer", "const": 1 }, "sections": { "type": "array", "items": { "oneOf": [ { "$ref": "#/components/schemas/HeaderV1" }, { "$ref": "#/components/schemas/LinksV1" } ] }, "maxItems": 30, "description": "Section IDs must be unique. Empty sections are accepted." } }, "required": [ "schemaVersion", "sections" ], "additionalProperties": false }, "Content": { "oneOf": [ { "$ref": "#/components/schemas/ContentV1" }, { "$ref": "#/components/schemas/ContentV2" } ], "description": "Versioned content, bounded to 256 KiB. Use capability discovery. Semantic URL, markup, identity-uniqueness, UTF-16 length, depth and publication readiness checks remain authoritative on the server." }, "Error": { "type": "object", "properties": { "schemaVersion": { "type": "integer", "const": 1 }, "code": { "type": "string" } }, "required": [ "schemaVersion", "code" ], "additionalProperties": false, "description": "Application error envelope. Ingress/body-parser failures may use a different envelope." }, "Binding": { "type": "object", "properties": { "schemaVersion": { "type": "integer", "const": 1 }, "realm": { "$ref": "#/components/schemas/Realm" }, "creatorId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, "identityId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" } }, "required": [ "schemaVersion", "realm", "creatorId", "identityId" ], "additionalProperties": false }, "CreatePage": { "type": "object", "properties": { "content": { "$ref": "#/components/schemas/Content" } }, "required": [ "content" ], "additionalProperties": false }, "SavePage": { "type": "object", "properties": { "expectedDraftVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "content": { "$ref": "#/components/schemas/Content" } }, "required": [ "expectedDraftVersion", "content" ], "additionalProperties": false }, "PublishPage": { "type": "object", "properties": { "expectedDraftVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expectedActiveRevision": { "anyOf": [ { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, { "type": "null" } ] }, "expectedPublicationVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "expectedDraftVersion", "expectedActiveRevision", "expectedPublicationVersion", "digest" ], "additionalProperties": false }, "UnpublishPage": { "type": "object", "properties": { "expectedDraftVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expectedActiveRevision": { "anyOf": [ { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, { "type": "null" } ] }, "expectedPublicationVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "digest": {} }, "required": [ "expectedDraftVersion", "expectedActiveRevision", "expectedPublicationVersion" ], "additionalProperties": false, "description": "digest is not required or used for unpublish; omit it. It is accepted by the shared command parser." }, "ContentV2": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$ref": "#/components/schemas/ContentV2/$defs/s0", "$defs": { "s1": { "const": 2 }, "s3": { "type": "string", "pattern": "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$" }, "s6": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, "s9": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, "s10": { "$ref": "#/components/schemas/ContentV2/$defs/s9" }, "s8": { "type": "object", "properties": { "name": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "brandColor": { "$ref": "#/components/schemas/ContentV2/$defs/s9" }, "textPrimary": { "$ref": "#/components/schemas/ContentV2/$defs/s10" }, "textPrimaryColor": { "$ref": "#/components/schemas/ContentV2/$defs/s9" }, "textSecondaryColor": { "$ref": "#/components/schemas/ContentV2/$defs/s9" }, "backgroundPrimaryColor": { "$ref": "#/components/schemas/ContentV2/$defs/s9" }, "backgroundAccentColor": { "$ref": "#/components/schemas/ContentV2/$defs/s9" }, "buttonTextColor": { "$ref": "#/components/schemas/ContentV2/$defs/s9" }, "buttonBackgroundColor": { "$ref": "#/components/schemas/ContentV2/$defs/s9" } }, "required": [ "name", "brandColor", "textPrimaryColor", "textSecondaryColor", "backgroundPrimaryColor", "backgroundAccentColor", "buttonTextColor", "buttonBackgroundColor" ], "additionalProperties": false }, "s7": { "type": "array", "items": { "$ref": "#/components/schemas/ContentV2/$defs/s8" }, "maxItems": 20, "minItems": 1 }, "s5": { "type": "object", "properties": { "selectedPalette": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "palettes": { "$ref": "#/components/schemas/ContentV2/$defs/s7" } }, "required": [ "selectedPalette", "palettes" ], "additionalProperties": false }, "s4": { "$ref": "#/components/schemas/ContentV2/$defs/s5" }, "s12": { "type": "string", "enum": [ "system-ui, sans-serif", "Arial, sans-serif", "Georgia, serif", "ui-monospace, monospace" ] }, "s13": { "type": "integer", "minimum": 100, "maximum": 900 }, "s11": { "type": "object", "properties": { "fontFamily": { "$ref": "#/components/schemas/ContentV2/$defs/s12" }, "fontWeight": { "$ref": "#/components/schemas/ContentV2/$defs/s13" } }, "required": [ "fontFamily", "fontWeight" ], "additionalProperties": false }, "s15": { "type": "number", "minimum": 0, "maximum": 100 }, "s16": { "type": "string", "enum": [ "primary", "secondary", "tertiary" ] }, "s17": { "type": "number", "minimum": 0, "maximum": 20 }, "s18": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "s14": { "type": "object", "properties": { "radius": { "$ref": "#/components/schemas/ContentV2/$defs/s15" }, "type": { "$ref": "#/components/schemas/ContentV2/$defs/s16" }, "borderWidth": { "$ref": "#/components/schemas/ContentV2/$defs/s17" }, "palette": { "$ref": "#/components/schemas/ContentV2/$defs/s18" } }, "required": [ "radius", "type", "borderWidth" ], "additionalProperties": false }, "s21": { "const": 1 }, "s25": { "type": "integer", "minimum": 12, "maximum": 22 }, "s24": { "$ref": "#/components/schemas/ContentV2/$defs/s25" }, "s27": { "type": "number", "minimum": 1.05, "maximum": 1.6 }, "s26": { "$ref": "#/components/schemas/ContentV2/$defs/s27" }, "s29": { "type": "number", "minimum": 1, "maximum": 1.8 }, "s28": { "$ref": "#/components/schemas/ContentV2/$defs/s29" }, "s23": { "type": "object", "properties": { "basePx": { "$ref": "#/components/schemas/ContentV2/$defs/s24" }, "ratio": { "$ref": "#/components/schemas/ContentV2/$defs/s26" }, "headingLineHeight": { "$ref": "#/components/schemas/ContentV2/$defs/s28" } }, "required": [], "additionalProperties": false }, "s22": { "$ref": "#/components/schemas/ContentV2/$defs/s23" }, "s33": { "type": "integer", "minimum": 8, "maximum": 48 }, "s32": { "$ref": "#/components/schemas/ContentV2/$defs/s33" }, "s35": { "type": "integer", "minimum": 0, "maximum": 80 }, "s34": { "$ref": "#/components/schemas/ContentV2/$defs/s35" }, "s31": { "type": "object", "properties": { "gutterPx": { "$ref": "#/components/schemas/ContentV2/$defs/s32" }, "sectionGapPx": { "$ref": "#/components/schemas/ContentV2/$defs/s34" } }, "required": [], "additionalProperties": false }, "s30": { "$ref": "#/components/schemas/ContentV2/$defs/s31" }, "s39": { "type": "number", "minimum": 0, "maximum": 16 }, "s38": { "$ref": "#/components/schemas/ContentV2/$defs/s39" }, "s41": { "type": "number", "minimum": 0, "maximum": 24 }, "s40": { "$ref": "#/components/schemas/ContentV2/$defs/s41" }, "s43": { "type": "number", "minimum": 0, "maximum": 32 }, "s42": { "$ref": "#/components/schemas/ContentV2/$defs/s43" }, "s37": { "type": "object", "properties": { "smPx": { "$ref": "#/components/schemas/ContentV2/$defs/s38" }, "mdPx": { "$ref": "#/components/schemas/ContentV2/$defs/s40" }, "lgPx": { "$ref": "#/components/schemas/ContentV2/$defs/s42" } }, "required": [], "additionalProperties": false }, "s36": { "$ref": "#/components/schemas/ContentV2/$defs/s37" }, "s47": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, "s46": { "$ref": "#/components/schemas/ContentV2/$defs/s47" }, "s48": { "$ref": "#/components/schemas/ContentV2/$defs/s47" }, "s49": { "$ref": "#/components/schemas/ContentV2/$defs/s47" }, "s50": { "$ref": "#/components/schemas/ContentV2/$defs/s47" }, "s51": { "$ref": "#/components/schemas/ContentV2/$defs/s47" }, "s45": { "type": "object", "properties": { "bgSecondary": { "$ref": "#/components/schemas/ContentV2/$defs/s46" }, "bgTertiary": { "$ref": "#/components/schemas/ContentV2/$defs/s48" }, "bgAccent": { "$ref": "#/components/schemas/ContentV2/$defs/s49" }, "textAccent": { "$ref": "#/components/schemas/ContentV2/$defs/s50" }, "accent": { "$ref": "#/components/schemas/ContentV2/$defs/s51" } }, "required": [], "additionalProperties": false }, "s44": { "$ref": "#/components/schemas/ContentV2/$defs/s45" }, "s20": { "type": "object", "properties": { "tokensVersion": { "$ref": "#/components/schemas/ContentV2/$defs/s21" }, "typeScale": { "$ref": "#/components/schemas/ContentV2/$defs/s22" }, "spacing": { "$ref": "#/components/schemas/ContentV2/$defs/s30" }, "radiusScale": { "$ref": "#/components/schemas/ContentV2/$defs/s36" }, "paletteRelations": { "$ref": "#/components/schemas/ContentV2/$defs/s44" } }, "required": [ "tokensVersion" ], "additionalProperties": false }, "s19": { "$ref": "#/components/schemas/ContentV2/$defs/s20" }, "s2": { "type": "object", "properties": { "defaultLocale": { "$ref": "#/components/schemas/ContentV2/$defs/s3" }, "colors": { "$ref": "#/components/schemas/ContentV2/$defs/s4" }, "typography": { "$ref": "#/components/schemas/ContentV2/$defs/s11" }, "buttons": { "$ref": "#/components/schemas/ContentV2/$defs/s14" }, "tokens": { "$ref": "#/components/schemas/ContentV2/$defs/s19" } }, "required": [ "defaultLocale", "colors", "typography", "buttons" ], "additionalProperties": false }, "s56": { "type": "boolean" }, "s60": { "type": "string", "enum": [ "global", "custom" ] }, "s59": { "$ref": "#/components/schemas/ContentV2/$defs/s60" }, "s61": { "$ref": "#/components/schemas/ContentV2/$defs/s9" }, "s62": { "$ref": "#/components/schemas/ContentV2/$defs/s9" }, "s66": { "type": "string", "enum": [ "solid", "outline", "soft", "text" ] }, "s68": { "type": "string", "pattern": "^#[0-9A-Fa-f]{6}$" }, "s69": { "const": "transparent" }, "s67": { "anyOf": [ { "$ref": "#/components/schemas/ContentV2/$defs/s68" }, { "$ref": "#/components/schemas/ContentV2/$defs/s69" } ] }, "s65": { "type": "object", "properties": { "fill": { "$ref": "#/components/schemas/ContentV2/$defs/s66" }, "backgroundColor": { "$ref": "#/components/schemas/ContentV2/$defs/s67" }, "textColor": { "$ref": "#/components/schemas/ContentV2/$defs/s68" }, "borderColor": { "$ref": "#/components/schemas/ContentV2/$defs/s67" } }, "required": [ "fill", "backgroundColor", "textColor", "borderColor" ], "additionalProperties": false }, "s64": { "type": "object", "properties": { "primary": { "$ref": "#/components/schemas/ContentV2/$defs/s65" }, "secondary": { "$ref": "#/components/schemas/ContentV2/$defs/s65" }, "tertiary": { "$ref": "#/components/schemas/ContentV2/$defs/s65" } }, "required": [ "primary", "secondary", "tertiary" ], "additionalProperties": false }, "s63": { "$ref": "#/components/schemas/ContentV2/$defs/s64" }, "s58": { "type": "object", "properties": { "mode": { "$ref": "#/components/schemas/ContentV2/$defs/s59" }, "backgroundColor": { "$ref": "#/components/schemas/ContentV2/$defs/s61" }, "textColor": { "$ref": "#/components/schemas/ContentV2/$defs/s62" }, "buttonStyles": { "$ref": "#/components/schemas/ContentV2/$defs/s63" } }, "required": [], "additionalProperties": false }, "s57": { "$ref": "#/components/schemas/ContentV2/$defs/s58" }, "s70": { "const": "creator-hero" }, "s74": { "type": "string", "enum": [ "image", "video", "any" ] }, "s76": { "type": "string", "maxLength": 2048 }, "s75": { "$ref": "#/components/schemas/ContentV2/$defs/s76" }, "s79": { "type": "string", "maxLength": 8000 }, "s78": { "$ref": "#/components/schemas/ContentV2/$defs/s79" }, "s77": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "s81": { "type": "string", "maxLength": 500, "pattern": "^[A-Za-z0-9_./-]+$" }, "s80": { "$ref": "#/components/schemas/ContentV2/$defs/s81" }, "s84": { "$ref": "#/components/schemas/ContentV2/$defs/s75" }, "s85": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "s86": { "$ref": "#/components/schemas/ContentV2/$defs/s75" }, "s87": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "s88": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "s90": { "type": "boolean" }, "s89": { "$ref": "#/components/schemas/ContentV2/$defs/s90" }, "s91": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "s92": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "s93": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "s83": { "type": "object", "properties": { "provider": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "externalId": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "pageUrl": { "$ref": "#/components/schemas/ContentV2/$defs/s84" }, "creatorName": { "$ref": "#/components/schemas/ContentV2/$defs/s85" }, "creatorUrl": { "$ref": "#/components/schemas/ContentV2/$defs/s86" }, "attribution": { "$ref": "#/components/schemas/ContentV2/$defs/s87" }, "importedAt": { "$ref": "#/components/schemas/ContentV2/$defs/s88" }, "generated": { "$ref": "#/components/schemas/ContentV2/$defs/s89" }, "modelId": { "$ref": "#/components/schemas/ContentV2/$defs/s91" }, "promptVersion": { "$ref": "#/components/schemas/ContentV2/$defs/s92" }, "promptHash": { "$ref": "#/components/schemas/ContentV2/$defs/s93" } }, "required": [ "provider", "externalId" ], "additionalProperties": false }, "s82": { "$ref": "#/components/schemas/ContentV2/$defs/s83" }, "s73": { "type": "object", "properties": { "type": { "$ref": "#/components/schemas/ContentV2/$defs/s74" }, "url": { "$ref": "#/components/schemas/ContentV2/$defs/s75" }, "alt": { "$ref": "#/components/schemas/ContentV2/$defs/s77" }, "publicId": { "$ref": "#/components/schemas/ContentV2/$defs/s80" }, "source": { "$ref": "#/components/schemas/ContentV2/$defs/s82" } }, "required": [ "type", "url" ], "additionalProperties": false }, "s72": { "anyOf": [ { "$ref": "#/components/schemas/ContentV2/$defs/s73" }, { "type": "null" } ] }, "s95": { "anyOf": [ { "$ref": "#/components/schemas/ContentV2/$defs/s73" }, { "type": "null" } ] }, "s94": { "$ref": "#/components/schemas/ContentV2/$defs/s95" }, "s96": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "s98": { "const": false }, "s97": { "$ref": "#/components/schemas/ContentV2/$defs/s98" }, "s100": { "type": "string", "enum": [ "hero", "profile" ] }, "s99": { "$ref": "#/components/schemas/ContentV2/$defs/s100" }, "s106": { "type": "string", "maxLength": 2048 }, "s105": { "$ref": "#/components/schemas/ContentV2/$defs/s106" }, "s104": { "type": "object", "properties": { "label": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "url": { "$ref": "#/components/schemas/ContentV2/$defs/s105" }, "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" } }, "required": [ "label", "url", "id" ], "additionalProperties": false }, "s103": { "type": "array", "items": { "$ref": "#/components/schemas/ContentV2/$defs/s104" }, "maxItems": 50 }, "s102": { "$ref": "#/components/schemas/ContentV2/$defs/s103" }, "s101": { "$ref": "#/components/schemas/ContentV2/$defs/s102" }, "s108": { "type": "array", "items": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "maxItems": 50 }, "s107": { "$ref": "#/components/schemas/ContentV2/$defs/s108" }, "s111": { "const": 1 }, "s112": { "type": "boolean" }, "s113": { "type": "string", "enum": [ "provided", "not-used" ] }, "s114": { "type": "string", "enum": [ "provided", "not-required" ] }, "s115": { "type": "string", "enum": [ "provided", "not-used" ] }, "s116": { "type": "string" }, "s110": { "type": "object", "properties": { "version": { "$ref": "#/components/schemas/ContentV2/$defs/s111" }, "approved": { "$ref": "#/components/schemas/ContentV2/$defs/s112" }, "avatarDecision": { "$ref": "#/components/schemas/ContentV2/$defs/s113" }, "partnershipDecision": { "$ref": "#/components/schemas/ContentV2/$defs/s114" }, "socialLinksDecision": { "$ref": "#/components/schemas/ContentV2/$defs/s115" }, "profileFingerprint": { "$ref": "#/components/schemas/ContentV2/$defs/s116" } }, "required": [ "version", "approved", "avatarDecision", "partnershipDecision", "socialLinksDecision", "profileFingerprint" ], "additionalProperties": false }, "s109": { "$ref": "#/components/schemas/ContentV2/$defs/s110" }, "s118": { "type": "object", "propertyNames": { "$ref": "#/components/schemas/ContentV2/$defs/s3" }, "additionalProperties": { "$ref": "#/components/schemas/ContentV2/$defs/s78" } }, "s117": { "$ref": "#/components/schemas/ContentV2/$defs/s118" }, "s119": { "$ref": "#/components/schemas/ContentV2/$defs/s9" }, "s120": { "$ref": "#/components/schemas/ContentV2/$defs/s9" }, "s126": { "anyOf": [ { "$ref": "#/components/schemas/ContentV2/$defs/s73" }, { "type": "null" } ] }, "s125": { "$ref": "#/components/schemas/ContentV2/$defs/s126" }, "s127": { "$ref": "#/components/schemas/ContentV2/$defs/s117" }, "s128": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "s131": { "type": "string" }, "s132": { "type": "string" }, "s133": { "type": "string" }, "s134": { "type": "string" }, "s136": { "type": "string" }, "s135": { "$ref": "#/components/schemas/ContentV2/$defs/s136" }, "s130": { "type": "object", "properties": { "creatorHandle": { "$ref": "#/components/schemas/ContentV2/$defs/s131" }, "adName": { "$ref": "#/components/schemas/ContentV2/$defs/s132" }, "utmSource": { "$ref": "#/components/schemas/ContentV2/$defs/s133" }, "utmCampaign": { "$ref": "#/components/schemas/ContentV2/$defs/s134" }, "utmContent": { "$ref": "#/components/schemas/ContentV2/$defs/s135" } }, "required": [ "creatorHandle", "adName", "utmSource", "utmCampaign" ], "additionalProperties": false }, "s129": { "$ref": "#/components/schemas/ContentV2/$defs/s130" }, "s124": { "type": "object", "properties": { "key": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "media": { "$ref": "#/components/schemas/ContentV2/$defs/s125" }, "quoteLocales": { "$ref": "#/components/schemas/ContentV2/$defs/s127" }, "displayName": { "$ref": "#/components/schemas/ContentV2/$defs/s128" }, "mapping": { "$ref": "#/components/schemas/ContentV2/$defs/s129" } }, "required": [ "key" ], "additionalProperties": false }, "s123": { "type": "array", "items": { "$ref": "#/components/schemas/ContentV2/$defs/s124" }, "maxItems": 50 }, "s122": { "$ref": "#/components/schemas/ContentV2/$defs/s123" }, "s121": { "$ref": "#/components/schemas/ContentV2/$defs/s122" }, "s71": { "type": "object", "properties": { "media": { "$ref": "#/components/schemas/ContentV2/$defs/s72" }, "avatar": { "$ref": "#/components/schemas/ContentV2/$defs/s94" }, "handle": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "displayName": { "$ref": "#/components/schemas/ContentV2/$defs/s96" }, "commerceHome": { "$ref": "#/components/schemas/ContentV2/$defs/s97" }, "presentation": { "$ref": "#/components/schemas/ContentV2/$defs/s99" }, "socialLinks": { "$ref": "#/components/schemas/ContentV2/$defs/s101" }, "partnerships": { "$ref": "#/components/schemas/ContentV2/$defs/s107" }, "profileApproval": { "$ref": "#/components/schemas/ContentV2/$defs/s109" }, "quoteLocales": { "$ref": "#/components/schemas/ContentV2/$defs/s117" }, "backgroundColor": { "$ref": "#/components/schemas/ContentV2/$defs/s119" }, "textColor": { "$ref": "#/components/schemas/ContentV2/$defs/s120" }, "variants": { "$ref": "#/components/schemas/ContentV2/$defs/s121" } }, "required": [ "media", "handle", "quoteLocales" ], "additionalProperties": false }, "s55": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "showSection": { "$ref": "#/components/schemas/ContentV2/$defs/s56" }, "theme": { "$ref": "#/components/schemas/ContentV2/$defs/s57" }, "type": { "$ref": "#/components/schemas/ContentV2/$defs/s70" }, "config": { "$ref": "#/components/schemas/ContentV2/$defs/s71" } }, "required": [ "id", "showSection", "type", "config" ], "additionalProperties": false }, "s140": { "$ref": "#/components/schemas/ContentV2/$defs/s9" }, "s141": { "$ref": "#/components/schemas/ContentV2/$defs/s9" }, "s143": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" }, "s142": { "$ref": "#/components/schemas/ContentV2/$defs/s143" }, "s139": { "type": "object", "properties": { "mode": { "$ref": "#/components/schemas/ContentV2/$defs/s59" }, "backgroundColor": { "$ref": "#/components/schemas/ContentV2/$defs/s140" }, "textColor": { "$ref": "#/components/schemas/ContentV2/$defs/s141" }, "buttonStyles": { "$ref": "#/components/schemas/ContentV2/$defs/s63" }, "linkColor": { "$ref": "#/components/schemas/ContentV2/$defs/s142" } }, "required": [], "additionalProperties": false }, "s138": { "$ref": "#/components/schemas/ContentV2/$defs/s139" }, "s144": { "const": "links" }, "s145": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "s146": { "type": "string", "enum": [ "solid", "outline", "minimal" ] }, "s150": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "s152": { "type": "string", "enum": [ "none", "cart", "bag", "play", "book", "globe", "spark", "tag", "instagram", "tiktok", "youtube", "facebook", "x", "linkedin", "stanstore", "skool", "substack", "pinterest", "threads", "snapchat", "reddit", "discord", "twitch", "whatsapp", "telegram", "spotify" ] }, "s151": { "$ref": "#/components/schemas/ContentV2/$defs/s152" }, "s154": { "type": "string", "enum": [ "original", "buttonBackgroundColor", "buttonTextColor", "backgroundPrimaryColor", "backgroundAccentColor", "textPrimaryColor", "textSecondaryColor" ] }, "s153": { "$ref": "#/components/schemas/ContentV2/$defs/s154" }, "s156": { "type": "boolean" }, "s155": { "$ref": "#/components/schemas/ContentV2/$defs/s156" }, "s149": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "label": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "sub": { "$ref": "#/components/schemas/ContentV2/$defs/s150" }, "url": { "$ref": "#/components/schemas/ContentV2/$defs/s105" }, "icon": { "$ref": "#/components/schemas/ContentV2/$defs/s151" }, "iconColor": { "$ref": "#/components/schemas/ContentV2/$defs/s153" }, "featured": { "$ref": "#/components/schemas/ContentV2/$defs/s155" } }, "required": [ "id", "label", "url" ], "additionalProperties": false }, "s148": { "type": "array", "items": { "$ref": "#/components/schemas/ContentV2/$defs/s149" }, "maxItems": 50 }, "s147": { "$ref": "#/components/schemas/ContentV2/$defs/s148" }, "s137": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "showSection": { "$ref": "#/components/schemas/ContentV2/$defs/s56" }, "theme": { "$ref": "#/components/schemas/ContentV2/$defs/s138" }, "type": { "$ref": "#/components/schemas/ContentV2/$defs/s144" }, "heading": { "$ref": "#/components/schemas/ContentV2/$defs/s145" }, "appearance": { "$ref": "#/components/schemas/ContentV2/$defs/s146" }, "links": { "$ref": "#/components/schemas/ContentV2/$defs/s147" } }, "required": [ "id", "showSection", "type", "appearance", "links" ], "additionalProperties": false }, "s158": { "const": "header" }, "s160": { "anyOf": [ { "$ref": "#/components/schemas/ContentV2/$defs/s73" }, { "type": "null" } ] }, "s159": { "$ref": "#/components/schemas/ContentV2/$defs/s160" }, "s161": { "$ref": "#/components/schemas/ContentV2/$defs/s75" }, "s163": { "type": "string", "enum": [ "left", "center" ] }, "s162": { "$ref": "#/components/schemas/ContentV2/$defs/s163" }, "s157": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "showSection": { "$ref": "#/components/schemas/ContentV2/$defs/s56" }, "theme": { "$ref": "#/components/schemas/ContentV2/$defs/s57" }, "type": { "$ref": "#/components/schemas/ContentV2/$defs/s158" }, "titleLocales": { "$ref": "#/components/schemas/ContentV2/$defs/s117" }, "subtitleLocales": { "$ref": "#/components/schemas/ContentV2/$defs/s117" }, "logo": { "$ref": "#/components/schemas/ContentV2/$defs/s159" }, "logoSrc": { "$ref": "#/components/schemas/ContentV2/$defs/s161" }, "layout": { "$ref": "#/components/schemas/ContentV2/$defs/s162" } }, "required": [ "id", "showSection", "type", "titleLocales", "subtitleLocales" ], "additionalProperties": false }, "s165": { "const": "content" }, "s170": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "s172": { "type": "number", "minimum": 0 }, "s171": { "$ref": "#/components/schemas/ContentV2/$defs/s172" }, "s177": { "const": "raw" }, "s180": { "type": "string" }, "s179": { "$ref": "#/components/schemas/ContentV2/$defs/s180" }, "s178": { "type": "object", "properties": { "html": { "$ref": "#/components/schemas/ContentV2/$defs/s179" } }, "required": [ "html" ], "additionalProperties": false }, "s184": { "type": "string", "enum": [ "left", "center", "right" ] }, "s183": { "$ref": "#/components/schemas/ContentV2/$defs/s184" }, "s182": { "type": "object", "properties": { "align": { "$ref": "#/components/schemas/ContentV2/$defs/s183" } }, "required": [], "additionalProperties": false }, "s181": { "$ref": "#/components/schemas/ContentV2/$defs/s182" }, "s176": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "type": { "$ref": "#/components/schemas/ContentV2/$defs/s177" }, "data": { "$ref": "#/components/schemas/ContentV2/$defs/s178" }, "tunes": { "$ref": "#/components/schemas/ContentV2/$defs/s181" } }, "required": [ "id", "type", "data" ], "additionalProperties": false }, "s186": { "const": "paragraph" }, "s187": { "type": "object", "properties": { "text": { "$ref": "#/components/schemas/ContentV2/$defs/s179" } }, "required": [ "text" ], "additionalProperties": false }, "s185": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "type": { "$ref": "#/components/schemas/ContentV2/$defs/s186" }, "data": { "$ref": "#/components/schemas/ContentV2/$defs/s187" }, "tunes": { "$ref": "#/components/schemas/ContentV2/$defs/s181" } }, "required": [ "id", "type", "data" ], "additionalProperties": false }, "s189": { "const": "header" }, "s191": { "type": "integer", "minimum": 1, "maximum": 6 }, "s190": { "type": "object", "properties": { "text": { "$ref": "#/components/schemas/ContentV2/$defs/s179" }, "level": { "$ref": "#/components/schemas/ContentV2/$defs/s191" } }, "required": [ "text", "level" ], "additionalProperties": false }, "s188": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "type": { "$ref": "#/components/schemas/ContentV2/$defs/s189" }, "data": { "$ref": "#/components/schemas/ContentV2/$defs/s190" }, "tunes": { "$ref": "#/components/schemas/ContentV2/$defs/s181" } }, "required": [ "id", "type", "data" ], "additionalProperties": false }, "s193": { "const": "quote" }, "s196": { "type": "string", "enum": [ "left", "center", "right" ] }, "s195": { "$ref": "#/components/schemas/ContentV2/$defs/s196" }, "s194": { "type": "object", "properties": { "text": { "$ref": "#/components/schemas/ContentV2/$defs/s179" }, "caption": { "$ref": "#/components/schemas/ContentV2/$defs/s179" }, "alignment": { "$ref": "#/components/schemas/ContentV2/$defs/s195" } }, "required": [ "text", "caption" ], "additionalProperties": false }, "s192": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "type": { "$ref": "#/components/schemas/ContentV2/$defs/s193" }, "data": { "$ref": "#/components/schemas/ContentV2/$defs/s194" }, "tunes": { "$ref": "#/components/schemas/ContentV2/$defs/s181" } }, "required": [ "id", "type", "data" ], "additionalProperties": false }, "s198": { "const": "delimiter" }, "s201": { "type": "string", "enum": [ "star", "dash", "line" ] }, "s200": { "$ref": "#/components/schemas/ContentV2/$defs/s201" }, "s203": { "type": "number", "minimum": 0, "maximum": 100 }, "s202": { "$ref": "#/components/schemas/ContentV2/$defs/s203" }, "s205": { "type": "number", "minimum": 0, "maximum": 20 }, "s204": { "$ref": "#/components/schemas/ContentV2/$defs/s205" }, "s199": { "type": "object", "properties": { "style": { "$ref": "#/components/schemas/ContentV2/$defs/s200" }, "lineWidth": { "$ref": "#/components/schemas/ContentV2/$defs/s202" }, "lineThickness": { "$ref": "#/components/schemas/ContentV2/$defs/s204" } }, "required": [], "additionalProperties": false }, "s197": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "type": { "$ref": "#/components/schemas/ContentV2/$defs/s198" }, "data": { "$ref": "#/components/schemas/ContentV2/$defs/s199" }, "tunes": { "$ref": "#/components/schemas/ContentV2/$defs/s181" } }, "required": [ "id", "type", "data" ], "additionalProperties": false }, "s207": { "const": "list" }, "s209": { "type": "string", "enum": [ "ordered", "unordered" ] }, "s214": { "type": "array", "items": { "$ref": "#/components/schemas/ContentV2/$defs/s211" }, "maxItems": 50 }, "s213": { "$ref": "#/components/schemas/ContentV2/$defs/s214" }, "s212": { "type": "object", "properties": { "content": { "$ref": "#/components/schemas/ContentV2/$defs/s179" }, "items": { "$ref": "#/components/schemas/ContentV2/$defs/s213" } }, "required": [ "content" ], "additionalProperties": false }, "s211": { "$ref": "#/components/schemas/ContentV2/$defs/s212" }, "s210": { "type": "array", "items": { "$ref": "#/components/schemas/ContentV2/$defs/s211" }, "maxItems": 50 }, "s208": { "type": "object", "properties": { "style": { "$ref": "#/components/schemas/ContentV2/$defs/s209" }, "items": { "$ref": "#/components/schemas/ContentV2/$defs/s210" } }, "required": [ "style", "items" ], "additionalProperties": false }, "s206": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "type": { "$ref": "#/components/schemas/ContentV2/$defs/s207" }, "data": { "$ref": "#/components/schemas/ContentV2/$defs/s208" }, "tunes": { "$ref": "#/components/schemas/ContentV2/$defs/s181" } }, "required": [ "id", "type", "data" ], "additionalProperties": false }, "s216": { "const": "image" }, "s218": { "type": "object", "properties": { "url": { "$ref": "#/components/schemas/ContentV2/$defs/s75" }, "alt": { "$ref": "#/components/schemas/ContentV2/$defs/s77" }, "publicId": { "$ref": "#/components/schemas/ContentV2/$defs/s80" }, "source": { "$ref": "#/components/schemas/ContentV2/$defs/s82" } }, "required": [ "url" ], "additionalProperties": false }, "s219": { "$ref": "#/components/schemas/ContentV2/$defs/s179" }, "s221": { "type": "boolean" }, "s220": { "$ref": "#/components/schemas/ContentV2/$defs/s221" }, "s223": { "type": "boolean" }, "s222": { "$ref": "#/components/schemas/ContentV2/$defs/s223" }, "s225": { "type": "boolean" }, "s224": { "$ref": "#/components/schemas/ContentV2/$defs/s225" }, "s227": { "type": "boolean" }, "s226": { "$ref": "#/components/schemas/ContentV2/$defs/s227" }, "s229": { "type": "boolean" }, "s228": { "$ref": "#/components/schemas/ContentV2/$defs/s229" }, "s231": { "type": "boolean" }, "s230": { "$ref": "#/components/schemas/ContentV2/$defs/s231" }, "s233": { "type": "boolean" }, "s232": { "$ref": "#/components/schemas/ContentV2/$defs/s233" }, "s217": { "type": "object", "properties": { "file": { "$ref": "#/components/schemas/ContentV2/$defs/s218" }, "caption": { "$ref": "#/components/schemas/ContentV2/$defs/s219" }, "withBorder": { "$ref": "#/components/schemas/ContentV2/$defs/s220" }, "stretched": { "$ref": "#/components/schemas/ContentV2/$defs/s222" }, "withBackground": { "$ref": "#/components/schemas/ContentV2/$defs/s224" }, "resize_25": { "$ref": "#/components/schemas/ContentV2/$defs/s226" }, "resize_50": { "$ref": "#/components/schemas/ContentV2/$defs/s228" }, "resize_80": { "$ref": "#/components/schemas/ContentV2/$defs/s230" }, "resize_100": { "$ref": "#/components/schemas/ContentV2/$defs/s232" } }, "required": [ "file" ], "additionalProperties": false }, "s215": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "type": { "$ref": "#/components/schemas/ContentV2/$defs/s216" }, "data": { "$ref": "#/components/schemas/ContentV2/$defs/s217" }, "tunes": { "$ref": "#/components/schemas/ContentV2/$defs/s181" } }, "required": [ "id", "type", "data" ], "additionalProperties": false }, "s235": { "const": "gallery" }, "s237": { "type": "array", "items": { "$ref": "#/components/schemas/ContentV2/$defs/s218" }, "maxItems": 50 }, "s238": { "$ref": "#/components/schemas/ContentV2/$defs/s179" }, "s239": { "type": "string", "enum": [ "slider", "fit" ] }, "s236": { "type": "object", "properties": { "files": { "$ref": "#/components/schemas/ContentV2/$defs/s237" }, "caption": { "$ref": "#/components/schemas/ContentV2/$defs/s238" }, "style": { "$ref": "#/components/schemas/ContentV2/$defs/s239" } }, "required": [ "files", "style" ], "additionalProperties": false }, "s234": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "type": { "$ref": "#/components/schemas/ContentV2/$defs/s235" }, "data": { "$ref": "#/components/schemas/ContentV2/$defs/s236" }, "tunes": { "$ref": "#/components/schemas/ContentV2/$defs/s181" } }, "required": [ "id", "type", "data" ], "additionalProperties": false }, "s175": { "oneOf": [ { "$ref": "#/components/schemas/ContentV2/$defs/s176" }, { "$ref": "#/components/schemas/ContentV2/$defs/s185" }, { "$ref": "#/components/schemas/ContentV2/$defs/s188" }, { "$ref": "#/components/schemas/ContentV2/$defs/s192" }, { "$ref": "#/components/schemas/ContentV2/$defs/s197" }, { "$ref": "#/components/schemas/ContentV2/$defs/s206" }, { "$ref": "#/components/schemas/ContentV2/$defs/s215" }, { "$ref": "#/components/schemas/ContentV2/$defs/s234" } ] }, "s174": { "type": "array", "items": { "$ref": "#/components/schemas/ContentV2/$defs/s175" }, "maxItems": 100 }, "s173": { "$ref": "#/components/schemas/ContentV2/$defs/s174" }, "s169": { "type": "object", "properties": { "version": { "$ref": "#/components/schemas/ContentV2/$defs/s170" }, "time": { "$ref": "#/components/schemas/ContentV2/$defs/s171" }, "blocks": { "$ref": "#/components/schemas/ContentV2/$defs/s173" } }, "required": [ "blocks" ], "additionalProperties": false }, "s168": { "type": "object", "propertyNames": { "$ref": "#/components/schemas/ContentV2/$defs/s3" }, "additionalProperties": { "$ref": "#/components/schemas/ContentV2/$defs/s169" } }, "s167": { "$ref": "#/components/schemas/ContentV2/$defs/s168" }, "s166": { "type": "object", "properties": { "content": { "$ref": "#/components/schemas/ContentV2/$defs/s167" } }, "required": [ "content" ], "additionalProperties": false }, "s164": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "showSection": { "$ref": "#/components/schemas/ContentV2/$defs/s56" }, "theme": { "$ref": "#/components/schemas/ContentV2/$defs/s57" }, "type": { "$ref": "#/components/schemas/ContentV2/$defs/s165" }, "config": { "$ref": "#/components/schemas/ContentV2/$defs/s166" } }, "required": [ "id", "showSection", "type", "config" ], "additionalProperties": false }, "s241": { "const": "media" }, "s243": { "type": "string", "enum": [ "carousel", "single", "grid" ] }, "s242": { "$ref": "#/components/schemas/ContentV2/$defs/s243" }, "s245": { "type": "string", "enum": [ "landscape", "square", "auto" ] }, "s244": { "$ref": "#/components/schemas/ContentV2/$defs/s245" }, "s250": { "anyOf": [ { "$ref": "#/components/schemas/ContentV2/$defs/s73" }, { "type": "null" } ] }, "s249": { "$ref": "#/components/schemas/ContentV2/$defs/s250" }, "s251": { "$ref": "#/components/schemas/ContentV2/$defs/s117" }, "s248": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "media": { "$ref": "#/components/schemas/ContentV2/$defs/s249" }, "captionLocales": { "$ref": "#/components/schemas/ContentV2/$defs/s251" } }, "required": [ "id" ], "additionalProperties": false }, "s247": { "type": "array", "items": { "$ref": "#/components/schemas/ContentV2/$defs/s248" }, "maxItems": 50 }, "s246": { "$ref": "#/components/schemas/ContentV2/$defs/s247" }, "s240": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "showSection": { "$ref": "#/components/schemas/ContentV2/$defs/s56" }, "theme": { "$ref": "#/components/schemas/ContentV2/$defs/s57" }, "type": { "$ref": "#/components/schemas/ContentV2/$defs/s241" }, "layout": { "$ref": "#/components/schemas/ContentV2/$defs/s242" }, "singleAspect": { "$ref": "#/components/schemas/ContentV2/$defs/s244" }, "slides": { "$ref": "#/components/schemas/ContentV2/$defs/s246" } }, "required": [ "id", "showSection", "type", "slides" ], "additionalProperties": false }, "s253": { "const": "accordions" }, "s254": { "type": "boolean" }, "s257": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "title": { "$ref": "#/components/schemas/ContentV2/$defs/s117" }, "text": { "$ref": "#/components/schemas/ContentV2/$defs/s167" } }, "required": [ "id", "title", "text" ], "additionalProperties": false }, "s256": { "type": "array", "items": { "$ref": "#/components/schemas/ContentV2/$defs/s257" }, "maxItems": 50 }, "s255": { "$ref": "#/components/schemas/ContentV2/$defs/s256" }, "s252": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "showSection": { "$ref": "#/components/schemas/ContentV2/$defs/s56" }, "theme": { "$ref": "#/components/schemas/ContentV2/$defs/s57" }, "type": { "$ref": "#/components/schemas/ContentV2/$defs/s253" }, "expandFirst": { "$ref": "#/components/schemas/ContentV2/$defs/s254" }, "items": { "$ref": "#/components/schemas/ContentV2/$defs/s255" } }, "required": [ "id", "showSection", "type", "expandFirst", "items" ], "additionalProperties": false }, "s259": { "const": "testimonials" }, "s261": { "type": "string", "enum": [ "grid", "carousel" ] }, "s265": { "type": "string", "pattern": "^(?:|[0-4](?:\\.\\d+)?|5(?:\\.0+)?)$" }, "s264": { "type": "object", "properties": { "rating": { "$ref": "#/components/schemas/ContentV2/$defs/s265" }, "title": { "$ref": "#/components/schemas/ContentV2/$defs/s117" }, "description": { "$ref": "#/components/schemas/ContentV2/$defs/s117" }, "customerName": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "customerInfo": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" } }, "required": [ "rating", "title", "description", "customerName", "customerInfo", "id" ], "additionalProperties": false }, "s263": { "type": "array", "items": { "$ref": "#/components/schemas/ContentV2/$defs/s264" }, "maxItems": 50 }, "s262": { "$ref": "#/components/schemas/ContentV2/$defs/s263" }, "s266": { "$ref": "#/components/schemas/ContentV2/$defs/s9" }, "s267": { "$ref": "#/components/schemas/ContentV2/$defs/s9" }, "s260": { "type": "object", "properties": { "layout": { "$ref": "#/components/schemas/ContentV2/$defs/s261" }, "testimonials": { "$ref": "#/components/schemas/ContentV2/$defs/s262" }, "backgroundColor": { "$ref": "#/components/schemas/ContentV2/$defs/s266" }, "textColor": { "$ref": "#/components/schemas/ContentV2/$defs/s267" } }, "required": [ "layout", "testimonials" ], "additionalProperties": false }, "s258": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "showSection": { "$ref": "#/components/schemas/ContentV2/$defs/s56" }, "theme": { "$ref": "#/components/schemas/ContentV2/$defs/s57" }, "type": { "$ref": "#/components/schemas/ContentV2/$defs/s259" }, "config": { "$ref": "#/components/schemas/ContentV2/$defs/s260" } }, "required": [ "id", "showSection", "type", "config" ], "additionalProperties": false }, "s269": { "const": "banner" }, "s270": { "$ref": "#/components/schemas/ContentV2/$defs/s9" }, "s271": { "$ref": "#/components/schemas/ContentV2/$defs/s9" }, "s273": { "type": "string", "enum": [ "none", "marquee", "fade-in" ] }, "s272": { "$ref": "#/components/schemas/ContentV2/$defs/s273" }, "s275": { "type": "boolean" }, "s274": { "$ref": "#/components/schemas/ContentV2/$defs/s275" }, "s278": { "type": "boolean" }, "s279": { "type": "string", "enum": [ "hide-banner", "hide-timer" ] }, "s277": { "type": "object", "properties": { "enabled": { "$ref": "#/components/schemas/ContentV2/$defs/s278" }, "endsAt": { "$ref": "#/components/schemas/ContentV2/$defs/s78" }, "labelLocales": { "$ref": "#/components/schemas/ContentV2/$defs/s117" }, "endBehavior": { "$ref": "#/components/schemas/ContentV2/$defs/s279" } }, "required": [ "enabled", "endsAt", "labelLocales", "endBehavior" ], "additionalProperties": false }, "s276": { "$ref": "#/components/schemas/ContentV2/$defs/s277" }, "s268": { "type": "object", "properties": { "id": { "$ref": "#/components/schemas/ContentV2/$defs/s6" }, "showSection": { "$ref": "#/components/schemas/ContentV2/$defs/s56" }, "theme": { "$ref": "#/components/schemas/ContentV2/$defs/s57" }, "type": { "$ref": "#/components/schemas/ContentV2/$defs/s269" }, "text": { "$ref": "#/components/schemas/ContentV2/$defs/s167" }, "backgroundColor": { "$ref": "#/components/schemas/ContentV2/$defs/s270" }, "textColor": { "$ref": "#/components/schemas/ContentV2/$defs/s271" }, "textAnimation": { "$ref": "#/components/schemas/ContentV2/$defs/s272" }, "textAnimationLoop": { "$ref": "#/components/schemas/ContentV2/$defs/s274" }, "countdown": { "$ref": "#/components/schemas/ContentV2/$defs/s276" } }, "required": [ "id", "showSection", "type", "text" ], "additionalProperties": false }, "s54": { "oneOf": [ { "$ref": "#/components/schemas/ContentV2/$defs/s55" }, { "$ref": "#/components/schemas/ContentV2/$defs/s137" }, { "$ref": "#/components/schemas/ContentV2/$defs/s157" }, { "$ref": "#/components/schemas/ContentV2/$defs/s164" }, { "$ref": "#/components/schemas/ContentV2/$defs/s240" }, { "$ref": "#/components/schemas/ContentV2/$defs/s252" }, { "$ref": "#/components/schemas/ContentV2/$defs/s258" }, { "$ref": "#/components/schemas/ContentV2/$defs/s268" } ] }, "s53": { "type": "array", "items": { "$ref": "#/components/schemas/ContentV2/$defs/s54" }, "maxItems": 30 }, "s52": { "$ref": "#/components/schemas/ContentV2/$defs/s53" }, "s0": { "type": "object", "properties": { "schemaVersion": { "$ref": "#/components/schemas/ContentV2/$defs/s1" }, "settings": { "$ref": "#/components/schemas/ContentV2/$defs/s2" }, "sections": { "$ref": "#/components/schemas/ContentV2/$defs/s52" } }, "required": [ "schemaVersion", "settings", "sections" ], "additionalProperties": false } }, "description": "Structural schema extracted from the merged generated backend contract. Semantic refinements are enforced by parseContentV2 and validatePublicationV2; this schema alone does not prove publication readiness." }, "Page": { "type": "object", "properties": { "schemaVersion": { "type": "integer", "const": 1 }, "pageId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, "draftVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "publicationVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "activeRevision": { "anyOf": [ { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, { "type": "null" } ] }, "content": { "$ref": "#/components/schemas/Content" }, "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "schemaVersion", "pageId", "draftVersion", "publicationVersion", "activeRevision", "content", "digest" ], "additionalProperties": false }, "PageRead": { "type": "object", "properties": { "schemaVersion": { "type": "integer", "const": 1 }, "pageId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, "draftVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "publicationVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "activeRevision": { "anyOf": [ { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, { "type": "null" } ] }, "content": { "$ref": "#/components/schemas/Content" }, "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "publicUrl": { "type": [ "string", "null" ], "format": "uri", "description": "Current canonical HTTPS URL, or null when no eligible public route/publication exists. Only GET page returns this field; reread after mutations." } }, "required": [ "schemaVersion", "pageId", "draftVersion", "publicationVersion", "activeRevision", "content", "digest", "publicUrl" ], "additionalProperties": false }, "PageList": { "type": "object", "properties": { "schemaVersion": { "type": "integer", "const": 1 }, "pages": { "type": "array", "items": { "type": "object", "properties": { "pageId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, "draftVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "publicationVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "activeRevision": { "anyOf": [ { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, { "type": "null" } ] } }, "required": [ "pageId", "draftVersion", "publicationVersion", "activeRevision" ], "additionalProperties": false }, "maxItems": 100 }, "nextCursor": { "anyOf": [ { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, { "type": "null" } ] } }, "required": [ "schemaVersion", "pages", "nextCursor" ], "additionalProperties": false }, "PublicationReceipt": { "type": "object", "properties": { "schemaVersion": { "type": "integer", "const": 1 }, "pageId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, "draftVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "publicationVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "activeRevision": { "anyOf": [ { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, { "type": "null" } ] }, "eventId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, "sequence": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "schemaVersion", "pageId", "draftVersion", "publicationVersion", "activeRevision", "eventId", "sequence" ], "additionalProperties": false }, "Revision": { "type": "object", "properties": { "schemaVersion": { "type": "integer", "const": 1 }, "revisionId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, "draftVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "content": { "$ref": "#/components/schemas/Content" } }, "required": [ "schemaVersion", "revisionId", "draftVersion", "digest", "content" ], "additionalProperties": false }, "ContentDescriptor": { "type": "object", "required": [ "schemaVersion", "sectionTypes" ], "properties": { "schemaVersion": { "type": "integer", "enum": [ 1, 2 ] }, "sectionTypes": { "type": "array", "items": { "type": "string" } }, "jsonSchema": { "type": "object", "description": "Available on v2; structural JSON Schema with semantic checks enforced separately." } }, "additionalProperties": true, "description": "Extensible discovery metadata, including limits, field descriptors or JSON Schema, and publication requirements. Do not treat v1 field descriptors as JSON Schema." }, "Capabilities": { "type": "object", "properties": { "schemaVersion": { "type": "integer", "const": 1 }, "grant": { "type": "object", "properties": { "generation": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expiresAt": { "type": "string", "format": "date-time" }, "capabilities": { "type": "array", "items": { "enum": [ "creator:bind", "page:read", "page:edit", "page:publish", "events:read" ] } } }, "required": [ "generation", "expiresAt", "capabilities" ], "additionalProperties": false }, "content": { "$ref": "#/components/schemas/ContentDescriptor" }, "contentVersions": { "type": "array", "items": { "$ref": "#/components/schemas/ContentDescriptor" } }, "preferredContentVersion": { "const": 2 }, "media": { "$ref": "#/components/schemas/MediaCapabilities" } }, "required": [ "schemaVersion", "grant", "content", "contentVersions", "preferredContentVersion" ], "additionalProperties": false }, "Event": { "type": "object", "properties": { "_id": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, "schemaVersion": { "type": "integer", "const": 1 }, "bindingId": { "type": "string" }, "sequence": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "eventType": { "type": "string", "description": "Examples: creator.bound, page.published, page.unpublished, authoring-grant.revoked, creator.suspended, creator.reactivated, page.route-renamed. Also page.deleted for durable page tombstones." }, "occurredAt": { "type": "string", "format": "date-time" }, "realm": { "$ref": "#/components/schemas/Realm" }, "aggregateId": { "type": "string" }, "aggregateRevision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "operationId": { "type": "string" }, "payload": { "type": "object", "additionalProperties": true } }, "required": [ "_id", "schemaVersion", "bindingId", "sequence", "eventType", "occurredAt", "realm", "aggregateId", "aggregateRevision", "operationId", "payload" ], "additionalProperties": false }, "MediaCapabilities": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "upload": { "type": "boolean" }, "maxBytes": { "type": "integer", "const": 5242880 }, "maxVideoBytes": { "type": "integer", "const": 20971520 }, "mimeTypes": { "type": "array", "items": { "enum": [ "image/jpeg", "image/png", "image/webp", "video/mp4", "video/webm" ] } } }, "required": [ "enabled", "upload", "maxBytes", "mimeTypes" ], "additionalProperties": false, "description": "Optional capability for compatibility with earlier services. maxBytes is the decoded image bound. maxVideoBytes is additive: clients must not offer video without the advertised video bound and MIME type. upload requires configured media and current page:edit." }, "MediaUpload": { "type": "object", "properties": { "schemaVersion": { "type": "integer", "const": 1 }, "fileName": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^(?=.*\\S)[^/\\\\\\u0000-\\u001f\\u007f-\\u009f]+$", "description": "Nonblank filename, at most 180 Unicode code points; no path separators or control characters." }, "mimeType": { "enum": [ "image/jpeg", "image/png", "image/webp", "video/mp4", "video/webm" ] }, "dataBase64": { "type": "string", "minLength": 4, "maxLength": 27962028, "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$", "contentEncoding": "base64", "description": "Canonical base64, no data: prefix. Server checks canonical padding bits, decoded size and MIME/container match. 5 MiB images / 20 MiB videos; HTTP JSON body ceiling 28 MiB." } }, "required": [ "schemaVersion", "fileName", "mimeType", "dataBase64" ], "additionalProperties": false }, "MediaAsset": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^upload_[a-f0-9]{64}$" }, "publicId": { "type": "string" }, "url": { "type": "string", "format": "uri", "pattern": "^https://" }, "thumbnailUrl": { "type": "string", "format": "uri", "pattern": "^https://" }, "fileName": { "type": "string", "minLength": 1, "maxLength": 180, "pattern": "^(?=.*\\S)[^/\\\\\\u0000-\\u001f\\u007f-\\u009f]+$", "description": "Nonblank filename, at most 180 Unicode code points; no path separators or control characters." }, "mimeType": { "enum": [ "image/jpeg", "image/png", "image/webp", "video/mp4", "video/webm" ] }, "width": { "type": "integer", "minimum": 1, "maximum": 50000 }, "height": { "type": "integer", "minimum": 1, "maximum": 50000 }, "bytes": { "type": "integer", "minimum": 1, "maximum": 20971520 }, "createdAt": { "type": "string", "format": "date-time" } }, "required": [ "id", "publicId", "url", "thumbnailUrl", "fileName", "mimeType", "width", "height", "bytes", "createdAt" ], "additionalProperties": false }, "MediaList": { "type": "object", "properties": { "schemaVersion": { "type": "integer", "const": 1 }, "items": { "type": "array", "maxItems": 100, "items": { "$ref": "#/components/schemas/MediaAsset" } }, "nextCursor": { "anyOf": [ { "type": "string", "maxLength": 88, "pattern": "^[0-9]{1,16}_upload_[a-f0-9]{64}$", "description": "Opaque ready-time/upload-ID cursor. Use the exact nextCursor; server also validates its timestamp." }, { "type": "null" } ] } }, "required": [ "schemaVersion", "items", "nextCursor" ], "additionalProperties": false }, "MediaUploaded": { "type": "object", "properties": { "schemaVersion": { "type": "integer", "const": 1 }, "asset": { "$ref": "#/components/schemas/MediaAsset" } }, "required": [ "schemaVersion", "asset" ], "additionalProperties": false }, "DeletePage": { "type": "object", "properties": { "expectedDraftVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expectedPublicationVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "expectedActiveRevision": { "anyOf": [ { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, { "type": "null" } ] } }, "required": [ "expectedDraftVersion", "expectedPublicationVersion", "expectedActiveRevision" ], "additionalProperties": false }, "DeletionReceipt": { "type": "object", "properties": { "schemaVersion": { "type": "integer", "const": 1 }, "pageId": { "type": "string", "pattern": "^[A-Za-z0-9_-]{1,128}$" }, "deleted": { "type": "boolean", "const": true }, "publicationVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "schemaVersion", "pageId", "deleted", "publicationVersion" ], "additionalProperties": false } }, "responses": { "400": { "description": "INVALID_INPUT or UNSUPPORTED_SECTION.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "UNAUTHENTICATED: missing or invalid app credential, or unsupported Authorization header.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Current grant, creator or realm authority does not allow this operation.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Scoped resource is absent or unavailable.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "VERSION_CONFLICT, PREVIEW_CONFLICT, IDEMPOTENCY_CONFLICT, BINDING_CONFLICT or UPLOAD_IN_PROGRESS (retry the same media command after its active lease).", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "Request exceeds the route limit: 256 KiB normally, 28 MiB JSON for POST media; decoded media limit is 5 MiB for images and 20 MiB for videos. Ingress parser failures may use a different envelope.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "CONTENT_NOT_READY: visible content is not ready for publication.", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "FEATURE_DISABLED, AUTHORITY_UNAVAILABLE or MEDIA_UNAVAILABLE (unconfigured media or provider failure).", "headers": { "Cache-Control": { "schema": { "type": "string", "const": "no-store" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "x-source": { "repository": "https://github.com/cometrocks/backend-core", "revision": "1f595395d54980e4565df93ec3cf8a071ff66007", "files": [ "apps/api/organizations/src/creatorPublishing/creatorPublishing.http.ts", "apps/api/organizations/src/creatorPublishing/creatorPublishing.store.ts", "apps/api/organizations/src/creatorPublishing/creatorPublishing.contract.ts", "apps/api/organizations/src/creatorPublishing/generated/creator-publishing-v2.ts", "apps/api/organizations/src/creatorPublishing/creatorPublishing.media.ts" ], "contentV2Schema": "Extracted from publishingContentCapabilitiesV2.jsonSchema; refs rebased to the ContentV2 component. Semantic refinements remain server-authoritative." } }