Skip to main content
PATCH
/
tokens
/
{tokenId}
Atualizar Token
curl --request PATCH \
  --url https://api.example.com/tokens/{tokenId} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "value": "<string>"
}
'
{
  "tokenId": "019525fd-f5cc-7dc1-c9e5-1f3a5b7d9e1b",
  "name": "Response Token V2",
  "description": "LLM response token",
  "type": "RESPONSE",
  "value": "0.015",
  "currency": "USD",
  "status": "ACTIVE",
  "createdBy": "019525fd-56a8-7db4-8c3e-2a1b4d6f8e0c",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedBy": "019525fd-56a8-7db4-8c3e-2a1b4d6f8e0c",
  "updatedAt": "2026-03-25T14:30:00.000Z"
}
Requer permissao token:write.

Headers

Authorization
string
required
Bearer token.

Parametros de Path

tokenId
string
required
UUID do token.

Corpo da Requisicao

name
string
Nome atualizado.
description
string
Descricao atualizada.
value
string
Valor atualizado.

Resposta

tokenId
string
UUID do token.
name
string
Nome do token.
description
string
Descricao do token.
type
string
Token type.
value
string
Decimal value per unit.
currency
string
Codigo da moeda.
status
string
Status do token.
createdBy
string
Identificador do criador.
createdAt
string
Timestamp de criacao.
updatedBy
string
Identificador do ultimo atualizador.
updatedAt
string
Timestamp da ultima atualizacao.
{
  "tokenId": "019525fd-f5cc-7dc1-c9e5-1f3a5b7d9e1b",
  "name": "Response Token V2",
  "description": "LLM response token",
  "type": "RESPONSE",
  "value": "0.015",
  "currency": "USD",
  "status": "ACTIVE",
  "createdBy": "019525fd-56a8-7db4-8c3e-2a1b4d6f8e0c",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedBy": "019525fd-56a8-7db4-8c3e-2a1b4d6f8e0c",
  "updatedAt": "2026-03-25T14:30:00.000Z"
}

Exemplos de Codigo

curl -X PATCH https://api.awsales.io/admin/tokens/019525fd-f5cc-7dc1-c9e5-1f3a5b7d9e1b \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Response Token v2",
  "value": "0.008"
}'

Codigos de Erro

StatusCodigoDescricao
400validation_errorEntrada invalida ou campos obrigatorios ausentes
401unauthorizedAutenticacao ausente ou invalida
403forbiddenPermissoes insuficientes
404token.not_foundToken nao encontrado
500internal_server_errorOcorreu um erro inesperado