# LetsSign Partners API

> API REST para sistemas parceiros operarem contas do LetsSign: envio de documentos para assinatura eletrônica, acompanhamento, download dos arquivos assinados, contatos, pastas, categorias, usuários e notificações por webhook. Autenticação por chave de integração no header `Authorization`. Documentação em português do Brasil.

Duas versões convivem. A v1 concentra a maior parte dos endpoints; a v2 substitui as listagens paginadas de documentos, categorias e usuários e o download do documento com anexos. Use a v2 quando o endpoint existir nela e a v1 para o restante. Os dez eventos de webhook estão descritos nos dois documentos. Cada referência existe em Markdown, para leitura direta, e em OpenAPI 3.1 JSON, para gerar clientes e ferramentas; o `operationId` de cada operação é estável e é citado nas descrições que apontam substitutos de endpoints obsoletos.

## Guias

- [Quickstart](https://api.letssign.com.br/docs/guides/quickstart.md): Da chave de integração à primeira assinatura concluída, em cinco passos com as requisições prontas.
- [Autenticação e contas](https://api.letssign.com.br/docs/guides/autenticacao-e-contas.md): Como a chave do parceiro funciona, o que é uma conta, como descobrir o accountId e o que causa 401 e 403.
- [Webhooks](https://api.letssign.com.br/docs/guides/webhooks.md): Cadastro de URLs, envelope, os dez eventos, contrato de entrega e como tratar repetições.
- [Erros](https://api.letssign.com.br/docs/guides/erros.md): Formato Problem Details, o significado de cada status e o que vale repetir.
- [Paginação e filtros](https://api.letssign.com.br/docs/guides/paginacao-e-filtros.md): Modelo de paginação da v2, filtros de cada listagem e o modelo legado da v1.
- [Limites e features](https://api.letssign.com.br/docs/guides/limites-e-features.md): Features de plano exigidas por operação, cotas, tamanhos, prazos e caches.
- [Ferramentas e agentes de IA](https://api.letssign.com.br/docs/guides/ferramentas-e-agentes.md): Coleção Postman (também Bruno, Insomnia e Hoppscotch), servidor MCP a partir do OpenAPI, sandbox e como um agente deve operar a API.
- [Migração da v1 para a v2](https://api.letssign.com.br/docs/guides/migracao-v1-para-v2.md): Os quatro endpoints substituídos, com o mapeamento de parâmetros e respostas.
- [Changelog](https://api.letssign.com.br/docs/guides/changelog.md): Mudanças no contrato e na documentação da Partners API, da mais recente para a mais antiga.

## Referência

- [V1 Partners API em Markdown](https://api.letssign.com.br/docs/partners/v1.md): Envio de documentos para assinatura eletrônica, acompanhamento, download dos arquivos assinados, contatos, pastas, categorias, usuários e webhooks. Concentra a maior parte dos endpoints; quatro deles têm substitutos na v2.
- [V1 Partners API em OpenAPI 3.1 JSON](https://api.letssign.com.br/docs/partners-v1/openapi.json): o mesmo contrato, para geração de clientes, validação e ferramentas.
- [V2 Partners API em Markdown](https://api.letssign.com.br/docs/partners/v2.md): Listagens paginadas de documentos, categorias e usuários e download do documento com anexos. Substitui os endpoints equivalentes da v1 e compartilha autenticação, contas e formato de erro com ela.
- [V2 Partners API em OpenAPI 3.1 JSON](https://api.letssign.com.br/docs/partners-v2/openapi.json): o mesmo contrato, para geração de clientes, validação e ferramentas.

## Optional

- [Documentação interativa](https://api.letssign.com.br/docs): índice em HTML com a página navegável de cada versão e o resumo dos webhooks.
- [Índice dos documentos em JSON](https://api.letssign.com.br/docs/index.json): título, versão, contagens e URLs de cada formato, para descoberta automática.
- [Referência completa em um arquivo](https://api.letssign.com.br/llms-full.txt): este índice seguido das duas versões em Markdown.
- [Coleção Postman da V1 Partners API](https://api.letssign.com.br/docs/partners/v1.postman_collection.json): requisições prontas com variáveis `baseUrl`, `apiKey` e `accountId`; importável também no Bruno, Insomnia e Hoppscotch.
- [Coleção Postman da V2 Partners API](https://api.letssign.com.br/docs/partners/v2.postman_collection.json): requisições prontas com variáveis `baseUrl`, `apiKey` e `accountId`; importável também no Bruno, Insomnia e Hoppscotch.