Skip to content

Concluir Tarefa ​

PATCH /external/v1/tasks/:id/complete

Marca uma tarefa como concluída. É um atalho para Atualizar Status da Tarefa com status: completed, e é idempotente: chamá-lo numa tarefa que já está concluída não muda nada. Para reabrir uma tarefa, use Atualizar Status da Tarefa com pending.

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)

Requisição ​

bash
curl --request PATCH \
  --url "https://app.getraze.com/external/v1/tasks/7b1e4c52-9a0d-4f1e-8c35-2d6f0a9b3e11/complete" \
  --header "X-API-Key: YOUR_API_KEY"
javascript
const axios = require('axios');

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

const response = await axios.patch(
  `https://app.getraze.com/external/v1/tasks/${taskId}/complete`,
  null,
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);

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

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

response = requests.patch(
    f'https://app.getraze.com/external/v1/tasks/{task_id}/complete',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)

print(response.json())

Resposta ​

json
{
  "success": true,
  "data": {
    "id": "7b1e4c52-9a0d-4f1e-8c35-2d6f0a9b3e11",
    "status": "completed",
    "is_completed": true,
    "completed_at": "2026-10-19T14:02:11.000Z",
    "completed_by": { "id": "2d19889d-6ff9-4782-8165-32e56bb593c0", "name": "Maria Silva" }
  },
  "changed": true,
  "next_occurrence_id": "5349488a-e097-4cd6-980d-ad30c553c7ab"
}

next_occurrence_id é preenchido quando a tarefa é recorrente e uma próxima ocorrência foi criada; caso contrário, é null.

Erros ​

StatusCódigoDescrição
400VALIDATION_ERRORA tarefa é uma 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