> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toolzz.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Ceder moedas

> Este endpoint permite inserir moedas na carteira de um aluno.

## Parâmetros

<ParamField body="user_id" type="string" required>
  ID do usuário ao qual as moedas serão atribuídas. Opcional. Deve ser uma string UUID ou identificador único do usuário no sistema.
</ParamField>

<ParamField body="email" type="string">
  E-mail do usuário ao qual as moedas serão atribuídas. Opcional. Utilizado como alternativa ao `user_id`. Deve ser um endereço de e-mail válido.
</ParamField>

<ParamField body="amount" type="integer">
  Quantidade de moedas a serem adicionadas ao saldo do usuário. Opcional. Deve ser um número inteiro positivo. Se o campo amount estiver ausente, nulo ou inválido, o sistema utilizará o valor padrão de 100 moedas.
</ParamField>

## Segurança

Para acessar este endpoint, é necessário mandar o "x-auth-version v2", e enviar um token de acesso válido através do cabeçalho de autorização (Authorization) da requisição. A API é protegida por outras medidas de segurança para garantir a proteção dos dados dos usuários.