@opusdns/api 1.70.0 → 1.72.0

package/package.json

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

package/src/helpers/constants.ts

@@ -1,4 +1,5 @@
 import type {
+  AiUsageGranularity,
   AllocationMethodType,
   AssignablePublicRole,
   AttributeType,
@@ -116,6 +117,18 @@ import type {
   ZoneSortField,
 } from './schemas';
 
+export const AI_USAGE_GRANULARITY = {
+  DAY: "day",
+  WEEK: "week",
+  MONTH: "month",
+} as const satisfies Record<string, AiUsageGranularity>;
+
+export const AI_USAGE_GRANULARITY_VALUES = [
+  'day',
+  'week',
+  'month',
+] as const satisfies ReadonlyArray<AiUsageGranularity>;
+
 export const ALLOCATION_METHOD_TYPE = {
   FCFS: "fcfs",
   AUCTION: "auction",

package/src/helpers/keys.ts

@@ -1,4 +1,8 @@
 import type {
+  AiUsageModelBreakdown,
+  AiUsageSeries,
+  AiUsageSummary,
+  AiUsageTimeBucket,
   AllowedNumberOfNameserverBase,
   AttributeCondition,
   BillingMetadata,
@@ -418,6 +422,52 @@ import type {
   DomainAvailabilityCheck,
 } from './schemas';
 
+export const KEY_AI_USAGE_MODEL_BREAKDOWN_CACHE_READ_TOKENS = 'cache_read_tokens' satisfies keyof AiUsageModelBreakdown;
+export const KEY_AI_USAGE_MODEL_BREAKDOWN_CACHE_WRITE_TOKENS = 'cache_write_tokens' satisfies keyof AiUsageModelBreakdown;
+export const KEY_AI_USAGE_MODEL_BREAKDOWN_INPUT_TOKENS = 'input_tokens' satisfies keyof AiUsageModelBreakdown;
+export const KEY_AI_USAGE_MODEL_BREAKDOWN_MODEL = 'model' satisfies keyof AiUsageModelBreakdown;
+export const KEY_AI_USAGE_MODEL_BREAKDOWN_OUTPUT_TOKENS = 'output_tokens' satisfies keyof AiUsageModelBreakdown;
+export const KEY_AI_USAGE_MODEL_BREAKDOWN_REQUEST_COUNT = 'request_count' satisfies keyof AiUsageModelBreakdown;
+
+export const KEYS_AI_USAGE_MODEL_BREAKDOWN = [
+  KEY_AI_USAGE_MODEL_BREAKDOWN_CACHE_READ_TOKENS,
+  KEY_AI_USAGE_MODEL_BREAKDOWN_CACHE_WRITE_TOKENS,
+  KEY_AI_USAGE_MODEL_BREAKDOWN_INPUT_TOKENS,
+  KEY_AI_USAGE_MODEL_BREAKDOWN_MODEL,
+  KEY_AI_USAGE_MODEL_BREAKDOWN_OUTPUT_TOKENS,
+  KEY_AI_USAGE_MODEL_BREAKDOWN_REQUEST_COUNT,
+] as const satisfies (keyof AiUsageModelBreakdown)[];
+
+export const KEY_AI_USAGE_SERIES_BUCKETS = 'buckets' satisfies keyof AiUsageSeries;
+export const KEY_AI_USAGE_SERIES_END_DATE = 'end_date' satisfies keyof AiUsageSeries;
+export const KEY_AI_USAGE_SERIES_GRANULARITY = 'granularity' satisfies keyof AiUsageSeries;
+export const KEY_AI_USAGE_SERIES_START_DATE = 'start_date' satisfies keyof AiUsageSeries;
+
+export const KEYS_AI_USAGE_SERIES = [
+  KEY_AI_USAGE_SERIES_BUCKETS,
+  KEY_AI_USAGE_SERIES_END_DATE,
+  KEY_AI_USAGE_SERIES_GRANULARITY,
+  KEY_AI_USAGE_SERIES_START_DATE,
+] as const satisfies (keyof AiUsageSeries)[];
+
+export const KEY_AI_USAGE_SUMMARY_BY_MODEL = 'by_model' satisfies keyof AiUsageSummary;
+export const KEY_AI_USAGE_SUMMARY_END_DATE = 'end_date' satisfies keyof AiUsageSummary;
+export const KEY_AI_USAGE_SUMMARY_START_DATE = 'start_date' satisfies keyof AiUsageSummary;
+
+export const KEYS_AI_USAGE_SUMMARY = [
+  KEY_AI_USAGE_SUMMARY_BY_MODEL,
+  KEY_AI_USAGE_SUMMARY_END_DATE,
+  KEY_AI_USAGE_SUMMARY_START_DATE,
+] as const satisfies (keyof AiUsageSummary)[];
+
+export const KEY_AI_USAGE_TIME_BUCKET_BY_MODEL = 'by_model' satisfies keyof AiUsageTimeBucket;
+export const KEY_AI_USAGE_TIME_BUCKET_PERIOD_START = 'period_start' satisfies keyof AiUsageTimeBucket;
+
+export const KEYS_AI_USAGE_TIME_BUCKET = [
+  KEY_AI_USAGE_TIME_BUCKET_BY_MODEL,
+  KEY_AI_USAGE_TIME_BUCKET_PERIOD_START,
+] as const satisfies (keyof AiUsageTimeBucket)[];
+
 export const KEY_ALLOWED_NUMBER_OF_NAMESERVER_BASE_MAX = 'max' satisfies keyof AllowedNumberOfNameserverBase;
 export const KEY_ALLOWED_NUMBER_OF_NAMESERVER_BASE_MIN = 'min' satisfies keyof AllowedNumberOfNameserverBase;
 
@@ -2388,6 +2438,7 @@ export const KEY_DOMAIN_STATUS_TAGS = 'status_tags' satisfies keyof Domain;
 export const KEY_DOMAIN_TAGS = 'tags' satisfies keyof Domain;
 export const KEY_DOMAIN_TLD = 'tld' satisfies keyof Domain;
 export const KEY_DOMAIN_TRANSFER_LOCK = 'transfer_lock' satisfies keyof Domain;
+export const KEY_DOMAIN_TRANSFERRED_ON = 'transferred_on' satisfies keyof Domain;
 export const KEY_DOMAIN_UPDATED_ON = 'updated_on' satisfies keyof Domain;
 export const KEY_DOMAIN_VERIFICATION_REQUIRED = 'verification_required' satisfies keyof Domain;
 
@@ -2416,6 +2467,7 @@ export const KEYS_DOMAIN = [
   KEY_DOMAIN_TAGS,
   KEY_DOMAIN_TLD,
   KEY_DOMAIN_TRANSFER_LOCK,
+  KEY_DOMAIN_TRANSFERRED_ON,
   KEY_DOMAIN_UPDATED_ON,
   KEY_DOMAIN_VERIFICATION_REQUIRED,
 ] as const satisfies (keyof Domain)[];

package/src/helpers/requests.d.ts

@@ -798,6 +798,16 @@ export type POST_Organizations_Request = {
 };
 export type POST_Organizations_Request_Body = POST_Organizations_Request['requestBody'];
 
+export type GET_OrganizationsAiUsage_Request = {
+  parameters: operations['get_ai_usage_series_v1_organizations_ai_usage_get']['parameters'];
+};
+export type GET_OrganizationsAiUsage_Request_Query = GET_OrganizationsAiUsage_Request['parameters']['query'];
+
+export type GET_OrganizationsAiUsageSummary_Request = {
+  parameters: operations['get_ai_usage_summary_v1_organizations_ai_usage_summary_get']['parameters'];
+};
+export type GET_OrganizationsAiUsageSummary_Request_Query = GET_OrganizationsAiUsageSummary_Request['parameters']['query'];
+
 export type GET_OrganizationsAttributes_Request = {
   parameters: operations['get_current_organization_attributes_v1_organizations_attributes_get']['parameters'];
 };

package/src/helpers/responses.d.ts

@@ -1,4 +1,6 @@
 import type {
+  AiUsageSeries,
+  AiUsageSummary,
   BillingTransaction,
   ClaimsNotices,
   ClearVanityNameserverSetDefaultRes,
@@ -643,6 +645,20 @@ export type GET_Organizations_Response_401 = Problem;
 export type GET_Organizations_Response_403 = Problem;
 export type GET_Organizations_Response_422 = HTTPValidationError;
 
+export type GET_OrganizationsAiUsage_Response = GET_OrganizationsAiUsage_Response_200 | GET_OrganizationsAiUsage_Response_401 | GET_OrganizationsAiUsage_Response_403 | GET_OrganizationsAiUsage_Response_422;
+
+export type GET_OrganizationsAiUsage_Response_200 = AiUsageSeries;
+export type GET_OrganizationsAiUsage_Response_401 = Problem;
+export type GET_OrganizationsAiUsage_Response_403 = Problem;
+export type GET_OrganizationsAiUsage_Response_422 = HTTPValidationError;
+
+export type GET_OrganizationsAiUsageSummary_Response = GET_OrganizationsAiUsageSummary_Response_200 | GET_OrganizationsAiUsageSummary_Response_401 | GET_OrganizationsAiUsageSummary_Response_403 | GET_OrganizationsAiUsageSummary_Response_422;
+
+export type GET_OrganizationsAiUsageSummary_Response_200 = AiUsageSummary;
+export type GET_OrganizationsAiUsageSummary_Response_401 = Problem;
+export type GET_OrganizationsAiUsageSummary_Response_403 = Problem;
+export type GET_OrganizationsAiUsageSummary_Response_422 = HTTPValidationError;
+
 export type GET_OrganizationsAttributes_Response = GET_OrganizationsAttributes_Response_200 | GET_OrganizationsAttributes_Response_401 | GET_OrganizationsAttributes_Response_403 | GET_OrganizationsAttributes_Response_422;
 
 export type GET_OrganizationsAttributes_Response_200 = OrganizationAttribute2[];

package/src/helpers/schemas.d.ts

@@ -1,5 +1,10 @@
 import { components } from '../schema';
 
+export type AiUsageGranularity = components['schemas']['AiUsageGranularity'];
+export type AiUsageModelBreakdown = components['schemas']['AiUsageModelBreakdown'];
+export type AiUsageSeries = components['schemas']['AiUsageSeriesResponse'];
+export type AiUsageSummary = components['schemas']['AiUsageSummaryResponse'];
+export type AiUsageTimeBucket = components['schemas']['AiUsageTimeBucket'];
 export type AllocationMethodType = components['schemas']['AllocationMethodType'];
 export type AllowedNumberOfNameserverBase = components['schemas']['AllowedNumberOfNameserverBase'];
 export type AssignablePublicRole = components['schemas']['AssignablePublicRole'];

package/src/openapi.yaml

@@ -15,6 +15,106 @@ components:
         - rfc3339
         type: string
   schemas:
+    AiUsageGranularity:
+      enum:
+      - day
+      - week
+      - month
+      title: AiUsageGranularity
+      type: string
+    AiUsageModelBreakdown:
+      description: 'Public per-model AI token usage. Deliberately excludes billing-gateway''s
+
+        internal COGS fields (cost_amount, per-million rates, has_rate).'
+      properties:
+        cache_read_tokens:
+          title: Cache Read Tokens
+          type: integer
+        cache_write_tokens:
+          title: Cache Write Tokens
+          type: integer
+        input_tokens:
+          title: Input Tokens
+          type: integer
+        model:
+          title: Model
+          type: string
+        output_tokens:
+          title: Output Tokens
+          type: integer
+        request_count:
+          title: Request Count
+          type: integer
+      required:
+      - model
+      - input_tokens
+      - output_tokens
+      - cache_read_tokens
+      - cache_write_tokens
+      - request_count
+      title: AiUsageModelBreakdown
+      type: object
+    AiUsageSeriesResponse:
+      properties:
+        buckets:
+          items:
+            $ref: '#/components/schemas/AiUsageTimeBucket'
+          title: Buckets
+          type: array
+        end_date:
+          format: date
+          title: End Date
+          type: string
+        granularity:
+          $ref: '#/components/schemas/AiUsageGranularity'
+        start_date:
+          format: date
+          title: Start Date
+          type: string
+      required:
+      - granularity
+      - start_date
+      - end_date
+      - buckets
+      title: AiUsageSeriesResponse
+      type: object
+    AiUsageSummaryResponse:
+      properties:
+        by_model:
+          items:
+            $ref: '#/components/schemas/AiUsageModelBreakdown'
+          title: By Model
+          type: array
+        end_date:
+          format: date
+          title: End Date
+          type: string
+        start_date:
+          format: date
+          title: Start Date
+          type: string
+      required:
+      - start_date
+      - end_date
+      - by_model
+      title: AiUsageSummaryResponse
+      type: object
+    AiUsageTimeBucket:
+      properties:
+        by_model:
+          items:
+            $ref: '#/components/schemas/AiUsageModelBreakdown'
+          title: By Model
+          type: array
+        period_start:
+          format: date
+          title: Period Start
+          type: string
+      required:
+      - period_start
+      - by_model
+      title: AiUsageTimeBucket
+      type: object
     AllocationMethodType:
       enum:
       - fcfs
@@ -5201,6 +5301,13 @@ components:
           description: Whether the domain is locked for transfer
           title: Transfer Lock
           type: boolean
+        transferred_on:
+          anyOf:
+          - format: date-time
+            type: string
+          - type: 'null'
+          description: When the domain was last transferred to us
+          title: Transferred On
         updated_on:
           description: The date/time the entry was last updated on
           format: date-time
@@ -14148,7 +14255,7 @@ info:
     \n\n"
   summary: OpusDNS - your gateway to a seamless domain management experience.
   title: OpusDNS API
-  version: 2026-07-21-001849
+  version: 2026-07-21-194842
   x-logo:
     altText: OpusDNS API Reference
     url: https://d24lr4zqs1tgqh.cloudfront.net/c9505a20-5ae1-406c-b060-d392569caebf.jpg
@@ -26811,6 +26918,164 @@ paths:
       summary: Create an organization
       tags:
       - organization
+  /v1/organizations/ai-usage:
+    get:
+      description: Retrieves the current organization's AI token usage as a time series,
+        bucketed by the requested granularity and broken down per model. Reports token
+        counts and request volumes only.
+      operationId: get_ai_usage_series_v1_organizations_ai_usage_get
+      parameters:
+      - in: query
+        name: start_date
+        required: true
+        schema:
+          format: date
+          title: Start Date
+          type: string
+      - in: query
+        name: end_date
+        required: true
+        schema:
+          format: date
+          title: End Date
+          type: string
+      - in: query
+        name: model
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Model
+      - in: query
+        name: granularity
+        required: false
+        schema:
+          $ref: '#/components/schemas/AiUsageGranularity'
+          default: day
+      - $ref: '#/components/parameters/DatetimeFormatHeader'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AiUsageSeriesResponse'
+          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: AI usage over time
+      tags:
+      - organization
+      - ai_usage
+      x-required-permissions:
+      - organization:read
+  /v1/organizations/ai-usage/summary:
+    get:
+      description: Retrieves the current organization's total AI token usage over
+        a date range, broken down per model. Reports token counts and request volumes
+        only.
+      operationId: get_ai_usage_summary_v1_organizations_ai_usage_summary_get
+      parameters:
+      - in: query
+        name: start_date
+        required: true
+        schema:
+          format: date
+          title: Start Date
+          type: string
+      - in: query
+        name: end_date
+        required: true
+        schema:
+          format: date
+          title: End Date
+          type: string
+      - in: query
+        name: model
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Model
+      - $ref: '#/components/parameters/DatetimeFormatHeader'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AiUsageSummaryResponse'
+          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: AI usage summary
+      tags:
+      - organization
+      - ai_usage
+      x-required-permissions:
+      - organization:read
   /v1/organizations/attributes:
     get:
       description: Retrieves a list of organization attributes for the current organization
@@ -31053,12 +31318,89 @@ tags:
 - description: Endpoints for creating new Tags
   name: tag
   x-displayName: Tags
+- description: 'Endpoints for reporting your organization''s AI usage.
+
+
+    These endpoints expose the AI token consumption incurred by your organization''s
+    use of OpusDNS AI features, so you can monitor usage over time and per model.
+    Usage is reported as token counts and request volumes only.
+
+
+    ### Endpoints
+
+
+    | Method | Path | Description |
+
+    |--------|------|-------------|
+
+    | `GET` | `/v1/organizations/ai-usage` | Token usage as a time series, bucketed
+    by granularity and broken down per model |
+
+    | `GET` | `/v1/organizations/ai-usage/summary` | Token usage totals over a date
+    range, broken down per model |
+
+
+    The reporting organization is taken from the authentication token; usage is always
+    scoped to the calling organization.
+
+
+    ### Query Parameters
+
+
+    | Parameter | Description |
+
+    |-----------|-------------|
+
+    | `start_date` | Inclusive start date (`YYYY-MM-DD`) |
+
+    | `end_date` | Inclusive end date (`YYYY-MM-DD`) |
+
+    | `granularity` | Time-bucket size for the series endpoint: `day` (default), `week`,
+    or `month` |
+
+    | `model` | Optional filter to a single model |
+
+
+    `start_date` must be on or before `end_date`, otherwise the request is rejected
+    with `422 Unprocessable Content`.
+
+
+    ### Reported Metrics
+
+
+    Each per-model breakdown reports token counts and request volume:
+
+
+    | Field | Description |
+
+    |-------|-------------|
+
+    | `model` | The AI model the usage was recorded against |
+
+    | `input_tokens` | Prompt (input) tokens consumed |
+
+    | `output_tokens` | Generated (output) tokens |
+
+    | `cache_read_tokens` | Tokens served from prompt cache |
+
+    | `cache_write_tokens` | Tokens written to prompt cache |
+
+    | `request_count` | Number of requests |
+
+
+    Usage is scoped to your billing organization and requires the organization `view`
+    permission.
+
+    '
+  name: ai_usage
+  x-displayName: AI usage
 x-tagGroups:
 - name: Account management
   tags:
   - authentication
   - user
   - organization
+  - ai_usage
 - name: Domains
   tags:
   - domain

package/src/schema.d.ts

@@ -1925,6 +1925,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/organizations/ai-usage": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * AI usage over time
+         * @description Retrieves the current organization's AI token usage as a time series, bucketed by the requested granularity and broken down per model. Reports token counts and request volumes only.
+         */
+        get: operations["get_ai_usage_series_v1_organizations_ai_usage_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/organizations/ai-usage/summary": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * AI usage summary
+         * @description Retrieves the current organization's total AI token usage over a date range, broken down per model. Reports token counts and request volumes only.
+         */
+        get: operations["get_ai_usage_summary_v1_organizations_ai_usage_summary_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/organizations/attributes": {
         parameters: {
             query?: never;
@@ -2832,6 +2872,71 @@ export interface paths {
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
+        /**
+         * AiUsageGranularity
+         * @enum {string}
+         */
+        AiUsageGranularity: "day" | "week" | "month";
+        /**
+         * AiUsageModelBreakdown
+         * @description Public per-model AI token usage. Deliberately excludes billing-gateway's
+         *     internal COGS fields (cost_amount, per-million rates, has_rate).
+         */
+        AiUsageModelBreakdown: {
+            /** Cache Read Tokens */
+            cache_read_tokens: number;
+            /** Cache Write Tokens */
+            cache_write_tokens: number;
+            /** Input Tokens */
+            input_tokens: number;
+            /** Model */
+            model: string;
+            /** Output Tokens */
+            output_tokens: number;
+            /** Request Count */
+            request_count: number;
+        };
+        /** AiUsageSeriesResponse */
+        AiUsageSeriesResponse: {
+            /** Buckets */
+            buckets: components["schemas"]["AiUsageTimeBucket"][];
+            /**
+             * End Date
+             * Format: date
+             */
+            end_date: string;
+            granularity: components["schemas"]["AiUsageGranularity"];
+            /**
+             * Start Date
+             * Format: date
+             */
+            start_date: string;
+        };
+        /** AiUsageSummaryResponse */
+        AiUsageSummaryResponse: {
+            /** By Model */
+            by_model: components["schemas"]["AiUsageModelBreakdown"][];
+            /**
+             * End Date
+             * Format: date
+             */
+            end_date: string;
+            /**
+             * Start Date
+             * Format: date
+             */
+            start_date: string;
+        };
+        /** AiUsageTimeBucket */
+        AiUsageTimeBucket: {
+            /** By Model */
+            by_model: components["schemas"]["AiUsageModelBreakdown"][];
+            /**
+             * Period Start
+             * Format: date
+             */
+            period_start: string;
+        };
         /**
          * AllocationMethodType
          * @enum {string}
@@ -6216,6 +6321,11 @@ export interface components {
              * @default false
              */
             transfer_lock: boolean;
+            /**
+             * Transferred On
+             * @description When the domain was last transferred to us
+             */
+            transferred_on?: Date | null;
             /**
              * Updated On
              * Format: date-time
@@ -22082,6 +22192,149 @@ export interface operations {
             };
         };
     };
+    get_ai_usage_series_v1_organizations_ai_usage_get: {
+        parameters: {
+            query: {
+                start_date: string;
+                end_date: string;
+                model?: string | null;
+                granularity?: components["schemas"]["AiUsageGranularity"];
+            };
+            header?: {
+                /**
+                 * @description Opt in to RFC 3339 datetime serialization. When set to `rfc3339`, response datetimes are normalized to UTC and serialized with a `Z` suffix. This is opt-in until the announced default cutover date, after which RFC 3339 becomes the default and this header is accepted as a no-op. Any other value or omission uses the current default serialization.
+                 * @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"]["AiUsageSeriesResponse"];
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    get_ai_usage_summary_v1_organizations_ai_usage_summary_get: {
+        parameters: {
+            query: {
+                start_date: string;
+                end_date: string;
+                model?: string | null;
+            };
+            header?: {
+                /**
+                 * @description Opt in to RFC 3339 datetime serialization. When set to `rfc3339`, response datetimes are normalized to UTC and serialized with a `Z` suffix. This is opt-in until the announced default cutover date, after which RFC 3339 becomes the default and this header is accepted as a no-op. Any other value or omission uses the current default serialization.
+                 * @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"]["AiUsageSummaryResponse"];
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
     get_current_organization_attributes_v1_organizations_attributes_get: {
         parameters: {
             query?: {