Zum Hauptinhalt springen
PATCH
API-Schlüssel aktualisieren
Für diesen Endpunkt ist ein Management-API-Schlüssel erforderlich. Standard-Gateway-API-Schlüssel werden nicht akzeptiert.
Mit dieser Route kannst du einen Schlüssel umbenennen, Berechtigungsbereiche anpassen, einen Ablauf festlegen, den Schlüssel deaktivieren oder mit limit und limit_reset ein Ausgabenlimit setzen.

Autorisierungen

Authorization
string
header
erforderlich

Authentifizierung mit Bearer-Token

Pfadparameter

id
string
erforderlich

Kennung oder Hash des API-Schlüssels.

Body

application/json
name
string
Minimum string length: 1
scopes
Beispiel:

"[\"chat.completions\",\"responses\"]"

limit
number | null

Optionales Ausgabenlimit in USD für diesen Schlüssel. Zum Löschen auf null setzen.

Erforderlicher Bereich: x >= 0
limit_reset
enum<string>

Zeitraum für das Ausgabenlimit-Fenster.

Verfügbare Optionen:
daily,
weekly,
monthly
include_byok_in_limit
boolean

Wird aus Kompatibilitätsgründen akzeptiert. Das aktuelle Phaseo-Verhalten schließt BYOK immer von diesem Limit aus.

expires_at
string<date-time> | null
disabled
boolean
soft_blocked
boolean
limits
object
department_id
string<uuid> | null

Abteilung, zu der dieser Schlüssel für Ratenlimits und Budgets der Abteilung gehört. Null bedeutet, dass der Schlüssel nur auf die Limits des gesamten Workspace angerechnet wird.

storage_locations
string[] | null

Wo du diesen Schlüssel aufbewahrst, zum Beispiel die Hosting-Plattform, in deren Umgebungsvariablen er liegt. Optional. Wenn einer dieser Orte ein Datenleck meldet, kannst du alle dort gespeicherten Schlüssel finden und widerrufen. Bekannte IDs: railway, vercel, netlify, render, fly, heroku, cloudflare, supabase, firebase, digitalocean, replit, modal, convex, koyeb, coolify, northflank, expo, deno-deploy, aws, google-cloud, azure, hetzner, vultr, linode, ovhcloud, scaleway, kubernetes, github, gitlab, circleci, bitbucket, 1password, bitwarden, hashicorp-vault, doppler, infisical, local-machine, own-server, other.

Maximum array length: 8
Pattern: ^[a-z0-9][a-z0-9-]{0,39}$
Beispiel:
ip_allowlist
object[]

Adressen, die den Schlüssel verwenden dürfen. Jeder Eintrag ist eine IPv4- oder IPv6-Adresse oder ein CIDR-Bereich mit einer Bezeichnung. Eine leere Liste erlaubt jede Adresse.

Maximum array length: 100

Antwort

API-Schlüsselmetadaten aktualisiert

data
object
erforderlich
Zuletzt geändert am 16. November 2026