---
title: "Update API key"
method: PATCH
path: "/v1/api-keys/{api_key_id}"
tags: ["api_keys"]
---

# Update API key

`PATCH /v1/api-keys/{api_key_id}`

Update a specific API key by its ID.

Args:
    api_key_id: The ID of the API key to update.
    params: The parameters to update.

Returns:
    ApiKey: The updated API key details.

## Path parameters

- `api_key_id` string, uuid, required — The ID of the API key to update

## Request body

- ApiKeyUpdateParams — Parameters for updating an API key.
  - `name` string, nullable — A name/description for the API key
  - `expires_at` string, date-time, nullable — Optional expiration datetime

## Response `200`

The updated API key details

- ApiKey — Response model for an API key.
  - `id` string, required — The ID of the API key
  - `name` string, required — The name of the API key
  - `redacted_value` string, required — The redacted value of the API key
  - `expires_at` string, date-time, nullable — The expiration datetime of the API key
  - `created_at` string, date-time, required — The creation datetime of the API key
  - `updated_at` string, date-time, required — The last update datetime of the API key
  - `last_active_at` string, date-time, nullable — The last active datetime of the API key
  - `object` 'api_key' — The type of the object
  - `scope` Scope[], nullable — The scope of the API key
    - `method` 'read' | 'write' | 'delete' | 'list' | 'create' | 'search', required
    - `resource_type` 'store', nullable
    - `resource_id` union
      - string
      - string, uuid

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mixedbread/apis/mxbai-omni.md) · [All operations](https://skmtc.net/mixedbread/apis/mxbai-omni/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixedbread/mxbai-omni/revisions/2eece97b5ae5/schema)