---
title: "Update External Key"
method: PUT
path: "/api/v1/external-keys/{key_name}"
tags: ["external-keys"]
---

# Update External Key

`PUT /api/v1/external-keys/{key_name}`

## Request

- Base URL: `https://memory.kagura-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://memory.kagura-ai.com/api/v1/external-keys/{key_name}`
- Auth: none declared

Update an external API key value in the current workspace.

Issue #381: owner-only (router-level dependency).
Issue #385: workspace-scoped lookup by (key_name, workspace_id). Any owner
of the workspace can update any key registered in it, including keys
originally registered by a previous owner.

## Path parameters

- `key_name` string, required

## Headers

- `authorization` string, nullable

## Request body

- ExternalKeyUpdate: Update external API key request.
  - `value` string, required

## Response `200`

Successful Response

- ExternalKeyResponse: External API key response (masked). No ``id``: external keys are addressed by ``key_name`` (#1008 dropped the integer primary key from the response).
  - `key_name` string, required
  - `provider` string, required
  - `masked_value` string, required
  - `user_id` string, required
  - `enabled` boolean, required
  - `is_protected` boolean, required
  - `created_at` string, required
  - `updated_at` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud.md) · [All operations](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/revisions/09f17f5ada29?raw)