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

# Visão geral dos endpoints

> Todos os endpoints da API da TESA, agrupados por recurso, com o escopo exigido por cada um

<Warning>
  Rascunho: especificação em definição. Endpoints e campos podem mudar.
</Warning>

As páginas desta seção são geradas a partir da especificação OpenAPI 3.1 do repositório (`api/openapi.yaml`). Todos os caminhos são relativos à URL base proposta: `https://api.t3sa.com/v1` em produção ou `https://sandbox.api.t3sa.com/v1` em sandbox. Nenhuma das duas está ativa ainda.

Toda requisição leva `Authorization: Bearer <chave>`. Requisições que alteram estado aceitam `Idempotency-Key` e, na proposta atual, a assinatura HMAC opcional com `Tesa-Timestamp` e `Tesa-Signature`. Veja [Autenticação](/docs/api/autenticacao).

### Organização

| Método | Caminho | Escopo | Operação |
| - | - | - | - |
| `GET` | [`/organizacao`](/docs/api/referencia/obter-organizacao) | `read` | Obter organização |

### Carteiras

| Método | Caminho | Escopo | Operação |
| - | - | - | - |
| `GET` | [`/carteiras`](/docs/api/referencia/listar-carteiras) | `read` | Listar carteiras |
| `POST` | [`/carteiras`](/docs/api/referencia/vincular-carteira) | `admin` | Vincular carteira |
| `GET` | [`/carteiras/{id}`](/docs/api/referencia/obter-carteira) | `read` | Obter carteira |
| `POST` | [`/carteiras/{id}/desvincular`](/docs/api/referencia/desvincular-carteira) | `admin` | Desvincular carteira |

### Posições

| Método | Caminho | Escopo | Operação |
| - | - | - | - |
| `GET` | [`/posicoes`](/docs/api/referencia/obter-posicoes) | `read` | Obter posições |

### Política de alocação

| Método | Caminho | Escopo | Operação |
| - | - | - | - |
| `GET` | [`/politica-de-alocacao`](/docs/api/referencia/obter-politica-de-alocacao) | `read` | Obter política de alocação |
| `PUT` | [`/politica-de-alocacao`](/docs/api/referencia/propor-nova-politica) | `admin` | Propor nova política |

### Propostas

| Método | Caminho | Escopo | Operação |
| - | - | - | - |
| `GET` | [`/propostas`](/docs/api/referencia/listar-propostas) | `read` | Listar propostas |
| `POST` | [`/propostas`](/docs/api/referencia/criar-proposta-de-rebalanceamento) | `propose` | Criar proposta de rebalanceamento |
| `GET` | [`/propostas/{id}`](/docs/api/referencia/obter-proposta) | `read` | Obter proposta |
| `POST` | [`/propostas/{id}/aprovar`](/docs/api/referencia/aprovar-proposta) | `admin` | Aprovar proposta |
| `POST` | [`/propostas/{id}/rejeitar`](/docs/api/referencia/rejeitar-proposta) | `admin` | Rejeitar proposta |

### Resgates

| Método | Caminho | Escopo | Operação |
| - | - | - | - |
| `GET` | [`/resgates`](/docs/api/referencia/listar-resgates) | `read` | Listar resgates |
| `POST` | [`/resgates`](/docs/api/referencia/solicitar-resgate) | `propose` | Solicitar resgate |
| `GET` | [`/resgates/{id}`](/docs/api/referencia/obter-resgate) | `read` | Obter resgate |
| `POST` | [`/resgates/{id}/aprovar`](/docs/api/referencia/aprovar-resgate) | `admin` | Aprovar resgate |

### Registros

| Método | Caminho | Escopo | Operação |
| - | - | - | - |
| `GET` | [`/registros`](/docs/api/referencia/listar-registros-on-chain) | `read` | Listar registros on-chain |

### Rendimento e cobranças

| Método | Caminho | Escopo | Operação |
| - | - | - | - |
| `GET` | [`/rendimento`](/docs/api/referencia/consultar-rendimento) | `read` | Consultar rendimento |
| `GET` | [`/cobrancas`](/docs/api/referencia/listar-cobrancas) | `read` | Listar cobranças |
| `GET` | [`/cobrancas/{id}`](/docs/api/referencia/obter-cobranca) | `read` | Obter cobrança |

### Webhooks

| Método | Caminho | Escopo | Operação |
| - | - | - | - |
| `GET` | [`/webhooks`](/docs/api/referencia/listar-destinos-de-webhook) | `admin` | Listar destinos de webhook |
| `POST` | [`/webhooks`](/docs/api/referencia/cadastrar-destino-de-webhook) | `admin` | Cadastrar destino de webhook |

<Note>
  Nenhum endpoint recebe chave privada ou transação assinada. Depois da aprovação, as transações seguem para a empresa ou o seu custodiante, que assina e transmite. A TESA acompanha a confirmação on-chain e atualiza o status.
</Note>