> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# API-Key aktualisieren

> Aktualisiert einen vorhandenen Benutzer-API-Key für die aktuelle Organisation.

## Überblick

Verwenden Sie diesen Endpunkt, um Name, Nutzungslimit, erlaubte Modelle, Ablaufzeit oder Status eines vorhandenen Benutzer-API-Keys zu aktualisieren.

## Request-Body

Mindestens ein Feld muss angegeben werden.

| Feld            | Typ            | Standard / Grenzen               | Beschreibung                                                                                                                                                  |
| --------------- | -------------- | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `status`        | enum           | -                                | `active`, `inactive`, `revoked`                                                                                                                               |
| `name`          | string         | Länge `1-50`                     | Aktualisierter Anzeigename                                                                                                                                    |
| `limitAmount`   | number \| null | min. `0`, Eingabe max. `1000000` | `null` = unbegrenzt, `0` = Nullkontingent. Positive Werte werden auf ein gespeichertes Limit normalisiert, das 100000 USD Gegenwert nicht überschreiten kann. |
| `limitCurrency` | enum           | Standardwert `USD`               | Nur USD. Das Senden von `CNY` gibt `400 currency_retired` zurück.                                                                                             |
| `models`        | string\[]      | -                                | Aktualisierte Allowlist für logische Modelle                                                                                                                  |
| `expiresAt`     | string \| null | RFC3339-Datetime                 | `null` entfernt die Ablaufzeit                                                                                                                                |

## Hinweise

* Hard Delete wird in Management API v1 bewusst nicht unterstützt.
* `revoked` ist für den normalen operativen Einsatz ein Endzustand; erstellen Sie lieber einen neuen Key, statt auf eine spätere Reaktivierung zu hoffen.

## Beispiel

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456" \
    -H "Authorization: Bearer mt-your-management-token" \
    -H "Content-Type: application/json" \
    -d '{
      "status": "inactive",
      "limitAmount": 0
    }'
  ```
</RequestExample>

## Anfrage / Antwort

Verwenden Sie das interaktive OpenAPI-Panel oben für das genaue Schema und die Response-Felder.

## Response example

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "key_abc123def456",
    "name": "Backend Worker",
    "key_prefix": "sk-live...",
    "status": "inactive",
    "limit_amount": 0,
    "limit_amount_decimal": "0",
    "used_amount": 148.25,
    "used_amount_decimal": "148.25",
    "models": [
      "gpt-5-mini",
      "claude-3-7-sonnet"
    ],
    "expires_at": "2026-12-31T23:59:59.000Z",
    "last_used_at": "2026-07-08T03:12:45.000Z",
    "created_at": "2026-07-01T10:00:00.000Z"
  }
  ```
</ResponseExample>

## Important fields

<ResponseField name="id" type="string">API key identifier used in follow-up Management API calls.</ResponseField>
<ResponseField name="name" type="string">Display name for the API key.</ResponseField>
<ResponseField name="key_prefix" type="string">Non-secret key prefix for display and support.</ResponseField>
<ResponseField name="status" type="string">One of `active`, `inactive`, or `revoked`.</ResponseField>
<ResponseField name="limit_amount" type="number | null">Spending cap in USD as a JSON number for display. `null` means unlimited.</ResponseField>
<ResponseField name="limit_amount_decimal" type="string | null">Exact spending cap in USD as a decimal string. `null` means unlimited.</ResponseField>
<ResponseField name="used_amount" type="number">Accumulated usage in USD as a JSON number for display.</ResponseField>
<ResponseField name="used_amount_decimal" type="string">Exact accumulated usage in USD as a decimal string.</ResponseField>
<ResponseField name="models" type="string[]">Per-key model allowlist. Empty array means no additional key-level model restriction.</ResponseField>
<ResponseField name="expires_at" type="string | null">ISO timestamp when the key expires, or `null` for no expiry.</ResponseField>
<ResponseField name="last_used_at" type="string | null">ISO timestamp for the most recent use, or `null` when unused.</ResponseField>
<ResponseField name="created_at" type="string">ISO creation timestamp.</ResponseField>