@openrouter/sdk 1.2.4 → 1.2.5

package/esm/funcs/analyticsGetUserActivity.d.ts

@@ -13,7 +13,7 @@ import { Result } from "../types/fp.js";
  * Get user activity grouped by endpoint
  *
  * @remarks
- * Returns user activity data grouped by endpoint for the last 30 (completed) UTC days. [Management key](/docs/guides/overview/auth/management-api-keys) required.
+ * Returns user activity data grouped by endpoint for the last 30 (completed) UTC days. Pass `workspace_id` to scope the response to a single workspace. Pass `group_by=workspace` to split each row per workspace and include `workspace_id` on every item; by default rows are aggregated across workspaces and `workspace_id` is not returned. Activity recorded before workspace resolution existed is permanently attributed to the account default workspace (no backfill is possible). [Management key](/docs/guides/overview/auth/management-api-keys) required.
  */
 export declare function analyticsGetUserActivity(client: OpenRouterCore, request?: operations.GetUserActivityRequest | undefined, options?: RequestOptions): APIPromise<Result<models.ActivityResponse, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.ForbiddenResponseError | errors.NotFoundResponseError | errors.InternalServerResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
 //# sourceMappingURL=analyticsGetUserActivity.d.ts.map

package/esm/funcs/analyticsGetUserActivity.js

@@ -17,7 +17,7 @@ import { APIPromise } from "../types/async.js";
  * Get user activity grouped by endpoint
  *
  * @remarks
- * Returns user activity data grouped by endpoint for the last 30 (completed) UTC days. [Management key](/docs/guides/overview/auth/management-api-keys) required.
+ * Returns user activity data grouped by endpoint for the last 30 (completed) UTC days. Pass `workspace_id` to scope the response to a single workspace. Pass `group_by=workspace` to split each row per workspace and include `workspace_id` on every item; by default rows are aggregated across workspaces and `workspace_id` is not returned. Activity recorded before workspace resolution existed is permanently attributed to the account default workspace (no backfill is possible). [Management key](/docs/guides/overview/auth/management-api-keys) required.
  */
 export function analyticsGetUserActivity(client, request, options) {
     return new APIPromise($do(client, request, options));
@@ -33,7 +33,9 @@ async function $do(client, request, options) {
     const query = encodeFormQuery({
         "api_key_hash": payload?.api_key_hash,
         "date": payload?.date,
+        "group_by": payload?.group_by,
         "user_id": payload?.user_id,
+        "workspace_id": payload?.workspace_id,
     });
     const headers = new Headers(compactMap({
         Accept: "application/json",

package/esm/lib/config.d.ts

@@ -49,8 +49,8 @@ export declare function serverURLFromOptions(options: SDKOptions): URL | null;
 export declare const SDK_METADATA: {
     readonly language: "typescript";
     readonly openapiDocVersion: "1.0.0";
-    readonly sdkVersion: "1.2.4";
+    readonly sdkVersion: "1.2.5";
     readonly genVersion: "2.914.0";
-    readonly userAgent: "speakeasy-sdk/typescript 1.2.4 2.914.0 1.0.0 @openrouter/sdk";
+    readonly userAgent: "speakeasy-sdk/typescript 1.2.5 2.914.0 1.0.0 @openrouter/sdk";
 };
 //# sourceMappingURL=config.d.ts.map

package/esm/lib/config.js

@@ -26,8 +26,8 @@ export function serverURLFromOptions(options) {
 export const SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "1.0.0",
-    sdkVersion: "1.2.4",
+    sdkVersion: "1.2.5",
     genVersion: "2.914.0",
-    userAgent: "speakeasy-sdk/typescript 1.2.4 2.914.0 1.0.0 @openrouter/sdk",
+    userAgent: "speakeasy-sdk/typescript 1.2.5 2.914.0 1.0.0 @openrouter/sdk",
 };
 //# sourceMappingURL=config.js.map

package/esm/models/activityitem.d.ts

@@ -46,6 +46,10 @@ export type ActivityItem = {
      * Total cost in USD (OpenRouter credits spent)
      */
     usage: number;
+    /**
+     * ID of the workspace this activity is attributed to. Only present when `group_by=workspace` is passed; the response is then split per workspace. Activity recorded before workspace resolution existed is attributed to the account default workspace.
+     */
+    workspaceId?: string | undefined;
 };
 /** @internal */
 export declare const ActivityItem$inboundSchema: z.ZodType<ActivityItem, unknown>;

package/esm/models/activityitem.js

@@ -19,6 +19,7 @@ export const ActivityItem$inboundSchema = z
     reasoning_tokens: z.int(),
     requests: z.int(),
     usage: z.number(),
+    workspace_id: z.string().optional(),
 }).transform((v) => {
     return remap$(v, {
         "byok_usage_inference": "byokUsageInference",
@@ -28,6 +29,7 @@ export const ActivityItem$inboundSchema = z
         "prompt_tokens": "promptTokens",
         "provider_name": "providerName",
         "reasoning_tokens": "reasoningTokens",
+        "workspace_id": "workspaceId",
     });
 });
 export function activityItemFromJSON(jsonString) {

package/esm/models/generationresponse.d.ts

@@ -211,6 +211,10 @@ export type GenerationResponseData = {
      * The resolved web search engine used for this generation (e.g. exa, firecrawl, parallel)
      */
     webSearchEngine: string | null;
+    /**
+     * ID of the workspace this generation is attributed to. Null for accounts without workspaces. Generations created before workspace resolution existed are attributed to the account default workspace.
+     */
+    workspaceId: string | null;
 };
 /**
  * Generation response

package/esm/models/generationresponse.js

@@ -78,6 +78,7 @@ export const GenerationResponseData$inboundSchema = z.object({
     usage: z.number(),
     user_agent: z.nullable(z.string()),
     web_search_engine: z.nullable(z.string()),
+    workspace_id: z.nullable(z.string()),
 }).transform((v) => {
     return remap$(v, {
         "api_type": "apiType",
@@ -116,6 +117,7 @@ export const GenerationResponseData$inboundSchema = z.object({
         "upstream_inference_cost": "upstreamInferenceCost",
         "user_agent": "userAgent",
         "web_search_engine": "webSearchEngine",
+        "workspace_id": "workspaceId",
     });
 });
 export function generationResponseDataFromJSON(jsonString) {

package/esm/models/operations/getuseractivity.d.ts

@@ -1,4 +1,5 @@
 import * as z from "zod/v4";
+import { ClosedEnum } from "../../types/enums.js";
 export type GetUserActivityGlobals = {
     /**
      * The app identifier should be your app's URL and is used as the primary identifier for rankings.
@@ -20,6 +21,16 @@ export type GetUserActivityGlobals = {
      */
     appCategories?: string | undefined;
 };
+/**
+ * Set to 'workspace' to split each row per workspace and include `workspace_id` on every item. Omitted by default, in which case rows are aggregated across workspaces (by date, model, and endpoint) and `workspace_id` is not returned — preserving the historical response shape.
+ */
+export declare const GroupBy: {
+    readonly Workspace: "workspace";
+};
+/**
+ * Set to 'workspace' to split each row per workspace and include `workspace_id` on every item. Omitted by default, in which case rows are aggregated across workspaces (by date, model, and endpoint) and `workspace_id` is not returned — preserving the historical response shape.
+ */
+export type GroupBy = ClosedEnum<typeof GroupBy>;
 export type GetUserActivityRequest = {
     /**
      * The app identifier should be your app's URL and is used as the primary identifier for rankings.
@@ -52,8 +63,18 @@ export type GetUserActivityRequest = {
      * Filter by org member user ID. Only applicable for organization accounts.
      */
     userId?: string | undefined;
+    /**
+     * Set to 'workspace' to split each row per workspace and include `workspace_id` on every item. Omitted by default, in which case rows are aggregated across workspaces (by date, model, and endpoint) and `workspace_id` is not returned — preserving the historical response shape.
+     */
+    groupBy?: GroupBy | undefined;
+    /**
+     * Filter by workspace ID (UUID). Returns only activity attributed to that workspace. The workspace must belong to the authenticated account.
+     */
+    workspaceId?: string | undefined;
 };
 /** @internal */
+export declare const GroupBy$outboundSchema: z.ZodEnum<typeof GroupBy>;
+/** @internal */
 export type GetUserActivityRequest$Outbound = {
     "HTTP-Referer"?: string | undefined;
     appTitle?: string | undefined;
@@ -61,6 +82,8 @@ export type GetUserActivityRequest$Outbound = {
     date?: string | undefined;
     api_key_hash?: string | undefined;
     user_id?: string | undefined;
+    group_by?: string | undefined;
+    workspace_id?: string | undefined;
 };
 /** @internal */
 export declare const GetUserActivityRequest$outboundSchema: z.ZodType<GetUserActivityRequest$Outbound, GetUserActivityRequest>;

package/esm/models/operations/getuseractivity.js

@@ -4,6 +4,14 @@
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../../lib/primitives.js";
+/**
+ * Set to 'workspace' to split each row per workspace and include `workspace_id` on every item. Omitted by default, in which case rows are aggregated across workspaces (by date, model, and endpoint) and `workspace_id` is not returned — preserving the historical response shape.
+ */
+export const GroupBy = {
+    Workspace: "workspace",
+};
+/** @internal */
+export const GroupBy$outboundSchema = z.enum(GroupBy);
 /** @internal */
 export const GetUserActivityRequest$outboundSchema = z.object({
     httpReferer: z.string().optional(),
@@ -12,11 +20,15 @@ export const GetUserActivityRequest$outboundSchema = z.object({
     date: z.string().optional(),
     apiKeyHash: z.string().optional(),
     userId: z.string().optional(),
+    groupBy: GroupBy$outboundSchema.optional(),
+    workspaceId: z.string().optional(),
 }).transform((v) => {
     return remap$(v, {
         httpReferer: "HTTP-Referer",
         apiKeyHash: "api_key_hash",
         userId: "user_id",
+        groupBy: "group_by",
+        workspaceId: "workspace_id",
     });
 });
 export function getUserActivityRequestToJSON(getUserActivityRequest) {

package/esm/models/operations/queryanalytics.d.ts

@@ -68,7 +68,7 @@ export type ClassifierFilters = {
 };
 export type Value2 = string | number;
 /**
- * Filter value (scalar or array depending on operator). Several dimensions are enriched in responses (returned as human-readable labels), but filters must use the underlying ID: `api_key_id` — numeric ID (from generation metadata) or key hash (64-char hex from GET /api/v1/keys, resolved server-side); `user` — Clerk user ID (e.g. "user_abc123"), not the display name; `workspace` — workspace UUID, not the workspace name; `app` — numeric app ID, not the app title; `model` — permaslug (e.g. "openai/gpt-4o"), not the display name. Other dimensions (provider, origin, country, etc.) are not enriched and accept the value as returned.
+ * Filter value (scalar or array depending on operator). Several dimensions are enriched in responses (returned as human-readable labels), but filters must use the underlying ID: `api_key_id` — numeric ID (from generation metadata) or key hash (64-char hex from GET /api/v1/keys, resolved server-side); `user` — Clerk user ID (e.g. "user_abc123"), not the display name; `workspace` — workspace UUID, not the workspace name (filtering or grouping by the account default workspace also covers activity recorded before workspace resolution existed, which is attributed to that default workspace); `app` — numeric app ID, not the app title; `model` — permaslug (e.g. "openai/gpt-4o"), not the display name. Other dimensions (provider, origin, country, etc.) are not enriched and accept the value as returned.
  */
 export type Value1 = string | number | Array<string | number>;
 export type Filter = {
@@ -81,7 +81,7 @@ export type Filter = {
      */
     operator: string;
     /**
-     * Filter value (scalar or array depending on operator). Several dimensions are enriched in responses (returned as human-readable labels), but filters must use the underlying ID: `api_key_id` — numeric ID (from generation metadata) or key hash (64-char hex from GET /api/v1/keys, resolved server-side); `user` — Clerk user ID (e.g. "user_abc123"), not the display name; `workspace` — workspace UUID, not the workspace name; `app` — numeric app ID, not the app title; `model` — permaslug (e.g. "openai/gpt-4o"), not the display name. Other dimensions (provider, origin, country, etc.) are not enriched and accept the value as returned.
+     * Filter value (scalar or array depending on operator). Several dimensions are enriched in responses (returned as human-readable labels), but filters must use the underlying ID: `api_key_id` — numeric ID (from generation metadata) or key hash (64-char hex from GET /api/v1/keys, resolved server-side); `user` — Clerk user ID (e.g. "user_abc123"), not the display name; `workspace` — workspace UUID, not the workspace name (filtering or grouping by the account default workspace also covers activity recorded before workspace resolution existed, which is attributed to that default workspace); `app` — numeric app ID, not the app title; `model` — permaslug (e.g. "openai/gpt-4o"), not the display name. Other dimensions (provider, origin, country, etc.) are not enriched and accept the value as returned.
      */
     value: string | number | Array<string | number>;
 };

package/esm/sdk/analytics.d.ts

@@ -6,7 +6,7 @@ export declare class Analytics extends ClientSDK {
      * Get user activity grouped by endpoint
      *
      * @remarks
-     * Returns user activity data grouped by endpoint for the last 30 (completed) UTC days. [Management key](/docs/guides/overview/auth/management-api-keys) required.
+     * Returns user activity data grouped by endpoint for the last 30 (completed) UTC days. Pass `workspace_id` to scope the response to a single workspace. Pass `group_by=workspace` to split each row per workspace and include `workspace_id` on every item; by default rows are aggregated across workspaces and `workspace_id` is not returned. Activity recorded before workspace resolution existed is permanently attributed to the account default workspace (no backfill is possible). [Management key](/docs/guides/overview/auth/management-api-keys) required.
      */
     getUserActivity(request?: operations.GetUserActivityRequest | undefined, options?: RequestOptions): Promise<models.ActivityResponse>;
 }

package/esm/sdk/analytics.js

@@ -10,7 +10,7 @@ export class Analytics extends ClientSDK {
      * Get user activity grouped by endpoint
      *
      * @remarks
-     * Returns user activity data grouped by endpoint for the last 30 (completed) UTC days. [Management key](/docs/guides/overview/auth/management-api-keys) required.
+     * Returns user activity data grouped by endpoint for the last 30 (completed) UTC days. Pass `workspace_id` to scope the response to a single workspace. Pass `group_by=workspace` to split each row per workspace and include `workspace_id` on every item; by default rows are aggregated across workspaces and `workspace_id` is not returned. Activity recorded before workspace resolution existed is permanently attributed to the account default workspace (no backfill is possible). [Management key](/docs/guides/overview/auth/management-api-keys) required.
      */
     async getUserActivity(request, options) {
         return unwrapAsync(analyticsGetUserActivity(this, request, options));

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@openrouter/sdk",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "author": "OpenRouter",
   "description": "The OpenRouter TypeScript SDK is a type-safe toolkit for building AI applications with access to 400+ language models through a unified API.",
   "keywords": [
@@ -74,14 +74,14 @@
     "build": "tsc",
     "prepublishOnly": "npm run build",
     "postinstall": "node scripts/check-types.js || true",
+    "prepare": "npm run build",
+    "test": "vitest --run --project unit",
+    "test:watch": "vitest --watch --project unit",
     "typecheck": "tsc --noEmit",
     "typecheck:transit": "exit 0",
     "compile": "tsc",
-    "prepare": "npm run build",
-    "test": "vitest --run --project unit",
     "test:e2e": "vitest --run --project e2e",
-    "test:transit": "exit 0",
-    "test:watch": "vitest --watch --project unit"
+    "test:transit": "exit 0"
   },
   "peerDependencies": {},
   "devDependencies": {