# update

## Usage

```bash
bdy distro route update|edit [options] <identifier> <route-id>
```

## Arguments

| **Argument** | **Description** |
| :--- | :--- |
| `identifier` | Human-readable ID of the distribution (required) |
| `route-id` | ID of the route (find via "bdy distro route ls") (required) |

## Options

| **Option** | **Description** |
| :--- | :--- |
| `-w, --workspace <domain>` | Workspace URL handle. Can be set via variable: BUDDY_WORKSPACE |
| `-p, --project <name>` | Project name. Can be set via variable: BUDDY_PROJECT |
| `-t, --type <type>` | Type of the route. Allowed: PROXY, PROXY_NO_CACHE, REDIRECT, CLOAKING |
| `-s, --subdomain <subdomain>` | Optional sub-name prepended to --domain (e.g. |
| `-d, --domain <domain>` | Zone for the route — pass the WHOLE string from `bdy domain ls` (e.g. "example.com" or "my-app.example.dev"). Do NOT split a multi-level zone into subdomain+domain; the entire bought/claimed string is one zone and goes here as-is. Use --subdomain only to route a sub-name within this zone |
| `--path <path>` | Path of the route |
| `--target <targets...>` | Target of the route (can be used multiple times). Format: "region=default,url=https://example.com,artifact=artifact:version,sandbox=sandbox:endpoint" To use "," in value use \, For external url target use url (required), region (optional) For artifact target use artifact (required), region (optional) For sandbox target use sandbox (required), region (optional) Region can be Default, NorthAmerica, Europe, Asia, Oceania, SouthAmerica, Africa, Antarctica or two letter country name If no region is specified or default is used, the target is used as the fallback for all locations. Default region is mandatory |
| `-h, --help` | display help for command |

## Examples

### ## update route path

```bash
bdy distro route update distro-identifier route-id --path="/public/*.js"
```

### ## update route subdomain & domain

```bash
bdy distro route update distro-identifier route-id --subdomain=new --domain=test.com
```

### ## update route target

```bash
bdy distro route update distro-identifier route-id --target url=https://example.com
```


---
Original source: https://buddy.works/docs/cli/distro/route/update