@rathnasgala2/schemas 3.25.0 → 3.26.0

package/openapi/openapi.yaml

@@ -1394,6 +1394,9 @@ components:
         `gala/publication.json`. An absent member is preserved. `null`
         resets `description` to the publication title (the file requires a
         description); `null` clears `defaultImageRef` and `crawlers`.
+        `listing`, `aiRights` and `performance` (SCHEMA-3.25.1, the
+        `publication.schema.json` 3.25.0 members) follow `crawlers`: absent
+        keeps the stored value, an object replaces it whole, `null` clears it.
         `title`, `defaultLanguage` and `socialLinks` cannot be cleared.
         `socialLinks` (max 32, the publication file's own limit) replaces
         the whole list. `canonicalBase` is never client-settable: it changes
@@ -1401,6 +1404,10 @@ components:
         `422 VALIDATION_FAILED` pointed at `/publicationProfile`; member
         failures point at `/publicationProfile/<member>`.
       properties:
+        aiRights:
+          oneOf:
+            - $ref: "#/components/schemas/PortablePublicationAiRights"
+            - type: "null"
         crawlers:
           oneOf:
             - $ref: "#/components/schemas/PortablePublicationCrawlers"
@@ -1420,6 +1427,14 @@ components:
                 maximum: 300
                 minimum: 1
             - type: "null"
+        listing:
+          oneOf:
+            - $ref: "#/components/schemas/PortablePublicationListing"
+            - type: "null"
+        performance:
+          oneOf:
+            - $ref: "#/components/schemas/PortablePublicationPerformance"
+            - type: "null"
         socialLinks:
           items:
             $ref: "#/components/schemas/PortablePublicationSocialLink"
@@ -1473,12 +1488,18 @@ components:
         `contentId` is the header's `id`; `status` is the header's `status`
         upper-cased to this contract's enum style. `publishAfter`
         (SCHEMA-3.19.0, optional and nullable) is the header's staggered-release
-        date.
+        date. `deleteDate` (SCHEMA-3.25.1, optional and nullable) is the
+        header's scheduled-removal date.
       properties:
         contentId:
           $ref: "#/components/schemas/PortableContentFrontmatterStableId"
         createdAt:
           $ref: "#/components/schemas/PortableContentFrontmatterRfc3339"
+        deleteDate:
+          description: "SCHEMA-3.25.1: the header's `deleteDate` date (`YYYY-MM-DD`) of an article scheduled for removal, `null` or absent when the header carries none."
+          oneOf:
+            - $ref: "#/components/schemas/PortableContentFrontmatterDeleteDate"
+            - type: "null"
         language:
           $ref: "#/components/schemas/PortableContentFrontmatterBcp47"
         publishAfter:
@@ -1573,8 +1594,12 @@ components:
         as the inventory, and returned on every page of the inventory, not
         only the first -- the editor needs these facts regardless of which
         page it opened. Carries no personal data beyond what each author
-        file itself already publishes.
+        file itself already publishes. `listing`, `aiRights` and `performance`
+        (SCHEMA-3.25.1, optional) are the publication file's 3.25.0 members,
+        absent when the file carries none.
       properties:
+        aiRights:
+          $ref: "#/components/schemas/PortablePublicationAiRights"
         authors:
           items:
             $ref: "#/components/schemas/ContentPublicationAuthorSummary"
@@ -1591,6 +1616,10 @@ components:
           x-gala-graphemeLength:
             maximum: 500
             minimum: 1
+        listing:
+          $ref: "#/components/schemas/PortablePublicationListing"
+        performance:
+          $ref: "#/components/schemas/PortablePublicationPerformance"
         socialLinks:
           items:
             $ref: "#/components/schemas/PortablePublicationSocialLink"
@@ -3776,6 +3805,8 @@ components:
         - openChange
         - setUp
       type: object
+    GetOrganizationsByOrganizationIdPublicationsByPublicationIdListenSettingsResponse:
+      $ref: "#/components/schemas/ListenSettings"
     GetOrganizationsByOrganizationIdPublicationsByPublicationIdModerationQueueResponse:
       additionalProperties: false
       properties:
@@ -6372,6 +6403,26 @@ components:
         - observedAt
         - evidenceDigest
       type: object
+    ListenSettings:
+      additionalProperties: false
+      description: "SCHEMA-3.26.0: the Listen setting of a site at the linked repository's main branch head: the `listen` member of `gala/publication.json` (`enabled`). A publication with no `listen` member reads `enabled` false. `planAllows` is read-only: false while the site's plan does not include Listen (the Free plan by default), in which case `enabled` cannot be turned on. `openChange` names an existing not-yet-published change of this publication that touches the file, or is null. `setUp` matches `GET .../repository/setup` `state`."
+      properties:
+        enabled:
+          type: boolean
+        openChange:
+          oneOf:
+            - $ref: "#/components/schemas/PublicationAppearanceOpenChange"
+            - type: "null"
+        planAllows:
+          type: boolean
+        setUp:
+          type: boolean
+      required:
+        - enabled
+        - planAllows
+        - openChange
+        - setUp
+      type: object
     ManagedDeploymentOperationResponse:
       additionalProperties: false
       allOf:
@@ -8651,6 +8702,9 @@ components:
         contactForm:
           description: "SCHEMA-3.23.0, whether sites on this plan may turn on the contact form. A site on a plan without it sees the form locked, and enabling it is `409 PLAN_REQUIRED`. Defaults of the first release: FREE 50 and no contact form, PRO 500 and a contact form, BUSINESS 2000 and a contact form."
           type: boolean
+        listen:
+          description: "SCHEMA-3.26.0, whether sites on this plan may turn on Listen, the audio version of posts. A site on a plan without it sees the setting locked, and enabling it is `409 PLAN_REQUIRED`. Defaults: FREE no Listen, PRO and BUSINESS Listen."
+          type: boolean
         newsletterSubscriberLimit:
           description: "SCHEMA-3.23.0, the confirmed newsletter subscribers one organization on this plan may hold across its sites; a confirmation past it is `409 NEWSLETTER_FULL`. 0 admits none. Defaults of the first release: FREE 50 and no contact form, PRO 500 and a contact form, BUSINESS 2000 and a contact form."
           format: int64
@@ -8667,6 +8721,7 @@ components:
         - publicationLimit
         - newsletterSubscriberLimit
         - contactForm
+        - listen
       type: object
     PlatformPlanCapacityRelease:
       additionalProperties: false
@@ -9138,6 +9193,31 @@ components:
         - generation
         - approvedAt
       type: object
+    PortableContentFrontmatterContentListen:
+      additionalProperties: false
+      description: "SCHEMA-3.26.0: the audio version of this article. All three members are required. `listen` is allowed only when `kind` is `article`. It has an effect only while the publication has `listen.enabled` true."
+      properties:
+        audio:
+          $ref: "#/components/schemas/PortableContentFrontmatterRepoRelativePath"
+          description: "Repository-relative path of the audio file: an `.mp3` or `.m4a` file that sits under one of the repository `assetRoots`. The schema fixes the shape and the extension; the publish toolchain checks the asset root, that the file exists and is a regular file, that it sniffs as MP3 or M4A and the size limits."
+          pattern: ^.+\.(?:mp3|m4a)$
+        durationSeconds:
+          description: Length of the episode in whole seconds, 1 to 10800 (three hours).
+          maximum: 10800
+          minimum: 1
+          type: integer
+        format:
+          description: "What the episode is: `conversation` (two voices talking the post over), `narration` (one voice reading it), `debate` (two voices taking sides) or `skit` (a scripted scene). The template words its invitation by format."
+          enum:
+            - conversation
+            - narration
+            - debate
+            - skit
+      required:
+        - audio
+        - durationSeconds
+        - format
+      type: object
     PortableContentFrontmatterContentSeo:
       additionalProperties: false
       description: "SCHEMA-3.12.0: optional search overrides for one document. `title` replaces the page title in search results (the site suffix is still appended on non-home pages), `description` replaces the search description, `canonicalUrl` is an absolute HTTPS canonical for syndicated or moved content, and `noindex: true` keeps a listed document out of search engines. Every member is optional; absent members fall back to the document's own title and description."
@@ -9217,6 +9297,17 @@ components:
                 x-gala-const: article
             required:
               - kind
+        - if:
+            required:
+              - listen
+          then:
+            properties:
+              kind:
+                pattern: ^article$
+                type: string
+                x-gala-const: article
+            required:
+              - kind
       dependentRequired:
         seriesOrder:
           - series
@@ -9251,6 +9342,8 @@ components:
             - edition
         language:
           $ref: "#/components/schemas/PortableContentFrontmatterBcp47"
+        listen:
+          $ref: "#/components/schemas/PortableContentFrontmatterContentListen"
         newsletter:
           enum:
             - ineligible
@@ -14924,6 +15017,28 @@ components:
           x-gala-graphemeLength:
             maximum: 500
             minimum: 0
+        details:
+          additionalProperties: false
+          description: "SCHEMA-3.25.1, optional, carried by a PAGE_LOSS_GUARD problem and absent from every other: the counts behind the refusal, the same members as the `PageLossGuardDetails` operation `reasonDetails`. The candidate build has fewer pages than the last successful deployment; `lostPageCount` is `previousPageCount - candidatePageCount` and `permittedLoss` is the loss the platform settings allow."
+          properties:
+            candidatePageCount:
+              minimum: 0
+              type: integer
+            lostPageCount:
+              minimum: 0
+              type: integer
+            permittedLoss:
+              minimum: 0
+              type: integer
+            previousPageCount:
+              minimum: 0
+              type: integer
+          required:
+            - previousPageCount
+            - candidatePageCount
+            - lostPageCount
+            - permittedLoss
+          type: object
         domainState:
           description: "SCHEMA-3.17.0, optional, carried by a CANONICAL_BASE_MISMATCH problem and absent from every other: the state of the site's custom-domain binding that decided `expectedBase` (a `DomainBindingState` value such as `CERTIFICATE_PENDING` or `ACTIVE`), absent when the site has no custom domain. A client shows a value it does not know as is."
           maxLength: 80
@@ -15063,6 +15178,24 @@ components:
       format: uri
       pattern: ^https://(?![^/?#]*@)
       type: string
+    PortablePublicationAiRights:
+      additionalProperties: false
+      description: "SCHEMA-3.25.0: how AI systems may use the writing. `search` covers search and answer bots, `training` covers training crawlers. When present it wins over `crawlers.ai`; when absent, `crawlers.ai` allow means both allow and block means both block. `licenseUrl` is the optional https URL of the license terms."
+      properties:
+        licenseUrl:
+          $ref: "#/components/schemas/PortablePublicationUrlHttps"
+        search:
+          enum:
+            - allow
+            - block
+        training:
+          enum:
+            - allow
+            - block
+      required:
+        - search
+        - training
+      type: object
     PortablePublicationBcp47:
       description: Structurally valid canonical BCP-47 language tag.
       format: gala-bcp47
@@ -15083,6 +15216,36 @@ components:
       required:
         - ai
       type: object
+    PortablePublicationListing:
+      additionalProperties: false
+      description: "SCHEMA-3.25.0: listing settings. `pageSize` is the number of posts on each listing page (1 to 50); an absent member means 10."
+      properties:
+        pageSize:
+          maximum: 50
+          minimum: 1
+          type: integer
+      required: []
+      type: object
+    PortablePublicationPerformance:
+      additionalProperties: false
+      description: "SCHEMA-3.25.0: size budgets in bytes, each at least 1024 and optional. `htmlBytes` bounds a page's HTML, `cssBytes` and `jsBytes` bound the sum of the same-origin stylesheets and scripts a page links. A page over budget is reported; a budget never fails a build."
+      properties:
+        budgets:
+          additionalProperties: false
+          properties:
+            cssBytes:
+              minimum: 1024
+              type: integer
+            htmlBytes:
+              minimum: 1024
+              type: integer
+            jsBytes:
+              minimum: 1024
+              type: integer
+          required: []
+          type: object
+      required: []
+      type: object
     PortablePublicationPlainLabel:
       description: Normalized Unicode plain text without markup, controls, or bidi overrides.
       format: gala-plain-label
@@ -16032,7 +16195,12 @@ components:
         (SCHEMA-3.19.0) is refused with `409 STAGGERED_RELEASE_DISABLED` while the
         publication's staggered release is off (`publishingPolicy.staggeredRelease`), and
         with `422 PUBLISH_AFTER_ON_PUBLISHED_POST` when its `status` is not
-        `draft`; `errors[].pointer` is `/documents/<path>`.
+        `draft`; `errors[].pointer` is `/documents/<path>`. A document whose
+        `deleteDate` (SCHEMA-3.25.0) is not later than its `publishAfter` or
+        `date` is refused with the content-change rejection reason
+        `DELETE_DATE_NOT_AFTER_RELEASE` (SCHEMA-3.25.1), alongside the other
+        reasons the API reports for cross-document rules; those reasons are
+        not an enumerated schema member.
         Assets are images only (PNG, JPEG, WebP, GIF, AVIF; SVG is refused):
         at most 20 per change, each at most 5 MiB and together at most
         20 MiB, measured on the decoded bytes -- `assets[].bytesBase64` is
@@ -16855,6 +17023,10 @@ components:
         person confirmed. The server publishes that head only while it is still
         the repository's head.
       properties:
+        allowPageLoss:
+          default: false
+          description: "SCHEMA-3.25.0: true accepts that this publish may remove many pages from the live site. The server stores it with the operation and skips the page-loss guard; absent or false keeps the guard on (a publish that would lose too many pages ends `FAILED_NO_EFFECT` with reason `PAGE_LOSS_GUARD`)."
+          type: boolean
         headCommit:
           $ref: "#/components/schemas/PortableDeploymentIntentGitObjectId"
       required:
@@ -18103,6 +18275,8 @@ components:
           format: uuid
           pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
           type: string
+        performance:
+          $ref: "#/components/schemas/PortableDeploymentReceiptDeploymentPerformance"
         provenanceDigest:
           pattern: ^sha256:[0-9a-f]{64}$
           type: string
@@ -19201,6 +19375,22 @@ components:
       required:
         - change
       type: object
+    PutOrganizationsByOrganizationIdPublicationsByPublicationIdListenSettingsRequest:
+      additionalProperties: false
+      properties:
+        enabled:
+          type: boolean
+      required:
+        - enabled
+      type: object
+    PutOrganizationsByOrganizationIdPublicationsByPublicationIdListenSettingsResponse:
+      additionalProperties: false
+      properties:
+        change:
+          $ref: "#/components/schemas/PostOrganizationsByOrganizationIdPublicationsByPublicationIdContentChangesPlanResponse"
+      required:
+        - change
+      type: object
     PutOrganizationsByOrganizationIdPublicationsByPublicationIdNewsletterSettingsRequest:
       additionalProperties: false
       allOf:
@@ -19300,6 +19490,9 @@ components:
         contactForm:
           description: SCHEMA-3.23.0, optional; absent keeps the plan's current value.
           type: boolean
+        listen:
+          description: SCHEMA-3.26.0, optional; absent keeps the plan's current value.
+          type: boolean
         newsletterSubscriberLimit:
           description: SCHEMA-3.23.0, optional; absent keeps the plan's current value.
           format: int64
@@ -44829,6 +45022,424 @@ paths:
         - RepositoryChange:REQUESTED -> PLANNED
       x-gala-success-category: protocol
       x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
+  /v2/organizations/{organizationId}/publications/{publicationId}/listen-settings:
+    get:
+      description: Reads the `listen` member of `gala/publication.json` at the linked repository's current main branch head. A publication with no `listen` member reads `enabled` false. `planAllows` is the API's own status and is never written to the repository.
+      operationId: getOrganizationsByOrganizationIdPublicationsByPublicationIdListenSettings
+      parameters:
+        - $ref: "#/components/parameters/XCorrelationId"
+        - example: 018f0000-0000-7000-8000-000000000001
+          in: path
+          name: organizationId
+          required: true
+          schema:
+            format: uuid
+            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
+            type: string
+        - example: 018f0000-0000-7000-8000-000000000001
+          in: path
+          name: publicationId
+          required: true
+          schema:
+            format: uuid
+            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
+            type: string
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                nominal:
+                  summary: Nominal successful response
+                  value:
+                    enabled: false
+                    openChange: null
+                    planAllows: false
+                    setUp: true
+              schema:
+                $ref: "#/components/schemas/GetOrganizationsByOrganizationIdPublicationsByPublicationIdListenSettingsResponse"
+          description: read this publication's listen settings at the main branch head succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+        "400":
+          $ref: "#/components/responses/ValidationFailed"
+        "401":
+          content:
+            application/problem+json:
+              examples:
+                AUTHENTICATION_REQUIRED:
+                  summary: AUTHENTICATION_REQUIRED
+                  value:
+                    code: AUTHENTICATION_REQUIRED
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 401
+                    title: AUTHENTICATION_REQUIRED
+                    type: urn:gala:problem:authentication-required
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHENTICATION_REQUIRED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHENTICATION_REQUIRED
+        "403":
+          $ref: "#/components/responses/AuthorizationDenied"
+        "404":
+          $ref: "#/components/responses/ResourceNotFound"
+        "429":
+          content:
+            application/problem+json:
+              examples:
+                RATE_LIMITED:
+                  summary: RATE_LIMITED
+                  value:
+                    code: RATE_LIMITED
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: true
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 429
+                    title: RATE_LIMITED
+                    type: urn:gala:problem:rate-limited
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: RATE_LIMITED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            Retry-After:
+              $ref: "#/components/headers/RetryAfter"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - RATE_LIMITED
+        "503":
+          content:
+            application/problem+json:
+              examples:
+                CAPABILITY_UNAVAILABLE:
+                  summary: CAPABILITY_UNAVAILABLE
+                  value:
+                    code: CAPABILITY_UNAVAILABLE
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 503
+                    title: CAPABILITY_UNAVAILABLE
+                    type: urn:gala:problem:capability-unavailable
+                DEPENDENCY_UNAVAILABLE:
+                  summary: DEPENDENCY_UNAVAILABLE
+                  value:
+                    code: DEPENDENCY_UNAVAILABLE
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: true
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 503
+                    title: DEPENDENCY_UNAVAILABLE
+                    type: urn:gala:problem:dependency-unavailable
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: CAPABILITY_UNAVAILABLE, DEPENDENCY_UNAVAILABLE
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - CAPABILITY_UNAVAILABLE
+            - DEPENDENCY_UNAVAILABLE
+      security:
+        - browserSession: []
+      summary: read this publication's listen settings at the main branch head
+      tags:
+        - interaction-settings
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - Active repository binding and configured GitHub App identity capability
+      x-gala-capability-key: publication.view
+      x-gala-concurrency: binding-epoch
+      x-gala-conditional-capabilities: []
+      x-gala-example-profile: NOMINAL_SUCCESS_AND_EACH_REACHABLE_PROBLEM
+      x-gala-nullability: required-and-nullable-are-explicit
+      x-gala-purpose: read this publication's listen settings at the main branch head
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - CAPABILITY_UNAVAILABLE
+        - DEPENDENCY_UNAVAILABLE
+        - RATE_LIMITED
+        - RESOURCE_NOT_FOUND
+        - VALIDATION_FAILED
+      x-gala-replay-identity: safe-query
+      x-gala-state-guards:
+        - NONE
+      x-gala-success-category: query
+      x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
+    put:
+      description: The server writes the `listen` member of `gala/publication.json` as one repository change, the way `sharing-settings` writes the `sharing` member. Publishing the change uses the normal publish flow. `change` has the shape the theme-selection write returns. Turning `enabled` on while the plan does not include Listen is `409 PLAN_REQUIRED` pointed at `/enabled`. Saving it off, or unchanged, is always allowed.
+      operationId: putOrganizationsByOrganizationIdPublicationsByPublicationIdListenSettings
+      parameters:
+        - $ref: "#/components/parameters/XCorrelationId"
+        - example: 018f0000-0000-7000-8000-000000000001
+          in: path
+          name: organizationId
+          required: true
+          schema:
+            format: uuid
+            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
+            type: string
+        - example: 018f0000-0000-7000-8000-000000000001
+          in: path
+          name: publicationId
+          required: true
+          schema:
+            format: uuid
+            pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
+            type: string
+        - $ref: "#/components/parameters/IdempotencyKey"
+        - $ref: "#/components/parameters/XCsrfToken"
+      requestBody:
+        content:
+          application/json:
+            examples:
+              nominal:
+                summary: Nominal valid request
+                value:
+                  enabled: true
+            schema:
+              $ref: "#/components/schemas/PutOrganizationsByOrganizationIdPublicationsByPublicationIdListenSettingsRequest"
+        required: true
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                nominal:
+                  summary: Nominal successful response
+                  value:
+                    change:
+                      changeId: 018f0000-0000-7000-8000-000000000001
+                      diffDigest: sha256:0000000000000000000000000000000000000000000000000000000000000000
+                      expectedHead: sha1:0000000000000000000000000000000000000000
+                      state: REQUESTED
+                      version: 0
+              schema:
+                $ref: "#/components/schemas/PutOrganizationsByOrganizationIdPublicationsByPublicationIdListenSettingsResponse"
+          description: save this publication's listen settings as a repository change succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+        "400":
+          $ref: "#/components/responses/RequestInvalid"
+        "401":
+          content:
+            application/problem+json:
+              examples:
+                AUTHENTICATION_REQUIRED:
+                  summary: AUTHENTICATION_REQUIRED
+                  value:
+                    code: AUTHENTICATION_REQUIRED
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 401
+                    title: AUTHENTICATION_REQUIRED
+                    type: urn:gala:problem:authentication-required
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHENTICATION_REQUIRED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHENTICATION_REQUIRED
+        "403":
+          $ref: "#/components/responses/AuthorizationDenied"
+        "404":
+          $ref: "#/components/responses/ResourceNotFound"
+        "409":
+          content:
+            application/problem+json:
+              examples:
+                COMMAND_REPLAY_CONFLICT:
+                  summary: COMMAND_REPLAY_CONFLICT
+                  value:
+                    code: COMMAND_REPLAY_CONFLICT
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 409
+                    title: COMMAND_REPLAY_CONFLICT
+                    type: urn:gala:problem:command-replay-conflict
+                INVALID_SOURCE_STATE:
+                  summary: INVALID_SOURCE_STATE
+                  value:
+                    code: INVALID_SOURCE_STATE
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 409
+                    title: INVALID_SOURCE_STATE
+                    type: urn:gala:problem:invalid-source-state
+                PLAN_REQUIRED:
+                  summary: PLAN_REQUIRED
+                  value:
+                    code: PLAN_REQUIRED
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: The site's plan does not include Listen. See the operation contract.
+                    errors:
+                      - code: PLAN_REQUIRED
+                        pointer: /enabled
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 409
+                    title: PLAN_REQUIRED
+                    type: urn:gala:problem:plan-required
+                TRANSFER_PENDING:
+                  summary: TRANSFER_PENDING
+                  value:
+                    code: TRANSFER_PENDING
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 409
+                    title: TRANSFER_PENDING
+                    type: urn:gala:problem:transfer-pending
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: COMMAND_REPLAY_CONFLICT, INVALID_SOURCE_STATE, PLAN_REQUIRED, TRANSFER_PENDING
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - COMMAND_REPLAY_CONFLICT
+            - INVALID_SOURCE_STATE
+            - PLAN_REQUIRED
+            - TRANSFER_PENDING
+        "422":
+          content:
+            application/problem+json:
+              examples:
+                VALIDATION_FAILED:
+                  summary: VALIDATION_FAILED
+                  value:
+                    code: VALIDATION_FAILED
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 422
+                    title: VALIDATION_FAILED
+                    type: urn:gala:problem:validation-failed
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: VALIDATION_FAILED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - VALIDATION_FAILED
+        "503":
+          content:
+            application/problem+json:
+              examples:
+                CAPABILITY_UNAVAILABLE:
+                  summary: CAPABILITY_UNAVAILABLE
+                  value:
+                    code: CAPABILITY_UNAVAILABLE
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 503
+                    title: CAPABILITY_UNAVAILABLE
+                    type: urn:gala:problem:capability-unavailable
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: CAPABILITY_UNAVAILABLE
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - CAPABILITY_UNAVAILABLE
+      security:
+        - browserSession: []
+      summary: save this publication's listen settings as a repository change
+      tags:
+        - interaction-settings
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - Active repository binding and configured GitHub App identity capability
+      x-gala-capability-key: publication.settings.manage
+      x-gala-concurrency: expected-git-head-and-binding-epoch
+      x-gala-conditional-capabilities: []
+      x-gala-example-profile: NOMINAL_SUCCESS_AND_EACH_REACHABLE_PROBLEM
+      x-gala-nullability: required-and-nullable-are-explicit
+      x-gala-purpose: save this publication's listen settings as a repository change
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - CAPABILITY_UNAVAILABLE
+        - COMMAND_REPLAY_CONFLICT
+        - INVALID_SOURCE_STATE
+        - PLAN_REQUIRED
+        - REQUEST_FIELD_UNKNOWN
+        - RESOURCE_NOT_FOUND
+        - TRANSFER_PENDING
+        - VALIDATION_FAILED
+      x-gala-replay-identity: idempotency-key
+      x-gala-state-guards:
+        - Publication:ACTIVE
+        - RepositoryBinding:ACTIVE
+        - RepositoryChange:REQUESTED -> PLANNED
+      x-gala-success-category: protocol
+      x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
   /v2/organizations/{organizationId}/publications/{publicationId}/moderation/comments/{commentId}:decide:
     post:
       description: |
@@ -59850,10 +60461,12 @@ paths:
         active publication-capacity release with its single optimistic-lock
         version and the closed FREE, PRO, and BUSINESS plan catalog.
         Each plan carries its `publicationLimit`, its `newsletterSubscriberLimit`
-        (confirmed newsletter subscribers per organization) and `contactForm`
-        (whether its sites may turn on the contact form). Defaults of the first
-        release: FREE 50 and no contact form, PRO 500 and a contact form,
-        BUSINESS 2000 and a contact form.
+        (confirmed newsletter subscribers per organization), `contactForm`
+        (whether its sites may turn on the contact form) and `listen` (whether
+        its sites may turn on Listen, the audio version of posts). Defaults of
+        the first release: FREE 50 and no contact form, PRO 500 and a contact
+        form, BUSINESS 2000 and a contact form. Listen defaults: FREE no, PRO
+        and BUSINESS yes.
       operationId: getPlatformPlans
       parameters:
         - $ref: "#/components/parameters/XCorrelationId"
@@ -59868,14 +60481,17 @@ paths:
                     effectiveAt: "2026-10-10T00:00:04.000Z"
                     items:
                       - contactForm: false
+                        listen: false
                         newsletterSubscriberLimit: 50
                         planKey: FREE
                         publicationLimit: 1
                       - contactForm: true
+                        listen: true
                         newsletterSubscriberLimit: 500
                         planKey: PRO
                         publicationLimit: 10
                       - contactForm: true
+                        listen: true
                         newsletterSubscriberLimit: 2000
                         planKey: BUSINESS
                         publicationLimit: 50
@@ -59924,9 +60540,9 @@ paths:
         Operators only, with recent authentication. Atomically replaces the
         complete publication-capacity release, changing the named plan's limits
         while retaining the other two, at the release version in `If-Match`.
-        `newsletterSubscriberLimit` and `contactForm` are optional: absent keeps
-        the plan's current value. The invariant FREE <= PRO <= BUSINESS is
-        enforced on `publicationLimit` only. `reason` is a
+        `newsletterSubscriberLimit`, `contactForm` and `listen` are optional:
+        absent keeps the plan's current value. The invariant FREE <= PRO <=
+        BUSINESS is enforced on `publicationLimit` only. `reason` is a
         non-sensitive operator reason code recorded in the audit event.
       operationId: putPlatformPlansByPlanKey
       parameters:
@@ -59963,14 +60579,17 @@ paths:
                     effectiveAt: "2026-10-10T12:00:00.000Z"
                     items:
                       - contactForm: false
+                        listen: false
                         newsletterSubscriberLimit: 50
                         planKey: FREE
                         publicationLimit: 1
                       - contactForm: true
+                        listen: true
                         newsletterSubscriberLimit: 500
                         planKey: PRO
                         publicationLimit: 12
                       - contactForm: true
+                        listen: true
                         newsletterSubscriberLimit: 2000
                         planKey: BUSINESS
                         publicationLimit: 50
@@ -70904,6 +71523,24 @@ paths:
                     status: 409
                     title: INVALID_SOURCE_STATE
                     type: urn:gala:problem:invalid-source-state
+                PAGE_LOSS_GUARD:
+                  summary: PAGE_LOSS_GUARD
+                  value:
+                    code: PAGE_LOSS_GUARD
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    details:
+                      candidatePageCount: 40
+                      lostPageCount: 60
+                      permittedLoss: 25
+                      previousPageCount: 100
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 409
+                    title: PAGE_LOSS_GUARD
+                    type: urn:gala:problem:page-loss-guard
                 WORKLOAD_REPLAYED:
                   summary: WORKLOAD_REPLAYED
                   value:
@@ -70919,7 +71556,7 @@ paths:
                     type: urn:gala:problem:workload-replayed
               schema:
                 $ref: "#/components/schemas/Problem"
-          description: DESTINATION_MUTATION_IN_PROGRESS, INVALID_SOURCE_STATE, WORKLOAD_REPLAYED
+          description: DESTINATION_MUTATION_IN_PROGRESS, INVALID_SOURCE_STATE, PAGE_LOSS_GUARD, WORKLOAD_REPLAYED
           headers:
             Cache-Control:
               $ref: "#/components/headers/CacheControlNoStore"
@@ -70928,6 +71565,7 @@ paths:
           x-gala-problem-codes:
             - DESTINATION_MUTATION_IN_PROGRESS
             - INVALID_SOURCE_STATE
+            - PAGE_LOSS_GUARD
             - WORKLOAD_REPLAYED
         "410":
           content:
@@ -71091,6 +71729,7 @@ paths:
         - DEPENDENCY_UNAVAILABLE
         - DESTINATION_MUTATION_IN_PROGRESS
         - INVALID_SOURCE_STATE
+        - PAGE_LOSS_GUARD
         - RATE_LIMITED
         - REQUEST_FIELD_UNKNOWN
         - VALIDATION_FAILED