Gateway Routes API: Create and Manage Payment Routes

Routes are the core configuration objects in the Meterlane Agent Gateway. Each route binds a public URL path to an upstream HTTP service and sets the USDC price that agents must pay per request. You manage routes through the /api/routes endpoints using your Bearer API key. Changes take effect immediately — no redeployment required.

POST /api/routes

Creates a new payment route under your organisation.

POST https://gateway.meterlane.app/api/routes
Authorization: Bearer bp_live_…
Content-Type: application/json

Request body

string

required

The route path segment appended after your org slug, e.g. weather/forecast. Must be unique within your organisation.

number

required

The per-request price in USD charged to the caller, e.g. 0.01. Settled as USDC on-chain.

string

required

The full upstream URL that the gateway proxies paid requests to, e.g. https://api.example.com/forecast.

string

required

The blockchain network used for settlement. Accepted values: base, base-sepolia.

boolean

Whether the route accepts requests. Defaults to true. Set to false to pause the route without deleting it.

boolean

Whether the gateway streams the upstream response body. Defaults to false. Enable for SSE or chunked-transfer upstreams.

boolean

Whether the route appears in your public route listing. Defaults to false.

string

A human-readable description shown in the dashboard and MCP manifest.

Example request

curl -X POST https://gateway.meterlane.app/api/routes \
  -H "Authorization: Bearer bp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "weather/forecast",
    "priceUSD": 0.01,
    "targetUrl": "https://api.example.com/forecast",
    "network": "base",
    "active": true,
    "streaming": false,
    "discoverable": true,
    "description": "Real-time weather forecast endpoint"
  }'

Response `201 Created`

string

Unique identifier for the route, e.g. route_01hx9z2k3m4n5p6q.

string

The organisation this route belongs to.

string

The route path as stored.

number

Per-request price in USD.

string

The upstream URL this route proxies to.

string

Blockchain network used for settlement.

boolean

Whether the route is currently accepting requests.

boolean

Whether response streaming is enabled.

boolean

Whether the route appears in the public listing.

{
  "id": "route_01hx9z2k3m4n5p6q",
  "orgId": "org_01hx9abcdefg",
  "path": "weather/forecast",
  "priceUSD": 0.01,
  "targetUrl": "https://api.example.com/forecast",
  "network": "base",
  "active": true,
  "streaming": false,
  "discoverable": true,
  "description": "Real-time weather forecast endpoint"
}

GET /api/routes

Returns all routes belonging to your organisation.

GET https://gateway.meterlane.app/api/routes
Authorization: Bearer bp_live_…

Example request

curl https://gateway.meterlane.app/api/routes \
  -H "Authorization: Bearer bp_live_…"

Response `200 OK`

[
  {
    "id": "route_01hx9z2k3m4n5p6q",
    "orgId": "org_01hx9abcdefg",
    "path": "weather/forecast",
    "priceUSD": 0.01,
    "targetUrl": "https://api.example.com/forecast",
    "network": "base",
    "active": true,
    "streaming": false,
    "discoverable": true,
    "description": "Real-time weather forecast endpoint"
  },
  {
    "id": "route_01hx9z2k3m4n5p6r",
    "orgId": "org_01hx9abcdefg",
    "path": "news/headlines",
    "priceUSD": 0.005,
    "targetUrl": "https://api.example.com/headlines",
    "network": "base",
    "active": true,
    "streaming": false,
    "discoverable": false,
    "description": "Latest news headlines"
  }
]

PATCH /api/routes/:id

Updates one or more fields on an existing route. Only fields you include in the request body are changed.

PATCH https://gateway.meterlane.app/api/routes/:id
Authorization: Bearer bp_live_…
Content-Type: application/json

Path parameters

string

required

The route ID returned when the route was created, e.g. route_01hx9z2k3m4n5p6q.

Request body (all fields optional)

string

New route path segment. Must remain unique within your organisation.

number

Updated per-request price in USD.

string

Updated upstream URL.

string

Updated settlement network. Accepted values: base, base-sepolia.

boolean

Pass false to pause the route or true to resume it.

boolean

Enable or disable response streaming.

boolean

Show or hide the route in the public listing.

string

Updated human-readable description.

Example request

curl -X PATCH https://gateway.meterlane.app/api/routes/route_01hx9z2k3m4n5p6q \
  -H "Authorization: Bearer bp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "priceUSD": 0.02,
    "active": false
  }'

Response `200 OK`

Returns the full updated route object in the same shape as the POST response.

DELETE /api/routes/:id

Permanently deletes a route. Agents calling the deleted route URL will receive a 404 ROUTE_NOT_FOUND error immediately after deletion.

DELETE https://gateway.meterlane.app/api/routes/:id
Authorization: Bearer bp_live_…

Path parameters

string

required

The ID of the route to delete.

Example request

curl -X DELETE https://gateway.meterlane.app/api/routes/route_01hx9z2k3m4n5p6q \
  -H "Authorization: Bearer bp_live_…"

Response `204 No Content`

A successful deletion returns 204 with an empty body.

Deletion is permanent. If you want to stop a route from accepting requests without losing its configuration, set active to false using PATCH instead.

Gateway API

Corridor API

Gateway Routes API: Create and Manage Payment Routes

POST /api/routes

Request body

Example request

Response `201 Created`

GET /api/routes

Example request

Response `200 OK`

PATCH /api/routes/:id

Path parameters

Request body (all fields optional)

Example request

Response `200 OK`

DELETE /api/routes/:id

Path parameters

Example request

Response `204 No Content`

​POST /api/routes

​Request body

​Example request

​Response 201 Created

​GET /api/routes

​Example request

​Response 200 OK

​PATCH /api/routes/:id

​Path parameters

​Request body (all fields optional)

​Example request

​Response 200 OK

​DELETE /api/routes/:id

​Path parameters

​Example request

​Response 204 No Content

POST /api/routes

Request body

Example request

Response `201 Created`

GET /api/routes

Example request

Response `200 OK`

PATCH /api/routes/:id

Path parameters

Request body (all fields optional)

Example request

Response `200 OK`

DELETE /api/routes/:id

Path parameters

Example request

Response `204 No Content`