@openmeter/sdk 1.0.0-beta.6 → 1.0.0-beta.60

package/dist/schemas/openapi.d.ts

@@ -3,50 +3,137 @@
  * Do not make direct changes to the file.
  */
 export interface paths {
-    "/api/v1/events": {
-        /** @description Ingest events */
-        post: operations["ingestEvents"];
+    '/api/v1/events': {
+        /**
+         * List ingested events
+         * @description List ingested events within a time range.
+         */
+        get: operations['listEvents'];
+        /**
+         * Ingest events
+         * @description Ingests an event or batch of events following the CloudEvents specification.
+         */
+        post: operations['ingestEvents'];
+    };
+    '/api/v1/meters': {
+        /**
+         * List meters
+         * @description List meters.
+         */
+        get: operations['listMeters'];
+        /**
+         * ☁ 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}': {
+        /**
+         * Get meter
+         * @description Get meter by ID or slug
+         */
+        get: operations['getMeter'];
+        /**
+         * ☁ Delete meter
+         * @description *Available in OpenMeter Cloud.*
+         *
+         * Delete a meter by ID or slug.
+         */
+        delete: operations['deleteMeter'];
+    };
+    '/api/v1/meters/{meterIdOrSlug}/query': {
+        /**
+         * Query meter
+         * @description Query meter for usage.
+         */
+        get: operations['queryMeter'];
     };
-    "/api/v1/meters": {
-        /** @description List meters */
-        get: operations["listMeters"];
-        /** @description Create meter */
-        post: operations["createMeter"];
+    '/api/v1/meters/{meterIdOrSlug}/subjects': {
+        /**
+         * List meter subjects
+         * @description List subjects for a meter.
+         */
+        get: operations['listMeterSubjects'];
     };
-    "/api/v1/meters/{meterIdOrSlug}": {
-        /** @description Get meter by slugs */
-        get: operations["getMeter"];
-        /** @description Delete meter by slug */
-        delete: operations["deleteMeter"];
+    '/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/meters/{meterIdOrSlug}/values": {
-        /** @description Get meter values */
-        get: operations["getMeterValues"];
+    '/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/meters/{meterIdOrSlug}/query": {
-        /** @description Query meter */
-        get: operations["queryMeter"];
+    '/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/meters/{meterIdOrSlug}/subjects": {
-        /** @description List meter subjects */
-        get: operations["listMeterSubjects"];
+    '/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/namespaces": {
-        /** @description Create namespace */
-        post: operations["createNamespace"];
+    '/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'];
     };
 }
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
         /**
-         * @description A Problem Details object (RFC 7807)
+         * @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: {
@@ -69,7 +156,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;
             /**
@@ -80,7 +167,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.
@@ -90,7 +192,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;
             /**
@@ -100,7 +202,7 @@ export interface components {
             specversion: string;
             /**
              * @description Describes the type of event related to the originating occurrence.
-             * @example api_request
+             * @example prompt
              */
             type: string;
             /**
@@ -108,7 +210,7 @@ export interface components {
              * @example application/json
              * @enum {string|null}
              */
-            datacontenttype?: "application/json" | null;
+            datacontenttype?: 'application/json' | null;
             /**
              * Format: uri
              * @description Identifies the schema that data adheres to.
@@ -116,7 +218,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;
             /**
@@ -128,14 +230,52 @@ export interface components {
             /**
              * @description The event payload.
              * @example {
-             *   "duration_ms": "12",
-             *   "path": "/hello"
+             *   "tokens": "1234",
+             *   "model": "gpt-4-turbo"
              * }
              */
             data?: {
                 [key: string]: unknown;
             };
         };
+        /**
+         * @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 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.
@@ -143,363 +283,705 @@ export interface components {
              */
             id?: string;
             /**
-             * @description A unique identifier for the meter.
-             * @example my-meter
+             * @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 My Meter Description
+             * @example AI Token Usage
              */
             description?: string | null;
-            aggregation: components["schemas"]["MeterAggregation"];
+            aggregation: components['schemas']['MeterAggregation'];
+            windowSize: components['schemas']['WindowSize'];
             /**
              * @description The event type to aggregate.
-             * @example api_request
+             * @example prompt
              */
             eventType: string;
             /**
              * @description JSONPath expression to extract the value from the event data.
-             * @example $.duration_ms
+             * @example $.tokens
              */
             valueProperty?: string;
             /**
-             * @description Named JSONPath expressions to extract the group by values from the event data.
+             * @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 {
-             *   "duration_ms": "$.duration_ms",
-             *   "path": "$.path"
+             *   "model": "$.model",
+             *   "type": "$.type"
              * }
              */
             groupBy?: {
                 [key: string]: string;
             };
-            windowSize: components["schemas"]["WindowSize"];
         };
         /**
          * @description The aggregation type to use for the meter.
+         * @example SUM
          * @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;
+        MeterAggregation: 'SUM' | '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 */
-            windowStart: string | null;
-            /** Format: date-time */
-            windowEnd: string | null;
-            /** @description The subject of the meter value. */
+            /**
+             * 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;
         };
-        IdOrSlug: string;
-        Namespace: {
+        /**
+         * @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;
             /**
-             * @description A namespace
-             * @example my-namesapce
+             * Format: date-time
+             * @example 2023-02-01T00:00:00Z
              */
-            namespace: string;
+            currentPeriodEnd?: string | null;
+            /** @example cus_JMOlctsKV8 */
+            stripeCustomerId?: string | null;
         };
+        /**
+         * @description A unique identifier.
+         * @example tokens_total
+         */
+        IdOrSlug: string;
     };
     responses: {
         /** @description Bad Request */
         BadRequestProblemResponse: {
             content: {
-                "application/problem+json": components["schemas"]["Problem"];
+                'application/problem+json': components['schemas']['Problem'];
             };
         };
-        /** @description Method not allowed, feature not supported */
-        MethodNotAllowedProblemResponse: {
+        /** @description Unauthorized */
+        UnauthorizedProblemResponse: {
             content: {
-                "application/problem+json": components["schemas"]["Problem"];
+                'application/problem+json': components['schemas']['Problem'];
             };
         };
         /** @description Not Found */
         NotFoundProblemResponse: {
             content: {
-                "application/problem+json": components["schemas"]["Problem"];
+                'application/problem+json': components['schemas']['Problem'];
             };
         };
         /** @description Not Implemented */
         NotImplementedProblemResponse: {
             content: {
-                "application/problem+json": components["schemas"]["Problem"];
+                'application/problem+json': components['schemas']['Problem'];
             };
         };
         /** @description Unexpected error */
         UnexpectedProblemResponse: {
             content: {
-                "application/problem+json": components["schemas"]["Problem"];
+                'application/problem+json': components['schemas']['Problem'];
             };
         };
     };
     parameters: {
         /** @description A unique identifier for the meter. */
-        meterIdOrSlug: components["schemas"]["IdOrSlug"];
-        /** @description Optional namespace */
-        namespaceParam?: string;
+        meterIdOrSlug: components['schemas']['IdOrSlug'];
+        /** @description A unique identifier for a subject. */
+        subjectIdOrKey: string;
+        /**
+         * @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 and group 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 {
-    /** @description Ingest events */
-    ingestEvents: {
+    /**
+     * List ingested events
+     * @description List ingested events within a time range.
+     */
+    listEvents: {
         parameters: {
-            header?: {
-                "OM-Namespace"?: components["parameters"]["namespaceParam"];
+            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"][];
+                'application/cloudevents+json': components['schemas']['Event'];
+                'application/cloudevents-batch+json': components['schemas']['Event'][];
             };
         };
         responses: {
-            /** @description OK */
+            /** @description Successfully ingested. */
             204: {
                 content: never;
             };
-            400: components["responses"]["BadRequestProblemResponse"];
-            default: components["responses"]["UnexpectedProblemResponse"];
+            400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
         };
     };
-    /** @description List meters */
+    /**
+     * List meters
+     * @description List meters.
+     */
     listMeters: {
-        parameters: {
-            header?: {
-                "OM-Namespace"?: components["parameters"]["namespaceParam"];
-            };
-        };
         responses: {
-            /** @description Meters response */
+            /** @description List of meters. */
             200: {
                 content: {
-                    "application/json": components["schemas"]["Meter"][];
+                    'application/json': components['schemas']['Meter'][];
                 };
             };
-            default: components["responses"]["UnexpectedProblemResponse"];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
         };
     };
-    /** @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.
+     */
     createMeter: {
-        parameters: {
-            header?: {
-                "OM-Namespace"?: components["parameters"]["namespaceParam"];
-            };
-        };
+        /** @description The meter to create. */
         requestBody: {
             content: {
-                "application/json": components["schemas"]["Meter"];
+                'application/json': components['schemas']['Meter'];
             };
         };
         responses: {
-            /** @description Created */
+            /** @description Created. */
             201: {
                 content: {
-                    "application/json": components["schemas"]["Meter"];
+                    'application/json': components['schemas']['Meter'];
                 };
             };
-            400: components["responses"]["BadRequestProblemResponse"];
-            501: components["responses"]["NotImplementedProblemResponse"];
-            default: components["responses"]["UnexpectedProblemResponse"];
+            400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            501: components['responses']['NotImplementedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
         };
     };
-    /** @description Get meter by slugs */
+    /**
+     * Get meter
+     * @description Get meter by ID or slug
+     */
     getMeter: {
         parameters: {
-            header?: {
-                "OM-Namespace"?: components["parameters"]["namespaceParam"];
-            };
             path: {
-                meterIdOrSlug: components["parameters"]["meterIdOrSlug"];
+                meterIdOrSlug: components['parameters']['meterIdOrSlug'];
             };
         };
         responses: {
-            /** @description OK */
+            /** @description Meter found. */
             200: {
                 content: {
-                    "application/json": components["schemas"]["Meter"];
+                    'application/json': components['schemas']['Meter'];
                 };
             };
-            404: components["responses"]["NotFoundProblemResponse"];
-            default: components["responses"]["UnexpectedProblemResponse"];
+            404: components['responses']['NotFoundProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
         };
     };
-    /** @description Delete meter by slug */
+    /**
+     * ☁ Delete meter
+     * @description *Available in OpenMeter Cloud.*
+     *
+     * Delete a meter by ID or slug.
+     */
     deleteMeter: {
         parameters: {
-            header?: {
-                "OM-Namespace"?: components["parameters"]["namespaceParam"];
-            };
             path: {
-                meterIdOrSlug: components["parameters"]["meterIdOrSlug"];
+                meterIdOrSlug: components['parameters']['meterIdOrSlug'];
             };
         };
         responses: {
-            /** @description No Content */
+            /** @description Meter deleted. */
             204: {
                 content: never;
             };
-            404: components["responses"]["NotFoundProblemResponse"];
-            501: components["responses"]["NotImplementedProblemResponse"];
-            default: components["responses"]["UnexpectedProblemResponse"];
+            404: components['responses']['NotFoundProblemResponse'];
+            501: components['responses']['NotImplementedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
         };
     };
-    /** @description Get meter values */
-    getMeterValues: {
+    /**
+     * Query meter
+     * @description Query meter for usage.
+     */
+    queryMeter: {
         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;
+                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'];
             };
-            header?: {
-                "OM-Namespace"?: components["parameters"]["namespaceParam"];
+        };
+        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"];
+                meterIdOrSlug: components['parameters']['meterIdOrSlug'];
             };
         };
         responses: {
-            /** @description OK */
+            /** @description List of subjects. */
             200: {
                 content: {
-                    "application/json": {
-                        windowSize?: components["schemas"]["WindowSize"];
-                        data: components["schemas"]["MeterValue"][];
-                    };
+                    'application/json': string[];
                 };
             };
-            400: components["responses"]["BadRequestProblemResponse"];
-            default: components["responses"]["UnexpectedProblemResponse"];
+            400: components['responses']['BadRequestProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
         };
     };
-    /** @description Query meter */
-    queryMeter: {
+    /**
+     * ☁ 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: {
                 /**
-                 * @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.
+                 * @example {
+                 *   "subject": "customer-id",
+                 *   "allowedMeterSlugs": [
+                 *     "tokens_total"
+                 *   ]
+                 * }
                  */
-                aggregation?: components["schemas"]["MeterAggregation"];
-                subject?: string[];
-                /** @description If not specified a single aggregate will be returned for each subject and time window. */
-                groupBy?: string[];
+                'application/json': components['schemas']['PortalToken'];
+            };
+        };
+        responses: {
+            /** @description Created. */
+            200: {
+                content: {
+                    'application/json': components['schemas']['PortalToken'];
+                };
             };
-            header?: {
-                "OM-Namespace"?: components["parameters"]["namespaceParam"];
+            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;
+                };
             };
-            path: {
-                meterIdOrSlug: components["parameters"]["meterIdOrSlug"];
+        };
+        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 OK */
+            /** @description List of subjects. */
             200: {
                 content: {
-                    "application/json": {
-                        /** Format: date-time */
-                        from?: string;
-                        /** Format: date-time */
-                        to?: string;
-                        windowSize?: components["schemas"]["WindowSize"];
-                        data: components["schemas"]["MeterQueryRow"][];
-                    };
+                    'application/json': components['schemas']['Subject'][];
                 };
             };
-            400: components["responses"]["BadRequestProblemResponse"];
-            default: components["responses"]["UnexpectedProblemResponse"];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
         };
     };
-    /** @description List meter subjects */
-    listMeterSubjects: {
-        parameters: {
-            header?: {
-                "OM-Namespace"?: components["parameters"]["namespaceParam"];
+    /**
+     * ☁ 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/json': components['schemas']['Subject'][];
+            };
+        };
+        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'];
+        };
+    };
+    /**
+     * ☁ Get subject
+     * @description *Available in OpenMeter Cloud.*
+     *
+     * Get subject by ID or key.
+     */
+    getSubject: {
+        parameters: {
             path: {
-                meterIdOrSlug: components["parameters"]["meterIdOrSlug"];
+                subjectIdOrKey: components['parameters']['subjectIdOrKey'];
             };
         };
         responses: {
-            /** @description OK */
+            /** @description Subject found. */
             200: {
                 content: {
-                    "application/json": string[];
+                    'application/json': components['schemas']['Subject'];
                 };
             };
-            400: components["responses"]["BadRequestProblemResponse"];
-            default: components["responses"]["UnexpectedProblemResponse"];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            404: components['responses']['NotFoundProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
         };
     };
-    /** @description Create namespace */
-    createNamespace: {
-        requestBody: {
-            content: {
-                "application/json": components["schemas"]["Namespace"];
+    /**
+     * ☁ Delete subject
+     * @description *Available in OpenMeter Cloud.*
+     *
+     * Delete a subject by ID or key.
+     */
+    deleteSubject: {
+        parameters: {
+            path: {
+                subjectIdOrKey: components['parameters']['subjectIdOrKey'];
             };
         };
         responses: {
-            /** @description Created */
-            201: {
+            /** @description Subject deleted. */
+            204: {
                 content: never;
             };
-            default: components["responses"]["UnexpectedProblemResponse"];
+            400: components['responses']['BadRequestProblemResponse'];
+            401: components['responses']['UnauthorizedProblemResponse'];
+            404: components['responses']['NotFoundProblemResponse'];
+            501: components['responses']['NotImplementedProblemResponse'];
+            default: components['responses']['UnexpectedProblemResponse'];
+        };
+    };
+    /**
+     * Query portal meter
+     * @description Query meter for consumer portal. This endpoint is publicly exposable to consumers.
+     */
+    queryPortalMeter: {
+        parameters: {
+            query?: {
+                from?: components['parameters']['queryFrom'];
+                to?: components['parameters']['queryTo'];
+                windowSize?: components['parameters']['queryWindowSize'];
+                windowTimeZone?: components['parameters']['queryWindowTimeZone'];
+                filterGroupBy?: components['parameters']['queryFilterGroupBy'];
+                groupBy?: components['parameters']['queryGroupBy'];
+            };
+            path: {
+                /** @description A unique identifier for the meter. */
+                meterSlug: string;
+            };
+        };
+        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'];
         };
     };
 }