Atualizar Tarefa
PUT/external/v1/tasks/:idAtualiza 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âmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | Sim | Identificador 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.
| Campo | Comportamento |
|---|---|
assignee_ids | Substitui a lista atual. [] remove todos os responsáveis |
label_ids | Substitui a lista atual. [] remove todas as etiquetas |
due_date | Alterá-lo também rearma o lembrete |
status | Mesmo efeito de Atualizar Status da Tarefa: concluir uma tarefa recorrente cria a próxima ocorrência |
recurrence | Um objeto liga a recorrência ou a altera; null a desliga |
description, end_date, task_pipeline_id, size, estimate_hours, reminder_minutes_before | null 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
| Status | Código | Descrição |
|---|---|---|
| 400 | VALIDATION_ERROR | Valor inválido, title vazio, opportunity_id/contact_id enviado, ou mudança de status numa etapa de uma execução de playbook cancelada |
| 404 | NOT_FOUND | Tarefa não encontrada, ou não visível para o criador da chave |