---
title: "Atualizar reunião"
method: PUT
path: "/meetings/{id}"
tags: ["crm-v2-meetings"]
---

# Atualizar reunião

`PUT /meetings/{id}`

## Request

- Base URL: `https://api.rd.services/crm/v2`
- URL: `https://api.rd.services/crm/v2/meetings/{id}`
- Auth: OAuth 2
  - Authorization code: `/oauth/authorize`
  - Token URL: `/oauth/token`

Atualiza os campos da reunião. Este end-point pode ser usado para remarcar horário, alterar status,
reatribuir o responsável ou modificar qualquer outro campo editável de reuniões.

## Erros comuns

* **404**: reunião não encontrada.
* **422**: payload inválido (ex.: `data` não é um objeto, `status` fora de `scheduled`/`completed`/`no_show`,
  `duration_minutes` inválido).
* **422**: conflito de agenda do responsável (quando há atualização de horário e o status resultante é
  `scheduled`), retornando `errors` com mensagem descritiva — com sugestões de horários livres no mesmo dia
  no formato `starts_at/ends_at`, ou sem sugestões quando não há nenhum slot disponível no dia.

## Path parameters

- `id` string, required

## Request body

- object
  - `data` object: Dados do recurso relacionado.
    - `id` string: Identificador único da reunião.
    - `subject` string: Assunto da reunião. Tamanho máximo de 150 caracteres.
    - `notes` string: Observações da reunião. Tamanho máximo de 1000 caracteres.
    - `starts_at` string, date-time: Data e hora de início da reunião.
    - `ends_at` string, date-time: Data e hora de término da reunião (calculado a partir de `starts_at` e `duration_minutes`).
    - `duration_minutes` integer: Duração da reunião em minutos.
    - `status` 'scheduled' | 'completed' | 'no_show': Status da reunião. Valores: `scheduled`, `completed`, `no_show`.
    - `responsible_id` string: ID do usuário responsável pela reunião.
    - `organizer_id` string: ID do usuário organizador da reunião.
    - `contact_ids` string[]: IDs dos contatos participantes da reunião (máximo de 20).
    - `created_at` string, date-time: Data de criação da reunião.
    - `updated_at` string, date-time: Data de atualização da reunião.

## Response `200`

OK

- object
  - `data` object: Dados do recurso relacionado.
    - `id` string: Identificador único da reunião.
    - `subject` string: Assunto da reunião. Tamanho máximo de 150 caracteres.
    - `notes` string: Observações da reunião. Tamanho máximo de 1000 caracteres.
    - `starts_at` string, date-time: Data e hora de início da reunião.
    - `ends_at` string, date-time: Data e hora de término da reunião (calculado a partir de `starts_at` e `duration_minutes`).
    - `duration_minutes` integer: Duração da reunião em minutos.
    - `status` 'scheduled' | 'completed' | 'no_show': Status da reunião. Valores: `scheduled`, `completed`, `no_show`.
    - `responsible_id` string: ID do usuário responsável pela reunião.
    - `organizer_id` string: ID do usuário organizador da reunião.
    - `contact_ids` string[]: IDs dos contatos participantes da reunião (máximo de 20).
    - `created_at` string, date-time: Data de criação da reunião.
    - `updated_at` string, date-time: Data de atualização da reunião.

## Other responses

- `400`: A requisição está malformada e não consegue ser processada.
- `401`: O token da API está ausente ou inválido.
- `403`: O token não tem permissão para acessar o recurso solicitado.
- `404`: O recurso solicitado não existe.
- `422`: A entidade não pode ser processada.
- `429`: O limite de requisições foi excedido.
- `500`: Erro interno ou inesperado no servidor.

---

[API](https://skmtc.dev/rdstation/apis/rd-station-crm-api-v2.md) - [All operations](https://skmtc.dev/rdstation/apis/rd-station-crm-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/rdstation/apis/rd-station-crm-api-v2/revisions/10d0a25b8c54?raw)