---
title: "Rename a route template"
method: PATCH
path: "/route-templates/{name}"
tags: ["Route Templates"]
---

# Rename a route template

`PATCH /route-templates/{name}`

## Request

- Base URL: `https://gajo.io/api/v1`
- URL: `https://gajo.io/api/v1/route-templates/{name}`
- Auth: API key in header `x-api-key`

**Requires a Pro plan.** Renames the template. Existing bindings keep working.

## Request body

- RenameTemplateRequest
  - `newName` string, required: 2-100 characters: letters, digits, hyphens and underscores. Unique per account.

## Response `200`

The renamed template.

- RouteTemplateResult: Envelope shared by every response.
  - `success` true, required: `true` when the request succeeded.
  - `message` string, nullable: Human-readable status or error message. Often `null` on reads.
  - `data` object, required: An abstract device-routing template: device slots only, no URLs.
    - `name` string, required
    - `description` string, nullable, required
    - `active` boolean, required
    - `createdDate` string, date-time, required
    - `updatedDate` string, date-time, nullable, required
    - `rules` object[], required
      - `deviceType` 'Android' | 'IOS' | 'Mobile' | 'Tablet' | 'Desktop' | 'Default', required: Device slot used by route templates and Device bindings. At redirect time OS-specific slots (`Android`, `IOS`) are matched first, then device classes (`Mobile`, `Tablet`, `Desktop`), then `Default` catches everything else.
      - `priority` integer, required: Position in the template (0-based, request order).

## Other responses

- `400`: Invalid request. `message` explains what to fix.
- `401`: The `x-api-key` header is missing, or the key is unknown or revoked.
- `403`: Your plan is not Pro (the message names the Pro feature).
- `404`: No route template with this name.
- `429`: Per-minute rate limit exceeded. Wait `Retry-After` seconds.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/gajo/apis/gajo-api.md) · [All operations](https://skmtc.dev/gajo/apis/gajo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gajo/apis/gajo-api/revisions/de6fe920cc26?raw)