@opusdns/api 1.190.0 → 1.191.0

package/package.json

@@ -3,7 +3,7 @@
     "@opusdns/api-spec-ts-generator": "^1.6.0"
   },
   "name": "@opusdns/api",
-  "version": "1.190.0",
+  "version": "1.191.0",
   "description": "TypeScript types for the OpusDNS OpenAPI specification",
   "main": "./src/index.ts",
   "module": "./src/index.ts",

package/src/helpers/constants.ts

@@ -127,6 +127,8 @@ import type {
   VerificationDeadlineType,
   VerificationPolicyType,
   VerificationType,
+  WaitlistEntryStatus,
+  WaitlistProduct,
   WhitelabelBrandingTier,
   WhitelabelOnboardingFailureCode,
   WhitelabelOnboardingFailureType,
@@ -2425,6 +2427,26 @@ export const VERIFICATION_TYPE_VALUES = [
   'email',
 ] as const satisfies ReadonlyArray<VerificationType>;
 
+export const WAITLIST_ENTRY_STATUS = {
+  PENDING: "pending",
+  GRANTED: "granted",
+  REJECTED: "rejected",
+} as const satisfies Record<string, WaitlistEntryStatus>;
+
+export const WAITLIST_ENTRY_STATUS_VALUES = [
+  'pending',
+  'granted',
+  'rejected',
+] as const satisfies ReadonlyArray<WaitlistEntryStatus>;
+
+export const WAITLIST_PRODUCT = {
+  AI_CONCIERGE: "ai_concierge",
+} as const satisfies Record<string, WaitlistProduct>;
+
+export const WAITLIST_PRODUCT_VALUES = [
+  'ai_concierge',
+] as const satisfies ReadonlyArray<WaitlistProduct>;
+
 export const WHITELABEL_BRANDING_TIER = {
   BASE: "base",
   PLUS: "plus",

package/src/helpers/endpoints.ts

@@ -106,6 +106,8 @@ export const ORGANIZATIONS_ENDPOINT = '/v1/organizations';
 export const ORGANIZATIONS_ATTRIBUTES_ENDPOINT = '/v1/organizations/attributes';
 export const ORGANIZATIONS_IP_RESTRICTIONS_ENDPOINT = '/v1/organizations/ip-restrictions';
 export const ORGANIZATIONS_IP_RESTRICTIONS_BY_IP_RESTRICTION_ID_ENDPOINT = '/v1/organizations/ip-restrictions/{ip_restriction_id}';
+export const ORGANIZATIONS_PRODUCT_WAITLIST_ENDPOINT = '/v1/organizations/product-waitlist';
+export const ORGANIZATIONS_PRODUCT_WAITLIST_BY_PRODUCT_APPLY_ENDPOINT = '/v1/organizations/product-waitlist/{product}/apply';
 export const ORGANIZATIONS_ROLE_PERMISSIONS_ENDPOINT = '/v1/organizations/role-permissions';
 export const ORGANIZATIONS_ROLES_ENDPOINT = '/v1/organizations/roles';
 export const ORGANIZATIONS_ROLES_BY_LABEL_ENDPOINT = '/v1/organizations/roles/{label}';
@@ -266,6 +268,8 @@ export type Endpoint =
   | typeof ORGANIZATIONS_ATTRIBUTES_ENDPOINT
   | typeof ORGANIZATIONS_IP_RESTRICTIONS_ENDPOINT
   | typeof ORGANIZATIONS_IP_RESTRICTIONS_BY_IP_RESTRICTION_ID_ENDPOINT
+  | typeof ORGANIZATIONS_PRODUCT_WAITLIST_ENDPOINT
+  | typeof ORGANIZATIONS_PRODUCT_WAITLIST_BY_PRODUCT_APPLY_ENDPOINT
   | typeof ORGANIZATIONS_ROLE_PERMISSIONS_ENDPOINT
   | typeof ORGANIZATIONS_ROLES_ENDPOINT
   | typeof ORGANIZATIONS_ROLES_BY_LABEL_ENDPOINT

package/src/helpers/keys.ts

@@ -451,6 +451,10 @@ import type {
   VerificationRegistrantDetails,
   Verification,
   VisitsByKeyBucket,
+  WaitlistApplyRequest,
+  WaitlistEntry,
+  WaitlistProductList,
+  WaitlistProductState,
   WhitelabelBaseCreate,
   WhitelabelBrandingPatch,
   WhitelabelBrandingRecheck,
@@ -6183,6 +6187,48 @@ export const KEYS_VISITS_BY_KEY_BUCKET = [
   KEY_VISITS_BY_KEY_BUCKET_UNIQUE,
 ] as const satisfies (keyof VisitsByKeyBucket)[];
 
+export const KEY_WAITLIST_APPLY_REQUEST_NOTE = 'note' satisfies keyof WaitlistApplyRequest;
+
+export const KEYS_WAITLIST_APPLY_REQUEST = [
+  KEY_WAITLIST_APPLY_REQUEST_NOTE,
+] as const satisfies (keyof WaitlistApplyRequest)[];
+
+export const KEY_WAITLIST_ENTRY_APPLIED_ON = 'applied_on' satisfies keyof WaitlistEntry;
+export const KEY_WAITLIST_ENTRY_DECIDED_ON = 'decided_on' satisfies keyof WaitlistEntry;
+export const KEY_WAITLIST_ENTRY_PRODUCT = 'product' satisfies keyof WaitlistEntry;
+export const KEY_WAITLIST_ENTRY_STATUS = 'status' satisfies keyof WaitlistEntry;
+
+export const KEYS_WAITLIST_ENTRY = [
+  KEY_WAITLIST_ENTRY_APPLIED_ON,
+  KEY_WAITLIST_ENTRY_DECIDED_ON,
+  KEY_WAITLIST_ENTRY_PRODUCT,
+  KEY_WAITLIST_ENTRY_STATUS,
+] as const satisfies (keyof WaitlistEntry)[];
+
+export const KEY_WAITLIST_PRODUCT_LIST_PRODUCTS = 'products' satisfies keyof WaitlistProductList;
+
+export const KEYS_WAITLIST_PRODUCT_LIST = [
+  KEY_WAITLIST_PRODUCT_LIST_PRODUCTS,
+] as const satisfies (keyof WaitlistProductList)[];
+
+export const KEY_WAITLIST_PRODUCT_STATE_APPLIED_ON = 'applied_on' satisfies keyof WaitlistProductState;
+export const KEY_WAITLIST_PRODUCT_STATE_CAN_APPLY = 'can_apply' satisfies keyof WaitlistProductState;
+export const KEY_WAITLIST_PRODUCT_STATE_DECIDED_ON = 'decided_on' satisfies keyof WaitlistProductState;
+export const KEY_WAITLIST_PRODUCT_STATE_DESCRIPTION = 'description' satisfies keyof WaitlistProductState;
+export const KEY_WAITLIST_PRODUCT_STATE_DISPLAY_NAME = 'display_name' satisfies keyof WaitlistProductState;
+export const KEY_WAITLIST_PRODUCT_STATE_PRODUCT = 'product' satisfies keyof WaitlistProductState;
+export const KEY_WAITLIST_PRODUCT_STATE_STATUS = 'status' satisfies keyof WaitlistProductState;
+
+export const KEYS_WAITLIST_PRODUCT_STATE = [
+  KEY_WAITLIST_PRODUCT_STATE_APPLIED_ON,
+  KEY_WAITLIST_PRODUCT_STATE_CAN_APPLY,
+  KEY_WAITLIST_PRODUCT_STATE_DECIDED_ON,
+  KEY_WAITLIST_PRODUCT_STATE_DESCRIPTION,
+  KEY_WAITLIST_PRODUCT_STATE_DISPLAY_NAME,
+  KEY_WAITLIST_PRODUCT_STATE_PRODUCT,
+  KEY_WAITLIST_PRODUCT_STATE_STATUS,
+] as const satisfies (keyof WaitlistProductState)[];
+
 export const KEY_WHITELABEL_BASE_CREATE_LABEL = 'label' satisfies keyof WhitelabelBaseCreate;
 export const KEY_WHITELABEL_BASE_CREATE_PERIOD = 'period' satisfies keyof WhitelabelBaseCreate;
 export const KEY_WHITELABEL_BASE_CREATE_TIER = 'tier' satisfies keyof WhitelabelBaseCreate;

package/src/helpers/permissions.ts

@@ -119,6 +119,8 @@ import {
   ORGANIZATIONS_ENDPOINT,
   ORGANIZATIONS_IP_RESTRICTIONS_BY_IP_RESTRICTION_ID_ENDPOINT,
   ORGANIZATIONS_IP_RESTRICTIONS_ENDPOINT,
+  ORGANIZATIONS_PRODUCT_WAITLIST_BY_PRODUCT_APPLY_ENDPOINT,
+  ORGANIZATIONS_PRODUCT_WAITLIST_ENDPOINT,
   ORGANIZATIONS_ROLE_PERMISSIONS_ENDPOINT,
   ORGANIZATIONS_ROLES_BY_LABEL_ENDPOINT,
   ORGANIZATIONS_ROLES_ENDPOINT,
@@ -1050,6 +1052,20 @@ export const REQUIRED_PERMISSIONS = {
     patch: [],
     delete: [],
   },
+  [ORGANIZATIONS_PRODUCT_WAITLIST_BY_PRODUCT_APPLY_ENDPOINT]: {
+    get: [],
+    post: [],
+    put: [],
+    patch: [],
+    delete: [],
+  },
+  [ORGANIZATIONS_PRODUCT_WAITLIST_ENDPOINT]: {
+    get: [PUBLIC_PERMISSION.ORGANIZATION_READ],
+    post: [],
+    put: [],
+    patch: [],
+    delete: [],
+  },
   [ORGANIZATIONS_ROLE_PERMISSIONS_ENDPOINT]: {
     get: [PUBLIC_PERMISSION.ORGANIZATION_READ],
     post: [],

package/src/helpers/requests.d.ts

@@ -957,6 +957,14 @@ export type PATCH_OrganizationsIpRestrictionsByIpRestrictionId_Request = {
 export type PATCH_OrganizationsIpRestrictionsByIpRestrictionId_Request_Path = PATCH_OrganizationsIpRestrictionsByIpRestrictionId_Request['parameters']['path'];
 export type PATCH_OrganizationsIpRestrictionsByIpRestrictionId_Request_Body = PATCH_OrganizationsIpRestrictionsByIpRestrictionId_Request['requestBody'];
 
+export type GET_OrganizationsProductWaitlist_Request = {
+};
+
+export type POST_OrganizationsProductWaitlistByProductApply_Request = {
+  parameters: operations['apply_for_product_waitlist_v1_organizations_product_waitlist__product__apply_post']['parameters'];
+};
+export type POST_OrganizationsProductWaitlistByProductApply_Request_Path = POST_OrganizationsProductWaitlistByProductApply_Request['parameters']['path'];
+
 export type GET_OrganizationsRolePermissions_Request = {
 };
 

package/src/helpers/responses.d.ts

@@ -120,6 +120,8 @@ import type {
   UserPublicWithAttributes,
   VanityNameserverSetSummaryDTO,
   VanityNsCheckRes,
+  WaitlistEntry,
+  WaitlistProductList,
   WhitelabelBranding,
 } from './schemas';
 
@@ -748,6 +750,13 @@ export type GET_OrganizationsIpRestrictionsByIpRestrictionId_Response_401 = Prob
 export type GET_OrganizationsIpRestrictionsByIpRestrictionId_Response_403 = Problem;
 export type GET_OrganizationsIpRestrictionsByIpRestrictionId_Response_422 = HTTPValidationError;
 
+export type GET_OrganizationsProductWaitlist_Response = GET_OrganizationsProductWaitlist_Response_200 | GET_OrganizationsProductWaitlist_Response_401 | GET_OrganizationsProductWaitlist_Response_403 | GET_OrganizationsProductWaitlist_Response_422;
+
+export type GET_OrganizationsProductWaitlist_Response_200 = WaitlistProductList;
+export type GET_OrganizationsProductWaitlist_Response_401 = Problem;
+export type GET_OrganizationsProductWaitlist_Response_403 = Problem;
+export type GET_OrganizationsProductWaitlist_Response_422 = HTTPValidationError;
+
 export type GET_OrganizationsRolePermissions_Response = GET_OrganizationsRolePermissions_Response_200 | GET_OrganizationsRolePermissions_Response_401 | GET_OrganizationsRolePermissions_Response_403 | GET_OrganizationsRolePermissions_Response_422;
 
 export type GET_OrganizationsRolePermissions_Response_200 = PublicPermissionSet;
@@ -1398,6 +1407,15 @@ export type POST_OrganizationsIpRestrictions_Response_401 = Problem;
 export type POST_OrganizationsIpRestrictions_Response_403 = Problem;
 export type POST_OrganizationsIpRestrictions_Response_422 = HTTPValidationError;
 
+export type POST_OrganizationsProductWaitlistByProductApply_Response = POST_OrganizationsProductWaitlistByProductApply_Response_200 | POST_OrganizationsProductWaitlistByProductApply_Response_401 | POST_OrganizationsProductWaitlistByProductApply_Response_403 | POST_OrganizationsProductWaitlistByProductApply_Response_404 | POST_OrganizationsProductWaitlistByProductApply_Response_409 | POST_OrganizationsProductWaitlistByProductApply_Response_422;
+
+export type POST_OrganizationsProductWaitlistByProductApply_Response_200 = WaitlistEntry;
+export type POST_OrganizationsProductWaitlistByProductApply_Response_401 = Problem;
+export type POST_OrganizationsProductWaitlistByProductApply_Response_403 = Problem;
+export type POST_OrganizationsProductWaitlistByProductApply_Response_404 = Problem;
+export type POST_OrganizationsProductWaitlistByProductApply_Response_409 = Problem;
+export type POST_OrganizationsProductWaitlistByProductApply_Response_422 = HTTPValidationError;
+
 export type POST_OrganizationsRoles_Response = POST_OrganizationsRoles_Response_201 | POST_OrganizationsRoles_Response_401 | POST_OrganizationsRoles_Response_403 | POST_OrganizationsRoles_Response_409 | POST_OrganizationsRoles_Response_422;
 
 export type POST_OrganizationsRoles_Response_201 = PublicRoleDefinition;

package/src/helpers/schemas.d.ts

@@ -604,6 +604,12 @@ export type VerificationRegistrantDetails = components['schemas']['VerificationR
 export type Verification = components['schemas']['VerificationResponse'];
 export type VerificationType = components['schemas']['VerificationType'];
 export type VisitsByKeyBucket = components['schemas']['VisitsByKeyBucket'];
+export type WaitlistApplyRequest = components['schemas']['WaitlistApplyRequest'];
+export type WaitlistEntry = components['schemas']['WaitlistEntryResponse'];
+export type WaitlistEntryStatus = components['schemas']['WaitlistEntryStatus'];
+export type WaitlistProduct = components['schemas']['WaitlistProduct'];
+export type WaitlistProductList = components['schemas']['WaitlistProductListResponse'];
+export type WaitlistProductState = components['schemas']['WaitlistProductState'];
 export type WhitelabelBaseCreate = components['schemas']['WhitelabelBaseCreate'];
 export type WhitelabelBrandingPatch = components['schemas']['WhitelabelBrandingPatch'];
 export type WhitelabelBrandingRecheck = components['schemas']['WhitelabelBrandingRecheck'];

package/src/openapi.yaml

@@ -16078,6 +16078,125 @@ components:
       - unique
       title: VisitsByKeyBucket
       type: object
+    WaitlistApplyRequest:
+      description: What an organization says when applying for a product.
+      properties:
+        note:
+          anyOf:
+          - maxLength: 1000
+            minLength: 1
+            type: string
+          - type: 'null'
+          description: What your organization would use the product for
+          examples:
+          - We manage 12k domains for agency clients and triage renewals by hand.
+          title: Note
+      title: WaitlistApplyRequest
+      type: object
+    WaitlistEntryResponse:
+      description: An organization's own waitlist application.
+      properties:
+        applied_on:
+          description: When the organization applied
+          format: date-time
+          title: Applied On
+          type: string
+        decided_on:
+          anyOf:
+          - format: date-time
+            type: string
+          - type: 'null'
+          description: When the application was decided; null while it is pending
+          title: Decided On
+        product:
+          $ref: '#/components/schemas/WaitlistProduct'
+          description: Product the application is for
+        status:
+          $ref: '#/components/schemas/WaitlistEntryStatus'
+          description: Where the application stands
+      required:
+      - product
+      - status
+      - applied_on
+      title: WaitlistEntryResponse
+      type: object
+    WaitlistEntryStatus:
+      enum:
+      - pending
+      - granted
+      - rejected
+      title: WaitlistEntryStatus
+      type: string
+    WaitlistProduct:
+      description: 'A product that is not generally available and is reached through
+        the waitlist.
+
+
+        The member value is the wire form used in URLs and API bodies; the column
+        persists the
+
+        member NAME (StringEnum binds `value.name`), so renaming a member is a data
+        migration.'
+      enum:
+      - ai_concierge
+      title: WaitlistProduct
+      type: string
+    WaitlistProductListResponse:
+      description: The waitlisted products an organization may see.
+      properties:
+        products:
+          description: Waitlisted products this organization may see
+          items:
+            $ref: '#/components/schemas/WaitlistProductState'
+          title: Products
+          type: array
+      title: WaitlistProductListResponse
+      type: object
+    WaitlistProductState:
+      description: A waitlisted product, and where the organization stands with it.
+      properties:
+        applied_on:
+          anyOf:
+          - format: date-time
+            type: string
+          - type: 'null'
+          description: When the organization applied, if it has
+          title: Applied On
+        can_apply:
+          description: Whether an apply would be accepted right now
+          title: Can Apply
+          type: boolean
+        decided_on:
+          anyOf:
+          - format: date-time
+            type: string
+          - type: 'null'
+          description: When the application was decided, if it was
+          title: Decided On
+        description:
+          description: What the product does
+          title: Description
+          type: string
+        display_name:
+          description: Human-readable product name
+          title: Display Name
+          type: string
+        product:
+          $ref: '#/components/schemas/WaitlistProduct'
+          description: Product key, used in the apply path
+        status:
+          anyOf:
+          - $ref: '#/components/schemas/WaitlistEntryStatus'
+          - type: 'null'
+          description: Where the organization's application stands; null until it
+            applies
+      required:
+      - product
+      - display_name
+      - description
+      - can_apply
+      title: WaitlistProductState
+      type: object
     WhitelabelBaseCreate:
       additionalProperties: false
       description: 'Create the base tier: served on a managed subdomain composed from
@@ -17059,7 +17178,7 @@ info:
     \n\n"
   summary: OpusDNS - your gateway to a seamless domain management experience.
   title: OpusDNS API
-  version: 2026-09-22-090818
+  version: 2026-09-22-143714
   x-logo:
     altText: OpusDNS API Reference
     url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -31370,6 +31489,154 @@ paths:
       summary: Update an IP restriction
       tags:
       - organization
+  /v1/organizations/product-waitlist:
+    get:
+      description: Lists the waitlisted products your organization has been invited
+        to, or has already applied for, with where your organization stands on each.
+        Any other product is omitted entirely.
+      operationId: list_product_waitlists_v1_organizations_product_waitlist_get
+      parameters:
+      - $ref: '#/components/parameters/DatetimeFormatHeader'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/WaitlistProductListResponse'
+          description: Successful Response
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+        '403':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_PERMISSION_DENIED
+                detail: Insufficient permissions to perform this action
+                status: 403
+                title: Permission Denied
+                type: permission-denied
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Forbidden
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      - APIKeyHeader: []
+      summary: List product waitlists
+      tags:
+      - organization
+      - product_waitlist
+      x-required-permissions:
+      - organization:read
+  /v1/organizations/product-waitlist/{product}/apply:
+    post:
+      description: 'Applies your organization to a product''s waitlist, optionally
+        saying what you would use the product for. The application is recorded as
+        `pending` until OpusDNS decides on it. One application per organization per
+        product: a second apply is refused, and a rejection is reconsidered by OpusDNS
+        rather than by applying again.'
+      operationId: apply_for_product_waitlist_v1_organizations_product_waitlist__product__apply_post
+      parameters:
+      - in: path
+        name: product
+        required: true
+        schema:
+          $ref: '#/components/schemas/WaitlistProduct'
+      - $ref: '#/components/parameters/DatetimeFormatHeader'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              anyOf:
+              - $ref: '#/components/schemas/WaitlistApplyRequest'
+              - type: 'null'
+              title: Body
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/WaitlistEntryResponse'
+          description: Successful Response
+        '401':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_AUTHENTICATION
+                detail: Additional error context.
+                status: 401
+                title: Authentication Error
+                type: authentication
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Unauthorized
+        '403':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_PERMISSION_DENIED
+                detail: Insufficient permissions to perform this action
+                status: 403
+                title: Permission Denied
+                type: permission-denied
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Forbidden
+        '404':
+          content:
+            application/problem+json:
+              example:
+                code: ERROR_WAITLIST_NOT_INVITED
+                detail: No waitlist is available for ai_concierge
+                product: ai_concierge
+                status: 404
+                title: Waitlist Error
+                type: waitlist-not-invited
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Not Found
+        '409':
+          content:
+            application/problem+json:
+              examples:
+                Waitlist Error:
+                  value:
+                    code: ERROR_WAITLIST_ENTRY_REJECTED
+                    detail: This organization's application for ai_concierge was rejected
+                    product: ai_concierge
+                    status: 409
+                    title: Waitlist Error
+                    type: waitlist-entry-rejected
+              schema:
+                $ref: '#/components/schemas/Problem'
+          description: Conflict
+        '422':
+          content:
+            application/problem+json:
+              schema:
+                $ref: '#/components/schemas/HTTPValidationError'
+          description: Validation Error
+      security:
+      - OAuth2PasswordBearer: []
+      summary: Apply for a product waitlist
+      tags:
+      - organization
+      - product_waitlist
   /v1/organizations/role-permissions:
     get:
       description: Retrieves the catalog of `resource:scope` permissions a custom
@@ -35886,6 +36153,90 @@ tags:
     '
   name: organization
   x-displayName: Organizations
+- description: 'Endpoints for products that are not generally available yet and are
+    reached through a waitlist.
+
+
+    A waitlisted product is invitation-only: OpusDNS invites an organization, the
+    organization applies, and OpusDNS decides. Until your organization is invited,
+    the product does not exist as far as this API is concerned - it is left out of
+    the listing, and applying for it answers `404`. Once your organization has applied,
+    the product stays in its listing whatever happens to the invite afterwards.
+
+
+    ### Endpoints
+
+
+    | Method | Path | Description |
+
+    |--------|------|-------------|
+
+    | `GET` | `/v1/organizations/product-waitlist` | The waitlisted products your
+    organization may see, and where it stands on each |
+
+    | `POST` | `/v1/organizations/product-waitlist/{product}/apply` | Apply your organization
+    to one product''s waitlist |
+
+
+    Both routes act on the organization the request is authenticated for; neither
+    takes an organization in the path.
+
+
+    ### Product state
+
+
+    Each entry in the listing describes one product and your organization''s standing
+    with it:
+
+
+    | Field | Description |
+
+    |-------|-------------|
+
+    | `product` | The product key, used as `{product}` in the apply path |
+
+    | `display_name` | Human-readable product name |
+
+    | `description` | What the product does |
+
+    | `status` | `pending`, `granted` or `rejected`, or `null` while your organization
+    has not applied |
+
+    | `applied_on` | When your organization applied, or `null` |
+
+    | `decided_on` | When OpusDNS decided, or `null` |
+
+    | `can_apply` | Whether an apply would be accepted right now, from this caller:
+    it also takes the `organization:write` the apply route requires |
+
+
+    ### Applying
+
+
+    `POST /v1/organizations/product-waitlist/{product}/apply` records the application
+    as `pending`, together with the applying user. It requires a user token: an API-key
+    token has no user to record.
+
+
+    The body is optional. Send `{"note": "..."}` to say what your organization would
+    use the product for - it is the one thing OpusDNS has to go on when deciding,
+    so it is worth filling in. A note is trimmed and may be up to 1000 characters;
+    a blank or whitespace-only one is rejected rather than stored. Posting no body
+    at all applies without a note.
+
+
+    One application per organization per product. A second apply answers `409`, whatever
+    state the first one reached - a rejection is reconsidered by OpusDNS approving
+    it after all, not by applying again. `can_apply` in the listing tells you in advance
+    which applies would be accepted.
+
+
+    Being granted a product means every user of your organization gains access to
+    it, including users created afterwards.
+
+    '
+  name: product_waitlist
+  x-displayName: Product waitlist
 - description: 'Endpoints for retrieving TLD specifications.
 
     '
@@ -36063,6 +36414,7 @@ x-tagGroups:
   - authentication
   - user
   - organization
+  - product_waitlist
   - usage
 - name: Domains
   tags:

package/src/schema.d.ts

@@ -2204,6 +2204,46 @@ export interface paths {
         patch: operations["update_ip_restriction_v1_organizations_ip_restrictions__ip_restriction_id__patch"];
         trace?: never;
     };
+    "/v1/organizations/product-waitlist": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List product waitlists
+         * @description Lists the waitlisted products your organization has been invited to, or has already applied for, with where your organization stands on each. Any other product is omitted entirely.
+         */
+        get: operations["list_product_waitlists_v1_organizations_product_waitlist_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/organizations/product-waitlist/{product}/apply": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Apply for a product waitlist
+         * @description Applies your organization to a product's waitlist, optionally saying what you would use the product for. The application is recorded as `pending` until OpusDNS decides on it. One application per organization per product: a second apply is refused, and a rejection is reconsidered by OpusDNS rather than by applying again.
+         */
+        post: operations["apply_for_product_waitlist_v1_organizations_product_waitlist__product__apply_post"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/organizations/role-permissions": {
         parameters: {
             query?: never;
@@ -13880,6 +13920,99 @@ export interface components {
             /** Unique */
             unique: number;
         };
+        /**
+         * WaitlistApplyRequest
+         * @description What an organization says when applying for a product.
+         */
+        WaitlistApplyRequest: {
+            /**
+             * Note
+             * @description What your organization would use the product for
+             * @example We manage 12k domains for agency clients and triage renewals by hand.
+             */
+            note?: string | null;
+        };
+        /**
+         * WaitlistEntryResponse
+         * @description An organization's own waitlist application.
+         */
+        WaitlistEntryResponse: {
+            /**
+             * Applied On
+             * Format: date-time
+             * @description When the organization applied
+             */
+            applied_on: Date;
+            /**
+             * Decided On
+             * @description When the application was decided; null while it is pending
+             */
+            decided_on?: Date | null;
+            /** @description Product the application is for */
+            product: components["schemas"]["WaitlistProduct"];
+            /** @description Where the application stands */
+            status: components["schemas"]["WaitlistEntryStatus"];
+        };
+        /**
+         * WaitlistEntryStatus
+         * @enum {string}
+         */
+        WaitlistEntryStatus: "pending" | "granted" | "rejected";
+        /**
+         * WaitlistProduct
+         * @description A product that is not generally available and is reached through the waitlist.
+         *
+         *     The member value is the wire form used in URLs and API bodies; the column persists the
+         *     member NAME (StringEnum binds `value.name`), so renaming a member is a data migration.
+         * @enum {string}
+         */
+        WaitlistProduct: "ai_concierge";
+        /**
+         * WaitlistProductListResponse
+         * @description The waitlisted products an organization may see.
+         */
+        WaitlistProductListResponse: {
+            /**
+             * Products
+             * @description Waitlisted products this organization may see
+             */
+            products?: components["schemas"]["WaitlistProductState"][];
+        };
+        /**
+         * WaitlistProductState
+         * @description A waitlisted product, and where the organization stands with it.
+         */
+        WaitlistProductState: {
+            /**
+             * Applied On
+             * @description When the organization applied, if it has
+             */
+            applied_on?: Date | null;
+            /**
+             * Can Apply
+             * @description Whether an apply would be accepted right now
+             */
+            can_apply: boolean;
+            /**
+             * Decided On
+             * @description When the application was decided, if it was
+             */
+            decided_on?: Date | null;
+            /**
+             * Description
+             * @description What the product does
+             */
+            description: string;
+            /**
+             * Display Name
+             * @description Human-readable product name
+             */
+            display_name: string;
+            /** @description Product key, used in the apply path */
+            product: components["schemas"]["WaitlistProduct"];
+            /** @description Where the organization's application stands; null until it applies */
+            status?: components["schemas"]["WaitlistEntryStatus"] | null;
+        };
         /**
          * WhitelabelBaseCreate
          * @description Create the base tier: served on a managed subdomain composed from `label`.
@@ -25672,6 +25805,172 @@ export interface operations {
             };
         };
     };
+    list_product_waitlists_v1_organizations_product_waitlist_get: {
+        parameters: {
+            query?: never;
+            header?: {
+                /**
+                 * @description Accepted for backwards compatibility; has no effect. Response datetimes are always normalized to UTC and serialized as RFC 3339 with a `Z` suffix, whether or not this header is sent.
+                 * @example rfc3339
+                 */
+                "X-Datetime-Format"?: components["parameters"]["DatetimeFormatHeader"];
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WaitlistProductListResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /** @example {
+                     *       "code": "ERROR_AUTHENTICATION",
+                     *       "detail": "Additional error context.",
+                     *       "status": 401,
+                     *       "title": "Authentication Error",
+                     *       "type": "authentication"
+                     *     } */
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /** @example {
+                     *       "code": "ERROR_PERMISSION_DENIED",
+                     *       "detail": "Insufficient permissions to perform this action",
+                     *       "status": 403,
+                     *       "title": "Permission Denied",
+                     *       "type": "permission-denied"
+                     *     } */
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
+    apply_for_product_waitlist_v1_organizations_product_waitlist__product__apply_post: {
+        parameters: {
+            query?: never;
+            header?: {
+                /**
+                 * @description Accepted for backwards compatibility; has no effect. Response datetimes are always normalized to UTC and serialized as RFC 3339 with a `Z` suffix, whether or not this header is sent.
+                 * @example rfc3339
+                 */
+                "X-Datetime-Format"?: components["parameters"]["DatetimeFormatHeader"];
+            };
+            path: {
+                product: components["schemas"]["WaitlistProduct"];
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": components["schemas"]["WaitlistApplyRequest"] | null;
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WaitlistEntryResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /** @example {
+                     *       "code": "ERROR_AUTHENTICATION",
+                     *       "detail": "Additional error context.",
+                     *       "status": 401,
+                     *       "title": "Authentication Error",
+                     *       "type": "authentication"
+                     *     } */
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /** @example {
+                     *       "code": "ERROR_PERMISSION_DENIED",
+                     *       "detail": "Insufficient permissions to perform this action",
+                     *       "status": 403,
+                     *       "title": "Permission Denied",
+                     *       "type": "permission-denied"
+                     *     } */
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+            /** @description Not Found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /** @example {
+                     *       "code": "ERROR_WAITLIST_NOT_INVITED",
+                     *       "detail": "No waitlist is available for ai_concierge",
+                     *       "product": "ai_concierge",
+                     *       "status": 404,
+                     *       "title": "Waitlist Error",
+                     *       "type": "waitlist-not-invited"
+                     *     } */
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+            /** @description Conflict */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["Problem"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/problem+json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     list_role_permissions_v1_organizations_role_permissions_get: {
         parameters: {
             query?: never;