---
title: "Update a Route"
method: PUT
path: "/apps/{app}/routes/{route}"
tags: ["Routes"]
---

# Update a Route

`PUT /apps/{app}/routes/{route}`

Update a route

## Path parameters

- `app` string, required
- `route` string, required

## Request body

- RouteWrapper
  - `message` string
  - `error` ErrorBody
    - `message` string
    - `fields` string
  - `route` Route, required
    - `app_name` string — App this route belongs to.
    - `path` string — URL path that will be matched to this route
    - `image` string — Name of Docker image to use in this route. You should include the image tag, which should be a version number, to be more accurate. Can be overridden on a per route basis with route.image.
    - `headers` string — Map of http headers that will be sent with the response
    - `memory` integer — Max usable memory for this route (MiB).
    - `type` 'sync' | 'async' — Route type
    - `config` object — Route configuration - overrides application configuration

## Response `201`

Route updated

- RouteWrapper
  - `message` string
  - `error` ErrorBody
    - `message` string
    - `fields` string
  - `route` Route, required
    - `app_name` string — App this route belongs to.
    - `path` string — URL path that will be matched to this route
    - `image` string — Name of Docker image to use in this route. You should include the image tag, which should be a version number, to be more accurate. Can be overridden on a per route basis with route.image.
    - `headers` string — Map of http headers that will be sent with the response
    - `memory` integer — Max usable memory for this route (MiB).
    - `type` 'sync' | 'async' — Route type
    - `config` object — Route configuration - overrides application configuration

## Other responses

- `400` — One or more of the routes were invalid due to parameters being missing or invalid.
- `500` — Could not accept routes due to internal error.
- `default` — Unexpected error

## Changes

- **2016-11-21** `6ce2ca3fd00a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/iron-io/apis/ironfunctions/changes/apps/:app/routes/:route/put.md)

---

[API](https://skmtc.dev/iron-io/apis/ironfunctions.md) · [All operations](https://skmtc.dev/iron-io/apis/ironfunctions/llms.txt) · [OpenAPI document](https://skmtc.dev/iron-io/apis/ironfunctions/revisions/6ce2ca3fd00a?raw)