WSO2 · JSON Structure

Admin Api Update Platform Gateway Request Structure

Request body for PUT /gateways/{gatewayId}. Per PUT semantics, send the full resource representation. Name and vhost are immutable (server validates they match the existing gateway).

Type: object Properties: 6 Required: 3
API ManagementGatewaysOpen SourceAPI LifecycleGraphQLSOAPREST

Update Platform Gateway Request is a JSON Structure definition published by WSO2, describing 6 properties, of which 3 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

name vhost displayName description properties permissions

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑ 
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/wso2/refs/heads/main/json-structure/admin-api-update-platform-gateway-request-structure.json",
  "name": "Update Platform Gateway Request",
  "description": "Request body for PUT /gateways/{gatewayId}. Per PUT semantics, send the full resource\nrepresentation. Name and vhost are immutable (server validates they match the existing gateway).\n",
  "required": [
    "name",
    "displayName",
    "vhost"
  ],
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "pattern": "^[a-z0-9-]+$",
      "minLength": 3,
      "maxLength": 64,
      "description": "Gateway identifier (immutable; must match existing). Required for PUT full representation."
    },
    "vhost": {
      "type": "uri",
      "description": "Gateway URL (immutable; must match existing). Same name as platform API; type is URL. Example https://mg.wso2.com",
      "example": "https://mg.wso2.com"
    },
    "displayName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Human-readable gateway name",
      "example": "Production Gateway 01"
    },
    "description": {
      "type": "string",
      "maxLength": 1023,
      "description": "Optional description"
    },
    "properties": {
      "type": "object",
      "additionalProperties": true,
      "description": "Custom key-value properties for the gateway",
      "example": {
        "region": "us-west",
        "tier": "premium"
      }
    },
    "permissions": {
      "type": "object",
      "description": "Gateway visibility permissions (on-prem extension)",
      "properties": {
        "permissionType": {
          "type": "string",
          "enum": [
            "PUBLIC",
            "ALLOW",
            "DENY"
          ],
          "default": "PUBLIC"
        },
        "roles": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "List of roles for ALLOW/DENY permission types"
        }
      }
    }
  }
}