Open MCP Portaldocs
ReferenceAdmin

Replace a platform gateway's selection (platform admins); If-Match is the gateway's revision

PUT/v1/admin/gateways/{gatewayId}/capabilities

Platform gateways may select approved, listed tools and prompts of published, enabled servers only, and minRole must be absent. Same 422 codes as the team operation; 403 team_gateway for a team gateway.

Path Parameters

gatewayId*string
Formatuuid

Header Parameters

If-Match*string

The resource's revision, as returned in ETag (for example "3"). Missing returns 428; stale returns 412.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/v1/admin/gateways/497f6eca-6276-4993-bfeb-53cbbbba6f08/capabilities" \  -H "If-Match: string" \  -H "Content-Type: application/json" \  -d '{    "items": [      {        "capabilityId": "486ae165-7fa3-4fe9-8d0b-0636c8459cb3"      }    ]  }'
{  "data": {    "revision": null,    "items": [      {        "requires": {          "providerId": "4834bcdc-4a64-444d-966b-1a6fe381da24",          "providerSlug": "github",          "providerName": "GitHub",          "scopes": [            "string"          ],          "connected": true,          "providerKind": "oauth2"        },        "capabilityId": "486ae165-7fa3-4fe9-8d0b-0636c8459cb3",        "serverId": "10d2345a-e43d-463d-830e-4f5b19b60d41",        "serverSlug": "string",        "serverName": "string",        "teamSlug": "string",        "kind": "tool",        "name": "string",        "exposedName": "service-status__check_outage",        "title": "string",        "description": "string",        "minRole": "owner",        "available": true,        "unavailableReason": "server_disabled",        "serverCapturesPayloads": true      }    ]  }}