Skip to content

Atualizar Tarefa ​

PUT /external/v1/tasks/:id

Atualiza uma tarefa. Só mudam os campos que você enviar.

Autenticação ​

Requer permissão tasks:write. A tarefa precisa estar visível para o usuário que criou a chave.

Parâmetros de Caminho ​

ParâmetroTipoObrigatórioDescrição
idstringSimIdentificador da tarefa (UUID)

Corpo da Requisição ​

Qualquer campo de Criar Tarefa, exceto opportunity_id e contact_id: aquilo de que a tarefa trata não pode mudar depois que ela é criada.

CampoComportamento
assignee_idsSubstitui a lista atual. [] remove todos os responsáveis
label_idsSubstitui a lista atual. [] remove todas as etiquetas
due_dateAlterá-lo também rearma o lembrete
statusMesmo efeito de Atualizar Status da Tarefa: concluir uma tarefa recorrente cria a próxima ocorrência
recurrenceUm objeto liga a recorrência ou a altera; null a desliga
description, end_date, task_pipeline_id, size, estimate_hours, reminder_minutes_beforenull limpa o valor

Requisição ​

bash
curl --request PUT \
  --url "https://app.getraze.com/external/v1/tasks/7b1e4c52-9a0d-4f1e-8c35-2d6f0a9b3e11" \
  --header "Content-Type: application/json" \
  --header "X-API-Key: YOUR_API_KEY" \
  --data '{
    "due_date": "2026-10-22T10:00:00-03:00",
    "priority": "urgent"
  }'
javascript
const axios = require('axios');

const taskId = '7b1e4c52-9a0d-4f1e-8c35-2d6f0a9b3e11';

const response = await axios.put(
  `https://app.getraze.com/external/v1/tasks/${taskId}`,
  { due_date: '2026-10-22T10:00:00-03:00', priority: 'urgent' },
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);

console.log(response.data);
python
import requests

task_id = '7b1e4c52-9a0d-4f1e-8c35-2d6f0a9b3e11'

response = requests.put(
    f'https://app.getraze.com/external/v1/tasks/{task_id}',
    headers={'X-API-Key': 'YOUR_API_KEY'},
    json={'due_date': '2026-10-22T10:00:00-03:00', 'priority': 'urgent'}
)

print(response.json())

Resposta ​

A tarefa atualizada, no formato de Buscar Tarefa.

Erros ​

StatusCódigoDescrição
400VALIDATION_ERRORValor inválido, title vazio, opportunity_id/contact_id enviado, ou mudança de status numa etapa de uma execução de playbook cancelada
404NOT_FOUNDTarefa não encontrada, ou não visível para o criador da chave

GetRaze - AI-Powered Lead Generation