@rathnasgala2/schemas 3.41.0 → 3.42.0

package/THIRD_PARTY_LICENSES.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "package": "@rathnasgala2/schemas@3.41.0",
+  "package": "@rathnasgala2/schemas@3.42.0",
   "source": "package-lock.json",
   "dependencies": [
     {

package/docs/catalogs/app-components.json

@@ -4985,7 +4985,7 @@
     },
     {
       "contentKey": "platform.users.screen.ready.summary",
-      "defaultMessage": "Operators inspect paged person state, provider display snapshots, account creation, last sign-in, accessible publication count and organization plan tiers without inferred subscription or traffic data, contact a person who allows it, and manage per-person settings overrides.",
+      "defaultMessage": "Operators inspect paged person state, provider display snapshots, account creation, last sign-in, accessible publication count and organization plan tiers without inferred subscription or traffic data, contact a person who allows it, manage per-person settings overrides, and grant or end a complimentary Basic or Pro plan for an organization the person owns (needs platform.billing.manage).",
       "description": "Summary for the platform.users screen, copied verbatim from the route's screenJob in catalog-sources/app-routes.json.",
       "placeholders": {},
       "sensitivity": "AUTHENTICATED"
@@ -11158,5 +11158,5 @@
       "sensitivity": "PUBLIC"
     }
   ],
-  "digest": "sha256:45d323bd2305f7f38412ec73c42b1922f9beb2963ebd015bb6a26af46d5e6062"
+  "digest": "sha256:bc62adf9aa7d2d83718ed44d8dc52d70ba666a8a0c47dc2629597f109c17226e"
 }

package/docs/catalogs/app-routes.json

@@ -1547,17 +1547,20 @@
       "screenId": "platform.users.screen",
       "authenticationClass": "SESSION_REQUIRED",
       "capabilityKeys": [
+        "platform.billing.manage",
         "platform.settings.manage",
         "platform.settings.view",
         "platform.users.contact",
         "platform.users.view"
       ],
       "apiOperationIds": [
+        "deletePlatformOrganizationsByOrganizationIdPlanGrant",
         "deletePlatformSettingsOverridesByKindByIdByKey",
         "getPlatformSettingsByKey",
         "getPlatformSettingsOverridesByKindByIdByKey",
         "getPlatformUsers",
         "postPlatformUsersByPersonIdContact",
+        "putPlatformOrganizationsByOrganizationIdPlanGrant",
         "putPlatformSettingsOverridesByKindByIdByKey"
       ],
       "componentIds": ["ValidationSummary"],
@@ -3761,5 +3764,5 @@
       ]
     }
   ],
-  "digest": "sha256:7cbb42b552bf9e04d74c01c2abbcf50de684bcd74fc1f5f8f4f36be7b59f564f"
+  "digest": "sha256:eb3d83fc68b6a118b153b5a2bfc12c863e933425823633ec6a6ea1d2541c016c"
 }

package/docs/catalogs/schema-inventory.json

@@ -229,9 +229,9 @@
       "version": "2.0.0",
       "path": "openapi/openapi.yaml",
       "materialized": true,
-      "sourceDigest": "sha256:4a900ecbc6118116001779afb71afe88fce5c97b08f8a955c54c4359f57e5d4d",
+      "sourceDigest": "sha256:d96aed78530af7047685d1117b7d70fdbc3f9921d99d5df311265398b8c721f2",
       "typescriptRootType": null
     }
   ],
-  "digest": "sha256:06ab0cbc82777d1d3d0fc5bbbb170f2bd7681588dbfcfb7c59318923b4690c28"
+  "digest": "sha256:21940be95717586eaf7ed6afd594c6f32887ff35e305b0fe85be110956ca1b1d"
 }

package/openapi/http-catalog.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "2.0.0",
   "sourceDesignRevision": "a53052955ceb6c1aa10c886289dc832eedfe6de0a00004df07d353ac19c4403a",
-  "openApiDigest": "sha256:4a900ecbc6118116001779afb71afe88fce5c97b08f8a955c54c4359f57e5d4d",
+  "openApiDigest": "sha256:d96aed78530af7047685d1117b7d70fdbc3f9921d99d5df311265398b8c721f2",
   "operations": [
     {
       "operationId": "getInternalHealth",
@@ -2802,6 +2802,32 @@
       "apiKeyScope": null,
       "sourceFragment": "platform"
     },
+    {
+      "operationId": "deletePlatformOrganizationsByOrganizationIdPlanGrant",
+      "method": "DELETE",
+      "path": "/v2/platform/organizations/{organizationId}/plan-grant",
+      "purpose": "remove organization plan grant",
+      "capabilityKey": "platform.billing.manage",
+      "conditionalCapabilityKeys": [],
+      "activationGate": "MVP",
+      "assuranceClass": "RECENT_AUTHENTICATION",
+      "actionGrant": "none",
+      "apiKeyScope": null,
+      "sourceFragment": "platform"
+    },
+    {
+      "operationId": "putPlatformOrganizationsByOrganizationIdPlanGrant",
+      "method": "PUT",
+      "path": "/v2/platform/organizations/{organizationId}/plan-grant",
+      "purpose": "set organization plan grant",
+      "capabilityKey": "platform.billing.manage",
+      "conditionalCapabilityKeys": [],
+      "activationGate": "MVP",
+      "assuranceClass": "RECENT_AUTHENTICATION",
+      "actionGrant": "none",
+      "apiKeyScope": null,
+      "sourceFragment": "platform"
+    },
     {
       "operationId": "getPlatformOverview",
       "method": "GET",
@@ -3869,5 +3895,5 @@
       "sourceFragment": "workloads"
     }
   ],
-  "digest": "sha256:1e95229acb1fc8413bba7472f5bfd5be3cb571c81488df439b389f061cde022d"
+  "digest": "sha256:49c66f31171f05427178f92b4562bf72f751a532ea452e7b58cdad5f405f2403"
 }

package/openapi/openapi.yaml

@@ -9098,11 +9098,21 @@ components:
           minLength: 1
           pattern: ^[a-z0-9](?:[a-z0-9.-]{0,251}[a-z0-9])?$
           type: string
+        grantExpiresAt:
+          description: "SCHEMA-3.41.0: when an operator grant ends, or null when it is open-ended or the plan is not an operator grant."
+          oneOf:
+            - $ref: "#/components/schemas/PortableProblemRfc3339"
+            - type: "null"
+        source:
+          $ref: "#/components/schemas/PlanSource"
+          description: "SCHEMA-3.41.0: where the plan comes from. A `source` of OPERATOR is a complimentary plan the Galascribe team granted; the App shows it as 'Complimentary Basic/Pro' (until `grantExpiresAt` when set) and keeps the upgrade action so the organization can subscribe."
         tier:
           $ref: "#/components/schemas/PlatformPlanKey"
           description: The plan tier.
       required:
         - tier
+        - source
+        - grantExpiresAt
         - collaborators
         - entitlements
       type: object
@@ -9488,6 +9498,45 @@ components:
         - label
         - createdAt
       type: object
+    PlanGrant:
+      additionalProperties: false
+      description: "SCHEMA-3.41.0: an operator plan grant, a complimentary Basic (`PRO`) or Pro (`BUSINESS`) plan given without Stripe."
+      properties:
+        expiresAt:
+          oneOf:
+            - $ref: "#/components/schemas/PortableProblemRfc3339"
+            - type: "null"
+        grantedAt:
+          $ref: "#/components/schemas/PortableProblemRfc3339"
+        grantedBy:
+          description: The operator's person id.
+          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
+        planTier:
+          $ref: "#/components/schemas/PlatformPlanKey"
+          description: "`PRO` or `BUSINESS`."
+        reasonCode:
+          $ref: "#/components/schemas/PlatformOperatorReasonCode"
+      required:
+        - organizationId
+        - planTier
+        - expiresAt
+        - reasonCode
+        - grantedAt
+        - grantedBy
+      type: object
+    PlanSource:
+      description: "SCHEMA-3.41.0: where an organization's plan comes from. `NONE` is Free with no subscription and no grant; `STRIPE` is a Stripe subscription; `OPERATOR` is a grant the Galascribe team made."
+      enum:
+        - NONE
+        - STRIPE
+        - OPERATOR
+      type: string
     PlatformAbuseCaseDetail:
       additionalProperties: false
       description: Review evidence for one abuse case. Report reasons include only open reports and are sorted and distinct; reporter identities and notes are never exposed.
@@ -10408,6 +10457,11 @@ components:
           type:
             - string
             - "null"
+        organizations:
+          description: "SCHEMA-3.41.0: every organization the person owns, in name order."
+          items:
+            $ref: "#/components/schemas/PlatformUserOrganization"
+          type: array
         personId:
           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}$
@@ -10433,9 +10487,37 @@ components:
         - lastSignInAt
         - publicationCount
         - planTiers
+        - organizations
         - contactEmailOnFile
         - contactEmail
       type: object
+    PlatformUserOrganization:
+      additionalProperties: false
+      description: "SCHEMA-3.41.0: an organization a person owns, with its plan and the active operator grant."
+      properties:
+        grant:
+          oneOf:
+            - $ref: "#/components/schemas/PlanGrant"
+            - type: "null"
+        name:
+          maxLength: 255
+          minLength: 1
+          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
+        planSource:
+          $ref: "#/components/schemas/PlanSource"
+        planTier:
+          $ref: "#/components/schemas/PlatformPlanKey"
+      required:
+        - organizationId
+        - name
+        - planTier
+        - planSource
+        - grant
+      type: object
     PlatformWebhookEvent:
       additionalProperties: false
       description: Redacted webhook inbox metadata and immutable routing coordinates. The request body and payload digest are deliberately never exposed.
@@ -21994,6 +22076,29 @@ components:
       required:
         - change
       type: object
+    PutPlatformOrganizationsByOrganizationIdPlanGrantRequest:
+      additionalProperties: false
+      properties:
+        expiresAt:
+          description: Null for open-ended; otherwise in the future.
+          oneOf:
+            - $ref: "#/components/schemas/PortableProblemRfc3339"
+            - type: "null"
+        planTier:
+          description: "`FREE` is not a grant tier; a DELETE ends the grant."
+          enum:
+            - PRO
+            - BUSINESS
+          type: string
+        reasonCode:
+          $ref: "#/components/schemas/PlatformOperatorReasonCode"
+      required:
+        - planTier
+        - expiresAt
+        - reasonCode
+      type: object
+    PutPlatformOrganizationsByOrganizationIdPlanGrantResponse:
+      $ref: "#/components/schemas/PlanGrant"
     PutPlatformPlansByPlanKeyRequest:
       additionalProperties: false
       properties:
@@ -33753,6 +33858,8 @@ paths:
                       galascribeHosting: true
                       includedDomain: false
                     galascribeAddressZone: galascribe.com
+                    grantExpiresAt: null
+                    source: STRIPE
                     tier: PRO
               schema:
                 $ref: "#/components/schemas/GetOrganizationsByOrganizationIdPlanResponse"
@@ -73575,6 +73682,498 @@ paths:
         - OAuthClient:DRAFT -> REVOKED
       x-gala-success-category: update
       x-gala-tenant-scope: NONE
+  /v2/platform/organizations/{organizationId}/plan-grant:
+    delete:
+      description: |
+        Operators only, with recent authentication and a browser session; API keys are refused. Ends the operator plan grant of one organization, which returns to Free unless it subscribes through Stripe. `404 RESOURCE_NOT_FOUND` when the organization does not exist or has no active grant. `409 PLAN_COLLABORATORS_PRESENT` when the organization is a collaborative Pro (`BUSINESS`) organization that still has members besides the owner. `Idempotency-Key` is the command identity.
+      operationId: deletePlatformOrganizationsByOrganizationIdPlanGrant
+      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
+        - $ref: "#/components/parameters/IdempotencyKey"
+        - $ref: "#/components/parameters/XCsrfToken"
+      responses:
+        "204":
+          description: remove organization plan grant 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
+                REAUTH_REQUIRED:
+                  summary: REAUTH_REQUIRED
+                  value:
+                    code: REAUTH_REQUIRED
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 401
+                    title: REAUTH_REQUIRED
+                    type: urn:gala:problem:reauth-required
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHENTICATION_REQUIRED, REAUTH_REQUIRED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHENTICATION_REQUIRED
+            - REAUTH_REQUIRED
+        "403":
+          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_COLLABORATORS_PRESENT:
+                  summary: PLAN_COLLABORATORS_PRESENT
+                  value:
+                    code: PLAN_COLLABORATORS_PRESENT
+                    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_COLLABORATORS_PRESENT
+                    type: urn:gala:problem:plan-collaborators-present
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: COMMAND_REPLAY_CONFLICT, PLAN_COLLABORATORS_PRESENT
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - COMMAND_REPLAY_CONFLICT
+            - PLAN_COLLABORATORS_PRESENT
+      security:
+        - browserSession: []
+      summary: remove organization plan grant
+      tags:
+        - platform
+      x-gala-action-grant: none
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - NONE
+      x-gala-assurance-class: RECENT_AUTHENTICATION
+      x-gala-capability-key: platform.billing.manage
+      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: remove organization plan grant
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - COMMAND_REPLAY_CONFLICT
+        - PLAN_COLLABORATORS_PRESENT
+        - REAUTH_REQUIRED
+        - RESOURCE_NOT_FOUND
+        - VALIDATION_FAILED
+      x-gala-replay-identity: idempotency-key
+      x-gala-state-guards:
+        - NONE
+      x-gala-success-category: delete
+      x-gala-tenant-scope: NONE
+    put:
+      description: |
+        Operators only, with recent authentication and a browser session; API keys are refused. Grants an organization Basic (`PRO`) or Pro (`BUSINESS`) without Stripe, until `expiresAt` or open-ended when it is null, and replaces an existing active grant (a new tier or a new end date). `expiresAt` must be in the future; `FREE` is not a grant tier, a DELETE ends the grant. `reasonCode` is a non-sensitive operator reason code recorded in the audit event. `404 RESOURCE_NOT_FOUND` for an unknown organization. `409 PLAN_SUBSCRIBED` when the organization has an active, trialing or past_due Stripe subscription. `409 PLAN_COLLABORATORS_PRESENT` when the change takes a collaborative Pro organization below Pro while it still has members besides the owner. `Idempotency-Key` is the command identity.
+      operationId: putPlatformOrganizationsByOrganizationIdPlanGrant
+      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
+        - $ref: "#/components/parameters/IdempotencyKey"
+        - $ref: "#/components/parameters/XCsrfToken"
+      requestBody:
+        content:
+          application/json:
+            examples:
+              nominal:
+                summary: Nominal valid request
+                value:
+                  expiresAt: "2026-12-05T12:00:00.000Z"
+                  planTier: PRO
+                  reasonCode: PILOT_CREATOR
+            schema:
+              $ref: "#/components/schemas/PutPlatformOrganizationsByOrganizationIdPlanGrantRequest"
+        required: true
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                nominal:
+                  summary: Nominal successful response
+                  value:
+                    expiresAt: "2026-12-05T12:00:00.000Z"
+                    grantedAt: "2026-11-05T12:00:00.000Z"
+                    grantedBy: 018f0000-0000-7000-8000-000000000001
+                    organizationId: 018f0000-0000-7000-8000-000000000001
+                    planTier: PRO
+                    reasonCode: PILOT_CREATOR
+              schema:
+                $ref: "#/components/schemas/PutPlatformOrganizationsByOrganizationIdPlanGrantResponse"
+          description: set organization plan grant succeeded
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            ETag:
+              $ref: "#/components/headers/ETag"
+            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
+                REAUTH_REQUIRED:
+                  summary: REAUTH_REQUIRED
+                  value:
+                    code: REAUTH_REQUIRED
+                    correlationId: 018f0000-0000-7000-8000-000000000001
+                    detail: See the operation contract.
+                    errors: []
+                    retryable: false
+                    schemaId: urn:gala:schema:problem:2.0.0
+                    schemaVersion: 2.0.0
+                    status: 401
+                    title: REAUTH_REQUIRED
+                    type: urn:gala:problem:reauth-required
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: AUTHENTICATION_REQUIRED, REAUTH_REQUIRED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - AUTHENTICATION_REQUIRED
+            - REAUTH_REQUIRED
+        "403":
+          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_COLLABORATORS_PRESENT:
+                  summary: PLAN_COLLABORATORS_PRESENT
+                  value:
+                    code: PLAN_COLLABORATORS_PRESENT
+                    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_COLLABORATORS_PRESENT
+                    type: urn:gala:problem:plan-collaborators-present
+                PLAN_SUBSCRIBED:
+                  summary: PLAN_SUBSCRIBED
+                  value:
+                    code: PLAN_SUBSCRIBED
+                    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_SUBSCRIBED
+                    type: urn:gala:problem:plan-subscribed
+              schema:
+                $ref: "#/components/schemas/Problem"
+          description: COMMAND_REPLAY_CONFLICT, PLAN_COLLABORATORS_PRESENT, PLAN_SUBSCRIBED
+          headers:
+            Cache-Control:
+              $ref: "#/components/headers/CacheControlNoStore"
+            X-Correlation-Id:
+              $ref: "#/components/headers/XCorrelationId"
+          x-gala-problem-codes:
+            - COMMAND_REPLAY_CONFLICT
+            - PLAN_COLLABORATORS_PRESENT
+            - PLAN_SUBSCRIBED
+      security:
+        - browserSession: []
+      summary: set organization plan grant
+      tags:
+        - platform
+      x-gala-action-grant: none
+      x-gala-activation-gate: MVP
+      x-gala-activation-guards:
+        - NONE
+      x-gala-assurance-class: RECENT_AUTHENTICATION
+      x-gala-capability-key: platform.billing.manage
+      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: set organization plan grant
+      x-gala-reachable-problems:
+        - AUTHENTICATION_REQUIRED
+        - AUTHORIZATION_DENIED
+        - COMMAND_REPLAY_CONFLICT
+        - PLAN_COLLABORATORS_PRESENT
+        - PLAN_SUBSCRIBED
+        - REAUTH_REQUIRED
+        - REQUEST_FIELD_UNKNOWN
+        - RESOURCE_NOT_FOUND
+        - VALIDATION_FAILED
+      x-gala-replay-identity: idempotency-key
+      x-gala-state-guards:
+        - NONE
+      x-gala-success-category: update
+      x-gala-tenant-scope: NONE
   /v2/platform/overview:
     get:
       description: |
@@ -75254,6 +75853,12 @@ paths:
                         displayName: Ada Reader
                         lastSignInAt: "2026-10-10T11:30:00.000Z"
                         login: ada-reader
+                        organizations:
+                          - grant: null
+                            name: Ada Reader
+                            organizationId: 018f0000-0000-7000-8000-000000000001
+                            planSource: STRIPE
+                            planTier: PRO
                         personId: 018f0000-0000-7000-8000-000000000001
                         planTiers:
                           - FREE

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rathnasgala2/schemas",
-  "version": "3.41.0",
+  "version": "3.42.0",
   "description": "Executable JSON Schema and OpenAPI contracts for Galascribe",
   "type": "module",
   "license": "Apache-2.0",

package/sbom.cdx.json

@@ -97,8 +97,8 @@
       "type": "library",
       "name": "schemas",
       "group": "@rathnasgala2",
-      "version": "3.41.0",
-      "bom-ref": "@rathnasgala2/schemas@3.41.0",
+      "version": "3.42.0",
+      "bom-ref": "@rathnasgala2/schemas@3.42.0",
       "description": "Executable JSON Schema and OpenAPI contracts for Galascribe",
       "licenses": [
         {
@@ -108,7 +108,7 @@
           }
         }
       ],
-      "purl": "pkg:npm/%40rathnasgala2/schemas@3.41.0?vcs_url=git%2Bhttps%3A%2F%2Fgithub.com%2Frathnasgala2%2Fschema.git",
+      "purl": "pkg:npm/%40rathnasgala2/schemas@3.42.0?vcs_url=git%2Bhttps%3A%2F%2Fgithub.com%2Frathnasgala2%2Fschema.git",
       "externalReferences": [
         {
           "url": "https://github.com/rathnasgala2/schema/issues",
@@ -153,7 +153,7 @@
       "type": "library",
       "name": "ajv-formats",
       "version": "3.0.1",
-      "bom-ref": "@rathnasgala2/schemas@3.41.0|ajv-formats@3.0.1",
+      "bom-ref": "@rathnasgala2/schemas@3.42.0|ajv-formats@3.0.1",
       "licenses": [
         {
           "license": {
@@ -187,7 +187,7 @@
       "type": "library",
       "name": "ajv",
       "version": "8.20.0",
-      "bom-ref": "@rathnasgala2/schemas@3.41.0|ajv@8.20.0",
+      "bom-ref": "@rathnasgala2/schemas@3.42.0|ajv@8.20.0",
       "licenses": [
         {
           "license": {
@@ -221,7 +221,7 @@
       "type": "library",
       "name": "fast-deep-equal",
       "version": "3.1.3",
-      "bom-ref": "@rathnasgala2/schemas@3.41.0|fast-deep-equal@3.1.3",
+      "bom-ref": "@rathnasgala2/schemas@3.42.0|fast-deep-equal@3.1.3",
       "licenses": [
         {
           "license": {
@@ -255,7 +255,7 @@
       "type": "library",
       "name": "fast-uri",
       "version": "3.1.8",
-      "bom-ref": "@rathnasgala2/schemas@3.41.0|fast-uri@3.1.8",
+      "bom-ref": "@rathnasgala2/schemas@3.42.0|fast-uri@3.1.8",
       "licenses": [
         {
           "license": {
@@ -289,7 +289,7 @@
       "type": "library",
       "name": "json-schema-traverse",
       "version": "1.0.0",
-      "bom-ref": "@rathnasgala2/schemas@3.41.0|json-schema-traverse@1.0.0",
+      "bom-ref": "@rathnasgala2/schemas@3.42.0|json-schema-traverse@1.0.0",
       "licenses": [
         {
           "license": {
@@ -323,7 +323,7 @@
       "type": "library",
       "name": "require-from-string",
       "version": "2.0.2",
-      "bom-ref": "@rathnasgala2/schemas@3.41.0|require-from-string@2.0.2",
+      "bom-ref": "@rathnasgala2/schemas@3.42.0|require-from-string@2.0.2",
       "licenses": [
         {
           "license": {
@@ -1064,10 +1064,10 @@
   ],
   "dependencies": [
     {
-      "ref": "@rathnasgala2/schemas@3.41.0",
+      "ref": "@rathnasgala2/schemas@3.42.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.41.0|ajv-formats@3.0.1",
-        "@rathnasgala2/schemas@3.41.0|ajv@8.20.0",
+        "@rathnasgala2/schemas@3.42.0|ajv-formats@3.0.1",
+        "@rathnasgala2/schemas@3.42.0|ajv@8.20.0",
         "pkg:npm/semver@7.8.5",
         "urn:gala:source-data:iana-ipv4-special-registry",
         "urn:gala:source-data:iana-ipv6-special-registry",
@@ -1089,31 +1089,31 @@
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@3.41.0|ajv-formats@3.0.1",
+      "ref": "@rathnasgala2/schemas@3.42.0|ajv-formats@3.0.1",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.41.0|ajv@8.20.0"
+        "@rathnasgala2/schemas@3.42.0|ajv@8.20.0"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@3.41.0|ajv@8.20.0",
+      "ref": "@rathnasgala2/schemas@3.42.0|ajv@8.20.0",
       "dependsOn": [
-        "@rathnasgala2/schemas@3.41.0|fast-deep-equal@3.1.3",
-        "@rathnasgala2/schemas@3.41.0|fast-uri@3.1.8",
-        "@rathnasgala2/schemas@3.41.0|json-schema-traverse@1.0.0",
-        "@rathnasgala2/schemas@3.41.0|require-from-string@2.0.2"
+        "@rathnasgala2/schemas@3.42.0|fast-deep-equal@3.1.3",
+        "@rathnasgala2/schemas@3.42.0|fast-uri@3.1.8",
+        "@rathnasgala2/schemas@3.42.0|json-schema-traverse@1.0.0",
+        "@rathnasgala2/schemas@3.42.0|require-from-string@2.0.2"
       ]
     },
     {
-      "ref": "@rathnasgala2/schemas@3.41.0|fast-deep-equal@3.1.3"
+      "ref": "@rathnasgala2/schemas@3.42.0|fast-deep-equal@3.1.3"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.41.0|fast-uri@3.1.8"
+      "ref": "@rathnasgala2/schemas@3.42.0|fast-uri@3.1.8"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.41.0|json-schema-traverse@1.0.0"
+      "ref": "@rathnasgala2/schemas@3.42.0|json-schema-traverse@1.0.0"
     },
     {
-      "ref": "@rathnasgala2/schemas@3.41.0|require-from-string@2.0.2"
+      "ref": "@rathnasgala2/schemas@3.42.0|require-from-string@2.0.2"
     },
     {
       "ref": "pkg:npm/semver@7.8.5"