---
title: "Update a routing key"
method: PUT
path: "/api-public/v1/org/routing-keys/{routingKey}"
tags: ["Routing Keys"]
---

# Update a routing key

`PUT /api-public/v1/org/routing-keys/{routingKey}`

Updates an existing routing key's escalation policy mappings. The default routing key cannot be updated.

Request semantics:
- The `routingKey` path parameter is the existing routing key to update.
- The `routingKey` field in the request body is the updated/new routing key value that replaces the existing key.

The targets array is a list of escalation policy policySlugs that the routing key will target.

This API may be called a maximum of 2 times per second.

## Path parameters

- `routingKey` string, required

## Headers

- `X-VO-Api-Id` string, required
- `X-VO-Api-Key` string, required

## Request body

- RoutingKeyUpdatePayload — The payload for updating a routing key
  - `routingKey` string, required — The updated/new routing key value that replaces the existing routing key specified in the path.
  - `targets` string[], required — Array of escalation policy policySlugs that this routing key will target
  - `isMultiResponder` boolean — Whether this routing key should trigger multiple responders

## Response `200`

The updated routing key

- RoutingKeyUpdatePayload — The payload for updating a routing key
  - `routingKey` string, required — The updated/new routing key value that replaces the existing routing key specified in the path.
  - `targets` string[], required — Array of escalation policy policySlugs that this routing key will target
  - `isMultiResponder` boolean — Whether this routing key should trigger multiple responders

## Other responses

- `400` — Problem with the request arguments. The response payload may include an error message.
- `401` — Authentication parameters missing
- `403` — Authentication failed or rate-limit reached
- `404` — Path not found
- `409` — The updated routing key value in the request body already exists for another routing key.
- `500` — Internal Server Error

## Changes

- **2026-07-26** `7a7391256058` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/victorops/apis/victorops-api/changes/api-public/v1/org/routing-keys/:routingKey/put.md)

---

[API](https://skmtc.dev/victorops/apis/victorops-api.md) · [All operations](https://skmtc.dev/victorops/apis/victorops-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/victorops/victorops-api/revisions/7a7391256058/schema)