# Endpoints

> A tabela completa dos endpoints do LMSP 1.0 com método, caminho, nível de exigência e finalidade, além das convenções para caminhos, autenticação e endpoints opcionais.

Source: https://madeforagent.com/pt-br/lmsp/1.0/endpoints/
Language: pt-BR
Specification: LMSP 1.0 (draft)
Updated: 2026-11-08

## 4.1 Tabela de endpoints {#table}

Um serviço em conformidade **DEVE** implementar todos os endpoints marcados como obrigatórios. Ele **PODE** implementar os opcionais e os sinaliza por meio das flags de capacidade de sua [descrição do serviço](https://madeforagent.com/pt-br/lmsp/1.0/discovery.md#service-description).

| Método | Caminho | Exigência | Finalidade |
| --- | --- | --- | --- |
| GET | `/.well-known/lmsp.json` | Obrigatório | [Descoberta do serviço e das capacidades](https://madeforagent.com/pt-br/lmsp/1.0/discovery.md#service-description) |
| GET | `/lmsp/v1/openapi.json` | Obrigatório | Especificação da interface legível por máquina |
| GET | `/lmsp/v1/health` | Obrigatório | [Verificação de atividade e de prontidão](https://madeforagent.com/pt-br/lmsp/1.0/common-rules.md#health) |
| POST | `/lmsp/v1/pair` | Obrigatório | [Trocar um código de pareamento por um token de portador](https://madeforagent.com/pt-br/lmsp/1.0/security.md#pairing) |
| GET | `/lmsp/v1/models` | Obrigatório | [Listar os modelos locais](https://madeforagent.com/pt-br/lmsp/1.0/models.md#list) |
| GET | `/lmsp/v1/models/{model_id}` | Obrigatório | [Obter um modelo](https://madeforagent.com/pt-br/lmsp/1.0/models.md#operations) |
| POST | `/lmsp/v1/responses` | Obrigatório | [Geração síncrona ou em streaming](https://madeforagent.com/pt-br/lmsp/1.0/responses.md#request) |
| GET | `/lmsp/v1/responses/{response_id}` | Opcional | [Recuperar uma resposta armazenada](https://madeforagent.com/pt-br/lmsp/1.0/responses.md#sync) |
| POST | `/lmsp/v1/tasks` | Obrigatório | [Criar uma tarefa de geração assíncrona](https://madeforagent.com/pt-br/lmsp/1.0/tasks.md#create) |
| GET | `/lmsp/v1/tasks/{task_id}` | Obrigatório | [Obter uma tarefa assíncrona](https://madeforagent.com/pt-br/lmsp/1.0/tasks.md#create) |
| POST | `/lmsp/v1/tasks/{task_id}/cancel` | Obrigatório | [Cancelar uma tarefa assíncrona](https://madeforagent.com/pt-br/lmsp/1.0/tasks.md#cancel) |
| GET | `/lmsp/v1/tasks/{task_id}/events` | Opcional | [Assinar ou retomar o fluxo de eventos](https://madeforagent.com/pt-br/lmsp/1.0/tasks.md#events) |
| POST | `/lmsp/v1/models/{model_id}/load` | Opcional | [Pré-carregar um modelo](https://madeforagent.com/pt-br/lmsp/1.0/models.md#operations) |
| POST | `/lmsp/v1/models/{model_id}/unload` | Opcional | [Descarregar um modelo](https://madeforagent.com/pt-br/lmsp/1.0/models.md#operations) |

Os endpoints compatíveis com a OpenAI em `/v1` e os endpoints opcionais compatíveis com o Ollama estão listados na [página 8](https://madeforagent.com/pt-br/lmsp/1.0/compatibility.md).

## 4.2 Convenções {#conventions}

- **Corpos.** Os corpos de requisição e de resposta são JSON (`application/json`), exceto os fluxos de eventos (`text/event-stream`) e os erros (`application/problem+json`).
- **Parâmetros de caminho.** Um nome entre chaves, como `{model_id}`, é um marcador. Os valores **DEVEM** ser codificados em percent-encoding. Um ID de modelo como `qwen3:14b-q4_k_m` é enviado como `qwen3%3A14b-q4_k_m`.
- **Autenticação.** Todo endpoint exige `Authorization: Bearer <token>`, exceto `/.well-known/lmsp.json`, `/lmsp/v1/openapi.json`, `/lmsp/v1/health` e `/lmsp/v1/pair`.
- **Endpoints opcionais.** Um endpoint opcional que o serviço não implementa **DEVE** responder `501 Not Implemented` com o código de erro `unsupported_capability`.
- **Versões e erros.** As requisições podem trazer cabeçalhos de versão, e todo erro usa um único formato. Ambos são definidos na [página 9](https://madeforagent.com/pt-br/lmsp/1.0/common-rules.md).
- **Contrato.** O documento OpenAPI publicado em [`/lmsp/1.0/openapi.json`](https://madeforagent.com/lmsp/1.0/openapi.json) é a forma legível por máquina desta página. Onde os dois divergem, o texto é normativo.