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

# Update a Route

`PATCH /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
    - `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` object — 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
    - `format` 'default' | 'http' | 'json' — Payload format sent into function.
    - `max_concurrency` integer — Maximum number of hot functions concurrency
    - `config` object — Route configuration - overrides application configuration
    - `timeout` integer — Timeout for executions of this route. Value in Seconds
    - `idle_timeout` integer — Hot functions idle timeout before termination. Value in Seconds
    - `jwt_key` string — Signing key for JWT

## Response `200`

Route updated

- RouteWrapper
  - `message` string
  - `error` ErrorBody
    - `message` string
    - `fields` string
  - `route` Route, required
    - `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` object — 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
    - `format` 'default' | 'http' | 'json' — Payload format sent into function.
    - `max_concurrency` integer — Maximum number of hot functions concurrency
    - `config` object — Route configuration - overrides application configuration
    - `timeout` integer — Timeout for executions of this route. Value in Seconds
    - `idle_timeout` integer — Hot functions idle timeout before termination. Value in Seconds
    - `jwt_key` string — Signing key for JWT

## Other responses

- `400` — Invalid route due to parameters being missing or invalid.
- `404` — App does not exist.
- `default` — Unexpected error

## Changes

- **2016-12-14** `3417c321db17` — 1 info
  - endpoint added
- **2016-10-14** `c0f4fbb1ba30` — 1 breaking
  - api removed without deprecation

[Change history](https://skmtc.dev/iron-io/apis/ironfunctions/changes/apps/:app/routes/:route/patch.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-service-production.skmtc.workers.dev/v1/apis/iron-io/ironfunctions/revisions/53fd9cdd70fc/schema)