Atualizar atividade (marcar feita, reagendar)

PATCH/api/v1/activities/:id

O complemento natural do POST: sua automação criou o follow-up, agora pode marcar como concluído (done: true), reabrir (done: false), reagendar (dueAt) ou editar título/descrição/responsável. Todos os campos são opcionais · só o que vier no body muda.

Parâmetros de path

idobrigatório

string

ID da atividade.

Body (JSON)

`title` string	Novo título (1-200 caracteres).
`description` string \| null	Nova descrição (max 10.000 caracteres).
`dueAt` string (ISO 8601) \| null	Reagenda · null = sem prazo.
`done` boolean	`true` seta `doneAt` = agora (conclui) · `false` limpa `doneAt` (reabre).
`assigneeId` string \| null	Responsável · precisa ser membro do workspace (senão `404`).

Headers

Idempotency-Key

string

Opcional, recomendado (8-200 caracteres, ex.: um UUID). A primeira request é processada normalmente; requests com a mesma key e mesmo body em até 24h retornam a resposta cacheada (header Idempotency-Replay: true), sem criar duplicata. Mesma key com body diferente retorna 422 IDEMPOTENCY_CONFLICT. Só respostas 2xx são cacheadas.

Suporta Idempotency-Key · replays com mesmo body em até 24h retornam a resposta cacheada sem duplicar (útil pra retries de n8n/Zapier).

Concluir dispara webhook activity.completed; qualquer outra mudança dispara activity.updated.

Concluir e reagendar também entram na timeline que a IA lê.

Autenticação: header Authorization: Bearer rmk_... · veja Introdução e autenticação.

curl -X PATCH "https://crmdojordao.com.br/api/v1/activities/:id" \
  -H "Authorization: Bearer rmk_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{ "done": true }'

Request body

{
  "done": true
}

Resposta · PATCH /api/v1/activities/:id

{
  "id": "act_xyz789",
  "title": "Ligar amanhã às 9h pra confirmar reunião",
  "description": "Lead pediu pra reagendar a apresentação",
  "typeId": "atype_ligacao",
  "typeName": "Ligação",
  "dueAt": "2026-07-16T12:00:00.000Z",
  "doneAt": null,
  "dealId": "deal_abc123",
  "accountId": null,
  "contactId": null,
  "assigneeId": "usr_maria",
  "authorId": null,
  "createdAt": "2026-07-15T13:30:00.000Z",
  "updatedAt": "2026-07-15T13:30:00.000Z"
}