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

​
Headers

​
Authorization
string
required
Bearer token.

​
Corpo da Requisicao

​
name
string
required
Nome do token. Max 255 caracteres.
​
description
string
required
Description.
​
type
string
required
Token type. One of: AUDIO_TO_TEXT, IMAGE_TO_TEXT, MEMORY, PLANNING, RESPONSE, RETRIEVAL, SUMMARY, TOOLS, TRANSCRIPTION, WEBSCRAPING.
​
value
string
required
Decimal value per unit.
​
currency
string
required
Um de: USD, BRL, EUR.

​
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": "Planning Token",
  "description": "LLM planning token",
  "type": "PLANNING",
  "value": "0.005",
  "currency": "USD",
  "status": "ACTIVE",
  "createdBy": "019525fd-56a8-7db4-8c3e-2a1b4d6f8e0c",
  "createdAt": "2026-03-25T14:00:00.000Z",
  "updatedBy": "019525fd-56a8-7db4-8c3e-2a1b4d6f8e0c",
  "updatedAt": "2026-03-25T14:00:00.000Z"
}

​
Exemplos de Codigo

curl -X POST https://api.awsales.io/admin/tokens \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Response Token",
  "description": "Token consumed per response generation",
  "type": "RESPONSE",
  "value": "0.005",
  "currency": "BRL"
}'

​
Codigos de Erro

StatusCodigoDescricao
400validation_errorEntrada invalida ou campos obrigatorios ausentes
401unauthorizedAutenticacao ausente ou invalida
403forbiddenPermissoes insuficientes
409token.name_type_currency_already_existsToken with same name, type, and currency already exists
500internal_server_errorOcorreu um erro inesperado