Pular para o conteúdo
Tarefas

Editar tarefa

v1.0.0
PATCHhttps://api.staging.growthaisystem.com/api/v1/tasks/{id}
  • ExigeAuthorization: Bearer gos_…— Chave de API (gos_…)· escoposcontacts.write

Edita título, descrição (body), responsável (assigneeUserId) e prazo (dueAt, ISO-8601 com fuso) de uma tarefa. Campo ausente não muda; null limpa a descrição, o prazo ou deixa a tarefa sem responsável. Na tarefa interna, o lembrete da Agenda anda junto com o prazo.

Campo fora da lista é recusado com 400, nunca ignorado. Passa pela Ação activity.update do Núcleo de Ações (auditada com o ator da chave; aceita Idempotency-Key).

Parâmetros de caminho

Entram no próprio endereço, no lugar das chaves.

  • idstringobrigatório
    • tamanho 1–80

Corpo da requisição

application/jsonobrigatório
  • titlestringopcional
    • tamanho 1–200
  • bodystring | nullopcional
    • tamanho máx. 10000
  • assigneeUserIdstring | nullopcional
    • tamanho mín. 1
  • dueAtstring (date-time) | nullopcional
    • regex "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579]…

Respostas

11 respostas documentadas — o código, o que ele significa nesta rota e a forma do corpo.

200Deu certoapplication/json

A tarefa como ficou depois da edição.

V1Task

  • idstring
  • contactIdstring | null
  • opportunityIdstring | null
  • titlestring
  • bodystring | null
  • dueAtstring | null
  • completedAtstring | null
  • assigneeUserIdstring | null
  • createdAtstring