--- title: Rename a dynamic route --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [AI Gateway](https://developers.cloudflare.com/api/python/resources/ai_gateway) [Dynamic Routing](https://developers.cloudflare.com/api/python/resources/ai_gateway/subresources/dynamic_routing) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Rename a dynamic route ai\_gateway.dynamic\_routing.update(strid, DynamicRoutingUpdateParams\*\*kwargs) -> [DynamicRoutingUpdateResponse]() PATCH/accounts/{account\_id}/ai-gateway/gateways/{gateway\_id}/routes/{id} Updates the name of a dynamic route. To change routing behaviour, create and deploy a new version. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `AI Gateway Write` ##### ParametersExpand Collapse account\_id: str [Link to this property](<#(resource)%20ai_gateway.dynamic_routing%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) gateway\_id: str [Link to this property](<#(resource)%20ai_gateway.dynamic_routing%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20gateway_id%20%3E%20(schema)>) id: str [Link to this property](<#(resource)%20ai_gateway.dynamic_routing%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20id%20%3E%20(schema)>) name: str minLength1 [Link to this property](<#(resource)%20ai_gateway.dynamic_routing%20%3E%20(method)%20update%20%3E%20(params)%20default%20%3E%20(param)%20name%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class DynamicRoutingUpdateResponse: …
route: Route id: str Link to this property account\_tag: str Link to this property created\_at: datetime formatdate-time Link to this property
deployment: RouteDeployment created\_at: str Link to this property deployment\_id: str Link to this property version\_id: str Link to this property
Link to this property
elements: List\[RouteElement] One of the following:
class RouteElementUnionMember0: … id: str Link to this property
outputs: RouteElementUnionMember0Outputs
next: RouteElementUnionMember0OutputsNext element\_id: str Link to this property
Link to this property
Link to this property type: Literal\["start"] Link to this property
Link to this property
class RouteElementUnionMember1: … id: str Link to this property
outputs: RouteElementUnionMember1Outputs
false: RouteElementUnionMember1OutputsFalse\_ element\_id: str Link to this property
Link to this property
true: RouteElementUnionMember1OutputsTrue\_ element\_id: str Link to this property
Link to this property
Link to this property
properties: RouteElementUnionMember1Properties conditions: Optional\[object] Link to this property
Link to this property type: Literal\["conditional"] Link to this property
Link to this property
class RouteElementUnionMember2: … id: str Link to this property
outputs: Dict\[str, RouteElementUnionMember2Outputs] element\_id: str Link to this property
Link to this property type: Literal\["percentage"] Link to this property
Link to this property
class RouteElementUnionMember3: … id: str Link to this property
outputs: RouteElementUnionMember3Outputs
fallback: RouteElementUnionMember3OutputsFallback element\_id: str Link to this property
Link to this property
success: RouteElementUnionMember3OutputsSuccess element\_id: str Link to this property
Link to this property
Link to this property
properties: RouteElementUnionMember3Properties key: str Link to this property limit: float Link to this property
limit\_type: Literal\["count", "cost"] One of the following: "count" Link to this property "cost" Link to this property
Link to this property window: float Link to this property
Link to this property type: Literal\["rate"] Link to this property
Link to this property
class RouteElementUnionMember4: … id: str Link to this property
outputs: RouteElementUnionMember4Outputs
fallback: RouteElementUnionMember4OutputsFallback element\_id: str Link to this property
Link to this property
success: RouteElementUnionMember4OutputsSuccess element\_id: str Link to this property
Link to this property
Link to this property
properties: RouteElementUnionMember4Properties model: str Link to this property provider: str Link to this property retries: float Link to this property timeout: float Link to this property
Link to this property type: Literal\["model"] Link to this property
Link to this property
class RouteElementUnionMember5: … id: str Link to this property
outputs: Dict\[str, RouteElementUnionMember5Outputs] element\_id: str Link to this property
Link to this property type: Literal\["end"] Link to this property
Link to this property
Link to this property gateway\_id: str Link to this property modified\_at: datetime formatdate-time Link to this property name: str minLength1 Link to this property
version: RouteVersion
active: Literal\["true", "false"] One of the following: "true" Link to this property "false" Link to this property
Link to this property created\_at: str Link to this property data: str Link to this property version\_id: str Link to this property is\_valid: Optional\[bool] Link to this property
Link to this property
Link to this property success: bool Link to this property
[Link to this property](<#(resource)%20ai_gateway.dynamic_routing%20%3E%20(model)%20dynamic_routing_update_response%20%3E%20(schema)>) ### Rename a dynamic route Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) dynamic_routing = client.ai_gateway.dynamic_routing.update( id="54442216", account_id="0d37909e38d3e99c29fa2cd343ac421a", gateway_id="54442216", name="Route Name", ) print(dynamic_routing.route) ``` 200 example ``` { "route": { "id": "id", "account_tag": "account_tag", "created_at": "2019-12-27T18:11:19.117Z", "deployment": { "created_at": "created_at", "deployment_id": "deployment_id", "version_id": "version_id" }, "elements": [ { "id": "id", "outputs": { "next": { "elementId": "elementId" } }, "type": "start" } ], "gateway_id": "gateway_id", "modified_at": "2019-12-27T18:11:19.117Z", "name": "x", "version": { "active": "true", "created_at": "created_at", "data": "data", "version_id": "version_id", "is_valid": true } }, "success": true } ``` ##### Returns Examples 200 example ``` { "route": { "id": "id", "account_tag": "account_tag", "created_at": "2019-12-27T18:11:19.117Z", "deployment": { "created_at": "created_at", "deployment_id": "deployment_id", "version_id": "version_id" }, "elements": [ { "id": "id", "outputs": { "next": { "elementId": "elementId" } }, "type": "start" } ], "gateway_id": "gateway_id", "modified_at": "2019-12-27T18:11:19.117Z", "name": "x", "version": { "active": "true", "created_at": "created_at", "data": "data", "version_id": "version_id", "is_valid": true } }, "success": true } ```