From f438a8adaebfe7aa7175522c74ba4a7874346bac Mon Sep 17 00:00:00 2001 From: sd Date: Thu, 9 Apr 2026 02:38:07 +0530 Subject: [PATCH 1/4] chore: added mcp server connection apis --- openapi.yaml | 108 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 108 insertions(+) diff --git a/openapi.yaml b/openapi.yaml index 04296fa5..094eae75 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -114,6 +114,8 @@ tags: description: List and manage capabilities for MCP Servers. - name: MCP Servers > User Access description: List and manage user access for MCP Servers. + - name: MCP Servers > Connections + description: List and manage user connections for MCP Servers. - name: Api-Keys description: Create, List, Retrieve, Update, and Delete your Portkey API keys. - name: Logs Export @@ -16091,6 +16093,78 @@ paths: schema: $ref: "#/components/schemas/McpServerUserAccessBulkUpdateResponse" + /mcp-servers/{mcpServerId}/connections: + servers: *ControlPlaneServers + parameters: + - name: mcpServerId + in: path + required: true + schema: + type: string + description: MCP Server ID or slug + get: + operationId: McpServerConnections_list + tags: + - MCP Servers > Connections + summary: List MCP Server Connections + description: List users who have connected to this MCP Server. + parameters: + - name: user_id + in: query + schema: + type: string + description: Filter by user ID(s), comma-separated. Defaults to current user. + - name: workspace_id + in: query + schema: + type: string + description: Workspace ID or slug + - name: current_page + in: query + schema: + type: integer + minimum: 0 + default: 0 + - name: page_size + in: query + schema: + type: integer + minimum: 1 + maximum: 500 + default: 100 + responses: + "200": + description: OK + content: + application/json: + schema: + $ref: "#/components/schemas/McpServerConnectionsListResponse" + delete: + operationId: McpServerConnections_delete + tags: + - MCP Servers > Connections + summary: Delete MCP Server Connection + description: Remove a user's connection to this MCP Server. + parameters: + - name: user_id + in: query + schema: + type: string + format: uuid + description: User ID to disconnect. Defaults to current user. + - name: workspace_id + in: query + schema: + type: string + description: Workspace ID or slug + responses: + "200": + description: OK + content: + application/json: + schema: + $ref: "#/components/schemas/McpServerConnectionDeleteResponse" + /logs: servers: *DataPlaneServers post: @@ -37135,6 +37209,40 @@ components: type: boolean example: true + McpServerConnectionItem: + type: object + properties: + user_id: + type: string + format: uuid + connected: + type: boolean + created_at: + type: string + format: date-time + last_updated_at: + type: string + format: date-time + + McpServerConnectionsListResponse: + type: object + properties: + data: + type: array + items: + $ref: "#/components/schemas/McpServerConnectionItem" + total: + type: integer + has_more: + type: boolean + + McpServerConnectionDeleteResponse: + type: object + properties: + success: + type: boolean + example: true + security: - Portkey-Key: [] From 755274451fa5ef0e15ded13fe602a7c2b16c76f4 Mon Sep 17 00:00:00 2001 From: sd Date: Mon, 13 Apr 2026 18:52:07 +0530 Subject: [PATCH 2/4] chore: improved the file changs --- openapi.yaml | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/openapi.yaml b/openapi.yaml index 094eae75..d8ff3fb7 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -16101,24 +16101,23 @@ paths: required: true schema: type: string - description: MCP Server ID or slug + description: MCP Server ID (UUID) or slug get: operationId: McpServerConnections_list tags: - MCP Servers > Connections summary: List MCP Server Connections - description: List users who have connected to this MCP Server. parameters: - name: user_id in: query schema: type: string - description: Filter by user ID(s), comma-separated. Defaults to current user. + description: Filter by user ID(s), comma-separated - name: workspace_id in: query schema: type: string - description: Workspace ID or slug + description: Workspace ID or slug. Required when using org admin API key; optional when API key is workspace-scoped. - name: current_page in: query schema: @@ -16144,19 +16143,18 @@ paths: tags: - MCP Servers > Connections summary: Delete MCP Server Connection - description: Remove a user's connection to this MCP Server. parameters: - name: user_id in: query schema: type: string format: uuid - description: User ID to disconnect. Defaults to current user. + description: User ID to disconnect - name: workspace_id in: query schema: type: string - description: Workspace ID or slug + description: Workspace ID or slug. Required when using org admin API key; optional when API key is workspace-scoped. responses: "200": description: OK From 1860f6ad28e2387f5a9e4cf1c093081c740c1253 Mon Sep 17 00:00:00 2001 From: sd Date: Tue, 14 Apr 2026 11:09:53 +0530 Subject: [PATCH 3/4] chore: updated description for delete api key --- openapi.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/openapi.yaml b/openapi.yaml index d8ff3fb7..8da04b2e 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -16149,7 +16149,7 @@ paths: schema: type: string format: uuid - description: User ID to disconnect + description: The UUID of the user to disconnect. Required when using a service API key; optional when using a user API key (the user ID is derived from the key if not provided). - name: workspace_id in: query schema: From 0e44f83940575e6da61895b34af9a385ca89a639 Mon Sep 17 00:00:00 2001 From: sd Date: Tue, 14 Apr 2026 11:27:39 +0530 Subject: [PATCH 4/4] chore: updated the description for list mcp server connections --- openapi.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/openapi.yaml b/openapi.yaml index 8da04b2e..2a388718 100644 --- a/openapi.yaml +++ b/openapi.yaml @@ -16112,7 +16112,7 @@ paths: in: query schema: type: string - description: Filter by user ID(s), comma-separated + description: Optional. UUID of the user whose connections to list. If not provided, defaults to the current user for user API keys, and returns all connections on the MCP server for service API keys. - name: workspace_id in: query schema: