@rathnasgala2/schemas 3.24.0 → 3.25.0

package/generated/typescript/contracts/build-input.d.ts

@@ -1,6 +1,12 @@
 // Generated from urn:gala:schema:build-input:2.0.0; sourceDesignRevision=a53052955ceb6c1aa10c886289dc832eedfe6de0a00004df07d353ac19c4403a.
 // Do not edit.
 
+export type BuildInputAiRights = Readonly<{
+  readonly licenseUrl?: BuildInputUrlHttps;
+  readonly search: 'allow' | 'block';
+  readonly training: 'allow' | 'block';
+}>;
+
 export type BuildInputAnalyticsConfig = Readonly<{
   readonly consent: Readonly<{
     readonly policy: 'opt-in';
@@ -158,6 +164,7 @@ export type BuildInputContentEdition = Readonly<{
 export type BuildInputContentFrontmatterNormalized = Readonly<{
   readonly authorIds: ReadonlyArray<BuildInputStableId>;
   readonly createdAt: BuildInputRfc3339;
+  readonly deleteDate?: BuildInputDeleteDate;
   readonly description?: BuildInputPlainText;
   readonly edition?: BuildInputContentEdition;
   readonly hero?: BuildInputResolvedMedia;
@@ -187,6 +194,8 @@ export type BuildInputContentSeo = Readonly<{
   readonly title?: BuildInputPlainText;
 }>;
 
+export type BuildInputDeleteDate = string;
+
 export type BuildInputDestinationCapabilityProfile = Readonly<{
   readonly adapter: BuildInputAuthoredAdapterIdentity;
   readonly baseUrl: BuildInputUrlHttps;
@@ -228,6 +237,10 @@ export type BuildInputInteractionsServiceOrigin = string;
 
 export type BuildInputIsoCountry = string;
 
+export type BuildInputListing = Readonly<{
+  readonly pageSize?: number;
+}>;
+
 export type BuildInputLocalizedAuthor = Readonly<{
   readonly biography: BuildInputPlainText;
   readonly displayName: BuildInputPlainText;
@@ -317,6 +330,14 @@ export type BuildInputPackageRange = string;
 
 export type BuildInputPassiveVisualToken = never;
 
+export type BuildInputPerformance = Readonly<{
+  readonly budgets?: Readonly<{
+    readonly cssBytes?: number;
+    readonly htmlBytes?: number;
+    readonly jsBytes?: number;
+  }>;
+}>;
+
 export type BuildInputPlainLabel = string;
 
 export type BuildInputPlainText = string;
@@ -332,6 +353,7 @@ export type BuildInputPolicyPageNormalized = Readonly<{
 }>;
 
 export type BuildInputPublicationNormalized = Readonly<{
+  readonly aiRights?: BuildInputAiRights;
   readonly authorIds: ReadonlyArray<BuildInputStableId>;
   readonly canonicalBase: BuildInputUrlHttps;
   readonly contactAuthorId?: BuildInputStableId;
@@ -349,7 +371,9 @@ export type BuildInputPublicationNormalized = Readonly<{
     readonly heading: BuildInputPlainText;
   }>;
   readonly id: BuildInputStableId;
+  readonly listing?: BuildInputListing;
   readonly newsletter?: BuildInputNewsletter;
+  readonly performance?: BuildInputPerformance;
   readonly profile?: Readonly<{
     readonly body: BuildInputRenderableBody;
     readonly route: BuildInputCanonicalRoute;

package/generated/typescript/contracts/content-frontmatter.d.ts

@@ -24,6 +24,8 @@ export type ContentFrontmatterContentSeo = Readonly<{
   readonly title?: ContentFrontmatterPlainText;
 }>;
 
+export type ContentFrontmatterDeleteDate = string;
+
 export type ContentFrontmatterDigest = string;
 
 export type ContentFrontmatterExtensionKey = string;
@@ -74,6 +76,7 @@ export type ContentFrontmatterUrn = string;
 export type ContentFrontmatterDocument = Readonly<{
   readonly authors: ReadonlyArray<ContentFrontmatterStableId>;
   readonly createdAt: ContentFrontmatterRfc3339;
+  readonly deleteDate?: ContentFrontmatterDeleteDate;
   readonly description?: ContentFrontmatterPlainText;
   readonly edition?: ContentFrontmatterContentEdition;
   readonly extensions: ContentFrontmatterExtensionMap;

package/generated/typescript/contracts/deployment-receipt.d.ts

@@ -745,6 +745,23 @@ export type DeploymentReceiptDeploymentObservation = (
   }> &
   unknown;
 
+export type DeploymentReceiptDeploymentPerformance = Readonly<{
+  readonly budgets: Readonly<{
+    readonly cssBytes?: number;
+    readonly htmlBytes?: number;
+    readonly jsBytes?: number;
+  }>;
+  readonly overBudget: ReadonlyArray<
+    Readonly<{
+      readonly budget: number;
+      readonly bytes: number;
+      readonly kind: 'html' | 'css' | 'js';
+      readonly path: DeploymentReceiptRepoRelativePath;
+    }>
+  >;
+  readonly overBudgetCount: number;
+}>;
+
 export type DeploymentReceiptDeploymentPolicyDecision = Readonly<{
   readonly activationDetectionIntervalSeconds: 60;
   readonly activationDetectionProfile: 'gala-public-activation-detection-v2';
@@ -1613,6 +1630,7 @@ export type DeploymentReceiptDocument = (
       | 'superseded'
       | 'unknown-reconciling'
       | 'rolled-back';
+    readonly performance?: DeploymentReceiptDeploymentPerformance;
     readonly provenanceDigest: DeploymentReceiptDigest;
     readonly publisher: DeploymentReceiptPackageIdentity &
       Readonly<{

package/generated/typescript/contracts/publication.d.ts

@@ -1,6 +1,12 @@
 // Generated from urn:gala:schema:publication:2.0.0; sourceDesignRevision=a53052955ceb6c1aa10c886289dc832eedfe6de0a00004df07d353ac19c4403a.
 // Do not edit.
 
+export type PublicationAiRights = Readonly<{
+  readonly licenseUrl?: PublicationUrlHttps;
+  readonly search: 'allow' | 'block';
+  readonly training: 'allow' | 'block';
+}>;
+
 export type PublicationBcp47 = string;
 
 export type PublicationCanonicalRoute = string;
@@ -36,6 +42,10 @@ export type PublicationGlob = string;
 
 export type PublicationIsoCountry = string;
 
+export type PublicationListing = Readonly<{
+  readonly pageSize?: number;
+}>;
+
 export type PublicationNewsletter =
   | Readonly<{
       readonly emailContent: 'card' | 'full';
@@ -57,6 +67,14 @@ export type PublicationPackageRange = string;
 
 export type PublicationPassiveVisualToken = never;
 
+export type PublicationPerformance = Readonly<{
+  readonly budgets?: Readonly<{
+    readonly cssBytes?: number;
+    readonly htmlBytes?: number;
+    readonly jsBytes?: number;
+  }>;
+}>;
+
 export type PublicationPlainLabel = string;
 
 export type PublicationPlainText = string;
@@ -125,6 +143,7 @@ export type PublicationUrlHttps = string;
 export type PublicationUrn = string;
 
 export type PublicationDocument = Readonly<{
+  readonly aiRights?: PublicationAiRights;
   readonly authors: ReadonlyArray<PublicationRepoRelativePath>;
   readonly canonicalBase: PublicationUrlHttps;
   readonly contactForm?: PublicationContactForm;
@@ -136,7 +155,9 @@ export type PublicationDocument = Readonly<{
   readonly extensions: PublicationExtensionMap;
   readonly footerCard?: PublicationFooterCard;
   readonly id: PublicationStableId;
+  readonly listing?: PublicationListing;
   readonly newsletter?: PublicationNewsletter;
+  readonly performance?: PublicationPerformance;
   readonly policies?: PublicationPublicationPolicies;
   readonly profile?: PublicationPublicationProfile;
   readonly schemaId: 'urn:gala:schema:publication:2.0.0';

package/openapi/http-catalog.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "2.0.0",
   "sourceDesignRevision": "a53052955ceb6c1aa10c886289dc832eedfe6de0a00004df07d353ac19c4403a",
-  "openApiDigest": "sha256:84db429fb73a76449703c1e6e5b7cb28114966f245b5fd20a0a1f5e049a584f1",
+  "openApiDigest": "sha256:55a877835a611d3a2cbd91e8f863baeca2192a228b95de1eebc94a568ff337ac",
   "operations": [
     {
       "operationId": "getInternalHealth",
@@ -2230,6 +2230,32 @@
       "apiKeyScope": null,
       "sourceFragment": "platform"
     },
+    {
+      "operationId": "getPlatformPrismGenerations",
+      "method": "GET",
+      "path": "/v2/platform/prism-generations",
+      "purpose": "list platform Prism generations",
+      "capabilityKey": "platform.prism.view",
+      "conditionalCapabilityKeys": [],
+      "activationGate": "MVP",
+      "assuranceClass": "SESSION",
+      "actionGrant": "none",
+      "apiKeyScope": null,
+      "sourceFragment": "platform"
+    },
+    {
+      "operationId": "postPlatformPrismGenerationsExport",
+      "method": "POST",
+      "path": "/v2/platform/prism-generations:export",
+      "purpose": "export platform Prism generations as CSV",
+      "capabilityKey": "platform.prism.export",
+      "conditionalCapabilityKeys": [],
+      "activationGate": "MVP",
+      "assuranceClass": "RECENT_AUTHENTICATION",
+      "actionGrant": "none",
+      "apiKeyScope": null,
+      "sourceFragment": "platform"
+    },
     {
       "operationId": "getPlatformSettingsByKey",
       "method": "GET",
@@ -3206,5 +3232,5 @@
       "sourceFragment": "workloads"
     }
   ],
-  "digest": "sha256:717a75c038a3380c6082a97d3c58f935187915c612228c35ae2fa64aaf5a1741"
+  "digest": "sha256:38eaece75559fa90ba57b4c0b5cd69bbd7d61188007266d18a62a48e5e33f89c"
 }

package/openapi/openapi.yaml

@@ -4776,6 +4776,48 @@ components:
       type: object
     GetPlatformPlansResponse:
       $ref: "#/components/schemas/PlatformPlanCapacityRelease"
+    GetPlatformPrismGenerationsResponse:
+      additionalProperties: false
+      allOf:
+        - else:
+            properties:
+              nextCursor:
+                type: "null"
+          if:
+            properties:
+              hasMore:
+                not:
+                  enum:
+                    - false
+                type: boolean
+                x-gala-const: true
+            required:
+              - hasMore
+          then:
+            properties:
+              nextCursor:
+                type: string
+            required:
+              - nextCursor
+      properties:
+        hasMore:
+          type: boolean
+        items:
+          items:
+            $ref: "#/components/schemas/PlatformPrismGeneration"
+          maxItems: 100
+          type: array
+        nextCursor:
+          description: Opaque cursor for the next page. Present and non-null exactly when `hasMore` is true; absent or null when `hasMore` is false.
+          maxLength: 2048
+          minLength: 1
+          type:
+            - string
+            - "null"
+      required:
+        - items
+        - hasMore
+      type: object
     GetPlatformSettingsByKeyResponse:
       $ref: "#/components/schemas/PlatformSetting"
     GetPlatformSettingsOverridesByKindByIdByKeyResponse:
@@ -5693,7 +5735,7 @@ components:
       additionalProperties: false
       properties:
         reasonCode:
-          description: "A free string. Known values: RUN_NOT_STARTED, BUILD_FAILED, RUN_CANCELLED, RUN_TIMED_OUT, WORKFLOW_UNAVAILABLE, DEPLOY_FAILED, PAGES_NOT_AVAILABLE, REPORT_FAILED, LIVE_CHECK_FAILED, CHANGE_CLOSED_ON_GITHUB and, new in 3.17.0, DESTINATION_BUSY_TIMEOUT, DESTINATION_FENCE_EXPIRED, CANONICAL_BASE_MISMATCH, DOMAIN_NOT_READY (the same codes as `OperationReason`). Clients must tolerate other values."
+          description: "A free string. Known values: RUN_NOT_STARTED, BUILD_FAILED, RUN_CANCELLED, RUN_TIMED_OUT, WORKFLOW_UNAVAILABLE, DEPLOY_FAILED, PAGES_NOT_AVAILABLE, REPORT_FAILED, LIVE_CHECK_FAILED, CHANGE_CLOSED_ON_GITHUB and, new in 3.17.0, DESTINATION_BUSY_TIMEOUT, DESTINATION_FENCE_EXPIRED, CANONICAL_BASE_MISMATCH, DOMAIN_NOT_READY and, new in 3.25.0, PAGE_LOSS_GUARD (the same codes as `OperationReason`). Clients must tolerate other values."
           maxLength: 80
           minLength: 1
           type: string
@@ -6479,10 +6521,14 @@ 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"
         phase:
           $ref: "#/components/schemas/OperationPhase"
         reason:
           $ref: "#/components/schemas/OperationReason"
+        reasonDetails:
+          $ref: "#/components/schemas/PageLossGuardDetails"
         recoveryActions:
           items:
             maxLength: 80
@@ -7455,6 +7501,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"
         phase:
           enum:
             - accepted
@@ -7466,6 +7514,8 @@ components:
           type: string
         reason:
           $ref: "#/components/schemas/OperationReason"
+        reasonDetails:
+          $ref: "#/components/schemas/PageLossGuardDetails"
         recoveryActions:
           items:
             maxLength: 80
@@ -7594,7 +7644,10 @@ components:
         run settled with no receipt), `CANONICAL_BASE_MISMATCH` (the site's
         canonical base was not the address it is served from when the
         operation was dispatched) and `DOMAIN_NOT_READY` (a custom domain was
-        part-way through its switch and no origin could be verified).
+        part-way through its switch and no origin could be verified). New in
+        3.25.0: `PAGE_LOSS_GUARD` (the publish would have removed too many pages
+        from the live site, so authorization was refused and nothing was
+        deployed; the operation's `reasonDetails` carry the counts).
       maxLength: 64
       minLength: 3
       pattern: ^[A-Z][A-Z0-9_]{2,63}$
@@ -7794,6 +7847,34 @@ components:
         - REVOKED
         - EXPIRED
       type: string
+    PageLossGuardDetails:
+      additionalProperties: false
+      description: |
+        SCHEMA-3.25.0. Present on an operation read when `reason` is
+        `PAGE_LOSS_GUARD`: the candidate build has fewer pages than the last
+        successful deployment of the same site and target. `lostPageCount` is
+        `previousPageCount - candidatePageCount`; `permittedLoss` is the loss
+        the platform settings allow. A person who accepts the loss publishes
+        again with `allowPageLoss: true`.
+      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
     PasskeyState:
       enum:
         - ACTIVE
@@ -8660,6 +8741,36 @@ components:
         - PRO
         - BUSINESS
       type: string
+    PlatformPrismGeneration:
+      additionalProperties: false
+      description: SCHEMA-3.25.0. One Prism generation as the operator list shows it, ownership and state only, never article text or the candidate body.
+      properties:
+        createdAt:
+          $ref: "#/components/schemas/PortableProblemRfc3339"
+        editionKind:
+          $ref: "#/components/schemas/PrismEditionKind"
+        generationId:
+          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
+        organizationId:
+          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
+        publicationId:
+          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
+        state:
+          $ref: "#/components/schemas/PrismGenerationState"
+      required:
+        - generationId
+        - organizationId
+        - publicationId
+        - editionKind
+        - state
+        - createdAt
+      type: object
     PlatformSetting:
       additionalProperties: false
       description: "An app-wide setting: the active release value, or the default when none is released."
@@ -9047,6 +9158,10 @@ components:
             minimum: 1
       required: []
       type: object
+    PortableContentFrontmatterDeleteDate:
+      description: "SCHEMA-3.25.0: the calendar date (`YYYY-MM-DD`, day precision, read in the publication's staggered-release timezone) on or after which Galascribe removes this article from the published site: it leaves every listing, feed, sitemap and search index and its route renders a removed-post notice. Same format as `publishAfter`; it must be later than `publishAfter` and `date` when both exist. The API enforces that rule; the schema only fixes the shape."
+      pattern: ^\d{4}-\d{2}-\d{2}$
+      type: string
     PortableContentFrontmatterDigest:
       pattern: ^sha256:[0-9a-f]{64}$
       type: string
@@ -9114,6 +9229,8 @@ components:
           type: array
         createdAt:
           $ref: "#/components/schemas/PortableContentFrontmatterRfc3339"
+        deleteDate:
+          $ref: "#/components/schemas/PortableContentFrontmatterDeleteDate"
         description:
           $ref: "#/components/schemas/PortableContentFrontmatterPlainText"
           x-gala-graphemeLength:
@@ -12988,6 +13105,57 @@ components:
         - evidenceDigest
         - probes
       type: object
+    PortableDeploymentReceiptDeploymentPerformance:
+      additionalProperties: false
+      description: "SCHEMA-3.25.0: the publish kernel's size-budget summary of the final artifact. `budgets` are the effective byte budgets; `overBudgetCount` counts every page asset over budget; `overBudget` lists at most 20, largest first. Informational: it never fails a publish."
+      properties:
+        budgets:
+          additionalProperties: false
+          properties:
+            cssBytes:
+              minimum: 1024
+              type: integer
+            htmlBytes:
+              minimum: 1024
+              type: integer
+            jsBytes:
+              minimum: 1024
+              type: integer
+          required: []
+          type: object
+        overBudget:
+          items:
+            additionalProperties: false
+            properties:
+              budget:
+                minimum: 1024
+                type: integer
+              bytes:
+                minimum: 0
+                type: integer
+              kind:
+                enum:
+                  - html
+                  - css
+                  - js
+              path:
+                $ref: "#/components/schemas/PortableDeploymentReceiptRepoRelativePath"
+            required:
+              - path
+              - kind
+              - bytes
+              - budget
+            type: object
+          maxItems: 20
+          type: array
+        overBudgetCount:
+          minimum: 0
+          type: integer
+      required:
+        - budgets
+        - overBudgetCount
+        - overBudget
+      type: object
     PortableDeploymentReceiptDeploymentWarning:
       oneOf:
         - allOf:
@@ -13837,6 +14005,8 @@ components:
             - superseded
             - unknown-reconciling
             - rolled-back
+        performance:
+          $ref: "#/components/schemas/PortableDeploymentReceiptDeploymentPerformance"
         provenanceDigest:
           $ref: "#/components/schemas/PortableDeploymentReceiptDigest"
         publisher:
@@ -15730,6 +15900,10 @@ components:
     PostOrganizationsByOrganizationIdPublicationsByPublicationIdChangesPublishRequest:
       additionalProperties: false
       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
         changeIds:
           items:
             format: uuid
@@ -16228,6 +16402,10 @@ components:
     PostOrganizationsByOrganizationIdPublicationsByPublicationIdPublishesRequest:
       additionalProperties: false
       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
         reviewId:
           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}$
@@ -19432,6 +19610,10 @@ components:
         manifestDigest:
           pattern: ^sha256:[0-9a-f]{64}$
           type: string
+        pageCount:
+          description: "SCHEMA-3.25.0: the number of `.html` files in the artifact. Optional so a kernel built before 3.25.0 still validates; an absent count exempts the deployment from the page-loss guard."
+          minimum: 0
+          type: integer
         pagesBuildVersion:
           description: |
             The Pages build version this deployment addresses, when the
@@ -59846,6 +60028,175 @@ paths:
         - NONE
       x-gala-success-category: update
       x-gala-tenant-scope: NONE
+  /v2/platform/prism-generations:
+    get:
+      description: |
+        Operators only (`ADMIN` or `ROOT`). Every Prism edition generation on
+        the platform across all organizations, newest first, one keyset page at
+        a time. Article text and candidate bodies are never exposed, only the
+        generation's state, size and ownership.
+      operationId: getPlatformPrismGenerations
+      parameters:
+        - $ref: "#/components/parameters/XCorrelationId"
+        - description: Only generations in this state.
+          example: CANDIDATE_READY
+          in: query
+          name: state
+          required: false
+          schema:
+            $ref: "#/components/schemas/PrismGenerationState"
+        - $ref: "#/components/parameters/Cursor"
+        - $ref: "#/components/parameters/Limit"
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                nominal:
+                  summary: Nominal successful response
+                  value:
+                    hasMore: false
+                    items:
+                      - createdAt: "2026-10-10T12:00:00.000Z"
+                        editionKind: QUICK_READ
+                        generationId: 018f0000-0000-7000-8000-000000000001
+                        organizationId: 018f0000-0000-7000-8000-000000000003
+                        publicationId: 018f0000-0000-7000-8000-000000000002
+                        state: CANDIDATE_READY
+                    nextCursor: null
+              schema:
+                $ref: "#/components/schemas/GetPlatformPrismGenerationsResponse"
+          description: list platform Prism generations succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+        "400":
+          $ref: "#/components/responses/ValidationFailed"
+        "401":
+          $ref: "#/components/responses/PlatformAuthenticationRequired"
+        "403":
+          $ref: "#/components/responses/AuthorizationDenied"
+      security:
+        - browserSession: []
+      summary: list platform Prism generations
+      tags:
+        - platform
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - NONE
+      x-gala-capability-key: platform.prism.view
+      x-gala-concurrency: none
+      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: list platform Prism generations
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - REAUTH_REQUIRED
+        - VALIDATION_FAILED
+      x-gala-replay-identity: safe-query
+      x-gala-state-guards:
+        - NONE
+      x-gala-success-category: query
+      x-gala-tenant-scope: NONE
+  /v2/platform/prism-generations:export:
+    post:
+      description: Operators only (`ADMIN` or `ROOT`), with recent authentication (`401 REAUTH_REQUIRED` when the session is stale). The answer is a UTF-8 CSV file with a header row (`generationId,organizationId,publicationId,editionKind,state,createdAt`) that the operator App saves as a download. A cell that starts with `=`, `+`, `-`, `@`, a tab or a carriage return is prefixed with an apostrophe so a spreadsheet does not run it as a formula.
+      operationId: postPlatformPrismGenerationsExport
+      parameters:
+        - $ref: "#/components/parameters/XCorrelationId"
+        - $ref: "#/components/parameters/XCsrfToken"
+      responses:
+        "200":
+          content:
+            text/csv:
+              schema:
+                format: binary
+                type: string
+          description: export platform Prism generations as CSV succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            Content-Disposition:
+              $ref: "#/components/headers/ContentDispositionAttachment"
+            X-Content-Type-Options:
+              $ref: "#/components/headers/XContentTypeOptionsNosniff"
+            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
+                REAUTH_REQUIRED:
+                  summary: REAUTH_REQUIRED
+                  value:
+                    code: REAUTH_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: REAUTH_REQUIRED
+                    type: urn:gala:problem:reauth-required
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHENTICATION_REQUIRED, REAUTH_REQUIRED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHENTICATION_REQUIRED
+            - REAUTH_REQUIRED
+        "403":
+          $ref: "#/components/responses/AuthorizationDenied"
+      security:
+        - browserSession: []
+      summary: export platform Prism generations as CSV
+      tags:
+        - platform
+      x-gala-action-grant: none
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - NONE
+      x-gala-assurance-class: RECENT_AUTHENTICATION
+      x-gala-capability-key: platform.prism.export
+      x-gala-concurrency: none
+      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: export platform Prism generations as CSV
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - REAUTH_REQUIRED
+        - VALIDATION_FAILED
+      x-gala-replay-identity: natural-idempotent-state
+      x-gala-state-guards:
+        - NONE
+      x-gala-success-category: protocol
+      x-gala-tenant-scope: NONE
   /v2/platform/settings/overrides/{kind}/{id}/{key}:
     delete:
       description: |