v6

latestOpenAPI 3.0.3raw.githubusercontent.com2025-11-28172255.4 KB
Mappings

Update a mapping

Updates an existing gateway mapping configuration.

patch/gateway/{gateway_topic}/mapping/details

Path parameters

gateway_topicstring required

Unique topic identifier of the gateway

Query parameters

method'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'OPTIONS' | 'HEAD' required

HTTP method for the mapping in uppercase

pathstring required

URL path for the mapping including the leading slash

Request body

pathstring

Updated URL path for the mapping

is_publicboolean

Whether the mapping is publicly accessible

timeoutinteger

Updated timeout in milliseconds for mapping requests

traffic_distributionobject

Updated traffic distribution configuration for A/B testing

Example request

{
  "path": "/api/users/v2",
  "limit": {
    "request": 5000,
    "time": 1000
  },
  "timeout": 60000,
  "traffic_distribution": {
    "1": 80,
    "2": 20
  }
}

Response

Mapping updated successfully

messagestring

Example response

{
  "message": "success"
}