portkey-admin-mcp 0.11.0 → 0.11.2

package/ENDPOINTS.md

@@ -1,7 +1,7 @@
 # Portkey Admin API endpoints and MCP tools
 
 Generated from the registered tool catalog by `npm run generate:endpoints`.
-Route mappings were reviewed against the official Portkey OpenAPI on 2026-08-27.
+Route mappings were reviewed against the official Portkey OpenAPI on 2026-08-28.
 
 - Base URL: `https://api.portkey.ai/v1`
 - Authentication: `x-portkey-api-key`
@@ -139,7 +139,7 @@ Routes:
 | `list_virtual_keys` | List provider API keys stored as virtual keys in your Portkey org. Use this to find slugs before wiring prompts/configs or auditing limits. Returns total plus name, slug, status, usage limits, rate limits, reset state, and model config. |
 | `create_virtual_key` | Store a provider API key as a virtual key. The raw key is encrypted and only returned at creation time, so save the returned slug and use it in prompts/configs. Optional usage and rate limits apply immediately, and the tool returns the new slug. |
 | `get_virtual_key` | Fetch one virtual key by slug, including metadata, a masked secret, limits, status, and model config. Use this before updating or to inspect the current configuration. |
-| `update_virtual_key` | Update a virtual key's name, secret, note, or limits. Rotating the key takes effect immediately, and limit changes apply to downstream prompts and configs using this slug. Returns the updated name, slug, and status. |
+| `update_virtual_key` | Update a virtual key's name, secret, note, or limits. Rotating the key takes effect immediately, and limit changes apply to downstream prompts and configs using this slug. Returns success when Portkey accepts the update. |
 | `delete_virtual_key` | Delete a virtual key by slug. This is irreversible and will break prompts and configs that reference the slug, so confirm no active dependencies first. Returns success after removal. |
 | `create_api_key` | Create a Portkey API key for auth. Org keys grant broader access; workspace keys are scoped. WARNING: The key secret is returned ONCE in the tool result and will be visible in MCP transcripts and LLM context — store it securely immediately. Using the key grants access immediately according to its scopes, defaults, and limits. Workspace keys require workspace_id and user keys require user_id. |
 | `list_api_keys` | List Portkey API keys for auditing access, scopes, defaults, limits, and expiration. Use this for API keys only; use list_virtual_keys for provider keys. Returns total plus id, type, status, workspace/user scope, limits, defaults, alert emails, and creation mode. |

package/build/index.js

@@ -124,6 +124,9 @@ async function parseErrorResponse(response) {
 // src/services/base.service.ts
 var DEFAULT_BASE_URL = "https://api.portkey.ai/v1";
 var DEFAULT_PUBLIC_BASE_URL = "https://api.portkey.ai";
+function toV2BaseUrl(baseUrl) {
+  return baseUrl.replace(/\/v1$/, "/v2");
+}
 var MISSING_API_KEY_PLACEHOLDER = "__PORTKEY_API_KEY_NOT_CONFIGURED__";
 var PRIVATE_BASE_URL_OVERRIDE_HINT = "Set PORTKEY_ALLOW_PRIVATE_BASE_URL=true to allow self-hosted gateways on loopback or private networks.";
 var INSECURE_HTTP_OVERRIDE_HINT = "Set PORTKEY_ALLOW_INSECURE_HTTP=true only for a trusted self-hosted gateway when TLS is unavailable.";
@@ -248,6 +251,7 @@ function isNoContent(value) {
 var BaseService = class {
   apiKey;
   baseUrl;
+  v2BaseUrl;
   timeout = 3e4;
   constructor(apiKeyOverride, baseUrlOverride) {
     const apiKey = apiKeyOverride ?? process.env.PORTKEY_API_KEY;
@@ -258,6 +262,7 @@ var BaseService = class {
     const baseUrl = baseUrlOverride ?? process.env.PORTKEY_BASE_URL ?? DEFAULT_BASE_URL;
     validateUrl(baseUrl);
     this.baseUrl = baseUrl.replace(/\/+$/, "");
+    this.v2BaseUrl = toV2BaseUrl(this.baseUrl);
   }
   encodePathSegment(value) {
     return encodeURIComponent(value);
@@ -368,11 +373,38 @@ var BaseService = class {
       })
     );
   }
+  /** Read a `/v2`-only admin endpoint. See {@link toV2BaseUrl}. */
+  async getV2(path, params) {
+    return this.rejectNoContent(
+      await this.executeRequest("GET", path, {
+        params,
+        baseUrl: this.v2BaseUrl
+      })
+    );
+  }
   async post(path, body) {
     return this.rejectNoContent(
       await this.executeRequest("POST", path, { body })
     );
   }
+  /** Write to a `/v2`-only admin endpoint. See {@link toV2BaseUrl}. */
+  async postV2(path, body) {
+    return this.rejectNoContent(
+      await this.executeRequest("POST", path, {
+        body,
+        baseUrl: this.v2BaseUrl
+      })
+    );
+  }
+  /** Update a `/v2`-only admin endpoint. See {@link toV2BaseUrl}. */
+  async putV2(path, body) {
+    return this.rejectNoContent(
+      await this.executeRequest("PUT", path, {
+        body,
+        baseUrl: this.v2BaseUrl
+      })
+    );
+  }
   async put(path, body) {
     return this.rejectNoContent(
       await this.executeRequest("PUT", path, { body })
@@ -389,6 +421,14 @@ var BaseService = class {
       allowNoContent: true
     });
   }
+  /** Delete on a `/v2`-only admin endpoint. See {@link toV2BaseUrl}. */
+  async deleteV2(path, params) {
+    return this.executeRequest("DELETE", path, {
+      params,
+      allowNoContent: true,
+      baseUrl: this.v2BaseUrl
+    });
+  }
 };
 
 // src/services/analytics.service.ts
@@ -682,28 +722,28 @@ var ConfigsService = class extends BaseService {
 // src/services/deployments.service.ts
 var DeploymentsService = class extends BaseService {
   async listDeployments(params) {
-    return this.get("/deployments", params);
+    return this.getV2("/deployments", params);
   }
   async registerDeployment(data) {
-    return this.post("/deployments", data);
+    return this.postV2("/deployments", data);
   }
   async getDeployment(id, organisation_id) {
     if (!id.trim()) throw new Error("Deployment ID is required");
-    return this.get(
+    return this.getV2(
       `/deployments/${this.encodePathSegment(id)}`,
       { organisation_id }
     );
   }
   async updateDeployment(id, data) {
     if (!id.trim()) throw new Error("Deployment ID is required");
-    return this.put(
+    return this.putV2(
       `/deployments/${this.encodePathSegment(id)}`,
       data
     );
   }
   async archiveDeployment(id) {
     if (!id.trim()) throw new Error("Deployment ID is required");
-    const result = await this.delete(
+    const result = await this.deleteV2(
       `/deployments/${this.encodePathSegment(id)}`
     );
     return isNoContent(result) ? {} : result;
@@ -714,13 +754,13 @@ var DeploymentsService = class extends BaseService {
 var GuardrailsService = class extends BaseService {
   /** Get the organisation-wide input and output guardrail defaults. */
   async getOrganisationDefaults() {
-    return this.get(
+    return this.getV2(
       "/admin/organisation/defaults"
     );
   }
   /** Replace either or both organisation-wide guardrail default lists. */
   async updateOrganisationDefaults(data) {
-    return this.put(
+    return this.putV2(
       "/admin/organisation/defaults",
       data
     );
@@ -1467,7 +1507,7 @@ var PromptsService = class extends BaseService {
   }
   async findPromptByExactName(name, collectionId) {
     const pageSize = 100;
-    let currentPage = 1;
+    let currentPage = 0;
     while (true) {
       const page = await this.listPrompts({
         collection_id: collectionId,
@@ -1481,7 +1521,7 @@ var PromptsService = class extends BaseService {
       if (exact) {
         return exact;
       }
-      if (page.data.length === 0 || currentPage * pageSize >= page.total) {
+      if (page.data.length === 0 || (currentPage + 1) * pageSize >= page.total) {
         return void 0;
       }
       currentPage += 1;
@@ -1900,7 +1940,7 @@ var WorkspacesService = class extends BaseService {
     return { success: true };
   }
   async listScimGroups(params) {
-    return this.get("/scim/groups", params);
+    return this.getV2("/scim/groups", params);
   }
   async listWorkspaces(params) {
     return this.get("/admin/workspaces", params);
@@ -2195,7 +2235,7 @@ var baseAnalyticsSchema = {
 };
 var paginatedAnalyticsSchema = {
   ...baseAnalyticsSchema,
-  current_page: z2.coerce.number().int().nonnegative().optional().describe("Page number for pagination"),
+  current_page: z2.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
   page_size: z2.coerce.number().int().positive().max(100).optional().describe("Results per page (max 100)")
 };
 var cacheSummarySchema = {
@@ -2683,7 +2723,7 @@ var AUDIT_TOOL_SCHEMAS = {
     end_time: z3.string().optional().describe(
       "End of time range filter (ISO 8601 format, e.g., '2024-01-31T23:59:59Z')"
     ),
-    current_page: z3.coerce.number().int().positive().optional().describe("Page number for pagination (starts at 1)"),
+    current_page: z3.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z3.coerce.number().int().positive().max(100).optional().describe("Number of results per page (max 100)")
   }
 };
@@ -2735,7 +2775,7 @@ var COLLECTIONS_TOOL_SCHEMAS = {
   listCollections: {
     workspace_id: z4.string().optional().describe("Filter by workspace ID"),
     search: z4.string().optional().describe("Search collections by name"),
-    current_page: z4.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z4.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z4.coerce.number().int().positive().max(100).optional().describe("Results per page (max 100)")
   },
   createCollection: {
@@ -2848,7 +2888,7 @@ var configTargetSchema = z5.object({
 });
 var CONFIGS_TOOL_SCHEMAS = {
   listConfigs: {
-    current_page: z5.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z5.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z5.coerce.number().int().positive().max(100).optional().describe("Number of results per page (max 100)")
   },
   getConfig: {
@@ -3248,7 +3288,7 @@ var GUARDRAILS_TOOL_SCHEMAS = {
     workspace_id: z7.string().optional().describe("Filter guardrails by workspace ID"),
     organisation_id: z7.string().optional().describe("Filter guardrails by organization ID"),
     page_size: z7.coerce.number().int().min(1).max(100).optional().describe("Number of items per page (1-100, default: 100)"),
-    current_page: z7.coerce.number().int().nonnegative().optional().describe("Page number for pagination")
+    current_page: z7.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0")
   },
   getGuardrail: {
     guardrail_id: z7.string().describe("The guardrail UUID or slug (with guard_ prefix) to retrieve")
@@ -3648,7 +3688,7 @@ var INTEGRATIONS_TOOL_SCHEMAS = {
     model: z9.string().describe("Exact provider model identifier, such as gpt-4o")
   },
   listIntegrations: {
-    current_page: z9.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z9.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z9.coerce.number().int().positive().max(100).optional().describe("Number of results per page (default 100, max 100)"),
     workspace_id: z9.string().optional().describe("Filter integrations accessible by a specific workspace"),
     type: z9.enum(["workspace", "organisation", "all"]).optional().describe(
@@ -3715,7 +3755,7 @@ var INTEGRATIONS_TOOL_SCHEMAS = {
   },
   listIntegrationModels: {
     slug: z9.string().describe("The slug of the integration"),
-    current_page: z9.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z9.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z9.coerce.number().int().positive().max(100).optional().describe("Number of results per page")
   },
   updateIntegrationModels: {
@@ -3744,7 +3784,7 @@ var INTEGRATIONS_TOOL_SCHEMAS = {
   },
   listIntegrationWorkspaces: {
     slug: z9.string().describe("The slug of the integration"),
-    current_page: z9.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z9.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z9.coerce.number().int().positive().max(100).optional().describe("Number of results per page")
   },
   updateIntegrationWorkspaces: {
@@ -4150,7 +4190,7 @@ var rotationPolicySchema = z10.object({
 }).describe("Automatic API-key rotation policy, or null to remove it");
 var KEYS_TOOL_SCHEMAS = {
   listVirtualKeys: {
-    current_page: z10.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z10.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z10.coerce.number().int().positive().max(100).optional().describe("Number of results per page (max 100)")
   },
   createVirtualKey: {
@@ -4220,7 +4260,7 @@ var KEYS_TOOL_SCHEMAS = {
   },
   listApiKeys: {
     page_size: z10.coerce.number().int().positive().max(100).optional().describe("Number of results per page (max 100)"),
-    current_page: z10.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z10.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     workspace_id: z10.string().optional().describe("Filter by workspace ID")
   },
   getApiKey: {
@@ -4612,7 +4652,7 @@ var LABELS_TOOL_SCHEMAS = {
     organisation_id: z11.string().optional().describe("Filter by organisation ID"),
     workspace_id: z11.string().optional().describe("Filter by workspace ID"),
     search: z11.string().optional().describe("Search labels by name"),
-    current_page: z11.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z11.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z11.coerce.number().int().positive().max(100).optional().describe("Results per page (max 100)")
   },
   getPromptLabel: {
@@ -5309,7 +5349,7 @@ var mcpConfigurationsSchema = z14.record(z14.string(), z14.unknown()).superRefin
 });
 var MCP_INTEGRATIONS_TOOL_SCHEMAS = {
   listMcpIntegrations: {
-    current_page: z14.coerce.number().int().nonnegative().optional().describe("Page number for pagination"),
+    current_page: z14.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z14.coerce.number().int().positive().max(1e3).optional().describe("Number of results per page (max 1000)"),
     workspace_id: z14.string().optional().describe("Filter by workspace ID"),
     organisation_id: z14.string().optional().describe("Filter by organisation UUID"),
@@ -5650,7 +5690,7 @@ function registerMcpIntegrationsTools(server, service) {
 import { z as z15 } from "zod";
 var MCP_SERVERS_TOOL_SCHEMAS = {
   listMcpServers: {
-    current_page: z15.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z15.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z15.coerce.number().int().positive().max(100).optional().describe("Number of results per page (max 100)"),
     workspace_id: z15.string().optional().describe("Filter by workspace ID")
   },
@@ -5676,7 +5716,7 @@ var MCP_SERVERS_TOOL_SCHEMAS = {
   },
   listMcpServerCapabilities: {
     id: z15.string().describe("The MCP server ID or slug"),
-    current_page: z15.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z15.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z15.coerce.number().int().positive().max(100).optional().describe("Number of results per page (max 100)")
   },
   updateMcpServerCapabilities: {
@@ -5691,7 +5731,7 @@ var MCP_SERVERS_TOOL_SCHEMAS = {
   },
   listMcpServerUserAccess: {
     id: z15.string().describe("The MCP server ID or slug"),
-    current_page: z15.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z15.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z15.coerce.number().int().positive().max(100).optional().describe("Number of results per page (max 100)")
   },
   updateMcpServerUserAccess: {
@@ -6234,7 +6274,7 @@ var PROMPTS_TOOL_SCHEMAS = {
     ),
     workspace_id: z18.string().optional().describe("Filter by workspace ID"),
     search: z18.string().optional().describe("Search prompts by name"),
-    current_page: z18.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z18.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z18.coerce.number().int().positive().max(100).optional().describe("Results per page (max 100)")
   },
   getPrompt: {
@@ -6410,11 +6450,12 @@ function formatPromptVersion(version) {
   };
 }
 function formatPromptListResponse(prompts, params) {
-  const currentPage = params.current_page ?? 1;
+  const paginated = params.current_page !== void 0;
+  const currentPage = params.current_page ?? 0;
   const returnedCount = prompts.data.length;
   const pageSize = params.page_size ?? returnedCount;
-  const nextOffset = currentPage * pageSize;
-  const hasMore = returnedCount > 0 && nextOffset < prompts.total;
+  const nextOffset = (currentPage + 1) * pageSize;
+  const hasMore = paginated && returnedCount > 0 && nextOffset < prompts.total;
   return {
     total: prompts.total,
     current_page: currentPage,
@@ -6815,7 +6856,7 @@ function registerPromptsTools(server, service) {
 import { z as z19 } from "zod";
 var PROVIDERS_TOOL_SCHEMAS = {
   listProviders: {
-    current_page: z19.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z19.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z19.coerce.number().int().positive().max(100).optional().describe("Number of results per page (max 100, default 50)"),
     workspace_id: z19.string().optional().describe(
       "Workspace ID - required when using organization admin keys, optional with workspace API keys"
@@ -7449,7 +7490,7 @@ function registerTracingTools(server, service) {
 import { z as z22 } from "zod";
 var USERS_TOOL_SCHEMAS = {
   listAllUsers: {
-    current_page: z22.coerce.number().int().nonnegative().optional().describe("Page number for pagination"),
+    current_page: z22.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z22.coerce.number().int().nonnegative().max(100).optional().describe("Number of results per page (max 100)"),
     role: z22.enum(["admin", "member", "owner"]).optional().describe("Filter by organisation role"),
     email: z22.string().email().optional().describe("Filter by exact email")
@@ -7508,7 +7549,7 @@ var USERS_TOOL_SCHEMAS = {
     user_id: z22.string().describe("The user ID to delete")
   },
   listUserInvites: {
-    current_page: z22.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z22.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z22.coerce.number().int().positive().max(100).optional().describe("Number of results per page (max 100)"),
     role: z22.enum(["admin", "member"]).optional().describe("Filter invitations by organisation role"),
     email: z22.string().email().optional().describe("Filter by invited email"),
@@ -7721,7 +7762,7 @@ var createScimWorkspaceMappingSchema = z23.object(createScimWorkspaceMappingShap
 var WORKSPACES_TOOL_SCHEMAS = {
   listWorkspaces: {
     page_size: z23.coerce.number().int().positive().max(100).optional().describe("Number of workspaces to return per page (max 100)"),
-    current_page: z23.coerce.number().int().nonnegative().optional().describe("Page number to retrieve when results are paginated"),
+    current_page: z23.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     name: z23.string().optional().describe("Case-sensitive name filter"),
     exact_name: z23.string().optional().describe("Exact workspace name filter"),
     status: z23.enum(["active", "archived"]).optional().describe("Filter by workspace lifecycle status")

package/build/server.js

@@ -141,6 +141,9 @@ var Logger = {
 // src/services/base.service.ts
 var DEFAULT_BASE_URL = "https://api.portkey.ai/v1";
 var DEFAULT_PUBLIC_BASE_URL = "https://api.portkey.ai";
+function toV2BaseUrl(baseUrl) {
+  return baseUrl.replace(/\/v1$/, "/v2");
+}
 var MISSING_API_KEY_PLACEHOLDER = "__PORTKEY_API_KEY_NOT_CONFIGURED__";
 var PRIVATE_BASE_URL_OVERRIDE_HINT = "Set PORTKEY_ALLOW_PRIVATE_BASE_URL=true to allow self-hosted gateways on loopback or private networks.";
 var INSECURE_HTTP_OVERRIDE_HINT = "Set PORTKEY_ALLOW_INSECURE_HTTP=true only for a trusted self-hosted gateway when TLS is unavailable.";
@@ -265,6 +268,7 @@ function isNoContent(value) {
 var BaseService = class {
   apiKey;
   baseUrl;
+  v2BaseUrl;
   timeout = 3e4;
   constructor(apiKeyOverride, baseUrlOverride) {
     const apiKey = apiKeyOverride ?? process.env.PORTKEY_API_KEY;
@@ -275,6 +279,7 @@ var BaseService = class {
     const baseUrl = baseUrlOverride ?? process.env.PORTKEY_BASE_URL ?? DEFAULT_BASE_URL;
     validateUrl(baseUrl);
     this.baseUrl = baseUrl.replace(/\/+$/, "");
+    this.v2BaseUrl = toV2BaseUrl(this.baseUrl);
   }
   encodePathSegment(value) {
     return encodeURIComponent(value);
@@ -385,11 +390,38 @@ var BaseService = class {
       })
     );
   }
+  /** Read a `/v2`-only admin endpoint. See {@link toV2BaseUrl}. */
+  async getV2(path, params) {
+    return this.rejectNoContent(
+      await this.executeRequest("GET", path, {
+        params,
+        baseUrl: this.v2BaseUrl
+      })
+    );
+  }
   async post(path, body) {
     return this.rejectNoContent(
       await this.executeRequest("POST", path, { body })
     );
   }
+  /** Write to a `/v2`-only admin endpoint. See {@link toV2BaseUrl}. */
+  async postV2(path, body) {
+    return this.rejectNoContent(
+      await this.executeRequest("POST", path, {
+        body,
+        baseUrl: this.v2BaseUrl
+      })
+    );
+  }
+  /** Update a `/v2`-only admin endpoint. See {@link toV2BaseUrl}. */
+  async putV2(path, body) {
+    return this.rejectNoContent(
+      await this.executeRequest("PUT", path, {
+        body,
+        baseUrl: this.v2BaseUrl
+      })
+    );
+  }
   async put(path, body) {
     return this.rejectNoContent(
       await this.executeRequest("PUT", path, { body })
@@ -406,6 +438,14 @@ var BaseService = class {
       allowNoContent: true
     });
   }
+  /** Delete on a `/v2`-only admin endpoint. See {@link toV2BaseUrl}. */
+  async deleteV2(path, params) {
+    return this.executeRequest("DELETE", path, {
+      params,
+      allowNoContent: true,
+      baseUrl: this.v2BaseUrl
+    });
+  }
 };
 
 // src/services/analytics.service.ts
@@ -699,28 +739,28 @@ var ConfigsService = class extends BaseService {
 // src/services/deployments.service.ts
 var DeploymentsService = class extends BaseService {
   async listDeployments(params) {
-    return this.get("/deployments", params);
+    return this.getV2("/deployments", params);
   }
   async registerDeployment(data) {
-    return this.post("/deployments", data);
+    return this.postV2("/deployments", data);
   }
   async getDeployment(id, organisation_id) {
     if (!id.trim()) throw new Error("Deployment ID is required");
-    return this.get(
+    return this.getV2(
       `/deployments/${this.encodePathSegment(id)}`,
       { organisation_id }
     );
   }
   async updateDeployment(id, data) {
     if (!id.trim()) throw new Error("Deployment ID is required");
-    return this.put(
+    return this.putV2(
       `/deployments/${this.encodePathSegment(id)}`,
       data
     );
   }
   async archiveDeployment(id) {
     if (!id.trim()) throw new Error("Deployment ID is required");
-    const result = await this.delete(
+    const result = await this.deleteV2(
       `/deployments/${this.encodePathSegment(id)}`
     );
     return isNoContent(result) ? {} : result;
@@ -731,13 +771,13 @@ var DeploymentsService = class extends BaseService {
 var GuardrailsService = class extends BaseService {
   /** Get the organisation-wide input and output guardrail defaults. */
   async getOrganisationDefaults() {
-    return this.get(
+    return this.getV2(
       "/admin/organisation/defaults"
     );
   }
   /** Replace either or both organisation-wide guardrail default lists. */
   async updateOrganisationDefaults(data) {
-    return this.put(
+    return this.putV2(
       "/admin/organisation/defaults",
       data
     );
@@ -1484,7 +1524,7 @@ var PromptsService = class extends BaseService {
   }
   async findPromptByExactName(name, collectionId) {
     const pageSize = 100;
-    let currentPage = 1;
+    let currentPage = 0;
     while (true) {
       const page = await this.listPrompts({
         collection_id: collectionId,
@@ -1498,7 +1538,7 @@ var PromptsService = class extends BaseService {
       if (exact) {
         return exact;
       }
-      if (page.data.length === 0 || currentPage * pageSize >= page.total) {
+      if (page.data.length === 0 || (currentPage + 1) * pageSize >= page.total) {
         return void 0;
       }
       currentPage += 1;
@@ -1917,7 +1957,7 @@ var WorkspacesService = class extends BaseService {
     return { success: true };
   }
   async listScimGroups(params) {
-    return this.get("/scim/groups", params);
+    return this.getV2("/scim/groups", params);
   }
   async listWorkspaces(params) {
     return this.get("/admin/workspaces", params);
@@ -2212,7 +2252,7 @@ var baseAnalyticsSchema = {
 };
 var paginatedAnalyticsSchema = {
   ...baseAnalyticsSchema,
-  current_page: z2.coerce.number().int().nonnegative().optional().describe("Page number for pagination"),
+  current_page: z2.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
   page_size: z2.coerce.number().int().positive().max(100).optional().describe("Results per page (max 100)")
 };
 var cacheSummarySchema = {
@@ -2700,7 +2740,7 @@ var AUDIT_TOOL_SCHEMAS = {
     end_time: z3.string().optional().describe(
       "End of time range filter (ISO 8601 format, e.g., '2024-01-31T23:59:59Z')"
     ),
-    current_page: z3.coerce.number().int().positive().optional().describe("Page number for pagination (starts at 1)"),
+    current_page: z3.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z3.coerce.number().int().positive().max(100).optional().describe("Number of results per page (max 100)")
   }
 };
@@ -2752,7 +2792,7 @@ var COLLECTIONS_TOOL_SCHEMAS = {
   listCollections: {
     workspace_id: z4.string().optional().describe("Filter by workspace ID"),
     search: z4.string().optional().describe("Search collections by name"),
-    current_page: z4.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z4.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z4.coerce.number().int().positive().max(100).optional().describe("Results per page (max 100)")
   },
   createCollection: {
@@ -2865,7 +2905,7 @@ var configTargetSchema = z5.object({
 });
 var CONFIGS_TOOL_SCHEMAS = {
   listConfigs: {
-    current_page: z5.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z5.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z5.coerce.number().int().positive().max(100).optional().describe("Number of results per page (max 100)")
   },
   getConfig: {
@@ -3265,7 +3305,7 @@ var GUARDRAILS_TOOL_SCHEMAS = {
     workspace_id: z7.string().optional().describe("Filter guardrails by workspace ID"),
     organisation_id: z7.string().optional().describe("Filter guardrails by organization ID"),
     page_size: z7.coerce.number().int().min(1).max(100).optional().describe("Number of items per page (1-100, default: 100)"),
-    current_page: z7.coerce.number().int().nonnegative().optional().describe("Page number for pagination")
+    current_page: z7.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0")
   },
   getGuardrail: {
     guardrail_id: z7.string().describe("The guardrail UUID or slug (with guard_ prefix) to retrieve")
@@ -3665,7 +3705,7 @@ var INTEGRATIONS_TOOL_SCHEMAS = {
     model: z9.string().describe("Exact provider model identifier, such as gpt-4o")
   },
   listIntegrations: {
-    current_page: z9.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z9.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z9.coerce.number().int().positive().max(100).optional().describe("Number of results per page (default 100, max 100)"),
     workspace_id: z9.string().optional().describe("Filter integrations accessible by a specific workspace"),
     type: z9.enum(["workspace", "organisation", "all"]).optional().describe(
@@ -3732,7 +3772,7 @@ var INTEGRATIONS_TOOL_SCHEMAS = {
   },
   listIntegrationModels: {
     slug: z9.string().describe("The slug of the integration"),
-    current_page: z9.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z9.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z9.coerce.number().int().positive().max(100).optional().describe("Number of results per page")
   },
   updateIntegrationModels: {
@@ -3761,7 +3801,7 @@ var INTEGRATIONS_TOOL_SCHEMAS = {
   },
   listIntegrationWorkspaces: {
     slug: z9.string().describe("The slug of the integration"),
-    current_page: z9.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z9.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z9.coerce.number().int().positive().max(100).optional().describe("Number of results per page")
   },
   updateIntegrationWorkspaces: {
@@ -4167,7 +4207,7 @@ var rotationPolicySchema = z10.object({
 }).describe("Automatic API-key rotation policy, or null to remove it");
 var KEYS_TOOL_SCHEMAS = {
   listVirtualKeys: {
-    current_page: z10.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z10.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z10.coerce.number().int().positive().max(100).optional().describe("Number of results per page (max 100)")
   },
   createVirtualKey: {
@@ -4237,7 +4277,7 @@ var KEYS_TOOL_SCHEMAS = {
   },
   listApiKeys: {
     page_size: z10.coerce.number().int().positive().max(100).optional().describe("Number of results per page (max 100)"),
-    current_page: z10.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z10.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     workspace_id: z10.string().optional().describe("Filter by workspace ID")
   },
   getApiKey: {
@@ -4629,7 +4669,7 @@ var LABELS_TOOL_SCHEMAS = {
     organisation_id: z11.string().optional().describe("Filter by organisation ID"),
     workspace_id: z11.string().optional().describe("Filter by workspace ID"),
     search: z11.string().optional().describe("Search labels by name"),
-    current_page: z11.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z11.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z11.coerce.number().int().positive().max(100).optional().describe("Results per page (max 100)")
   },
   getPromptLabel: {
@@ -5326,7 +5366,7 @@ var mcpConfigurationsSchema = z14.record(z14.string(), z14.unknown()).superRefin
 });
 var MCP_INTEGRATIONS_TOOL_SCHEMAS = {
   listMcpIntegrations: {
-    current_page: z14.coerce.number().int().nonnegative().optional().describe("Page number for pagination"),
+    current_page: z14.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z14.coerce.number().int().positive().max(1e3).optional().describe("Number of results per page (max 1000)"),
     workspace_id: z14.string().optional().describe("Filter by workspace ID"),
     organisation_id: z14.string().optional().describe("Filter by organisation UUID"),
@@ -5667,7 +5707,7 @@ function registerMcpIntegrationsTools(server, service) {
 import { z as z15 } from "zod";
 var MCP_SERVERS_TOOL_SCHEMAS = {
   listMcpServers: {
-    current_page: z15.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z15.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z15.coerce.number().int().positive().max(100).optional().describe("Number of results per page (max 100)"),
     workspace_id: z15.string().optional().describe("Filter by workspace ID")
   },
@@ -5693,7 +5733,7 @@ var MCP_SERVERS_TOOL_SCHEMAS = {
   },
   listMcpServerCapabilities: {
     id: z15.string().describe("The MCP server ID or slug"),
-    current_page: z15.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z15.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z15.coerce.number().int().positive().max(100).optional().describe("Number of results per page (max 100)")
   },
   updateMcpServerCapabilities: {
@@ -5708,7 +5748,7 @@ var MCP_SERVERS_TOOL_SCHEMAS = {
   },
   listMcpServerUserAccess: {
     id: z15.string().describe("The MCP server ID or slug"),
-    current_page: z15.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z15.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z15.coerce.number().int().positive().max(100).optional().describe("Number of results per page (max 100)")
   },
   updateMcpServerUserAccess: {
@@ -6251,7 +6291,7 @@ var PROMPTS_TOOL_SCHEMAS = {
     ),
     workspace_id: z18.string().optional().describe("Filter by workspace ID"),
     search: z18.string().optional().describe("Search prompts by name"),
-    current_page: z18.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z18.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z18.coerce.number().int().positive().max(100).optional().describe("Results per page (max 100)")
   },
   getPrompt: {
@@ -6427,11 +6467,12 @@ function formatPromptVersion(version) {
   };
 }
 function formatPromptListResponse(prompts, params) {
-  const currentPage = params.current_page ?? 1;
+  const paginated = params.current_page !== void 0;
+  const currentPage = params.current_page ?? 0;
   const returnedCount = prompts.data.length;
   const pageSize = params.page_size ?? returnedCount;
-  const nextOffset = currentPage * pageSize;
-  const hasMore = returnedCount > 0 && nextOffset < prompts.total;
+  const nextOffset = (currentPage + 1) * pageSize;
+  const hasMore = paginated && returnedCount > 0 && nextOffset < prompts.total;
   return {
     total: prompts.total,
     current_page: currentPage,
@@ -6832,7 +6873,7 @@ function registerPromptsTools(server, service) {
 import { z as z19 } from "zod";
 var PROVIDERS_TOOL_SCHEMAS = {
   listProviders: {
-    current_page: z19.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z19.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z19.coerce.number().int().positive().max(100).optional().describe("Number of results per page (max 100, default 50)"),
     workspace_id: z19.string().optional().describe(
       "Workspace ID - required when using organization admin keys, optional with workspace API keys"
@@ -7466,7 +7507,7 @@ function registerTracingTools(server, service) {
 import { z as z22 } from "zod";
 var USERS_TOOL_SCHEMAS = {
   listAllUsers: {
-    current_page: z22.coerce.number().int().nonnegative().optional().describe("Page number for pagination"),
+    current_page: z22.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z22.coerce.number().int().nonnegative().max(100).optional().describe("Number of results per page (max 100)"),
     role: z22.enum(["admin", "member", "owner"]).optional().describe("Filter by organisation role"),
     email: z22.string().email().optional().describe("Filter by exact email")
@@ -7525,7 +7566,7 @@ var USERS_TOOL_SCHEMAS = {
     user_id: z22.string().describe("The user ID to delete")
   },
   listUserInvites: {
-    current_page: z22.coerce.number().int().positive().optional().describe("Page number for pagination"),
+    current_page: z22.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     page_size: z22.coerce.number().int().positive().max(100).optional().describe("Number of results per page (max 100)"),
     role: z22.enum(["admin", "member"]).optional().describe("Filter invitations by organisation role"),
     email: z22.string().email().optional().describe("Filter by invited email"),
@@ -7738,7 +7779,7 @@ var createScimWorkspaceMappingSchema = z23.object(createScimWorkspaceMappingShap
 var WORKSPACES_TOOL_SCHEMAS = {
   listWorkspaces: {
     page_size: z23.coerce.number().int().positive().max(100).optional().describe("Number of workspaces to return per page (max 100)"),
-    current_page: z23.coerce.number().int().nonnegative().optional().describe("Page number to retrieve when results are paginated"),
+    current_page: z23.coerce.number().int().nonnegative().optional().describe("Zero-based page number; the first page is 0"),
     name: z23.string().optional().describe("Case-sensitive name filter"),
     exact_name: z23.string().optional().describe("Exact workspace name filter"),
     status: z23.enum(["active", "archived"]).optional().describe("Filter by workspace lifecycle status")

package/docs/PRISMA_AIRS_INTEROPERABILITY.md

@@ -1,6 +1,6 @@
 # Prisma AIRS interoperability
 
-Last verified: 2026-08-27
+Last verified: 2026-08-28
 
 ## Short answer
 
@@ -19,6 +19,10 @@ Changing `PORTKEY_BASE_URL` to a Prisma AIRS or Strata Cloud Manager URL will no
 
 Palo Alto Networks says the Portkey acquisition makes Portkey the core AI Gateway for Prisma AIRS. Its current AI Gateway instructions direct administrators to Strata Cloud Manager, while the documented Prisma AIRS MCP endpoint is for centralized AI-agent security. No public Prisma AIRS admin contract equivalent to Portkey's users, workspaces, prompts, configs, integrations, or keys is documented today. That last sentence is an inference from the currently published product and API documentation, not a promise that such an API will never exist.
 
+The August 2026 Prisma AIRS additions cover runtime, model, skill, discovery, and
+red-team security capabilities. They do not publish a Portkey-compatible AI
+Gateway administration contract, so they do not change this boundary.
+
 ## Recommended coexistence
 
 Run the two MCP servers side by side when you need both administration and runtime security:

package/package.json

@@ -56,7 +56,7 @@
 	},
 	"name": "portkey-admin-mcp",
 	"mcpName": "io.github.CodesWhat/portkey-admin-mcp",
-	"version": "0.11.0",
+	"version": "0.11.2",
 	"main": "build/index.js",
 	"keywords": [
 		"mcp",