---
title: "Refresh User Key"
method: POST
path: "/api/admin/users/{user_id}/keys/{key_id}/refresh"
tags: ["admin-users", "admin-users"]
---

# Refresh User Key

`POST /api/admin/users/{user_id}/keys/{key_id}/refresh`

## Request

- Base URL: `https://grandline.luzomi.com`
- URL: `https://grandline.luzomi.com/api/admin/users/{user_id}/keys/{key_id}/refresh`
- Auth: none declared

Rotate a user's key (revoke old, mint new with fresh 90-day expiry), emailing
the new key by default.

## Path parameters

- `user_id` integer, required
- `key_id` integer, required

## Query parameters

- `send_email` boolean

## Response `200`

Successful Response

- AdminKeyIssued: Cleartext key shown to the operator once (also emailed when requested).
  - `user_id` integer, required
  - `key_id` integer, required
  - `name` string, required
  - `prefix` string, required
  - `key` string, required
  - `created_at` string, date-time, required
  - `expires_at` string, date-time, nullable, required
  - `emailed` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/luzomi/apis/grandline-api.md) · [All operations](https://skmtc.dev/luzomi/apis/grandline-api/llms.txt) · [OpenAPI document](https://skmtc.dev/luzomi/apis/grandline-api/revisions/4ce06aea012b?raw)