Update rule | Vercel REST API

APIs & SDKs

Update rule

PATCHhttps://api.vercel.com/ai-gateway/rules

Update a routing rule (enabled, action, or description)

https://api.vercel.com/ai-gateway/rules

const response = await fetch('https://api.vercel.com/ai-gateway/rules?teamId=string&slug=string', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

Response

{
  "action": {
    "reason": "Customer requested refund",
    "rewriteModel": "string"
  },
  "createdAt": "123",
  "createdBy": "string",
  "deleted": "false",
  "description": "string",
  "enabled": "false",
  "match": {
    "model": "string"
  },
  "ownerId": "example_id",
  "ruleId": "example_id",
  "type": "deny",
  "updatedAt": "123",
  "updatedBy": "string"
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Query parameters

teamIdstringOptional

The Team identifier to perform the request on behalf of.

slugstringOptional

The Team slug to perform the request on behalf of.

Response

200Success

actionobjectOptional

createdAtnumberRequired

createdBystringOptional

deletedbooleanOptional

descriptionstringOptional

enabledbooleanRequired

matchobjectOptional

ownerIdstringRequired

ruleIdstringRequired

typestringRequired

updatedAtnumberRequired

updatedBystringOptional

Errors

400Error

401The request is not authorized.

403You do not have permission to access this resource.

404Error

410Error

500Error

Cross-link map: Update rule (/docs/rest-api/ai-gateway/update-rule)

From the Vercel docs graph (built 2026-10-14T10:24:21.026Z), spanning vercel.com docs + KB, nextjs.org, ai-sdk.dev, and other Vercel documentation sites. Full graph as JSON: https://vercel.com/docs/graph.json

Semantically closest pages

Create rule — POST /ai-gateway/rules — Create a routing rule
List rules — GET /ai-gateway/rules — List the authenticated team's routing rules
Delete rule — DELETE /ai-gateway/rules — Delete a routing rule \(soft delete\)
Edit a routing rule — PATCH /v1/projects/{projectId}/routes/{routeId} — Replace a routing rule identified by its ID, or restore it from the cu
Add a routing rule — POST /v1/projects/{projectId}/routes — Add a single routing rule to a project at a specified position. Defaults to the e

This page links to (1)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

Pages that link here (1)

By site: vercel-docs (1)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

https://api.vercel.com/ai-gateway/rules

const response = await fetch('https://api.vercel.com/ai-gateway/rules?teamId=string&slug=string', {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

Response

{
  "action": {
    "reason": "Customer requested refund",
    "rewriteModel": "string"
  },
  "createdAt": "123",
  "createdBy": "string",
  "deleted": "false",
  "description": "string",
  "enabled": "false",
  "match": {
    "model": "string"
  },
  "ownerId": "example_id",
  "ruleId": "example_id",
  "type": "deny",
  "updatedAt": "123",
  "updatedBy": "string"
}

OpenAPI Specification