---
title: "Replace Upstream Key"
method: PUT
path: "/gateway/upstreams/{upstream_id}/api-key"
tags: ["gateway"]
---

# Replace Upstream Key

`PUT /gateway/upstreams/{upstream_id}/api-key`

## Request

- Base URL: `https://api.os3robotics.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.os3robotics.com/gateway/upstreams/{upstream_id}/api-key`
- Auth: HTTP bearer

Replaces the upstream's vendor key; only an upstream created through this API has
one.

## Path parameters

- `upstream_id` string, uuid, required

## Request body

- UpstreamKeyIn
  - `api_key` string, password, required

## Response `204`

Successful Response

## Other responses

- `422`: Validation Error

---

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