Skip to main content
PATCH
/
fees
/
{feeId}
Atualizar Taxa
curl --request PATCH \
  --url https://api.example.com/fees/{feeId} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>"
}
'
{
  "feeId": "019525fd-8f54-7d6b-c3e9-5f7a9b1d3e5b",
  "externalProductRef": "prod_stripe_abc",
  "externalPriceRef": "price_stripe_abc",
  "externalBillingMeterRef": "meter_stripe_abc",
  "name": "API Calls Updated",
  "description": "Per-API-call usage fee",
  "eventName": "api.call",
  "currency": "BRL",
  "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 fee:write.

​
Headers

​
Authorization
string
required
Bearer token.

​
Parametros de Path

​
feeId
string
required
ID da taxa.

​
Corpo da Requisicao

​
name
string
Nome atualizado.
​
description
string
Descricao atualizada.

​
Resposta

​
feeId
string
ID da taxa.
​
externalProductRef
string
External product reference.
​
externalPriceRef
string
External price reference.
​
externalBillingMeterRef
string
External billing meter reference.
​
name
string
Nome da taxa.
​
description
string
Descricao da taxa.
​
eventName
string
Event name.
​
currency
string
Codigo da moeda.
​
status
string
Status da taxa.
​
createdBy
string
Identificador do criador.
​
createdAt
string
Timestamp de criacao.
​
updatedBy
string
Identificador do ultimo atualizador.
​
updatedAt
string
Timestamp da ultima atualizacao.
{
  "feeId": "019525fd-8f54-7d6b-c3e9-5f7a9b1d3e5b",
  "externalProductRef": "prod_stripe_abc",
  "externalPriceRef": "price_stripe_abc",
  "externalBillingMeterRef": "meter_stripe_abc",
  "name": "API Calls Updated",
  "description": "Per-API-call usage fee",
  "eventName": "api.call",
  "currency": "BRL",
  "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/fees/019525fd-8f54-7d6b-c3e9-5f7a9b1d3e5b \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "API Call Fee v2",
  "description": "Updated fee description"
}'

​
Codigos de Erro

StatusCodigoDescricao
400validation_errorEntrada invalida ou campos obrigatorios ausentes
401unauthorizedAutenticacao ausente ou invalida
403forbiddenPermissoes insuficientes
404fee.not_foundTaxa nao encontrada
500internal_server_errorOcorreu um erro inesperado