@rathnasgala2/schemas 3.33.0 → 3.34.0

package/openapi/openapi.yaml

@@ -4302,6 +4302,57 @@ components:
         - openChange
         - setUp
       type: object
+    GetOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewPolicyResponse:
+      allOf:
+        - $ref: "#/components/schemas/InterviewPolicy"
+    GetOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewProfileResponse:
+      allOf:
+        - $ref: "#/components/schemas/InterviewProfile"
+    GetOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdResponse:
+      allOf:
+        - $ref: "#/components/schemas/Interview"
+    GetOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsResponse:
+      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/InterviewListItem"
+          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. The length bounds constrain the string branch only.
+          maxLength: 2048
+          minLength: 1
+          type:
+            - string
+            - "null"
+      required:
+        - items
+        - hasMore
+      type: object
     GetOrganizationsByOrganizationIdPublicationsByPublicationIdListenSettingsResponse:
       $ref: "#/components/schemas/ListenSettings"
     GetOrganizationsByOrganizationIdPublicationsByPublicationIdModerationQueueResponse:
@@ -5134,6 +5185,9 @@ components:
         - installation
         - problems
       type: object
+    GetPlatformInterviewUsageResponse:
+      allOf:
+        - $ref: "#/components/schemas/PlatformInterviewUsage"
     GetPlatformOauthClientsResponse:
       additionalProperties: false
       properties:
@@ -6434,6 +6488,495 @@ components:
         - consequences
         - consequenceDigest
       type: object
+    Interview:
+      additionalProperties: false
+      description: "SCHEMA-3.34.0. One Interview: an AI interviewer asks the author about captured material and writes a draft in their words. `turns` is the conversation; `draft` and `review` are present from `DRAFT_READY`; `failure` once `FAILED`."
+      properties:
+        capture:
+          $ref: "#/components/schemas/InterviewCapture"
+        createdAt:
+          $ref: "#/components/schemas/PortableProblemRfc3339"
+        draft:
+          $ref: "#/components/schemas/InterviewDraft"
+        expiresAt:
+          $ref: "#/components/schemas/PortableProblemRfc3339"
+        failure:
+          $ref: "#/components/schemas/InterviewFailure"
+        finishedAt:
+          $ref: "#/components/schemas/PortableProblemRfc3339"
+        interviewId:
+          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
+        progress:
+          $ref: "#/components/schemas/InterviewProgress"
+        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
+        review:
+          $ref: "#/components/schemas/InterviewReview"
+        startedAt:
+          $ref: "#/components/schemas/PortableProblemRfc3339"
+        state:
+          $ref: "#/components/schemas/InterviewState"
+        turns:
+          items:
+            $ref: "#/components/schemas/InterviewTurn"
+          maxItems: 400
+          type: array
+        updatedAt:
+          $ref: "#/components/schemas/PortableProblemRfc3339"
+      required:
+        - interviewId
+        - organizationId
+        - publicationId
+        - state
+        - capture
+        - progress
+        - createdAt
+        - updatedAt
+        - expiresAt
+        - turns
+      type: object
+    InterviewAnswer:
+      additionalProperties: false
+      description: SCHEMA-3.34.0. The author's answer to the last question.
+      properties:
+        text:
+          maxLength: 8000
+          minLength: 1
+          type: string
+      required:
+        - text
+      type: object
+    InterviewCapture:
+      additionalProperties: false
+      description: SCHEMA-3.34.0. The material an interview starts from.
+      properties:
+        kind:
+          $ref: "#/components/schemas/InterviewCaptureKind"
+        sourceTitle:
+          maxLength: 300
+          minLength: 1
+          type: string
+        sourceUrl:
+          format: uri
+          maxLength: 2048
+          minLength: 1
+          type: string
+        text:
+          description: The note or the transcript.
+          maxLength: 20000
+          minLength: 1
+          type: string
+      required:
+        - kind
+        - text
+      type: object
+    InterviewCaptureKind:
+      description: "How the material was captured: a typed `NOTE`, a `VOICE` transcript or a `LINK` with its text."
+      enum:
+        - NOTE
+        - VOICE
+        - LINK
+      type: string
+    InterviewCreate:
+      additionalProperties: false
+      properties:
+        capture:
+          $ref: "#/components/schemas/InterviewCapture"
+      required:
+        - capture
+      type: object
+    InterviewDraft:
+      additionalProperties: false
+      description: SCHEMA-3.34.0. The post the interview produced; nothing is published until the author accepts and saves it.
+      properties:
+        body:
+          description: Markdown.
+          maxLength: 262144
+          minLength: 1
+          type: string
+        description:
+          maxLength: 160
+          minLength: 1
+          type: string
+        language:
+          maxLength: 35
+          minLength: 2
+          pattern: ^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{1,8})*$
+          type: string
+        title:
+          maxLength: 300
+          minLength: 1
+          type: string
+        tldr:
+          maxLength: 2000
+          minLength: 1
+          type: string
+      required:
+        - title
+        - description
+        - tldr
+        - body
+        - language
+      type: object
+    InterviewFailure:
+      additionalProperties: false
+      properties:
+        code:
+          enum:
+            - PROVIDER_UNAVAILABLE
+            - PROVIDER_REFUSED
+            - MALFORMED_ANSWER
+            - BUDGET_EXHAUSTED
+            - EXPIRED
+          type: string
+        message:
+          maxLength: 500
+          minLength: 1
+          type: string
+      required:
+        - code
+      type: object
+    InterviewListItem:
+      additionalProperties: false
+      description: "SCHEMA-3.34.0. An Interview as the list shows it: no turns, draft or review, with `turnCount` and `hasDraft` instead."
+      properties:
+        capture:
+          $ref: "#/components/schemas/InterviewCapture"
+        createdAt:
+          $ref: "#/components/schemas/PortableProblemRfc3339"
+        expiresAt:
+          $ref: "#/components/schemas/PortableProblemRfc3339"
+        failure:
+          $ref: "#/components/schemas/InterviewFailure"
+        finishedAt:
+          $ref: "#/components/schemas/PortableProblemRfc3339"
+        hasDraft:
+          type: boolean
+        interviewId:
+          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
+        progress:
+          $ref: "#/components/schemas/InterviewProgress"
+        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
+        startedAt:
+          $ref: "#/components/schemas/PortableProblemRfc3339"
+        state:
+          $ref: "#/components/schemas/InterviewState"
+        turnCount:
+          format: int64
+          minimum: 0
+          type: integer
+        updatedAt:
+          $ref: "#/components/schemas/PortableProblemRfc3339"
+      required:
+        - interviewId
+        - organizationId
+        - publicationId
+        - state
+        - capture
+        - progress
+        - createdAt
+        - updatedAt
+        - expiresAt
+        - turnCount
+        - hasDraft
+      type: object
+    InterviewPhase:
+      description: "Where the interview is: asking for the author's own details (`OWNED`), pushing for a view (`INSIGHTFUL`), or finished asking (`DONE`)."
+      enum:
+        - OWNED
+        - INSIGHTFUL
+        - DONE
+      type: string
+    InterviewPolicy:
+      additionalProperties: false
+      description: "SCHEMA-3.34.0. Whether Interview is available to this publication and how many interviews are left this period (UTC month). `enabled: false` means the feature is off; the editor says so and stays usable."
+      properties:
+        budget:
+          additionalProperties: false
+          description: "`available` is false when the platform's monthly spend cap is reached."
+          properties:
+            available:
+              type: boolean
+          required:
+            - available
+          type: object
+        enabled:
+          description: False when the platform switch is off or the provider is not configured.
+          type: boolean
+        plan:
+          additionalProperties: false
+          properties:
+            allowed:
+              type: boolean
+            requiredTier:
+              description: "The API tier the feature needs: `BUSINESS`, sold as Pro."
+              enum:
+                - FREE
+                - PRO
+                - BUSINESS
+              type: string
+          required:
+            - allowed
+            - requiredTier
+          type: object
+        quota:
+          additionalProperties: false
+          properties:
+            limit:
+              format: int64
+              minimum: 0
+              type: integer
+            period:
+              description: The UTC month, `YYYY-MM`.
+              pattern: ^[0-9]{4}-(?:0[1-9]|1[0-2])$
+              type: string
+            remaining:
+              format: int64
+              minimum: 0
+              type: integer
+            used:
+              format: int64
+              minimum: 0
+              type: integer
+          required:
+            - period
+            - limit
+            - used
+            - remaining
+          type: object
+      required:
+        - enabled
+        - plan
+        - quota
+        - budget
+      type: object
+    InterviewProfile:
+      additionalProperties: false
+      description: SCHEMA-3.34.0. The two facts the interviewer keeps about the site between interviews.
+      properties:
+        niche:
+          description: What the site is about, in the author's words. May be empty.
+          maxLength: 200
+          minLength: 0
+          type: string
+        reader:
+          description: Who it is for. May be empty.
+          maxLength: 300
+          minLength: 0
+          type: string
+      required:
+        - niche
+        - reader
+      type: object
+    InterviewProgress:
+      additionalProperties: false
+      properties:
+        beliefDone:
+          type: boolean
+        canFinish:
+          description: True once at least three details are on record.
+          type: boolean
+        details:
+          format: int64
+          minimum: 0
+          type: integer
+        detailsTarget:
+          description: How many details the interviewer aims for (5).
+          format: int64
+          minimum: 0
+          type: integer
+        phase:
+          $ref: "#/components/schemas/InterviewPhase"
+        skepticRounds:
+          format: int64
+          minimum: 0
+          type: integer
+      required:
+        - phase
+        - details
+        - detailsTarget
+        - beliefDone
+        - skepticRounds
+        - canFinish
+      type: object
+    InterviewReview:
+      additionalProperties: false
+      description: "SCHEMA-3.34.0. What the draft was checked against: each claim is `VERIFIED` against a source, `UNVERIFIED`, or in `CONFLICT` with the author's earlier posts, plus a three-sentence read-back and any passages flagged as unclear."
+      properties:
+        claims:
+          items:
+            additionalProperties: false
+            properties:
+              source:
+                additionalProperties: false
+                properties:
+                  contentPath:
+                    maxLength: 512
+                    minLength: 1
+                    pattern: ^(?!/)(?!.*(?:^|/)\.)(?!gala(?:/|$))(?!gala\.lock\.json$)[^\x00-\x1f\x7f\\]+$
+                    type: string
+                  note:
+                    maxLength: 500
+                    minLength: 1
+                    type: string
+                  url:
+                    format: uri
+                    maxLength: 2048
+                    minLength: 1
+                    type: string
+                required: []
+                type: object
+              status:
+                enum:
+                  - VERIFIED
+                  - UNVERIFIED
+                  - CONFLICT
+                type: string
+              text:
+                maxLength: 1000
+                minLength: 1
+                type: string
+            required:
+              - text
+              - status
+            type: object
+          maxItems: 100
+          type: array
+        clear:
+          additionalProperties: false
+          properties:
+            flagged:
+              items:
+                additionalProperties: false
+                properties:
+                  quote:
+                    maxLength: 500
+                    minLength: 1
+                    type: string
+                  why:
+                    maxLength: 500
+                    minLength: 1
+                    type: string
+                required:
+                  - quote
+                  - why
+                type: object
+              maxItems: 50
+              type: array
+            threeSentences:
+              items:
+                maxLength: 500
+                minLength: 1
+                type: string
+              maxItems: 3
+              minItems: 3
+              type: array
+          required:
+            - threeSentences
+            - flagged
+          type: object
+        pastPostsRead:
+          description: Content paths of the author's earlier posts the interviewer read.
+          items:
+            maxLength: 512
+            minLength: 1
+            pattern: ^(?!/)(?!.*(?:^|/)\.)(?!gala(?:/|$))(?!gala\.lock\.json$)[^\x00-\x1f\x7f\\]+$
+            type: string
+          maxItems: 50
+          type: array
+        sources:
+          items:
+            additionalProperties: false
+            properties:
+              title:
+                maxLength: 300
+                minLength: 1
+                type: string
+              url:
+                format: uri
+                maxLength: 2048
+                minLength: 1
+                type: string
+            required:
+              - url
+              - title
+            type: object
+          maxItems: 50
+          type: array
+      required:
+        - claims
+        - clear
+        - sources
+        - pastPostsRead
+      type: object
+    InterviewState:
+      description: SCHEMA-3.34.0. `CAPTURED` (the material is saved, no question asked yet) -> `INTERVIEWING` (a quota unit is reserved) -> `WRITING` -> `DRAFT_READY` -> `ACCEPTED`; `CANCELLED` from any state before `ACCEPTED`; `FAILED` and `EXPIRED` are terminal.
+      enum:
+        - CAPTURED
+        - INTERVIEWING
+        - WRITING
+        - DRAFT_READY
+        - ACCEPTED
+        - CANCELLED
+        - FAILED
+        - EXPIRED
+      type: string
+    InterviewTurn:
+      additionalProperties: false
+      properties:
+        at:
+          $ref: "#/components/schemas/PortableProblemRfc3339"
+        kind:
+          $ref: "#/components/schemas/InterviewTurnKind"
+        role:
+          $ref: "#/components/schemas/InterviewTurnRole"
+        seq:
+          format: int64
+          minimum: 0
+          type: integer
+        text:
+          maxLength: 20000
+          minLength: 1
+          type: string
+      required:
+        - seq
+        - role
+        - kind
+        - text
+        - at
+      type: object
+    InterviewTurnKind:
+      description: "What the turn is: an interviewer `QUESTION`, `RECAP`, `SKEPTIC` challenge or `CLOSING`, or the author's `ANSWER`."
+      enum:
+        - QUESTION
+        - RECAP
+        - SKEPTIC
+        - CLOSING
+        - ANSWER
+      type: string
+    InterviewTurnRole:
+      description: Who spoke.
+      enum:
+        - INTERVIEWER
+        - AUTHOR
+      type: string
     KernelAttemptSubmission:
       additionalProperties: false
       allOf:
@@ -9395,6 +9938,40 @@ components:
         - source
         - description
       type: object
+    PlatformInterviewUsage:
+      additionalProperties: false
+      description: SCHEMA-3.34.0. Interview volume and spend for the current UTC month, platform-wide. Counts and money only, never interview text.
+      properties:
+        cap:
+          additionalProperties: false
+          description: The monthly spend cap.
+          properties:
+            usdMicros:
+              format: int64
+              minimum: 0
+              type: integer
+          required:
+            - usdMicros
+          type: object
+        interviews:
+          format: int64
+          minimum: 0
+          type: integer
+        period:
+          description: The current UTC month, `YYYY-MM`.
+          pattern: ^[0-9]{4}-(?:0[1-9]|1[0-2])$
+          type: string
+        usdMicros:
+          description: Spend so far this month, in millionths of a US dollar.
+          format: int64
+          minimum: 0
+          type: integer
+      required:
+        - period
+        - interviews
+        - usdMicros
+        - cap
+      type: object
     PlatformOauthClient:
       additionalProperties: false
       properties:
@@ -17993,6 +18570,43 @@ components:
       type: object
     PostOrganizationsByOrganizationIdPublicationsByPublicationIdHandoverResponse:
       $ref: "#/components/schemas/GetOrganizationsByOrganizationIdPublicationsByPublicationIdHandoverResponse"
+    PostOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdAcceptResponse:
+      allOf:
+        - $ref: "#/components/schemas/Interview"
+    PostOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdCancelResponse:
+      allOf:
+        - $ref: "#/components/schemas/Interview"
+    PostOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdFinishResponse:
+      allOf:
+        - $ref: "#/components/schemas/Interview"
+    PostOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdStartResponse:
+      allOf:
+        - $ref: "#/components/schemas/Interview"
+    PostOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdTurnsRequest:
+      additionalProperties: false
+      description: SCHEMA-3.34.0. The author's answer to the last question.
+      properties:
+        text:
+          maxLength: 8000
+          minLength: 1
+          type: string
+      required:
+        - text
+      type: object
+    PostOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdTurnsResponse:
+      allOf:
+        - $ref: "#/components/schemas/Interview"
+    PostOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsRequest:
+      additionalProperties: false
+      properties:
+        capture:
+          $ref: "#/components/schemas/InterviewCapture"
+      required:
+        - capture
+      type: object
+    PostOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsResponse:
+      allOf:
+        - $ref: "#/components/schemas/Interview"
     PostOrganizationsByOrganizationIdPublicationsByPublicationIdModerationCommentsByCommentIdDecideRequest:
       additionalProperties: false
       properties:
@@ -21136,6 +21750,27 @@ components:
       required:
         - change
       type: object
+    PutOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewProfileRequest:
+      additionalProperties: false
+      description: SCHEMA-3.34.0. The two facts the interviewer keeps about the site between interviews.
+      properties:
+        niche:
+          description: What the site is about, in the author's words. May be empty.
+          maxLength: 200
+          minLength: 0
+          type: string
+        reader:
+          description: Who it is for. May be empty.
+          maxLength: 300
+          minLength: 0
+          type: string
+      required:
+        - niche
+        - reader
+      type: object
+    PutOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewProfileResponse:
+      allOf:
+        - $ref: "#/components/schemas/InterviewProfile"
     PutOrganizationsByOrganizationIdPublicationsByPublicationIdListenSettingsRequest:
       additionalProperties: false
       properties:
@@ -48866,39 +49501,2979 @@ paths:
               $ref: "#/components/headers/XCorrelationId"
           x-gala-problem-codes:
             - RESOURCE_NOT_FOUND
-        "429":
+        "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: []
+        - adminApiKey: []
+      summary: read this publication's reader interaction 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-api-key-scope: read
+      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 reader interaction 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 `gala/modules/interactions.json` as a repository change, the way a theme selection writes `gala/appearance.json`. Publishing the change uses the normal publish flow. `change` has the shape the theme-selection write returns. `settings.follows.enabled` (SCHEMA-3.23.0) turns the Follow button on; absent means off.
+      operationId: putOrganizationsByOrganizationIdPublicationsByPublicationIdInteractionSettings
+      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:
+                  settings:
+                    comments:
+                      allowReplies: true
+                      enabled: true
+                      maxDepth: 3
+                    publicCounts:
+                      comments: true
+                      reactions: true
+                    reactions:
+                      definitions: []
+                      enabled: true
+                    schemaId: urn:gala:schema:interactions-config:2.0.0
+                    schemaVersion: 2.0.0
+            schema:
+              $ref: "#/components/schemas/PutOrganizationsByOrganizationIdPublicationsByPublicationIdInteractionSettingsRequest"
+        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/PutOrganizationsByOrganizationIdPublicationsByPublicationIdInteractionSettingsResponse"
+          description: save this publication's reader interaction settings as a repository change succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+        "400":
+          content:
+            application/problem+json:
+              examples:
+                REQUEST_FIELD_UNKNOWN:
+                  summary: REQUEST_FIELD_UNKNOWN
+                  value:
+                    code: REQUEST_FIELD_UNKNOWN
+                    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: 400
+                    title: REQUEST_FIELD_UNKNOWN
+                    type: urn:gala:problem:request-field-unknown
+                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: 400
+                    title: VALIDATION_FAILED
+                    type: urn:gala:problem:validation-failed
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: REQUEST_FIELD_UNKNOWN, VALIDATION_FAILED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - REQUEST_FIELD_UNKNOWN
+            - VALIDATION_FAILED
+        "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":
+          content:
+            application/problem+json:
+              examples:
+                AUTHORIZATION_DENIED:
+                  summary: AUTHORIZATION_DENIED
+                  value:
+                    code: AUTHORIZATION_DENIED
+                    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: 403
+                    title: AUTHORIZATION_DENIED
+                    type: urn:gala:problem:authorization-denied
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHORIZATION_DENIED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHORIZATION_DENIED
+        "404":
+          content:
+            application/problem+json:
+              examples:
+                RESOURCE_NOT_FOUND:
+                  summary: RESOURCE_NOT_FOUND
+                  value:
+                    code: RESOURCE_NOT_FOUND
+                    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: 404
+                    title: RESOURCE_NOT_FOUND
+                    type: urn:gala:problem:resource-not-found
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: RESOURCE_NOT_FOUND
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - RESOURCE_NOT_FOUND
+        "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
+                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, 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
+            - 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: []
+        - adminApiKey: []
+      summary: save this publication's reader interaction 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-api-key-scope: content:write
+      x-gala-capability-key: publication.source.write
+      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 reader interaction settings as a repository change
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - CAPABILITY_UNAVAILABLE
+        - COMMAND_REPLAY_CONFLICT
+        - INVALID_SOURCE_STATE
+        - 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}/interview-policy:
+    get:
+      description: |
+        Whether Interview is available to this publication (`enabled`), whether the plan includes it (`plan.allowed`, `BUSINESS` tier, sold as Pro), how many interviews are left this period (UTC month) and whether the platform's monthly spend cap still has room. `enabled: false` means the feature is off; the editor says so and stays usable.
+      operationId: getOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewPolicy
+      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:
+                    budget:
+                      available: true
+                    enabled: true
+                    plan:
+                      allowed: true
+                      requiredTier: BUSINESS
+                    quota:
+                      limit: 10
+                      period: 2026-11
+                      remaining: 7
+                      used: 3
+              schema:
+                $ref: "#/components/schemas/GetOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewPolicyResponse"
+          description: read the Interview policy succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+        "400":
+          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: 400
+                    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
+        "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":
+          content:
+            application/problem+json:
+              examples:
+                AUTHORIZATION_DENIED:
+                  summary: AUTHORIZATION_DENIED
+                  value:
+                    code: AUTHORIZATION_DENIED
+                    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: 403
+                    title: AUTHORIZATION_DENIED
+                    type: urn:gala:problem:authorization-denied
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHORIZATION_DENIED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHORIZATION_DENIED
+        "404":
+          content:
+            application/problem+json:
+              examples:
+                RESOURCE_NOT_FOUND:
+                  summary: RESOURCE_NOT_FOUND
+                  value:
+                    code: RESOURCE_NOT_FOUND
+                    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: 404
+                    title: RESOURCE_NOT_FOUND
+                    type: urn:gala:problem:resource-not-found
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: RESOURCE_NOT_FOUND
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - RESOURCE_NOT_FOUND
+      security:
+        - browserSession: []
+      summary: read the Interview policy
+      tags:
+        - interview
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - NONE
+      x-gala-capability-key: publication.source.write
+      x-gala-concurrency: authorization-and-publication-epochs
+      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 the Interview policy
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - 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
+  /v2/organizations/{organizationId}/publications/{publicationId}/interview-profile:
+    get:
+      description: |
+        The two facts the interviewer keeps about this site between interviews: its niche and its reader. Either may be an empty string.
+      operationId: getOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewProfile
+      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:
+                    niche: Product-led growth for small SaaS teams
+                    reader: Founders running their first onboarding
+              schema:
+                $ref: "#/components/schemas/GetOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewProfileResponse"
+          description: read the Interview profile succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+        "400":
+          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: 400
+                    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
+        "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":
+          content:
+            application/problem+json:
+              examples:
+                AUTHORIZATION_DENIED:
+                  summary: AUTHORIZATION_DENIED
+                  value:
+                    code: AUTHORIZATION_DENIED
+                    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: 403
+                    title: AUTHORIZATION_DENIED
+                    type: urn:gala:problem:authorization-denied
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHORIZATION_DENIED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHORIZATION_DENIED
+        "404":
+          content:
+            application/problem+json:
+              examples:
+                RESOURCE_NOT_FOUND:
+                  summary: RESOURCE_NOT_FOUND
+                  value:
+                    code: RESOURCE_NOT_FOUND
+                    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: 404
+                    title: RESOURCE_NOT_FOUND
+                    type: urn:gala:problem:resource-not-found
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: RESOURCE_NOT_FOUND
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - RESOURCE_NOT_FOUND
+      security:
+        - browserSession: []
+      summary: read the Interview profile
+      tags:
+        - interview
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - NONE
+      x-gala-capability-key: publication.source.write
+      x-gala-concurrency: authorization-and-publication-epochs
+      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 the Interview profile
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - 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: |
+        Replaces the niche and reader the interviewer keeps for this site; the values live in the platform database, not in the repository, so no publish is involved. Empty strings clear them. Authorized by `publication.settings.manage`.
+      operationId: putOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewProfile
+      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:
+                  niche: Product-led growth for small SaaS teams
+                  reader: Founders running their first onboarding
+            schema:
+              $ref: "#/components/schemas/PutOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewProfileRequest"
+        required: true
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                nominal:
+                  summary: Nominal successful response
+                  value:
+                    niche: Product-led growth for small SaaS teams
+                    reader: Founders running their first onboarding
+              schema:
+                $ref: "#/components/schemas/PutOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewProfileResponse"
+          description: save the Interview profile succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+        "400":
+          content:
+            application/problem+json:
+              examples:
+                REQUEST_FIELD_UNKNOWN:
+                  summary: REQUEST_FIELD_UNKNOWN
+                  value:
+                    code: REQUEST_FIELD_UNKNOWN
+                    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: 400
+                    title: REQUEST_FIELD_UNKNOWN
+                    type: urn:gala:problem:request-field-unknown
+                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: 400
+                    title: VALIDATION_FAILED
+                    type: urn:gala:problem:validation-failed
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: REQUEST_FIELD_UNKNOWN, VALIDATION_FAILED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - REQUEST_FIELD_UNKNOWN
+            - VALIDATION_FAILED
+        "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":
+          content:
+            application/problem+json:
+              examples:
+                AUTHORIZATION_DENIED:
+                  summary: AUTHORIZATION_DENIED
+                  value:
+                    code: AUTHORIZATION_DENIED
+                    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: 403
+                    title: AUTHORIZATION_DENIED
+                    type: urn:gala:problem:authorization-denied
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHORIZATION_DENIED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHORIZATION_DENIED
+        "404":
+          content:
+            application/problem+json:
+              examples:
+                RESOURCE_NOT_FOUND:
+                  summary: RESOURCE_NOT_FOUND
+                  value:
+                    code: RESOURCE_NOT_FOUND
+                    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: 404
+                    title: RESOURCE_NOT_FOUND
+                    type: urn:gala:problem:resource-not-found
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: RESOURCE_NOT_FOUND
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - RESOURCE_NOT_FOUND
+        "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
+                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, TRANSFER_PENDING
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - COMMAND_REPLAY_CONFLICT
+            - TRANSFER_PENDING
+      security:
+        - browserSession: []
+      summary: save the Interview profile
+      tags:
+        - interview
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - NONE
+      x-gala-capability-key: publication.settings.manage
+      x-gala-concurrency: interview-version
+      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 the Interview profile
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - COMMAND_REPLAY_CONFLICT
+        - REQUEST_FIELD_UNKNOWN
+        - RESOURCE_NOT_FOUND
+        - TRANSFER_PENDING
+        - VALIDATION_FAILED
+      x-gala-replay-identity: idempotency-key
+      x-gala-state-guards:
+        - NONE
+      x-gala-success-category: protocol
+      x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
+  /v2/organizations/{organizationId}/publications/{publicationId}/interviews:
+    get:
+      description: |
+        This publication's interviews, newest first, one cursor page at a time. Items carry `turnCount` and `hasDraft` instead of the conversation, draft and review; read one interview for those.
+      operationId: getOrganizationsByOrganizationIdPublicationsByPublicationIdInterviews
+      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/Cursor"
+        - $ref: "#/components/parameters/Limit"
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                nominal:
+                  summary: Nominal successful response
+                  value:
+                    hasMore: false
+                    items:
+                      - capture:
+                          kind: NOTE
+                          text: We cut our onboarding from nine steps to four and signups doubled.
+                        createdAt: "2026-11-04T12:00:00.000Z"
+                        expiresAt: "2026-11-11T12:00:00.000Z"
+                        hasDraft: false
+                        interviewId: 018f0000-0000-7000-8000-000000000001
+                        organizationId: 018f0000-0000-7000-8000-000000000003
+                        progress:
+                          beliefDone: false
+                          canFinish: false
+                          details: 0
+                          detailsTarget: 5
+                          phase: OWNED
+                          skepticRounds: 0
+                        publicationId: 018f0000-0000-7000-8000-000000000002
+                        state: CAPTURED
+                        turnCount: 0
+                        updatedAt: "2026-11-04T12:00:00.000Z"
+              schema:
+                $ref: "#/components/schemas/GetOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsResponse"
+          description: list Interviews succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+        "400":
+          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: 400
+                    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
+        "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":
+          content:
+            application/problem+json:
+              examples:
+                AUTHORIZATION_DENIED:
+                  summary: AUTHORIZATION_DENIED
+                  value:
+                    code: AUTHORIZATION_DENIED
+                    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: 403
+                    title: AUTHORIZATION_DENIED
+                    type: urn:gala:problem:authorization-denied
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHORIZATION_DENIED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHORIZATION_DENIED
+        "404":
+          content:
+            application/problem+json:
+              examples:
+                RESOURCE_NOT_FOUND:
+                  summary: RESOURCE_NOT_FOUND
+                  value:
+                    code: RESOURCE_NOT_FOUND
+                    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: 404
+                    title: RESOURCE_NOT_FOUND
+                    type: urn:gala:problem:resource-not-found
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: RESOURCE_NOT_FOUND
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - RESOURCE_NOT_FOUND
+      security:
+        - browserSession: []
+      summary: list Interviews
+      tags:
+        - interview
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - NONE
+      x-gala-capability-key: publication.source.write
+      x-gala-concurrency: authorization-and-publication-epochs
+      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 Interviews
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - 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
+    post:
+      description: |
+        Saves the material (a note, a voice transcript or a link with its text) as an interview in `CAPTURED`. Nothing is asked and no quota unit is used yet; `POST .../interviews/{interviewId}:start` begins the conversation. `409 PLAN_REQUIRED` when the plan is below `BUSINESS`; `503 CAPABILITY_UNAVAILABLE` when Interview is off. `201`.
+      operationId: postOrganizationsByOrganizationIdPublicationsByPublicationIdInterviews
+      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:
+                  capture:
+                    kind: NOTE
+                    text: We cut our onboarding from nine steps to four and signups doubled.
+            schema:
+              $ref: "#/components/schemas/PostOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsRequest"
+        required: true
+      responses:
+        "201":
+          content:
+            application/json:
+              examples:
+                nominal:
+                  summary: Nominal successful response
+                  value:
+                    capture:
+                      kind: NOTE
+                      text: We cut our onboarding from nine steps to four and signups doubled.
+                    createdAt: "2026-11-04T12:00:00.000Z"
+                    expiresAt: "2026-11-11T12:00:00.000Z"
+                    interviewId: 018f0000-0000-7000-8000-000000000001
+                    organizationId: 018f0000-0000-7000-8000-000000000003
+                    progress:
+                      beliefDone: false
+                      canFinish: false
+                      details: 0
+                      detailsTarget: 5
+                      phase: OWNED
+                      skepticRounds: 0
+                    publicationId: 018f0000-0000-7000-8000-000000000002
+                    state: CAPTURED
+                    turns: []
+                    updatedAt: "2026-11-04T12:00:00.000Z"
+              schema:
+                $ref: "#/components/schemas/PostOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsResponse"
+          description: capture material for an Interview succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            Location:
+              $ref: "#/components/headers/Location"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+        "400":
+          content:
+            application/problem+json:
+              examples:
+                REQUEST_FIELD_UNKNOWN:
+                  summary: REQUEST_FIELD_UNKNOWN
+                  value:
+                    code: REQUEST_FIELD_UNKNOWN
+                    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: 400
+                    title: REQUEST_FIELD_UNKNOWN
+                    type: urn:gala:problem:request-field-unknown
+                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: 400
+                    title: VALIDATION_FAILED
+                    type: urn:gala:problem:validation-failed
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: REQUEST_FIELD_UNKNOWN, VALIDATION_FAILED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - REQUEST_FIELD_UNKNOWN
+            - VALIDATION_FAILED
+        "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":
+          content:
+            application/problem+json:
+              examples:
+                AUTHORIZATION_DENIED:
+                  summary: AUTHORIZATION_DENIED
+                  value:
+                    code: AUTHORIZATION_DENIED
+                    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: 403
+                    title: AUTHORIZATION_DENIED
+                    type: urn:gala:problem:authorization-denied
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHORIZATION_DENIED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHORIZATION_DENIED
+        "404":
+          content:
+            application/problem+json:
+              examples:
+                RESOURCE_NOT_FOUND:
+                  summary: RESOURCE_NOT_FOUND
+                  value:
+                    code: RESOURCE_NOT_FOUND
+                    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: 404
+                    title: RESOURCE_NOT_FOUND
+                    type: urn:gala:problem:resource-not-found
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: RESOURCE_NOT_FOUND
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - RESOURCE_NOT_FOUND
+        "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
+                PLAN_REQUIRED:
+                  summary: PLAN_REQUIRED
+                  value:
+                    code: PLAN_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: 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, 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
+            - PLAN_REQUIRED
+            - TRANSFER_PENDING
+        "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: capture material for an Interview
+      tags:
+        - interview
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - Interview enabled for this deployment and publication
+      x-gala-capability-key: publication.source.write
+      x-gala-concurrency: interview-version
+      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: capture material for an Interview
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - CAPABILITY_UNAVAILABLE
+        - COMMAND_REPLAY_CONFLICT
+        - PLAN_REQUIRED
+        - REQUEST_FIELD_UNKNOWN
+        - RESOURCE_NOT_FOUND
+        - TRANSFER_PENDING
+        - VALIDATION_FAILED
+      x-gala-replay-identity: idempotency-key
+      x-gala-state-guards:
+        - NONE
+      x-gala-success-category: create
+      x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
+  /v2/organizations/{organizationId}/publications/{publicationId}/interviews/{interviewId}:
+    get:
+      description: |
+        One interview with its conversation (`turns`), and from `DRAFT_READY` its `draft` and `review`. Poll it while `state` is `WRITING`.
+      operationId: getOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewId
+      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
+        - example: 018f0000-0000-7000-8000-000000000001
+          in: path
+          name: interviewId
+          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:
+                    capture:
+                      kind: NOTE
+                      text: We cut our onboarding from nine steps to four and signups doubled.
+                    createdAt: "2026-11-04T12:00:00.000Z"
+                    draft:
+                      body: |-
+                        We cut onboarding from nine steps to four.
+
+                        The first step to go was the account type.
+                      description: How cutting onboarding steps doubled signups.
+                      language: en
+                      title: Nine steps to four
+                      tldr: Fewer steps, twice the signups.
+                    expiresAt: "2026-11-11T12:00:00.000Z"
+                    finishedAt: "2026-11-04T12:00:00.000Z"
+                    interviewId: 018f0000-0000-7000-8000-000000000001
+                    organizationId: 018f0000-0000-7000-8000-000000000003
+                    progress:
+                      beliefDone: false
+                      canFinish: true
+                      details: 3
+                      detailsTarget: 5
+                      phase: DONE
+                      skepticRounds: 0
+                    publicationId: 018f0000-0000-7000-8000-000000000002
+                    review:
+                      claims:
+                        - source:
+                            note: From the author's note.
+                          status: VERIFIED
+                          text: Signups doubled.
+                      clear:
+                        flagged: []
+                        threeSentences:
+                          - Onboarding was nine steps.
+                          - You cut it to four.
+                          - Signups doubled.
+                      pastPostsRead:
+                        - content/my-post.md
+                      sources: []
+                    startedAt: "2026-11-04T12:00:00.000Z"
+                    state: DRAFT_READY
+                    turns:
+                      - at: "2026-11-04T12:00:00.000Z"
+                        kind: QUESTION
+                        role: INTERVIEWER
+                        seq: 1
+                        text: What did you cut first, and what did you expect to happen?
+                      - at: "2026-11-04T12:00:00.000Z"
+                        kind: ANSWER
+                        role: AUTHOR
+                        seq: 2
+                        text: The account-type step. I expected no one to notice.
+                    updatedAt: "2026-11-04T12:00:00.000Z"
+              schema:
+                $ref: "#/components/schemas/GetOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdResponse"
+          description: read an Interview succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+        "400":
+          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: 400
+                    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
+        "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":
+          content:
+            application/problem+json:
+              examples:
+                AUTHORIZATION_DENIED:
+                  summary: AUTHORIZATION_DENIED
+                  value:
+                    code: AUTHORIZATION_DENIED
+                    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: 403
+                    title: AUTHORIZATION_DENIED
+                    type: urn:gala:problem:authorization-denied
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHORIZATION_DENIED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHORIZATION_DENIED
+        "404":
+          content:
+            application/problem+json:
+              examples:
+                RESOURCE_NOT_FOUND:
+                  summary: RESOURCE_NOT_FOUND
+                  value:
+                    code: RESOURCE_NOT_FOUND
+                    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: 404
+                    title: RESOURCE_NOT_FOUND
+                    type: urn:gala:problem:resource-not-found
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: RESOURCE_NOT_FOUND
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - RESOURCE_NOT_FOUND
+      security:
+        - browserSession: []
+      summary: read an Interview
+      tags:
+        - interview
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - NONE
+      x-gala-capability-key: publication.source.write
+      x-gala-concurrency: interview-version
+      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 an Interview
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - 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
+  /v2/organizations/{organizationId}/publications/{publicationId}/interviews/{interviewId}/turns:
+    post:
+      description: |
+        Adds the author's answer and the interviewer's reply (a question, a recap, a challenge or the closing) to the conversation and returns the interview. Only while `INTERVIEWING`. `503 PROVIDER_UNAVAILABLE` when the reply could not be produced: nothing is stored, so the same answer can be sent again.
+      operationId: postOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdTurns
+      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
+        - example: 018f0000-0000-7000-8000-000000000001
+          in: path
+          name: interviewId
+          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:
+                  text: The account-type step. I expected no one to notice.
+            schema:
+              $ref: "#/components/schemas/PostOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdTurnsRequest"
+        required: true
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                nominal:
+                  summary: Nominal successful response
+                  value:
+                    capture:
+                      kind: NOTE
+                      text: We cut our onboarding from nine steps to four and signups doubled.
+                    createdAt: "2026-11-04T12:00:00.000Z"
+                    expiresAt: "2026-11-11T12:00:00.000Z"
+                    interviewId: 018f0000-0000-7000-8000-000000000001
+                    organizationId: 018f0000-0000-7000-8000-000000000003
+                    progress:
+                      beliefDone: false
+                      canFinish: false
+                      details: 1
+                      detailsTarget: 5
+                      phase: OWNED
+                      skepticRounds: 0
+                    publicationId: 018f0000-0000-7000-8000-000000000002
+                    startedAt: "2026-11-04T12:00:00.000Z"
+                    state: INTERVIEWING
+                    turns:
+                      - at: "2026-11-04T12:00:00.000Z"
+                        kind: QUESTION
+                        role: INTERVIEWER
+                        seq: 1
+                        text: What did you cut first, and what did you expect to happen?
+                      - at: "2026-11-04T12:00:00.000Z"
+                        kind: ANSWER
+                        role: AUTHOR
+                        seq: 2
+                        text: The account-type step. I expected no one to notice.
+                      - at: "2026-11-04T12:00:00.000Z"
+                        kind: QUESTION
+                        role: INTERVIEWER
+                        seq: 3
+                        text: Who noticed first?
+                    updatedAt: "2026-11-04T12:00:00.000Z"
+              schema:
+                $ref: "#/components/schemas/PostOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdTurnsResponse"
+          description: answer the Interviewer succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+        "400":
+          content:
+            application/problem+json:
+              examples:
+                REQUEST_FIELD_UNKNOWN:
+                  summary: REQUEST_FIELD_UNKNOWN
+                  value:
+                    code: REQUEST_FIELD_UNKNOWN
+                    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: 400
+                    title: REQUEST_FIELD_UNKNOWN
+                    type: urn:gala:problem:request-field-unknown
+                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: 400
+                    title: VALIDATION_FAILED
+                    type: urn:gala:problem:validation-failed
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: REQUEST_FIELD_UNKNOWN, VALIDATION_FAILED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - REQUEST_FIELD_UNKNOWN
+            - VALIDATION_FAILED
+        "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":
+          content:
+            application/problem+json:
+              examples:
+                AUTHORIZATION_DENIED:
+                  summary: AUTHORIZATION_DENIED
+                  value:
+                    code: AUTHORIZATION_DENIED
+                    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: 403
+                    title: AUTHORIZATION_DENIED
+                    type: urn:gala:problem:authorization-denied
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHORIZATION_DENIED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHORIZATION_DENIED
+        "404":
+          content:
+            application/problem+json:
+              examples:
+                RESOURCE_NOT_FOUND:
+                  summary: RESOURCE_NOT_FOUND
+                  value:
+                    code: RESOURCE_NOT_FOUND
+                    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: 404
+                    title: RESOURCE_NOT_FOUND
+                    type: urn:gala:problem:resource-not-found
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: RESOURCE_NOT_FOUND
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - RESOURCE_NOT_FOUND
+        "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
+                INTERVIEW_STATE_CONFLICT:
+                  summary: INTERVIEW_STATE_CONFLICT
+                  value:
+                    code: INTERVIEW_STATE_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: INTERVIEW_STATE_CONFLICT
+                    type: urn:gala:problem:interview-state-conflict
+                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, INTERVIEW_STATE_CONFLICT, TRANSFER_PENDING
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - COMMAND_REPLAY_CONFLICT
+            - INTERVIEW_STATE_CONFLICT
+            - TRANSFER_PENDING
+        "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:
+                BUDGET_EXHAUSTED:
+                  summary: BUDGET_EXHAUSTED
+                  value:
+                    code: BUDGET_EXHAUSTED
+                    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: BUDGET_EXHAUSTED
+                    type: urn:gala:problem:budget-exhausted
+                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
+                PROVIDER_UNAVAILABLE:
+                  summary: PROVIDER_UNAVAILABLE
+                  value:
+                    code: PROVIDER_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: PROVIDER_UNAVAILABLE
+                    type: urn:gala:problem:provider-unavailable
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: BUDGET_EXHAUSTED, CAPABILITY_UNAVAILABLE, PROVIDER_UNAVAILABLE
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - BUDGET_EXHAUSTED
+            - CAPABILITY_UNAVAILABLE
+            - PROVIDER_UNAVAILABLE
+      security:
+        - browserSession: []
+      summary: answer the Interviewer
+      tags:
+        - interview
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - Interview enabled for this deployment and publication
+      x-gala-capability-key: publication.source.write
+      x-gala-concurrency: interview-version
+      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: answer the Interviewer
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - BUDGET_EXHAUSTED
+        - CAPABILITY_UNAVAILABLE
+        - COMMAND_REPLAY_CONFLICT
+        - INTERVIEW_STATE_CONFLICT
+        - PROVIDER_UNAVAILABLE
+        - RATE_LIMITED
+        - REQUEST_FIELD_UNKNOWN
+        - RESOURCE_NOT_FOUND
+        - TRANSFER_PENDING
+        - VALIDATION_FAILED
+      x-gala-replay-identity: idempotency-key
+      x-gala-state-guards:
+        - NONE
+      x-gala-success-category: protocol
+      x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
+  /v2/organizations/{organizationId}/publications/{publicationId}/interviews/{interviewId}:accept:
+    post:
+      description: |
+        Marks the draft as taken. Only from `DRAFT_READY`; `409 INTERVIEW_STATE_CONFLICT` otherwise. The post itself is written and saved through the content endpoints; accepting publishes nothing.
+      operationId: postOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdAccept
+      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
+        - example: 018f0000-0000-7000-8000-000000000001
+          in: path
+          name: interviewId
+          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"
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                nominal:
+                  summary: Nominal successful response
+                  value:
+                    capture:
+                      kind: NOTE
+                      text: We cut our onboarding from nine steps to four and signups doubled.
+                    createdAt: "2026-11-04T12:00:00.000Z"
+                    draft:
+                      body: |-
+                        We cut onboarding from nine steps to four.
+
+                        The first step to go was the account type.
+                      description: How cutting onboarding steps doubled signups.
+                      language: en
+                      title: Nine steps to four
+                      tldr: Fewer steps, twice the signups.
+                    expiresAt: "2026-11-11T12:00:00.000Z"
+                    finishedAt: "2026-11-04T12:00:00.000Z"
+                    interviewId: 018f0000-0000-7000-8000-000000000001
+                    organizationId: 018f0000-0000-7000-8000-000000000003
+                    progress:
+                      beliefDone: false
+                      canFinish: true
+                      details: 3
+                      detailsTarget: 5
+                      phase: DONE
+                      skepticRounds: 0
+                    publicationId: 018f0000-0000-7000-8000-000000000002
+                    review:
+                      claims:
+                        - source:
+                            note: From the author's note.
+                          status: VERIFIED
+                          text: Signups doubled.
+                      clear:
+                        flagged: []
+                        threeSentences:
+                          - Onboarding was nine steps.
+                          - You cut it to four.
+                          - Signups doubled.
+                      pastPostsRead:
+                        - content/my-post.md
+                      sources: []
+                    startedAt: "2026-11-04T12:00:00.000Z"
+                    state: ACCEPTED
+                    turns:
+                      - at: "2026-11-04T12:00:00.000Z"
+                        kind: QUESTION
+                        role: INTERVIEWER
+                        seq: 1
+                        text: What did you cut first, and what did you expect to happen?
+                      - at: "2026-11-04T12:00:00.000Z"
+                        kind: ANSWER
+                        role: AUTHOR
+                        seq: 2
+                        text: The account-type step. I expected no one to notice.
+                    updatedAt: "2026-11-04T12:00:00.000Z"
+              schema:
+                $ref: "#/components/schemas/PostOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdAcceptResponse"
+          description: accept an Interview draft succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+        "400":
+          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: 400
+                    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
+        "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":
+          content:
+            application/problem+json:
+              examples:
+                AUTHORIZATION_DENIED:
+                  summary: AUTHORIZATION_DENIED
+                  value:
+                    code: AUTHORIZATION_DENIED
+                    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: 403
+                    title: AUTHORIZATION_DENIED
+                    type: urn:gala:problem:authorization-denied
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHORIZATION_DENIED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHORIZATION_DENIED
+        "404":
+          content:
+            application/problem+json:
+              examples:
+                RESOURCE_NOT_FOUND:
+                  summary: RESOURCE_NOT_FOUND
+                  value:
+                    code: RESOURCE_NOT_FOUND
+                    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: 404
+                    title: RESOURCE_NOT_FOUND
+                    type: urn:gala:problem:resource-not-found
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: RESOURCE_NOT_FOUND
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - RESOURCE_NOT_FOUND
+        "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
+                INTERVIEW_STATE_CONFLICT:
+                  summary: INTERVIEW_STATE_CONFLICT
+                  value:
+                    code: INTERVIEW_STATE_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: INTERVIEW_STATE_CONFLICT
+                    type: urn:gala:problem:interview-state-conflict
+                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, INTERVIEW_STATE_CONFLICT, TRANSFER_PENDING
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - COMMAND_REPLAY_CONFLICT
+            - INTERVIEW_STATE_CONFLICT
+            - TRANSFER_PENDING
+      security:
+        - browserSession: []
+      summary: accept an Interview draft
+      tags:
+        - interview
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - NONE
+      x-gala-capability-key: publication.source.write
+      x-gala-concurrency: interview-version
+      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: accept an Interview draft
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - COMMAND_REPLAY_CONFLICT
+        - INTERVIEW_STATE_CONFLICT
+        - RESOURCE_NOT_FOUND
+        - TRANSFER_PENDING
+        - VALIDATION_FAILED
+      x-gala-replay-identity: idempotency-key
+      x-gala-state-guards:
+        - NONE
+      x-gala-success-category: protocol
+      x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
+  /v2/organizations/{organizationId}/publications/{publicationId}/interviews/{interviewId}:cancel:
+    post:
+      description: |
+        Stops an interview that has not been accepted. Allowed from `CAPTURED`, `INTERVIEWING`, `WRITING` and `DRAFT_READY`; `409 INTERVIEW_STATE_CONFLICT` otherwise. A quota unit already used is not returned.
+      operationId: postOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdCancel
+      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
+        - example: 018f0000-0000-7000-8000-000000000001
+          in: path
+          name: interviewId
+          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"
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                nominal:
+                  summary: Nominal successful response
+                  value:
+                    capture:
+                      kind: NOTE
+                      text: We cut our onboarding from nine steps to four and signups doubled.
+                    createdAt: "2026-11-04T12:00:00.000Z"
+                    expiresAt: "2026-11-11T12:00:00.000Z"
+                    interviewId: 018f0000-0000-7000-8000-000000000001
+                    organizationId: 018f0000-0000-7000-8000-000000000003
+                    progress:
+                      beliefDone: false
+                      canFinish: false
+                      details: 0
+                      detailsTarget: 5
+                      phase: OWNED
+                      skepticRounds: 0
+                    publicationId: 018f0000-0000-7000-8000-000000000002
+                    state: CANCELLED
+                    turns: []
+                    updatedAt: "2026-11-04T12:00:00.000Z"
+              schema:
+                $ref: "#/components/schemas/PostOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdCancelResponse"
+          description: cancel an Interview succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+        "400":
+          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: 400
+                    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
+        "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":
+          content:
+            application/problem+json:
+              examples:
+                AUTHORIZATION_DENIED:
+                  summary: AUTHORIZATION_DENIED
+                  value:
+                    code: AUTHORIZATION_DENIED
+                    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: 403
+                    title: AUTHORIZATION_DENIED
+                    type: urn:gala:problem:authorization-denied
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHORIZATION_DENIED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHORIZATION_DENIED
+        "404":
+          content:
+            application/problem+json:
+              examples:
+                RESOURCE_NOT_FOUND:
+                  summary: RESOURCE_NOT_FOUND
+                  value:
+                    code: RESOURCE_NOT_FOUND
+                    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: 404
+                    title: RESOURCE_NOT_FOUND
+                    type: urn:gala:problem:resource-not-found
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: RESOURCE_NOT_FOUND
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - RESOURCE_NOT_FOUND
+        "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
+                INTERVIEW_STATE_CONFLICT:
+                  summary: INTERVIEW_STATE_CONFLICT
+                  value:
+                    code: INTERVIEW_STATE_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: INTERVIEW_STATE_CONFLICT
+                    type: urn:gala:problem:interview-state-conflict
+                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, INTERVIEW_STATE_CONFLICT, TRANSFER_PENDING
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - COMMAND_REPLAY_CONFLICT
+            - INTERVIEW_STATE_CONFLICT
+            - TRANSFER_PENDING
+      security:
+        - browserSession: []
+      summary: cancel an Interview
+      tags:
+        - interview
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - NONE
+      x-gala-capability-key: publication.source.write
+      x-gala-concurrency: interview-version
+      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: cancel an Interview
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - COMMAND_REPLAY_CONFLICT
+        - INTERVIEW_STATE_CONFLICT
+        - RESOURCE_NOT_FOUND
+        - TRANSFER_PENDING
+        - VALIDATION_FAILED
+      x-gala-replay-identity: idempotency-key
+      x-gala-state-guards:
+        - NONE
+      x-gala-success-category: protocol
+      x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
+  /v2/organizations/{organizationId}/publications/{publicationId}/interviews/{interviewId}:finish:
+    post:
+      description: |
+        Ends the questions and starts writing the draft. Only while `INTERVIEWING`, and only once at least three details are on record (`progress.canFinish`); otherwise `409 INTERVIEW_TOO_THIN`. `202` with the interview in `WRITING`; poll `GET .../interviews/{interviewId}` until `DRAFT_READY` or `FAILED`.
+      operationId: postOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdFinish
+      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
+        - example: 018f0000-0000-7000-8000-000000000001
+          in: path
+          name: interviewId
+          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"
+      responses:
+        "202":
+          content:
+            application/json:
+              examples:
+                nominal:
+                  summary: Nominal successful response
+                  value:
+                    capture:
+                      kind: NOTE
+                      text: We cut our onboarding from nine steps to four and signups doubled.
+                    createdAt: "2026-11-04T12:00:00.000Z"
+                    expiresAt: "2026-11-11T12:00:00.000Z"
+                    finishedAt: "2026-11-04T12:00:00.000Z"
+                    interviewId: 018f0000-0000-7000-8000-000000000001
+                    organizationId: 018f0000-0000-7000-8000-000000000003
+                    progress:
+                      beliefDone: false
+                      canFinish: true
+                      details: 3
+                      detailsTarget: 5
+                      phase: DONE
+                      skepticRounds: 0
+                    publicationId: 018f0000-0000-7000-8000-000000000002
+                    startedAt: "2026-11-04T12:00:00.000Z"
+                    state: WRITING
+                    turns:
+                      - at: "2026-11-04T12:00:00.000Z"
+                        kind: QUESTION
+                        role: INTERVIEWER
+                        seq: 1
+                        text: What did you cut first, and what did you expect to happen?
+                      - at: "2026-11-04T12:00:00.000Z"
+                        kind: ANSWER
+                        role: AUTHOR
+                        seq: 2
+                        text: The account-type step. I expected no one to notice.
+                    updatedAt: "2026-11-04T12:00:00.000Z"
+              schema:
+                $ref: "#/components/schemas/PostOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdFinishResponse"
+          description: finish an Interview and write the draft succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+        "400":
+          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: 400
+                    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
+        "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":
+          content:
+            application/problem+json:
+              examples:
+                AUTHORIZATION_DENIED:
+                  summary: AUTHORIZATION_DENIED
+                  value:
+                    code: AUTHORIZATION_DENIED
+                    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: 403
+                    title: AUTHORIZATION_DENIED
+                    type: urn:gala:problem:authorization-denied
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHORIZATION_DENIED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHORIZATION_DENIED
+        "404":
+          content:
+            application/problem+json:
+              examples:
+                RESOURCE_NOT_FOUND:
+                  summary: RESOURCE_NOT_FOUND
+                  value:
+                    code: RESOURCE_NOT_FOUND
+                    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: 404
+                    title: RESOURCE_NOT_FOUND
+                    type: urn:gala:problem:resource-not-found
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: RESOURCE_NOT_FOUND
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - RESOURCE_NOT_FOUND
+        "409":
           content:
             application/problem+json:
               examples:
-                RATE_LIMITED:
-                  summary: RATE_LIMITED
+                COMMAND_REPLAY_CONFLICT:
+                  summary: COMMAND_REPLAY_CONFLICT
                   value:
-                    code: RATE_LIMITED
+                    code: COMMAND_REPLAY_CONFLICT
                     correlationId: 018f0000-0000-7000-8000-000000000001
                     detail: See the operation contract.
                     errors: []
-                    retryable: true
+                    retryable: false
                     schemaId: urn:gala:schema:problem:2.0.0
                     schemaVersion: 2.0.0
-                    status: 429
-                    title: RATE_LIMITED
-                    type: urn:gala:problem:rate-limited
+                    status: 409
+                    title: COMMAND_REPLAY_CONFLICT
+                    type: urn:gala:problem:command-replay-conflict
+                INTERVIEW_STATE_CONFLICT:
+                  summary: INTERVIEW_STATE_CONFLICT
+                  value:
+                    code: INTERVIEW_STATE_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: INTERVIEW_STATE_CONFLICT
+                    type: urn:gala:problem:interview-state-conflict
+                INTERVIEW_TOO_THIN:
+                  summary: INTERVIEW_TOO_THIN
+                  value:
+                    code: INTERVIEW_TOO_THIN
+                    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: INTERVIEW_TOO_THIN
+                    type: urn:gala:problem:interview-too-thin
+                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: RATE_LIMITED
+          description: COMMAND_REPLAY_CONFLICT, INTERVIEW_STATE_CONFLICT, INTERVIEW_TOO_THIN, TRANSFER_PENDING
           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
+            - COMMAND_REPLAY_CONFLICT
+            - INTERVIEW_STATE_CONFLICT
+            - INTERVIEW_TOO_THIN
+            - TRANSFER_PENDING
         "503":
           content:
             application/problem+json:
               examples:
+                BUDGET_EXHAUSTED:
+                  summary: BUDGET_EXHAUSTED
+                  value:
+                    code: BUDGET_EXHAUSTED
+                    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: BUDGET_EXHAUSTED
+                    type: urn:gala:problem:budget-exhausted
                 CAPABILITY_UNAVAILABLE:
                   summary: CAPABILITY_UNAVAILABLE
                   value:
@@ -48912,10 +52487,10 @@ paths:
                     status: 503
                     title: CAPABILITY_UNAVAILABLE
                     type: urn:gala:problem:capability-unavailable
-                DEPENDENCY_UNAVAILABLE:
-                  summary: DEPENDENCY_UNAVAILABLE
+                PROVIDER_UNAVAILABLE:
+                  summary: PROVIDER_UNAVAILABLE
                   value:
-                    code: DEPENDENCY_UNAVAILABLE
+                    code: PROVIDER_UNAVAILABLE
                     correlationId: 018f0000-0000-7000-8000-000000000001
                     detail: See the operation contract.
                     errors: []
@@ -48923,51 +52498,56 @@ paths:
                     schemaId: urn:gala:schema:problem:2.0.0
                     schemaVersion: 2.0.0
                     status: 503
-                    title: DEPENDENCY_UNAVAILABLE
-                    type: urn:gala:problem:dependency-unavailable
+                    title: PROVIDER_UNAVAILABLE
+                    type: urn:gala:problem:provider-unavailable
               schema:
                 $ref: "#/components/schemas/Problem"
-          description: CAPABILITY_UNAVAILABLE, DEPENDENCY_UNAVAILABLE
+          description: BUDGET_EXHAUSTED, CAPABILITY_UNAVAILABLE, PROVIDER_UNAVAILABLE
           headers:
             Cache-Control:
               $ref: "#/components/headers/CacheControlNoStore"
             X-Correlation-Id:
               $ref: "#/components/headers/XCorrelationId"
           x-gala-problem-codes:
+            - BUDGET_EXHAUSTED
             - CAPABILITY_UNAVAILABLE
-            - DEPENDENCY_UNAVAILABLE
+            - PROVIDER_UNAVAILABLE
       security:
         - browserSession: []
-        - adminApiKey: []
-      summary: read this publication's reader interaction settings at the main branch head
+      summary: finish an Interview and write the draft
       tags:
-        - interaction-settings
+        - interview
       x-gala-activation-gate: MVP
       x-gala-activation-guards:
-        - Active repository binding and configured GitHub App identity capability
-      x-gala-api-key-scope: read
-      x-gala-capability-key: publication.view
-      x-gala-concurrency: binding-epoch
+        - Interview enabled for this deployment and publication
+      x-gala-capability-key: publication.source.write
+      x-gala-concurrency: interview-version
       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 reader interaction settings at the main branch head
+      x-gala-purpose: finish an Interview and write the draft
       x-gala-reachable-problems:
         - AUTHENTICATION_REQUIRED
         - AUTHORIZATION_DENIED
+        - BUDGET_EXHAUSTED
         - CAPABILITY_UNAVAILABLE
-        - DEPENDENCY_UNAVAILABLE
-        - RATE_LIMITED
+        - COMMAND_REPLAY_CONFLICT
+        - INTERVIEW_STATE_CONFLICT
+        - INTERVIEW_TOO_THIN
+        - PROVIDER_UNAVAILABLE
         - RESOURCE_NOT_FOUND
+        - TRANSFER_PENDING
         - VALIDATION_FAILED
-      x-gala-replay-identity: safe-query
+      x-gala-replay-identity: idempotency-key
       x-gala-state-guards:
         - NONE
-      x-gala-success-category: query
+      x-gala-success-category: async
       x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
-    put:
-      description: The server writes `gala/modules/interactions.json` as a repository change, the way a theme selection writes `gala/appearance.json`. Publishing the change uses the normal publish flow. `change` has the shape the theme-selection write returns. `settings.follows.enabled` (SCHEMA-3.23.0) turns the Follow button on; absent means off.
-      operationId: putOrganizationsByOrganizationIdPublicationsByPublicationIdInteractionSettings
+  /v2/organizations/{organizationId}/publications/{publicationId}/interviews/{interviewId}:start:
+    post:
+      description: |
+        Reserves one unit of the organization's monthly allowance and asks the first question. Only from `CAPTURED`. `429 QUOTA_EXHAUSTED` with `Retry-After` when no unit is left this period; `503 BUDGET_EXHAUSTED` when the platform's monthly spend cap is reached; `503 PROVIDER_UNAVAILABLE` when the question could not be asked (nothing is stored and no unit is used; retry).
+      operationId: postOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdStart
       parameters:
         - $ref: "#/components/parameters/XCorrelationId"
         - example: 018f0000-0000-7000-8000-000000000001
@@ -48986,31 +52566,16 @@ paths:
             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: interviewId
+          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:
-                  settings:
-                    comments:
-                      allowReplies: true
-                      enabled: true
-                      maxDepth: 3
-                    publicCounts:
-                      comments: true
-                      reactions: true
-                    reactions:
-                      definitions: []
-                      enabled: true
-                    schemaId: urn:gala:schema:interactions-config:2.0.0
-                    schemaVersion: 2.0.0
-            schema:
-              $ref: "#/components/schemas/PutOrganizationsByOrganizationIdPublicationsByPublicationIdInteractionSettingsRequest"
-        required: true
       responses:
         "200":
           content:
@@ -49019,15 +52584,33 @@ paths:
                 nominal:
                   summary: Nominal successful response
                   value:
-                    change:
-                      changeId: 018f0000-0000-7000-8000-000000000001
-                      diffDigest: sha256:0000000000000000000000000000000000000000000000000000000000000000
-                      expectedHead: sha1:0000000000000000000000000000000000000000
-                      state: REQUESTED
-                      version: 0
+                    capture:
+                      kind: NOTE
+                      text: We cut our onboarding from nine steps to four and signups doubled.
+                    createdAt: "2026-11-04T12:00:00.000Z"
+                    expiresAt: "2026-11-11T12:00:00.000Z"
+                    interviewId: 018f0000-0000-7000-8000-000000000001
+                    organizationId: 018f0000-0000-7000-8000-000000000003
+                    progress:
+                      beliefDone: false
+                      canFinish: false
+                      details: 1
+                      detailsTarget: 5
+                      phase: OWNED
+                      skepticRounds: 0
+                    publicationId: 018f0000-0000-7000-8000-000000000002
+                    startedAt: "2026-11-04T12:00:00.000Z"
+                    state: INTERVIEWING
+                    turns:
+                      - at: "2026-11-04T12:00:00.000Z"
+                        kind: QUESTION
+                        role: INTERVIEWER
+                        seq: 1
+                        text: What did you cut first, and what did you expect to happen?
+                    updatedAt: "2026-11-04T12:00:00.000Z"
               schema:
-                $ref: "#/components/schemas/PutOrganizationsByOrganizationIdPublicationsByPublicationIdInteractionSettingsResponse"
-          description: save this publication's reader interaction settings as a repository change succeeded
+                $ref: "#/components/schemas/PostOrganizationsByOrganizationIdPublicationsByPublicationIdInterviewsByInterviewIdStartResponse"
+          description: start an Interview succeeded
           headers:
             Cache-Control:
               $ref: "#/components/headers/CacheControlNoStore"
@@ -49037,19 +52620,6 @@ paths:
           content:
             application/problem+json:
               examples:
-                REQUEST_FIELD_UNKNOWN:
-                  summary: REQUEST_FIELD_UNKNOWN
-                  value:
-                    code: REQUEST_FIELD_UNKNOWN
-                    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: 400
-                    title: REQUEST_FIELD_UNKNOWN
-                    type: urn:gala:problem:request-field-unknown
                 VALIDATION_FAILED:
                   summary: VALIDATION_FAILED
                   value:
@@ -49065,14 +52635,13 @@ paths:
                     type: urn:gala:problem:validation-failed
               schema:
                 $ref: "#/components/schemas/Problem"
-          description: REQUEST_FIELD_UNKNOWN, VALIDATION_FAILED
+          description: VALIDATION_FAILED
           headers:
             Cache-Control:
               $ref: "#/components/headers/CacheControlNoStore"
             X-Correlation-Id:
               $ref: "#/components/headers/XCorrelationId"
           x-gala-problem-codes:
-            - REQUEST_FIELD_UNKNOWN
             - VALIDATION_FAILED
         "401":
           content:
@@ -49172,10 +52741,10 @@ paths:
                     status: 409
                     title: COMMAND_REPLAY_CONFLICT
                     type: urn:gala:problem:command-replay-conflict
-                INVALID_SOURCE_STATE:
-                  summary: INVALID_SOURCE_STATE
+                INTERVIEW_STATE_CONFLICT:
+                  summary: INTERVIEW_STATE_CONFLICT
                   value:
-                    code: INVALID_SOURCE_STATE
+                    code: INTERVIEW_STATE_CONFLICT
                     correlationId: 018f0000-0000-7000-8000-000000000001
                     detail: See the operation contract.
                     errors: []
@@ -49183,8 +52752,21 @@ paths:
                     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
+                    title: INTERVIEW_STATE_CONFLICT
+                    type: urn:gala:problem:interview-state-conflict
+                PLAN_REQUIRED:
+                  summary: PLAN_REQUIRED
+                  value:
+                    code: PLAN_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: 409
+                    title: PLAN_REQUIRED
+                    type: urn:gala:problem:plan-required
                 TRANSFER_PENDING:
                   summary: TRANSFER_PENDING
                   value:
@@ -49200,7 +52782,7 @@ paths:
                     type: urn:gala:problem:transfer-pending
               schema:
                 $ref: "#/components/schemas/Problem"
-          description: COMMAND_REPLAY_CONFLICT, INVALID_SOURCE_STATE, TRANSFER_PENDING
+          description: COMMAND_REPLAY_CONFLICT, INTERVIEW_STATE_CONFLICT, PLAN_REQUIRED, TRANSFER_PENDING
           headers:
             Cache-Control:
               $ref: "#/components/headers/CacheControlNoStore"
@@ -49208,39 +52790,69 @@ paths:
               $ref: "#/components/headers/XCorrelationId"
           x-gala-problem-codes:
             - COMMAND_REPLAY_CONFLICT
-            - INVALID_SOURCE_STATE
+            - INTERVIEW_STATE_CONFLICT
+            - PLAN_REQUIRED
             - TRANSFER_PENDING
-        "422":
+        "429":
           content:
             application/problem+json:
               examples:
-                VALIDATION_FAILED:
-                  summary: VALIDATION_FAILED
+                QUOTA_EXHAUSTED:
+                  summary: QUOTA_EXHAUSTED
                   value:
-                    code: VALIDATION_FAILED
+                    code: QUOTA_EXHAUSTED
                     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
+                    status: 429
+                    title: QUOTA_EXHAUSTED
+                    type: urn:gala:problem:quota-exhausted
+                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: VALIDATION_FAILED
+          description: QUOTA_EXHAUSTED, 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:
-            - VALIDATION_FAILED
+            - QUOTA_EXHAUSTED
+            - RATE_LIMITED
         "503":
           content:
             application/problem+json:
               examples:
+                BUDGET_EXHAUSTED:
+                  summary: BUDGET_EXHAUSTED
+                  value:
+                    code: BUDGET_EXHAUSTED
+                    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: BUDGET_EXHAUSTED
+                    type: urn:gala:problem:budget-exhausted
                 CAPABILITY_UNAVAILABLE:
                   summary: CAPABILITY_UNAVAILABLE
                   value:
@@ -49254,47 +52866,62 @@ paths:
                     status: 503
                     title: CAPABILITY_UNAVAILABLE
                     type: urn:gala:problem:capability-unavailable
+                PROVIDER_UNAVAILABLE:
+                  summary: PROVIDER_UNAVAILABLE
+                  value:
+                    code: PROVIDER_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: PROVIDER_UNAVAILABLE
+                    type: urn:gala:problem:provider-unavailable
               schema:
                 $ref: "#/components/schemas/Problem"
-          description: CAPABILITY_UNAVAILABLE
+          description: BUDGET_EXHAUSTED, CAPABILITY_UNAVAILABLE, PROVIDER_UNAVAILABLE
           headers:
             Cache-Control:
               $ref: "#/components/headers/CacheControlNoStore"
             X-Correlation-Id:
               $ref: "#/components/headers/XCorrelationId"
           x-gala-problem-codes:
+            - BUDGET_EXHAUSTED
             - CAPABILITY_UNAVAILABLE
+            - PROVIDER_UNAVAILABLE
       security:
         - browserSession: []
-        - adminApiKey: []
-      summary: save this publication's reader interaction settings as a repository change
+      summary: start an Interview
       tags:
-        - interaction-settings
+        - interview
       x-gala-activation-gate: MVP
       x-gala-activation-guards:
-        - Active repository binding and configured GitHub App identity capability
-      x-gala-api-key-scope: content:write
+        - Interview enabled for this deployment and publication
       x-gala-capability-key: publication.source.write
-      x-gala-concurrency: expected-git-head-and-binding-epoch
+      x-gala-concurrency: interview-version
       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 reader interaction settings as a repository change
+      x-gala-purpose: start an Interview
       x-gala-reachable-problems:
         - AUTHENTICATION_REQUIRED
         - AUTHORIZATION_DENIED
+        - BUDGET_EXHAUSTED
         - CAPABILITY_UNAVAILABLE
         - COMMAND_REPLAY_CONFLICT
-        - INVALID_SOURCE_STATE
-        - REQUEST_FIELD_UNKNOWN
+        - INTERVIEW_STATE_CONFLICT
+        - PLAN_REQUIRED
+        - PROVIDER_UNAVAILABLE
+        - QUOTA_EXHAUSTED
+        - RATE_LIMITED
         - RESOURCE_NOT_FOUND
         - TRANSFER_PENDING
         - VALIDATION_FAILED
       x-gala-replay-identity: idempotency-key
       x-gala-state-guards:
-        - Publication:ACTIVE
-        - RepositoryBinding:ACTIVE
-        - RepositoryChange:REQUESTED -> PLANNED
+        - NONE
       x-gala-success-category: protocol
       x-gala-tenant-scope: ORGANIZATION_AND_PUBLICATION_PATH
   /v2/organizations/{organizationId}/publications/{publicationId}/listen-settings:
@@ -65184,6 +68811,64 @@ paths:
         - NONE
       x-gala-success-category: query
       x-gala-tenant-scope: NONE
+  /v2/platform/interview-usage:
+    get:
+      description: |
+        Operators only (`ADMIN` or `ROOT`). Interview volume and spend for the current UTC month across the platform: how many interviews were started, what they cost in millionths of a US dollar and the monthly cap. Counts and money only, never interview text.
+      operationId: getPlatformInterviewUsage
+      parameters:
+        - $ref: "#/components/parameters/XCorrelationId"
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                nominal:
+                  summary: Nominal successful response
+                  value:
+                    cap:
+                      usdMicros: 50000000
+                    interviews: 42
+                    period: 2026-11
+                    usdMicros: 12500000
+              schema:
+                $ref: "#/components/schemas/GetPlatformInterviewUsageResponse"
+          description: read platform Interview usage 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: read platform Interview usage
+      tags:
+        - platform
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - NONE
+      x-gala-capability-key: platform.interview.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: read platform Interview usage
+      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/oauth-clients:
     get:
       description: |
@@ -77211,6 +80896,7 @@ tags:
   - name: github
   - name: interaction-settings
   - name: internal
+  - name: interview
   - name: membership-invitations
   - name: moderation
   - name: notifications