---
title: "List External Keys"
method: GET
path: "/api/v1/external-keys"
tags: ["external-keys"]
---

# List External Keys

`GET /api/v1/external-keys`

## 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`
- Auth: none declared

List all external API keys for the current workspace.

Issue #381: owner-only (router-level dependency); members, admins, and viewers
are rejected with 403 before reaching this handler.
Issue #385: workspace-scoped — returns every key registered in
`current_workspace_id` regardless of the original creator's user_id, since
the workspace owner is the sole manager of these keys.

Returns masked values for security.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- ExternalKeyListResponse: External API keys list response.
  - `keys` ExternalKeyResponse[], required
    - `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
  - `total` integer, 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)