Skip to main content
PATCH
Atualizar uma chave de API
Este endpoint requer uma chave de API de gerenciamento. Chaves de API padrão do gateway não são aceitas.
Use esta rota para renomear uma chave, ajustar escopos, definir expiração, desativá-la ou definir um limite de gastos com limit e limit_reset.

Autorizações

Authorization
string
header
obrigatório

Autenticação com token Bearer

Parâmetros de caminho

id
string
obrigatório

Identificador ou hash da chave de API.

Corpo

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

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

limit
number | null

Limite de gastos opcional em USD para esta chave. Defina como null para removê-lo.

Intervalo obrigatório: x >= 0
limit_reset
enum<string>

Período usado para a janela do limite de gastos.

Opções disponíveis:
daily,
weekly,
monthly
include_byok_in_limit
boolean

Aceito por compatibilidade. O comportamento atual do Phaseo sempre exclui o BYOK deste limite.

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

Resposta

Metadados da chave de API atualizados

data
object
obrigatório
Última modificação em 2 de outubro de 2026