@openmeter/sdk 1.0.0-beta.9 → 1.0.0-beta.91

package/dist/schemas/openapi.d.ts

@@ -4,55 +4,320 @@
  */
 export interface paths {
     '/api/v1/events': {
-        /** @description Retrieve latest raw events. */
+        /**
+         * List ingested events
+         * @description List ingested events within a time range.
+         */
         get: operations['listEvents'];
-        /** @description Ingest events */
+        /**
+         * Ingest events
+         * @description Ingests an event or batch of events following the CloudEvents specification.
+         */
         post: operations['ingestEvents'];
     };
     '/api/v1/meters': {
-        /** @description List meters */
+        /**
+         * List meters
+         * @description List meters.
+         */
         get: operations['listMeters'];
-        /** @description Create meter */
+        /**
+         * ☁ Create meter
+         * @description *Available in OpenMeter Cloud.*
+         * *In the open-source version, meters are created in the configuration file.*
+         *
+         * Create a meter.
+         */
         post: operations['createMeter'];
     };
     '/api/v1/meters/{meterIdOrSlug}': {
-        /** @description Get meter by slugs */
+        /**
+         * Get meter
+         * @description Get meter by ID or slug
+         */
         get: operations['getMeter'];
-        /** @description Delete meter by slug */
-        delete: operations['deleteMeter'];
-    };
-    '/api/v1/meters/{meterIdOrSlug}/values': {
         /**
-         * @deprecated
-         * @description Get meter values
-         * Deprecated: use /api/v1/meters/{meter}/query instead.
+         * ☁ Delete meter
+         * @description *Available in OpenMeter Cloud.*
+         *
+         * Delete a meter by ID or slug.
          */
-        get: operations['getMeterValues'];
+        delete: operations['deleteMeter'];
     };
     '/api/v1/meters/{meterIdOrSlug}/query': {
-        /** @description Query meter */
+        /**
+         * Query meter
+         * @description Query meter for usage.
+         */
         get: operations['queryMeter'];
     };
     '/api/v1/meters/{meterIdOrSlug}/subjects': {
-        /** @description List meter subjects */
+        /**
+         * List meter subjects
+         * @description List subjects for a meter.
+         */
         get: operations['listMeterSubjects'];
     };
-    '/api/v1/namespaces': {
-        /** @description Create namespace */
-        post: operations['createNamespace'];
+    '/api/v1/portal/tokens': {
+        /**
+         * ☁ List portal tokens
+         * @description *Available in OpenMeter Cloud.*
+         *
+         * List consumer portal tokens.
+         */
+        get: operations['listPortalTokens'];
+        /**
+         * Create portal token
+         * @description Create a consumer portal token.
+         */
+        post: operations['createPortalToken'];
+    };
+    '/api/v1/portal/tokens/invalidate': {
+        /**
+         * ☁ Invalidate portal tokens
+         * @description *Available in OpenMeter Cloud.*
+         *
+         * Invalidates consumer portal tokens by ID or subject.
+         */
+        post: operations['invalidatePortalTokens'];
+    };
+    '/api/v1/subjects': {
+        /**
+         * ☁ List subjects
+         * @description *Available in OpenMeter Cloud.*
+         *
+         * List subjects.
+         */
+        get: operations['listSubjects'];
+        /**
+         * ☁ Upsert subject
+         * @description *Available in OpenMeter Cloud.*
+         *
+         * Upserts a subject. Creates or updates subject.
+         * If the subject doesn't exist, it will be created.
+         * If the subject exists, it will be partially updated with the provided fields.
+         */
+        post: operations['upsertSubject'];
+    };
+    '/api/v1/subjects/{subjectIdOrKey}': {
+        /**
+         * ☁ Get subject
+         * @description *Available in OpenMeter Cloud.*
+         *
+         * Get subject by ID or key.
+         */
+        get: operations['getSubject'];
+        /**
+         * ☁ Delete subject
+         * @description *Available in OpenMeter Cloud.*
+         *
+         * Delete a subject by ID or key.
+         */
+        delete: operations['deleteSubject'];
+    };
+    '/api/v1/portal/meters/{meterSlug}/query': {
+        /**
+         * Query portal meter
+         * @description Query meter for consumer portal. This endpoint is publicly exposable to consumers.
+         */
+        get: operations['queryPortalMeter'];
+    };
+    '/api/v1/entitlements': {
+        /**
+         * List entitlements
+         * @description List entitlements.
+         */
+        get: operations['listEntitlements'];
+    };
+    '/api/v1/features': {
+        /**
+         * List features
+         * @description List features.
+         */
+        get: operations['listFeatures'];
+        /**
+         * Create feature
+         * @description Creates a feature.
+         */
+        post: operations['createFeature'];
+    };
+    '/api/v1/features/{featureId}': {
+        /**
+         * Get feature
+         * @description Get feature by id.
+         */
+        get: operations['getFeature'];
+        /**
+         * Delete feature
+         * @description Delete a feature by key.
+         */
+        delete: operations['deleteFeature'];
+    };
+    '/api/v1/grants': {
+        /**
+         * List grants
+         * @description List all grants.
+         */
+        get: operations['listGrants'];
+    };
+    '/api/v1/grants/{grantId}': {
+        /**
+         * Delete a grant
+         * @description Void (delete) a grant. A grant can only be deleted if it hasn't been used.
+         */
+        delete: operations['voidGrant'];
+    };
+    '/api/v1/subjects/{subjectIdOrKey}/entitlements': {
+        /**
+         * List entitlements
+         * @description List all entitlements for a subject.
+         */
+        get: operations['listSubjectEntitlements'];
+        /**
+         * Create entitlement
+         * @description Create an entitlement for a subject.
+         */
+        post: operations['createEntitlement'];
+    };
+    '/api/v1/subjects/{subjectIdOrKey}/entitlements/{entitlementId}': {
+        /**
+         * Get entitlement
+         * @description Get entitlement by id.
+         */
+        get: operations['getEntitlement'];
+        /**
+         * Delete entitlement
+         * @description Delete an entitlement by id.
+         */
+        delete: operations['deleteEntitlement'];
+    };
+    '/api/v1/subjects/{subjectIdOrKey}/entitlements/{entitlementId}/grants': {
+        /**
+         * List grants for an entitlement
+         * @description List all grants for an entitlement.
+         */
+        get: operations['listEntitlementGrants'];
+        /**
+         * Create grant
+         * @description Create a grant for an entitlement.
+         */
+        post: operations['createGrant'];
+    };
+    '/api/v1/subjects/{subjectIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/value': {
+        /**
+         * Get the balance of a specific entitlement.
+         * @description Get the balance of a specific entitlement.
+         */
+        get: operations['getEntitlementValue'];
+    };
+    '/api/v1/subjects/{subjectIdOrKey}/entitlements/{entitlementId}/history': {
+        /**
+         * Get the balance history of a specific entitlement.
+         * @description Get the balance history of a specific entitlement.
+         *
+         * The windows are inclusive at their start and exclusive at their end.
+         * The last window may be smaller than the window size and is inclusive at both ends.
+         */
+        get: operations['getEntitlementHistory'];
+    };
+    '/api/v1/subjects/{subjectIdOrKey}/entitlements/{entitlementId}/reset': {
+        /**
+         * Reset entitlement
+         * @description Reset the entitlement usage and start a new period. Grants that can be are rolled over.
+         */
+        post: operations['resetEntitlementUsage'];
     };
 }
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
         /**
-         * @description A Problem Details object (RFC 7807)
+         * @description Metadata fields for a resource.
+         * These fields are automatically populated by the system for the entities we manage.
+         */
+        SharedMetaFields: {
+            /**
+             * @description Readonly unique ULID identifier.
+             *
+             * @example 01ARZ3NDEKTSV4RRFFQ69G5FAV
+             */
+            id: string;
+            /**
+             * Format: date-time
+             * @description The date and time the resource was created.
+             * @example 2023-01-01T00:00:00Z
+             */
+            createdAt: string;
+            /**
+             * Format: date-time
+             * @description The date and time the resource was last updated.
+             * @example 2023-01-01T00:00:00Z
+             */
+            updatedAt: string;
+            /**
+             * Format: date-time
+             * @description The date and time the resource was deleted.
+             * @example null
+             */
+            deletedAt: string | null;
+        };
+        /**
+         * @description Conflict
+         * @example {
+         *   "type": "about:blank",
+         *   "title": "Conflict",
+         *   "status": 409,
+         *   "detail": "ledger (default.01HXVNDJR532E8GTBVSC2XK5D4) already exitst for subject subject-1",
+         *   "instance": "urn:request:local/JMOlctsKV8-000001",
+         *   "conflictingEntityId": "01HXVNDJR532E8GTBVSC2XK5D4"
+         * }
+         */
+        ConflictProblem: {
+            /**
+             * Format: uri
+             * @description Type contains a URI that identifies the problem type.
+             * @example urn:problem-type:bad-request
+             */
+            type: string;
+            /**
+             * @description A a short, human-readable summary of the problem type.
+             * @example Bad Request
+             */
+            title: string;
+            /**
+             * Format: int32
+             * @description The HTTP status code generated by the origin server for this occurrence of the problem.
+             * @example 400
+             */
+            status: number;
+            /**
+             * @description A human-readable explanation specific to this occurrence of the problem.
+             * @example body must be a JSON object
+             */
+            detail: string;
+            /**
+             * Format: uri
+             * @description A URI reference that identifies the specific occurrence of the problem.
+             * @example urn:request:local/JMOlctsKV8-000001
+             */
+            instance?: string;
+            extensions?: {
+                /**
+                 * @description The id of the conflicting entity.
+                 * @example 01ARZ3NDEKTSV4RRFFQ69G5FAV
+                 */
+                conflictingEntityId: string;
+            };
+            [key: string]: unknown;
+        };
+        /**
+         * @description A Problem Details object (RFC 7807).
+         * Additional properties specific to the problem type may be present.
          * @example {
          *   "type": "urn:problem-type:bad-request",
          *   "title": "Bad Request",
          *   "status": 400,
-         *   "detail": "header Content-Type has unexpected value \"application/xml\"",
-         *   "instance": "urn:request:local/JMOlctsKV8-000001"
+         *   "detail": "body must be a JSON object"
          * }
          */
         Problem: {
@@ -75,7 +340,7 @@ export interface components {
             status: number;
             /**
              * @description A human-readable explanation specific to this occurrence of the problem.
-             * @example header Content-Type has unexpected value \"application/xml\"
+             * @example body must be a JSON object
              */
             detail: string;
             /**
@@ -86,7 +351,22 @@ export interface components {
             instance?: string;
             [key: string]: unknown;
         };
-        /** @description CloudEvents Specification JSON Schema */
+        /**
+         * @description CloudEvents Specification JSON Schema
+         * @example {
+         *   "id": "5c10fade-1c9e-4d6c-8275-c52c36731d3c",
+         *   "source": "service-name",
+         *   "specversion": "1.0",
+         *   "type": "prompt",
+         *   "subject": "customer-id",
+         *   "time": "2023-01-01T01:01:01.001Z",
+         *   "data": {
+         *     "tokens": "1234",
+         *     "model": "gpt-4-turbo",
+         *     "type": "input"
+         *   }
+         * }
+         */
         Event: {
             /**
              * @description Identifies the event.
@@ -96,7 +376,7 @@ export interface components {
             /**
              * Format: uri-reference
              * @description Identifies the context in which an event happened.
-             * @example services/service-0
+             * @example service-name
              */
             source: string;
             /**
@@ -106,7 +386,7 @@ export interface components {
             specversion: string;
             /**
              * @description Describes the type of event related to the originating occurrence.
-             * @example api_request
+             * @example prompt
              */
             type: string;
             /**
@@ -122,7 +402,7 @@ export interface components {
             dataschema?: string | null;
             /**
              * @description Describes the subject of the event in the context of the event producer (identified by source).
-             * @example customer_id
+             * @example customer-id
              */
             subject: string;
             /**
@@ -134,405 +414,1608 @@ export interface components {
             /**
              * @description The event payload.
              * @example {
-             *   "duration_ms": "12",
-             *   "path": "/hello"
+             *   "tokens": "1234",
+             *   "model": "gpt-4-turbo"
              * }
              */
             data?: {
                 [key: string]: unknown;
             };
         };
-        Meter: {
+        /**
+         * @description An ingested event with optional validation error.
+         * @example {
+         *   "event": {
+         *     "id": "5c10fade-1c9e-4d6c-8275-c52c36731d3d",
+         *     "source": "service-name",
+         *     "specversion": "1.0",
+         *     "type": "prompt",
+         *     "subject": "customer-id",
+         *     "time": "2023-01-01T01:01:01.001Z",
+         *     "data": {
+         *       "tokens": "1234",
+         *       "model": "gpt-4-turbo"
+         *     }
+         *   },
+         *   "validationError": "meter not found for event"
+         * }
+         */
+        IngestedEvent: {
+            event: components['schemas']['Event'];
+            /** @example invalid event */
+            validationError?: string;
+        };
+        /**
+         * @description A feature is a feature or service offered to a customer.
+         * For example: CPU-Hours, Tokens, API Calls, etc.
+         */
+        FeatureCreateInputs: {
             /**
-             * @description A unique identifier for the meter.
-             * @example 01G65Z755AFWAKHE12NY0CQ9FH
+             * @description The unique key of the feature to reference it from your application.
+             *
+             * @example gpt4_tokens
              */
-            id?: string;
+            key: string;
             /**
-             * @description A unique identifier for the meter.
-             * @example my-meter
+             * @description The name of the feature.
+             *
+             * @example AI Tokens
              */
-            slug: string;
+            name: string;
+            /** @description Additional metadata for the feature. */
+            metadata?: {
+                [key: string]: string;
+            };
             /**
-             * @description A description of the meter.
-             * @example My Meter Description
+             * @description The meter that the feature is associated with and decreases grants by usage.
+             * If present, the usage of the feature can be metered.
+             *
+             * @example tokens_total
              */
-            description?: string | null;
-            aggregation: components['schemas']['MeterAggregation'];
+            meterSlug?: string;
             /**
-             * @description The event type to aggregate.
-             * @example api_request
+             * @description Optional meter group by filters. Useful if the meter scope is broader than what feature tracks.
+             *
+             * @example {
+             *   "model": "gpt-4"
+             * }
              */
-            eventType: string;
+            meterGroupByFilters?: {
+                [key: string]: string;
+            };
+        };
+        /**
+         * @description A feature is a feature or service offered to a customer.
+         * For example: CPU-Hours, Tokens, API Calls, etc.
+         */
+        Feature: {
             /**
-             * @description JSONPath expression to extract the value from the event data.
-             * @example $.duration_ms
+             * Format: date-time
+             * @description If the feature is archived, it will not be used for grants or usage.
+             *
+             * @example 2023-01-01T00:00:00Z
              */
-            valueProperty?: string;
+            archivedAt?: string;
+        } & components['schemas']['FeatureCreateInputs'] & components['schemas']['SharedMetaFields'];
+        EntitlementCreateSharedFields: {
+            /**
+             * @description The feature the subject is entitled to use
+             *
+             * @example 01ARZ3NDEKTSV4RRFFQ69G5FAV
+             */
+            featureId: string;
+            /** @description Additional metadata for the feature. */
+            metadata?: {
+                [key: string]: string;
+            };
+            usagePeriod?: components['schemas']['RecurringPeriod'];
+        };
+        EntitlementSharedFields: components['schemas']['SharedMetaFields'] & components['schemas']['EntitlementCreateSharedFields'] & {
+            /**
+             * @description The identifier key unique to the subject
+             * @example customer-1
+             */
+            subjectKey: string;
+            usagePeriod?: components['schemas']['RecurringPeriod'];
+        };
+        EntitlementMeteredCreateInputs: components['schemas']['EntitlementCreateSharedFields'] & {
+            /**
+             * @example metered
+             * @enum {string}
+             */
+            type: 'metered';
+            /**
+             * @description If unlimited=true the subject can use the feature an unlimited amount.
+             *
+             * @default false
+             */
+            isUnlimited?: boolean;
+            usagePeriod: components['schemas']['RecurringPeriod'];
+            /** @description You can issue usage automatically after reset. This usage is not rolled over. */
+            issueAfterReset?: number;
+        };
+        /** @description Entitles a subject to use a feature. */
+        EntitlementMetered: components['schemas']['EntitlementMeteredCreateInputs'] & components['schemas']['EntitlementSharedFields'];
+        EntitlementStaticCreateInputs: components['schemas']['EntitlementCreateSharedFields'] & {
+            /**
+             * @example static
+             * @enum {string}
+             */
+            type: 'static';
+            /**
+             * @description The JSON parsable config of the entitlement.
+             *
+             * @example {"key1": "value1"}
+             */
+            config: string;
+        };
+        /** @description Entitles a subject to use a feature. */
+        EntitlementStatic: components['schemas']['EntitlementStaticCreateInputs'] & components['schemas']['EntitlementSharedFields'];
+        EntitlementBooleanCreateInputs: components['schemas']['EntitlementCreateSharedFields'] & {
+            /**
+             * @example boolean
+             * @enum {string}
+             */
+            type: 'boolean';
+        };
+        /** @description Entitles a subject to use a feature. */
+        EntitlementBoolean: components['schemas']['EntitlementBooleanCreateInputs'] & components['schemas']['EntitlementSharedFields'];
+        Entitlement: components['schemas']['EntitlementMetered'] | components['schemas']['EntitlementStatic'] | components['schemas']['EntitlementBoolean'];
+        /**
+         * @description A segment of the grant burn down history.
+         *
+         * A given segment represents the usage of a grant in a specific period.
+         */
+        GrantBurnDownHistorySegment: {
+            period?: components['schemas']['Period'];
+            /**
+             * Format: double
+             * @description The usage of the grant in the period.
+             *
+             * @example 100
+             */
+            usage?: number;
+            /**
+             * Format: double
+             * @description Overuse that wasn't covered by grants.
+             *
+             * @example 25
+             */
+            overage?: number;
+            /**
+             * Format: double
+             * @description The entitlement balance at the start of the period.
+             *
+             * @example 100
+             */
+            balanceAtStart?: number;
             /**
-             * @description Named JSONPath expressions to extract the group by values from the event data.
+             * @description The balance breakdown of each active grant at the start of the period: GrantID: Balance
+             *
              * @example {
-             *   "duration_ms": "$.duration_ms",
-             *   "path": "$.path"
+             *   "01ARZ3NDEKTSV4RRFFQ69G5FAV": 100
              * }
              */
-            groupBy?: {
-                [key: string]: string;
+            grantBalancesAtStart?: {
+                [key: string]: number;
             };
-            windowSize: components['schemas']['WindowSize'];
+            /**
+             * Format: double
+             * @description The entitlement balance at the end of the period.
+             *
+             * @example 100
+             */
+            balanceAtEnd?: number;
+            /**
+             * @description The balance breakdown of each active grant at the start of the period: GrantID: Balance
+             *
+             * @example {
+             *   "01ARZ3NDEKTSV4RRFFQ69G5FAV": 100
+             * }
+             */
+            grantBalancesAtEnd?: {
+                [key: string]: number;
+            };
+            /** @description Which grants were actually burnt down in the period and by what amount. */
+            grantUsages?: readonly components['schemas']['GrantUsageRecord'][];
+        };
+        GrantUsageRecord: {
+            /**
+             * @description The id of the grant.
+             *
+             * @example 01ARZ3NDEKTSV4RRFFQ69G5FAV
+             */
+            grantId?: string;
+            /**
+             * Format: double
+             * @description The usage of the grant.
+             *
+             * @example 100
+             */
+            usage?: number;
+        };
+        /** @description A window of balance history. */
+        BalanceHistoryWindow: {
+            period?: components['schemas']['Period'];
+            /**
+             * Format: double
+             * @description The total usage of the feature in the period.
+             *
+             * @example 100
+             */
+            usage?: number;
+            /**
+             * Format: double
+             * @description The entitlement balance at the start of the period.
+             *
+             * @example 100
+             */
+            balanceAtStart?: number;
+        };
+        /** @description The windowed balance history. */
+        WindowedBalanceHistory: {
+            /**
+             * @description The windowed balance history.
+             * Only returns rows for windows where there was usage.
+             */
+            windowedHistory?: components['schemas']['BalanceHistoryWindow'][];
+            /** @description The grant burn down history in the period. */
+            burndownHistory?: components['schemas']['GrantBurnDownHistorySegment'][];
+        };
+        /** @description A time period */
+        Period: {
+            /**
+             * Format: date-time
+             * @description Period start time where the amount was applied. If applicable.
+             *
+             * @example 2023-01-01T00:00:00Z
+             */
+            from: string;
+            /**
+             * Format: date-time
+             * @description Period end time where the amount was applied. If applicable.
+             *
+             * @example 2023-01-01T00:00:00Z
+             */
+            to: string;
         };
         /**
-         * @description The aggregation type to use for the meter.
+         * @description List of pre-defined periods that can be used for recurring & scheduling.
+         *
+         * DAILY:      Every day
+         * # MONDAY:     Every Monday
+         * # TUESDAY:    Every Tuesday
+         * # WEDNESDAY:  Every Wednesday
+         * # THURSDAY:   Every Thursday
+         * # FRIDAY:     Every Friday
+         * # SATURDAY:   Every Saturday
+         * # SUNDAY:     Every Sunday
+         * WEEKLY:     Every week
+         * MONTHLY:    Every month
+         * YEARLY:     Every year
+         * BILLING:    Every billing cycle
+         *
          * @enum {string}
          */
-        MeterAggregation: 'SUM' | 'COUNT' | 'AVG' | 'MIN' | 'MAX';
-        /** @enum {string} */
-        WindowSize: 'MINUTE' | 'HOUR' | 'DAY';
-        MeterValue: {
-            /** @description The subject of the meter value. */
-            subject?: string;
-            /** Format: date-time */
-            windowStart: string;
-            /** Format: date-time */
-            windowEnd: string;
-            value: number;
-            groupBy?: {
-                [key: string]: string;
-            } | null;
+        RecurringPeriodEnum: 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'YEARLY' | 'BILLING';
+        /** @description Recurring period of an entitlement. */
+        RecurringPeriod: {
+            interval: components['schemas']['RecurringPeriodEnum'];
+            /**
+             * Format: date-time
+             * @description An arbitrary anchor to base the recurring period on.
+             */
+            anchor: string;
         };
-        MeterQueryRow: {
-            value: number;
-            /** Format: date-time */
-            windowStart: string;
-            /** Format: date-time */
-            windowEnd: string;
-            /** @description The subject of the meter value. */
-            subject?: string | null;
-            groupBy?: {
+        /** @description Grants are used to increase balance of specific subjects. */
+        EntitlementGrantCreateInput: {
+            /**
+             * Format: double
+             * @description The amount to grant. Should be a positive number.
+             *
+             * @example 100
+             */
+            amount: number;
+            /**
+             * @description The priority of the grant. Grants with higher priority are applied first.
+             * Priority is a positive decimal numbers. With lower numbers indicating higher importance.
+             * For example, a priority of 1 is more urgent than a priority of 2.
+             * When there are several grants available for the same subject, the system selects the grant with the highest priority.
+             * In cases where grants share the same priority level, the grant closest to its expiration will be used first.
+             * In the case of two grants have identical priorities and expiration dates, the system will use the grant that was created first.
+             *
+             * @default 1
+             * @example 1
+             */
+            priority?: number;
+            /**
+             * Format: date-time
+             * @description The effective time. Provided value will be ceiled to metering windowSize (minute).
+             *
+             * @example 2023-01-01T00:00:00Z
+             */
+            effectiveAt: string;
+            expiration: components['schemas']['ExpirationPeriod'];
+            /**
+             * Format: double
+             * @description The maximum amount of the grant that can be rolled over. Defaults to 0.
+             *
+             * - maxAmount = {original_amount} -> rollover original amount
+             * - maxAmount = 0 -> no rollover
+             * - maxAmount = 90 -> rollover 90 max
+             *
+             * If it's larger than 0 then the grant's balance will be the MAX(maxRollover, balance) + amount.
+             *
+             * @default 0
+             * @example 100
+             */
+            maxRolloverAmount?: number;
+            /**
+             * @example {
+             *   "stripePaymentId": "pi_4OrAkhLvyihio9p51h9iiFnB"
+             * }
+             */
+            metadata?: {
                 [key: string]: string;
-            } | null;
+            };
+            recurrence?: components['schemas']['RecurringPeriod'];
         };
-        IdOrSlug: string;
-        Namespace: {
+        EntitlementGrant: components['schemas']['EntitlementGrantCreateInput'] & components['schemas']['SharedMetaFields'] & {
             /**
-             * @description A namespace
-             * @example my-namesapce
+             * @description The unique entitlement ULID that the grant is associated with.
+             *
+             * @example 01ARZ3NDEKTSV4RRFFQ69G5FAV
              */
-            namespace: string;
+            entitlementId: string;
+            /**
+             * @description The subject that is granted the entitlement.
+             *
+             * @example customer-id
+             */
+            subjectKey: string;
+            /**
+             * Format: date-time
+             * @description The next time the grant will recurr.
+             *
+             * @example 2023-01-01T00:00:00Z
+             */
+            nextRecurrence?: string;
+            /**
+             * Format: date-time
+             * @description The expiration date of the grant.
+             *
+             * @example 2023-01-01T00:00:00Z
+             */
+            expiresAt?: string;
+            /**
+             * Format: date-time
+             * @description The date and time the grant was voided (cannot be used after that).
+             */
+            voidedAt?: string;
+        };
+        EntitlementValue: {
+            /**
+             * @description Whether the subject has access to the feature.
+             * @example true
+             */
+            hasAccess: boolean;
+            /**
+             * Format: double
+             * @description The balance of a metered entitlement.
+             * @example 100
+             */
+            balance?: number;
+            /**
+             * Format: double
+             * @description Total usage of the feature in the period. Includes overages.
+             * @example 50
+             */
+            usage?: number;
+            /**
+             * Format: double
+             * @description The overage of a metered entitlement.
+             * @example 0
+             */
+            overage?: number;
+            /**
+             * @description The JSON parseable configuration value of a static entitlement.
+             * @example {"key1": "value1"}
+             */
+            config?: string;
+        };
+        /** @description Expiration period of a grant. */
+        ExpirationPeriod: {
+            /**
+             * @description The expiration period duration like month.
+             *
+             * @enum {string}
+             */
+            duration: 'HOUR' | 'DAY' | 'WEEK' | 'MONTH' | 'YEAR';
+            /**
+             * @description The expiration period count like 12 months.
+             *
+             * @example 12
+             */
+            count: number;
+        };
+        /**
+         * @description A meter is a configuration that defines how to match and aggregate events.
+         * @example {
+         *   "slug": "tokens_total",
+         *   "description": "AI token usage",
+         *   "aggregation": "SUM",
+         *   "windowSize": "MINUTE",
+         *   "eventType": "prompt",
+         *   "valueProperty": "$.tokens",
+         *   "groupBy": {
+         *     "model": "$.model",
+         *     "type": "$.type"
+         *   }
+         * }
+         */
+        Meter: {
+            /**
+             * @description A unique identifier for the meter.
+             * @example 01G65Z755AFWAKHE12NY0CQ9FH
+             */
+            id?: string;
+            /**
+             * @description A unique, human-readable identifier for the meter. Must consist only alphanumeric and underscore characters.
+             * @example tokens_total
+             */
+            slug: string;
+            /**
+             * @description A description of the meter.
+             * @example AI Token Usage
+             */
+            description?: string | null;
+            aggregation: components['schemas']['MeterAggregation'];
+            windowSize: components['schemas']['WindowSize'];
+            /**
+             * @description The event type to aggregate.
+             * @example prompt
+             */
+            eventType: string;
+            /**
+             * @description JSONPath expression to extract the value from the ingested event's data property.
+             * The ingested value for SUM, AVG, MIN, and MAX aggregations is a number or a string that can be parsed to a number.
+             * For UNIQUE_COUNT aggregation, the ingested value must be a string. For COUNT aggregation the valueProperty is ignored.
+             *
+             * @example $.tokens
+             */
+            valueProperty?: string;
+            /**
+             * @description Named JSONPath expressions to extract the group by values from the event data. Keys must be unique and consist only alphanumeric and underscore characters.
+             * @example {
+             *   "model": "$.model",
+             *   "type": "$.type"
+             * }
+             */
+            groupBy?: {
+                [key: string]: string;
+            };
+        };
+        /**
+         * @description The aggregation type to use for the meter.
+         * @example SUM
+         * @enum {string}
+         */
+        MeterAggregation: 'SUM' | 'COUNT' | 'UNIQUE_COUNT' | 'AVG' | 'MIN' | 'MAX';
+        /**
+         * @description Aggregation window size.
+         * @example MINUTE
+         * @enum {string}
+         */
+        WindowSize: 'MINUTE' | 'HOUR' | 'DAY';
+        /**
+         * @description The result of a meter query.
+         * @example {
+         *   "from": "2023-01-01T00:00:00Z",
+         *   "to": "2023-01-02T00:00:00Z",
+         *   "windowSize": "MINUTE",
+         *   "data": [
+         *     {
+         *       "value": 12,
+         *       "windowStart": "2023-01-01T00:00:00Z",
+         *       "windowEnd": "2023-01-02T00:00:00Z",
+         *       "subject": "customer-id",
+         *       "groupBy": {
+         *         "model": "gpt-4-turbo",
+         *         "type": "prompt"
+         *       }
+         *     }
+         *   ]
+         * }
+         */
+        MeterQueryResult: {
+            /**
+             * Format: date-time
+             * @example 2023-01-01T00:00:00Z
+             */
+            from?: string;
+            /**
+             * Format: date-time
+             * @example 2023-01-02T00:00:00Z
+             */
+            to?: string;
+            windowSize?: components['schemas']['WindowSize'];
+            /**
+             * @example [
+             *   {
+             *     "value": 12,
+             *     "windowStart": "2023-01-01T00:00:00Z",
+             *     "windowEnd": "2023-01-02T00:00:00Z",
+             *     "subject": "customer-id",
+             *     "groupBy": {
+             *       "model": "gpt-4-turbo",
+             *       "type": "prompt"
+             *     }
+             *   }
+             * ]
+             */
+            data: components['schemas']['MeterQueryRow'][];
+        };
+        /**
+         * @description A row in the result of a meter query.
+         * @example {
+         *   "value": 12,
+         *   "windowStart": "2023-01-01T00:00:00Z",
+         *   "windowEnd": "2023-01-02T00:00:00Z",
+         *   "subject": "customer-id",
+         *   "groupBy": {
+         *     "model": "gpt-4-turbo",
+         *     "type": "prompt"
+         *   }
+         * }
+         */
+        MeterQueryRow: {
+            /** @example 12 */
+            value: number;
+            /**
+             * Format: date-time
+             * @example 2023-01-01T00:00:00Z
+             */
+            windowStart: string;
+            /**
+             * Format: date-time
+             * @example 2023-01-02T00:00:00Z
+             */
+            windowEnd: string;
+            /**
+             * @description The subject of the meter value.
+             * @example customer-id
+             */
+            subject?: string | null;
+            /**
+             * @example {
+             *   "model": "gpt-4-turbo",
+             *   "type": "prompt"
+             * }
+             */
+            groupBy?: {
+                [key: string]: string;
+            } | null;
+        };
+        /**
+         * @description A consumer portal token.
+         * @example {
+         *   "id": "01G65Z755AFWAKHE12NY0CQ9FH",
+         *   "subject": "customer-id",
+         *   "expiresAt": "2023-01-02T00:00:00Z",
+         *   "expired": false,
+         *   "createdAt": "2023-01-01T00:00:00Z",
+         *   "token": "om_portal_IAnD3PpWW2A2Wr8m9jfzeHlGX8xmCXwG.y5q4S-AWqFu6qjfaFz0zQq4Ez28RsnyVwJffX5qxMvo",
+         *   "allowedMeterSlugs": [
+         *     "tokens_total"
+         *   ]
+         * }
+         */
+        PortalToken: {
+            /** @example 01G65Z755AFWAKHE12NY0CQ9FH */
+            id?: string;
+            /** @example customer-id */
+            subject: string;
+            /**
+             * Format: date-time
+             * @example 2023-01-02T00:00:00Z
+             */
+            expiresAt?: string;
+            expired?: boolean;
+            /**
+             * Format: date-time
+             * @example 2023-01-01T00:00:00Z
+             */
+            createdAt?: string;
+            /**
+             * @description The token is only returned at creation.
+             * @example om_portal_IAnD3PpWW2A2Wr8m9jfzeHlGX8xmCXwG.y5q4S-AWqFu6qjfaFz0zQq4Ez28RsnyVwJffX5qxMvo
+             */
+            token?: string;
+            /**
+             * @description Optional, if defined only the specified meters will be allowed
+             * @example [
+             *   "tokens_total"
+             * ]
+             */
+            allowedMeterSlugs?: string[];
+        };
+        /**
+         * @description A subject is a unique identifier for a user or entity.
+         * @example {
+         *   "id": "01G65Z755AFWAKHE12NY0CQ9FH",
+         *   "key": "customer-id",
+         *   "displayName": "Customer Name",
+         *   "metadata": {
+         *     "hubspotId": "123456"
+         *   },
+         *   "currentPeriodStart": "2023-01-01T00:00:00Z",
+         *   "currentPeriodEnd": "2023-02-01T00:00:00Z",
+         *   "stripeCustomerId": "cus_JMOlctsKV8"
+         * }
+         */
+        Subject: {
+            /** @example 01G65Z755AFWAKHE12NY0CQ9FH */
+            id?: string;
+            /** @example customer-id */
+            key: string;
+            /** @example Customer Name */
+            displayName?: string | null;
+            /**
+             * @example {
+             *   "hubspotId": "123456"
+             * }
+             */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Format: date-time
+             * @example 2023-01-01T00:00:00Z
+             */
+            currentPeriodStart?: string | null;
+            /**
+             * Format: date-time
+             * @example 2023-02-01T00:00:00Z
+             */
+            currentPeriodEnd?: string | null;
+            /** @example cus_JMOlctsKV8 */
+            stripeCustomerId?: string | null;
+        };
+        /**
+         * @description A unique identifier.
+         * @example tokens_total
+         */
+        IdOrSlug: string;
+    };
+    responses: {
+        /** @description Ledger Exists */
+        ConflictProblemResponse: {
+            content: {
+                'application/problem+json': components['schemas']['ConflictProblem'];
+            };
+        };
+        /** @description Bad Request */
+        BadRequestProblemResponse: {
+            content: {
+                'application/problem+json': components['schemas']['Problem'];
+            };
+        };
+        /** @description Unauthorized */
+        UnauthorizedProblemResponse: {
+            content: {
+                'application/problem+json': components['schemas']['Problem'];
+            };
+        };
+        /** @description Not Found */
+        NotFoundProblemResponse: {
+            content: {
+                'application/problem+json': components['schemas']['Problem'];
+            };
+        };
+        /** @description Not Implemented */
+        NotImplementedProblemResponse: {
+            content: {
+                'application/problem+json': components['schemas']['Problem'];
+            };
+        };
+        /** @description Unexpected error */
+        UnexpectedProblemResponse: {
+            content: {
+                'application/problem+json': components['schemas']['Problem'];
+            };
+        };
+    };
+    parameters: {
+        /** @description A unique identifier for the meter. */
+        meterIdOrSlug: components['schemas']['IdOrSlug'];
+        /** @description A unique identifier for a subject. */
+        subjectIdOrKey: string;
+        /** @description A unique ULID identifier for a feature. */
+        featureId: string;
+        /** @description A unique identifier for a grant. */
+        grantId: string;
+        /** @description A unique ULID for an entitlement. */
+        entitlementId: string;
+        /** @description The id of the entitlement or the key of the feature. */
+        entitlementIdOrFeatureKey: string;
+        /** @description Include deleted entries. */
+        includeDeleted?: boolean;
+        /** @description Number of entries to return */
+        queryLimit?: number;
+        /** @description Number of entries to skip */
+        queryOffset?: number;
+        /**
+         * @description Start date-time in RFC 3339 format.
+         * Inclusive.
+         */
+        queryFrom?: string;
+        /**
+         * @description End date-time in RFC 3339 format.
+         * Inclusive.
+         */
+        queryTo?: string;
+        /** @description If not specified, a single usage aggregate will be returned for the entirety of the specified period for each subject and group. */
+        queryWindowSize?: components['schemas']['WindowSize'];
+        /**
+         * @description The value is the name of the time zone as defined in the IANA Time Zone Database (http://www.iana.org/time-zones).
+         * If not specified, the UTC timezone will be used.
+         */
+        queryWindowTimeZone?: string;
+        /**
+         * @description Filtering by multiple subjects.
+         *
+         * Usage: ?subject=customer-1&subject=customer-2
+         */
+        queryFilterSubject?: string[];
+        queryFilterGroupBy?: {
+            [key: string]: string;
+        };
+        /**
+         * @description If not specified a single aggregate will be returned for each subject and time window.
+         * `subject` is a reserved group by value.
+         */
+        queryGroupBy?: string[];
+    };
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export type external = Record<string, never>;
+export interface operations {
+    /**
+     * List ingested events
+     * @description List ingested events within a time range.
+     */
+    listEvents: {
+        parameters: {
+            query?: {
+                from?: components['parameters']['queryFrom'];
+                to?: components['parameters']['queryTo'];
+                /** @description Number of events to return */
+                limit?: number;
+            };
+        };
+        responses: {
+            /** @description List of events for debugging. */
+            200: {
+                content: {
+                    'application/json': components['schemas']['IngestedEvent'][];
+                };
+            };
+            400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
+    };
+    /**
+     * Ingest events
+     * @description Ingests an event or batch of events following the CloudEvents specification.
+     */
+    ingestEvents: {
+        /**
+         * @description The event or batch of events to ingest.
+         * The request body must be a CloudEvents JSON object or an array of CloudEvents JSON objects.
+         * The CloudEvents JSON object must adhere to the CloudEvents Specification JSON Schema.
+         */
+        requestBody: {
+            content: {
+                'application/cloudevents+json': components['schemas']['Event'];
+                'application/cloudevents-batch+json': components['schemas']['Event'][];
+            };
+        };
+        responses: {
+            /** @description Successfully ingested. */
+            204: {
+                content: never;
+            };
+            400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
+    };
+    /**
+     * List meters
+     * @description List meters.
+     */
+    listMeters: {
+        responses: {
+            /** @description List of meters. */
+            200: {
+                content: {
+                    'application/json': components['schemas']['Meter'][];
+                };
+            };
+            401: components['responses']['UnauthorizedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
+    };
+    /**
+     * ☁ Create meter
+     * @description *Available in OpenMeter Cloud.*
+     * *In the open-source version, meters are created in the configuration file.*
+     *
+     * Create a meter.
+     */
+    createMeter: {
+        /** @description The meter to create. */
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['Meter'];
+            };
+        };
+        responses: {
+            /** @description Created. */
+            201: {
+                content: {
+                    'application/json': components['schemas']['Meter'];
+                };
+            };
+            400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            501: components['responses']['NotImplementedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
+    };
+    /**
+     * Get meter
+     * @description Get meter by ID or slug
+     */
+    getMeter: {
+        parameters: {
+            path: {
+                meterIdOrSlug: components['parameters']['meterIdOrSlug'];
+            };
+        };
+        responses: {
+            /** @description Meter found. */
+            200: {
+                content: {
+                    'application/json': components['schemas']['Meter'];
+                };
+            };
+            404: components['responses']['NotFoundProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
+    };
+    /**
+     * ☁ Delete meter
+     * @description *Available in OpenMeter Cloud.*
+     *
+     * Delete a meter by ID or slug.
+     */
+    deleteMeter: {
+        parameters: {
+            path: {
+                meterIdOrSlug: components['parameters']['meterIdOrSlug'];
+            };
+        };
+        responses: {
+            /** @description Meter deleted. */
+            204: {
+                content: never;
+            };
+            404: components['responses']['NotFoundProblemResponse'];
+            501: components['responses']['NotImplementedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
+    };
+    /**
+     * Query meter
+     * @description Query meter for usage.
+     */
+    queryMeter: {
+        parameters: {
+            query?: {
+                from?: components['parameters']['queryFrom'];
+                to?: components['parameters']['queryTo'];
+                windowSize?: components['parameters']['queryWindowSize'];
+                windowTimeZone?: components['parameters']['queryWindowTimeZone'];
+                subject?: components['parameters']['queryFilterSubject'];
+                filterGroupBy?: components['parameters']['queryFilterGroupBy'];
+                groupBy?: components['parameters']['queryGroupBy'];
+            };
+            path: {
+                meterIdOrSlug: components['parameters']['meterIdOrSlug'];
+            };
+        };
+        responses: {
+            /** @description Usage data. */
+            200: {
+                content: {
+                    'application/json': components['schemas']['MeterQueryResult'];
+                    'text/csv': string;
+                };
+            };
+            400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
+    };
+    /**
+     * List meter subjects
+     * @description List subjects for a meter.
+     */
+    listMeterSubjects: {
+        parameters: {
+            path: {
+                meterIdOrSlug: components['parameters']['meterIdOrSlug'];
+            };
+        };
+        responses: {
+            /** @description List of subjects. */
+            200: {
+                content: {
+                    'application/json': string[];
+                };
+            };
+            400: components['responses']['BadRequestProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
+    };
+    /**
+     * ☁ List portal tokens
+     * @description *Available in OpenMeter Cloud.*
+     *
+     * List consumer portal tokens.
+     */
+    listPortalTokens: {
+        parameters: {
+            query?: {
+                /** @description Number of portal tokens to return. Default is 25. */
+                limit?: number;
+            };
+        };
+        responses: {
+            /** @description List of portal tokens. */
+            200: {
+                content: {
+                    'application/json': components['schemas']['PortalToken'][];
+                };
+            };
+            400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            501: components['responses']['NotImplementedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
+    };
+    /**
+     * Create portal token
+     * @description Create a consumer portal token.
+     */
+    createPortalToken: {
+        /** @description The portal token to create. */
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *   "subject": "customer-id",
+                 *   "allowedMeterSlugs": [
+                 *     "tokens_total"
+                 *   ]
+                 * }
+                 */
+                'application/json': components['schemas']['PortalToken'];
+            };
+        };
+        responses: {
+            /** @description Created. */
+            200: {
+                content: {
+                    'application/json': components['schemas']['PortalToken'];
+                };
+            };
+            400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
+    };
+    /**
+     * ☁ Invalidate portal tokens
+     * @description *Available in OpenMeter Cloud.*
+     *
+     * Invalidates consumer portal tokens by ID or subject.
+     */
+    invalidatePortalTokens: {
+        /** @description If no id or subject is specified, all tokens will be invalidated. */
+        requestBody: {
+            content: {
+                'application/json': {
+                    /** @description Invalidate a portal token by ID. */
+                    id?: string;
+                    /** @description Invalidate all portal tokens for a subject. */
+                    subject?: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Portal tokens invalidated. */
+            204: {
+                content: never;
+            };
+            400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            501: components['responses']['NotImplementedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
+    };
+    /**
+     * ☁ List subjects
+     * @description *Available in OpenMeter Cloud.*
+     *
+     * List subjects.
+     */
+    listSubjects: {
+        responses: {
+            /** @description List of subjects. */
+            200: {
+                content: {
+                    'application/json': components['schemas']['Subject'][];
+                };
+            };
+            401: components['responses']['UnauthorizedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
         };
     };
-    responses: {
-        /** @description Bad Request */
-        BadRequestProblemResponse: {
+    /**
+     * ☁ Upsert subject
+     * @description *Available in OpenMeter Cloud.*
+     *
+     * Upserts a subject. Creates or updates subject.
+     * If the subject doesn't exist, it will be created.
+     * If the subject exists, it will be partially updated with the provided fields.
+     */
+    upsertSubject: {
+        /** @description The subject to upsert. */
+        requestBody: {
             content: {
-                'application/problem+json': components['schemas']['Problem'];
+                'application/json': components['schemas']['Subject'][];
             };
         };
-        /** @description Method not allowed, feature not supported */
-        MethodNotAllowedProblemResponse: {
-            content: {
-                'application/problem+json': components['schemas']['Problem'];
+        responses: {
+            /** @description Subject upserted. */
+            200: {
+                content: {
+                    'application/json': components['schemas']['Subject'][];
+                };
             };
+            400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            501: components['responses']['NotImplementedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
         };
-        /** @description Not Found */
-        NotFoundProblemResponse: {
-            content: {
-                'application/problem+json': components['schemas']['Problem'];
+    };
+    /**
+     * ☁ Get subject
+     * @description *Available in OpenMeter Cloud.*
+     *
+     * Get subject by ID or key.
+     */
+    getSubject: {
+        parameters: {
+            path: {
+                subjectIdOrKey: components['parameters']['subjectIdOrKey'];
             };
         };
-        /** @description Not Implemented */
-        NotImplementedProblemResponse: {
-            content: {
-                'application/problem+json': components['schemas']['Problem'];
+        responses: {
+            /** @description Subject found. */
+            200: {
+                content: {
+                    'application/json': components['schemas']['Subject'];
+                };
             };
+            401: components['responses']['UnauthorizedProblemResponse'];
+            404: components['responses']['NotFoundProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
         };
-        /** @description Unexpected error */
-        UnexpectedProblemResponse: {
-            content: {
-                'application/problem+json': components['schemas']['Problem'];
+    };
+    /**
+     * ☁ Delete subject
+     * @description *Available in OpenMeter Cloud.*
+     *
+     * Delete a subject by ID or key.
+     */
+    deleteSubject: {
+        parameters: {
+            path: {
+                subjectIdOrKey: components['parameters']['subjectIdOrKey'];
             };
         };
+        responses: {
+            /** @description Subject deleted. */
+            204: {
+                content: never;
+            };
+            400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            404: components['responses']['NotFoundProblemResponse'];
+            501: components['responses']['NotImplementedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
     };
-    parameters: {
-        /** @description A unique identifier for the meter. */
-        meterIdOrSlug: components['schemas']['IdOrSlug'];
-        /** @description Optional namespace */
-        namespaceParam?: string;
-    };
-    requestBodies: never;
-    headers: never;
-    pathItems: never;
-}
-export type $defs = Record<string, never>;
-export type external = Record<string, never>;
-export interface operations {
-    /** @description Retrieve latest raw events. */
-    listEvents: {
+    /**
+     * Query portal meter
+     * @description Query meter for consumer portal. This endpoint is publicly exposable to consumers.
+     */
+    queryPortalMeter: {
         parameters: {
             query?: {
-                /** @description Number of events to return. */
-                limit?: number;
+                from?: components['parameters']['queryFrom'];
+                to?: components['parameters']['queryTo'];
+                windowSize?: components['parameters']['queryWindowSize'];
+                windowTimeZone?: components['parameters']['queryWindowTimeZone'];
+                filterGroupBy?: components['parameters']['queryFilterGroupBy'];
+                groupBy?: components['parameters']['queryGroupBy'];
             };
-            header?: {
-                'OM-Namespace'?: components['parameters']['namespaceParam'];
+            path: {
+                /** @description A unique identifier for the meter. */
+                meterSlug: string;
             };
         };
         responses: {
-            /** @description Events response */
+            /** @description Usage data. */
             200: {
                 content: {
-                    'application/json': components['schemas']['Event'][];
+                    'application/json': components['schemas']['MeterQueryResult'];
+                    'text/csv': string;
                 };
             };
             400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
             default: components['responses']['UnexpectedProblemResponse'];
         };
     };
-    /** @description Ingest events */
-    ingestEvents: {
+    /**
+     * List entitlements
+     * @description List entitlements.
+     */
+    listEntitlements: {
+        parameters: {
+            query?: {
+                limit?: components['parameters']['queryLimit'];
+                offset?: components['parameters']['queryOffset'];
+                /** @description Order by field */
+                orderBy?: 'createdAt' | 'updatedAt';
+            };
+        };
+        responses: {
+            /** @description List of entitlements. */
+            200: {
+                content: {
+                    'application/json': components['schemas']['Entitlement'][];
+                };
+            };
+            401: components['responses']['UnauthorizedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
+    };
+    /**
+     * List features
+     * @description List features.
+     */
+    listFeatures: {
         parameters: {
-            header?: {
-                'OM-Namespace'?: components['parameters']['namespaceParam'];
+            query?: {
+                limit?: components['parameters']['queryLimit'];
+                offset?: components['parameters']['queryOffset'];
+                /** @description Order by field */
+                orderBy?: 'id' | 'createdAt' | 'updatedAt';
+                /** @description Include archived features. */
+                includeArchived?: boolean;
+            };
+        };
+        responses: {
+            /** @description List of features. */
+            200: {
+                content: {
+                    'application/json': components['schemas']['Feature'][];
+                };
             };
+            401: components['responses']['UnauthorizedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
         };
+    };
+    /**
+     * Create feature
+     * @description Creates a feature.
+     */
+    createFeature: {
+        /** @description The feature to create. */
         requestBody: {
             content: {
-                'application/cloudevents+json': components['schemas']['Event'];
-                'application/cloudevents-batch+json': components['schemas']['Event'][];
+                'application/json': components['schemas']['FeatureCreateInputs'];
+            };
+        };
+        responses: {
+            /** @description Feature created. */
+            201: {
+                content: {
+                    'application/json': components['schemas']['Feature'];
+                };
+            };
+            400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            501: components['responses']['NotImplementedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
+    };
+    /**
+     * Get feature
+     * @description Get feature by id.
+     */
+    getFeature: {
+        parameters: {
+            path: {
+                featureId: components['parameters']['featureId'];
+            };
+        };
+        responses: {
+            /** @description Feature found. */
+            200: {
+                content: {
+                    'application/json': components['schemas']['Feature'];
+                };
+            };
+            401: components['responses']['UnauthorizedProblemResponse'];
+            404: components['responses']['NotFoundProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
+    };
+    /**
+     * Delete feature
+     * @description Delete a feature by key.
+     */
+    deleteFeature: {
+        parameters: {
+            path: {
+                featureId: components['parameters']['featureId'];
+            };
+        };
+        responses: {
+            /** @description Feature deleted. */
+            204: {
+                content: never;
+            };
+            401: components['responses']['UnauthorizedProblemResponse'];
+            404: components['responses']['NotFoundProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
+    };
+    /**
+     * List grants
+     * @description List all grants.
+     */
+    listGrants: {
+        parameters: {
+            query?: {
+                limit?: components['parameters']['queryLimit'];
+                offset?: components['parameters']['queryOffset'];
+                /** @description Order by field */
+                orderBy?: 'id' | 'createdAt' | 'updatedAt';
+                includeDeleted?: components['parameters']['includeDeleted'];
+            };
+        };
+        responses: {
+            /** @description List of grants. */
+            200: {
+                content: {
+                    'application/json': components['schemas']['EntitlementGrant'][];
+                };
+            };
+            401: components['responses']['UnauthorizedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
+    };
+    /**
+     * Delete a grant
+     * @description Void (delete) a grant. A grant can only be deleted if it hasn't been used.
+     */
+    voidGrant: {
+        parameters: {
+            path: {
+                grantId: components['parameters']['grantId'];
             };
         };
         responses: {
-            /** @description OK */
+            /** @description Grant has been voided. */
             204: {
                 content: never;
             };
             400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            404: components['responses']['NotFoundProblemResponse'];
+            409: components['responses']['ConflictProblemResponse'];
             default: components['responses']['UnexpectedProblemResponse'];
         };
     };
-    /** @description List meters */
-    listMeters: {
+    /**
+     * List entitlements
+     * @description List all entitlements for a subject.
+     */
+    listSubjectEntitlements: {
         parameters: {
-            header?: {
-                'OM-Namespace'?: components['parameters']['namespaceParam'];
+            query?: {
+                includeDeleted?: components['parameters']['includeDeleted'];
+            };
+            path: {
+                subjectIdOrKey: components['parameters']['subjectIdOrKey'];
             };
         };
         responses: {
-            /** @description Meters response */
+            /** @description List of entitlements. */
             200: {
                 content: {
-                    'application/json': components['schemas']['Meter'][];
+                    'application/json': components['schemas']['Entitlement'][];
                 };
             };
+            401: components['responses']['UnauthorizedProblemResponse'];
             default: components['responses']['UnexpectedProblemResponse'];
         };
     };
-    /** @description Create meter */
-    createMeter: {
+    /**
+     * Create entitlement
+     * @description Create an entitlement for a subject.
+     */
+    createEntitlement: {
         parameters: {
-            header?: {
-                'OM-Namespace'?: components['parameters']['namespaceParam'];
+            path: {
+                subjectIdOrKey: components['parameters']['subjectIdOrKey'];
             };
         };
+        /** @description The entitlement to create. */
         requestBody: {
             content: {
-                'application/json': components['schemas']['Meter'];
+                'application/json': components['schemas']['EntitlementMeteredCreateInputs'] | components['schemas']['EntitlementStaticCreateInputs'] | components['schemas']['EntitlementBooleanCreateInputs'];
             };
         };
         responses: {
-            /** @description Created */
+            /** @description Entitlement created. */
             201: {
                 content: {
-                    'application/json': components['schemas']['Meter'];
+                    'application/json': components['schemas']['Entitlement'];
                 };
             };
             400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            409: components['responses']['ConflictProblemResponse'];
             501: components['responses']['NotImplementedProblemResponse'];
             default: components['responses']['UnexpectedProblemResponse'];
         };
     };
-    /** @description Get meter by slugs */
-    getMeter: {
+    /**
+     * Get entitlement
+     * @description Get entitlement by id.
+     */
+    getEntitlement: {
         parameters: {
-            header?: {
-                'OM-Namespace'?: components['parameters']['namespaceParam'];
-            };
             path: {
-                meterIdOrSlug: components['parameters']['meterIdOrSlug'];
+                subjectIdOrKey: components['parameters']['subjectIdOrKey'];
+                entitlementId: components['parameters']['entitlementId'];
             };
         };
         responses: {
-            /** @description OK */
+            /** @description Entitlement found. */
             200: {
                 content: {
-                    'application/json': components['schemas']['Meter'];
+                    'application/json': {
+                        type: 'json';
+                    } & Omit<components['schemas']['Entitlement'], 'type'> & {
+                        /**
+                         * Format: date-time
+                         * @description The last time usage was reset.
+                         * @example 2023-01-01T00:00:00Z
+                         */
+                        lastReset?: string;
+                    };
                 };
             };
+            401: components['responses']['UnauthorizedProblemResponse'];
             404: components['responses']['NotFoundProblemResponse'];
             default: components['responses']['UnexpectedProblemResponse'];
         };
     };
-    /** @description Delete meter by slug */
-    deleteMeter: {
+    /**
+     * Delete entitlement
+     * @description Delete an entitlement by id.
+     */
+    deleteEntitlement: {
         parameters: {
-            header?: {
-                'OM-Namespace'?: components['parameters']['namespaceParam'];
-            };
             path: {
-                meterIdOrSlug: components['parameters']['meterIdOrSlug'];
+                subjectIdOrKey: components['parameters']['subjectIdOrKey'];
+                entitlementId: components['parameters']['entitlementId'];
             };
         };
         responses: {
-            /** @description No Content */
+            /** @description Entitlement deleted. */
             204: {
                 content: never;
             };
+            401: components['responses']['UnauthorizedProblemResponse'];
             404: components['responses']['NotFoundProblemResponse'];
-            501: components['responses']['NotImplementedProblemResponse'];
             default: components['responses']['UnexpectedProblemResponse'];
         };
     };
     /**
-     * @deprecated
-     * @description Get meter values
-     * Deprecated: use /api/v1/meters/{meter}/query instead.
+     * List grants for an entitlement
+     * @description List all grants for an entitlement.
      */
-    getMeterValues: {
+    listEntitlementGrants: {
         parameters: {
             query?: {
-                subject?: string;
-                /**
-                 * @description Start date-time in RFC 3339 format in UTC timezone.
-                 * Must be aligned with the window size.
-                 * Inclusive.
-                 */
-                from?: string;
-                /**
-                 * @description End date-time in RFC 3339 format in UTC timezone.
-                 * Must be aligned with the window size.
-                 * Inclusive.
-                 */
-                to?: string;
-                /** @description If not specified, a single usage aggregate will be returned for the entirety of the specified period for each subject and group. */
-                windowSize?: components['schemas']['WindowSize'];
-                /**
-                 * @description If not specified, OpenMeter will use the default aggregation type.
-                 * As OpenMeter stores aggregates defined by meter config, passing a different aggregate can lead to inaccurate results.
-                 * For example getting the MIN of SUMs.
-                 */
-                aggregation?: components['schemas']['MeterAggregation'];
-                /** @description If not specified a single aggregate will be returned for each subject and time window. */
-                groupBy?: string;
-            };
-            header?: {
-                'OM-Namespace'?: components['parameters']['namespaceParam'];
+                includeDeleted?: components['parameters']['includeDeleted'];
+                /** @description Order by field */
+                orderBy?: 'id' | 'createdAt' | 'updatedAt';
             };
             path: {
-                meterIdOrSlug: components['parameters']['meterIdOrSlug'];
+                subjectIdOrKey: components['parameters']['subjectIdOrKey'];
+                entitlementId: components['parameters']['entitlementId'];
             };
         };
         responses: {
-            /** @description OK */
+            /** @description List of grants. */
             200: {
                 content: {
-                    'application/json': {
-                        windowSize?: components['schemas']['WindowSize'];
-                        data: components['schemas']['MeterValue'][];
-                    };
+                    'application/json': components['schemas']['EntitlementGrant'][];
+                };
+            };
+            401: components['responses']['UnauthorizedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
+    };
+    /**
+     * Create grant
+     * @description Create a grant for an entitlement.
+     */
+    createGrant: {
+        parameters: {
+            path: {
+                subjectIdOrKey: components['parameters']['subjectIdOrKey'];
+                entitlementId: components['parameters']['entitlementId'];
+            };
+        };
+        /** @description The grant to create. */
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['EntitlementGrantCreateInput'];
+            };
+        };
+        responses: {
+            /** @description Grant created. */
+            201: {
+                content: {
+                    'application/json': components['schemas']['EntitlementGrant'];
                 };
             };
             400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            501: components['responses']['NotImplementedProblemResponse'];
             default: components['responses']['UnexpectedProblemResponse'];
         };
     };
-    /** @description Query meter */
-    queryMeter: {
+    /**
+     * Get the balance of a specific entitlement.
+     * @description Get the balance of a specific entitlement.
+     */
+    getEntitlementValue: {
         parameters: {
             query?: {
-                /**
-                 * @description Start date-time in RFC 3339 format in UTC timezone.
-                 * Must be aligned with the window size.
-                 * Inclusive.
-                 */
-                from?: string;
-                /**
-                 * @description End date-time in RFC 3339 format in UTC timezone.
-                 * Must be aligned with the window size.
-                 * Inclusive.
-                 */
-                to?: string;
-                /** @description If not specified, a single usage aggregate will be returned for the entirety of the specified period for each subject and group. */
-                windowSize?: components['schemas']['WindowSize'];
-                /**
-                 * @deprecated
-                 * @description If not specified, OpenMeter will use the default aggregation type.
-                 * As OpenMeter stores aggregates defined by meter config, passing a different aggregate can lead to inaccurate results.
-                 * For example getting the MIN of SUMs.
-                 */
-                aggregation?: components['schemas']['MeterAggregation'];
-                subject?: string[];
-                /** @description If not specified a single aggregate will be returned for each subject and time window. */
-                groupBy?: string[];
-            };
-            header?: {
-                'OM-Namespace'?: components['parameters']['namespaceParam'];
+                /** @description Point of time to check value: date-time in RFC 3339 format. Defaults to now. */
+                time?: string;
             };
             path: {
-                meterIdOrSlug: components['parameters']['meterIdOrSlug'];
+                subjectIdOrKey: components['parameters']['subjectIdOrKey'];
+                entitlementIdOrFeatureKey: components['parameters']['entitlementIdOrFeatureKey'];
             };
         };
         responses: {
-            /** @description OK */
+            /** @description The entitlement value. */
             200: {
                 content: {
-                    'application/json': {
-                        /** Format: date-time */
-                        from?: string;
-                        /** Format: date-time */
-                        to?: string;
-                        windowSize?: components['schemas']['WindowSize'];
-                        data: components['schemas']['MeterQueryRow'][];
-                    };
-                    'text/csv': string;
+                    'application/json': components['schemas']['EntitlementValue'];
                 };
             };
             400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            404: components['responses']['NotFoundProblemResponse'];
             default: components['responses']['UnexpectedProblemResponse'];
         };
     };
-    /** @description List meter subjects */
-    listMeterSubjects: {
+    /**
+     * Get the balance history of a specific entitlement.
+     * @description Get the balance history of a specific entitlement.
+     *
+     * The windows are inclusive at their start and exclusive at their end.
+     * The last window may be smaller than the window size and is inclusive at both ends.
+     */
+    getEntitlementHistory: {
         parameters: {
-            header?: {
-                'OM-Namespace'?: components['parameters']['namespaceParam'];
+            query: {
+                /**
+                 * @description Start of time range to query entitlement: date-time in RFC 3339 format.
+                 * Gets truncated to the granularity of the underlying meter.
+                 */
+                from: string;
+                /**
+                 * @description End of time range to query entitlement: date-time in RFC 3339 format. Defaults to now.
+                 * If not now then gets truncated to the granularity of the underlying meter.
+                 */
+                to?: string;
+                /** @description Size of the time window to group the history by. Cannot be shorter than meter granularity. */
+                windowSize: 'MINUTE' | 'HOUR' | 'DAY';
+                windowTimeZone?: components['parameters']['queryWindowTimeZone'];
             };
             path: {
-                meterIdOrSlug: components['parameters']['meterIdOrSlug'];
+                subjectIdOrKey: components['parameters']['subjectIdOrKey'];
+                entitlementId: components['parameters']['entitlementId'];
             };
         };
         responses: {
-            /** @description OK */
+            /** @description Entitlement balance history. If windowsize is specified then the history is grouped by the window size. */
             200: {
                 content: {
-                    'application/json': string[];
+                    'application/json': components['schemas']['WindowedBalanceHistory'];
                 };
             };
             400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            404: components['responses']['NotFoundProblemResponse'];
             default: components['responses']['UnexpectedProblemResponse'];
         };
     };
-    /** @description Create namespace */
-    createNamespace: {
+    /**
+     * Reset entitlement
+     * @description Reset the entitlement usage and start a new period. Grants that can be are rolled over.
+     */
+    resetEntitlementUsage: {
+        parameters: {
+            path: {
+                subjectIdOrKey: components['parameters']['subjectIdOrKey'];
+                entitlementId: components['parameters']['entitlementId'];
+            };
+        };
         requestBody: {
             content: {
-                'application/json': components['schemas']['Namespace'];
+                'application/json': {
+                    /**
+                     * Format: date-time
+                     * @description The time at which the reset takes effect, defaults to now.
+                     * The reset cannot be in the future.
+                     * The provided value is truncated to the granularity of the underlying meter.
+                     *
+                     * @example 2023-01-01T00:00:00Z
+                     */
+                    effectiveAt?: string;
+                };
             };
         };
         responses: {
-            /** @description Created */
-            201: {
+            /** @description Entitlement reset. */
+            204: {
                 content: never;
             };
+            400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            404: components['responses']['NotFoundProblemResponse'];
             default: components['responses']['UnexpectedProblemResponse'];
         };
     };