Skip to main content
POST
Crear una nueva clave de API
Este endpoint requiere una clave de API de gestión. No se aceptan las claves de API estándar de Gateway.
La clave de API en texto sin formato se devuelve una sola vez, al crearla. Se aceptan los campos de compatibilidad limit, limit_reset e include_byok_in_limit; actualmente, Phaseo trata include_byok_in_limit solo por compatibilidad y siempre excluye BYOK del límite de esta clave.

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer

Cuerpo

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

"Analytics Service Key"

workspace_id
string<uuid>

Anulación opcional del espacio de trabajo para llamadas internas.

scopes
Ejemplo:

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

limit
number | null

Límite de gasto opcional en USD para esta clave.

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
predeterminado:false
soft_blocked
boolean
predeterminado:false
limits
object

Respuesta

Clave de API creada

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