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

> ## Agent Instructions
> Leia /llms.txt antes de explorar páginas. A API HTTP usa Authorization: Bearer com o JWT da conta. A chave kl_live_ serve só ao assistente MCP e não substitui o JWT. Não invente rotas, hosts públicos, SDKs ou CLI. companyId e userId vêm da sessão. Consultas não aceitam SQL. Exclusão no assistente exige confirm=true. O webhook público é POST /webhook/leads.

# Reserva

> Marca um recurso no calendário comercial. O ciclo é `draft`, `requested`, `confirmed`, `canceled` e `completed`.

Marca um recurso no calendário comercial. O ciclo é `draft`, `requested`, `confirmed`, `canceled` e `completed`.

> [card] Obrigatório
>
> `typeReservationId`, `title`, `startsAt` e `endsAt` em ISO 8601. O fim vem depois do início.

## Fluxo

1. Liste os tipos de reserva.
2. Confira a disponibilidade no intervalo.
3. Crie com tipo, título, início e fim.
4. Envie, aprove, recuse ou cancele conforme o fluxo da empresa.

## Enums

| Campo | Valores |
| - | - |
| `status` | draft, requested, confirmed, canceled, completed |

## Operações

| Você quer | Método | Caminho |
| - | - | - |
| [Tipos de reserva](https://docs.kinglog.com.br/pages/reference/crm/crm-reservationTypes-list.md) | `GET` | `/crmTypeReservation/getAll/:companyId/:userId` |
| [Reservas](https://docs.kinglog.com.br/pages/reference/crm/crm-reservations-list.md) | `GET` | `/crmReservation/getAll/:companyId/:userId` |
| [Uma reserva](https://docs.kinglog.com.br/pages/reference/crm/crm-reservations-getOne.md) | `GET` | `/crmReservation/getOne/:companyId/:userId/:id` |
| [Disponibilidade da reserva](https://docs.kinglog.com.br/pages/reference/crm/crm-reservations-availability.md) | `GET` | `/crmReservation/availability/:companyId/:userId` |
| [Criar reserva](https://docs.kinglog.com.br/pages/reference/crm/crm-reservations-create.md) | `POST` | `/crmReservation/create/:companyId/:userId` |
| [Atualizar reserva](https://docs.kinglog.com.br/pages/reference/crm/crm-reservations-update.md) | `PUT` | `/crmReservation/update/:companyId/:userId/:id` |
| [Enviar reserva](https://docs.kinglog.com.br/pages/reference/crm/crm-reservations-submit.md) | `POST` | `/crmReservation/submit/:companyId/:userId/:id` |
| [Aprovar reserva](https://docs.kinglog.com.br/pages/reference/crm/crm-reservations-approve.md) | `POST` | `/crmReservation/approve/:companyId/:userId/:id` |
| [Recusar reserva](https://docs.kinglog.com.br/pages/reference/crm/crm-reservations-reject.md) | `POST` | `/crmReservation/reject/:companyId/:userId/:id` |
| [Cancelar reserva](https://docs.kinglog.com.br/pages/reference/crm/crm-reservations-cancel.md) | `POST` | `/crmReservation/cancel/:companyId/:userId/:id` |
| [Excluir reserva](https://docs.kinglog.com.br/pages/reference/crm/crm-reservations-delete.md) | `DELETE` | `/crmReservation/delete/:companyId/:userId/:id` |
| [Categorias de tipo de reserva](https://docs.kinglog.com.br/pages/reference/crm/crm-reservationTypeCategories-list.md) | `GET` | `/crmReservationTypeCategory/getAll/:companyId/:userId` |

## Exemplo de resposta

```json theme={null}
{
  "success": true,
  "data": {
    "id": "ID_DA_RESERVA",
    "title": "Reserva de sala",
    "startsAt": "2026-11-05T09:00:00.000Z",
    "endsAt": "2026-11-05T10:00:00.000Z",
    "status": "draft"
  },
  "code": "SUCCESS"
}
```

> [!TIP]
>
> Se o tipo exige aprovação, o rascunho vai para envio, depois para aprovar ou recusar. Recusar pede motivo.

## Relacionado

* [Guia: criar uma reserva](https://docs.kinglog.com.br/pages/guides/criar-reserva.md)
* [Conceito: reservas](https://docs.kinglog.com.br/pages/concepts/reservas.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.