Skip to main content
PATCH
Actualizar una clave de API
Este endpoint requiere una clave de API de gestión. No se aceptan las claves de API estándar de la pasarela.
Usa esta ruta para cambiar el nombre de una clave, ajustar sus ámbitos, definir su caducidad, deshabilitarla o establecer un límite de gasto con limit y limit_reset.

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

Parámetros de ruta

id
string
requerido

Identificador o hash de la clave de API.

Cuerpo

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

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

limit
number | null

Límite de gasto opcional en USD para esta clave. Establécelo en null para borrarlo.

Rango requerido: x >= 0
limit_reset
enum<string>

Período usado para la ventana del límite de gasto.

Opciones disponibles:
daily,
weekly,
monthly
include_byok_in_limit
boolean

Se acepta por compatibilidad. El comportamiento actual de Phaseo siempre excluye BYOK de este límite.

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

Respuesta

Metadatos de la clave de API actualizados

data
object
requerido
Última modificación el 2 de octubre de 2026