Skip to content

Buscar Tarefa ​

GET /external/v1/tasks/:id

Busca uma tarefa com suas subtarefas (o checklist dentro da tarefa).

Autenticação ​

Requer permissão tasks:read. A tarefa precisa estar visível para o usuário que criou a chave (veja Listar Tarefas); caso contrário, a resposta é 404.

Parâmetros de Caminho ​

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

Requisição ​

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

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

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

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

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

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

print(response.json())

Resposta ​

Os mesmos campos de Listar Tarefas, mais subtasks.

json
{
  "success": true,
  "data": {
    "id": "7b1e4c52-9a0d-4f1e-8c35-2d6f0a9b3e11",
    "number": 482,
    "title": "Ligar para confirmar a proposta",
    "task_type": "call",
    "status": "pending",
    "priority": "high",
    "is_completed": false,
    "is_overdue": true,
    "due_date": "2026-10-18T17:00:00.000Z",
    "contact": { "id": "c2f9d1a4-5b7e-4c1a-9e0f-3a8b6d2c4e71", "name": "John Doe", "company": "Acme Inc" },
    "opportunity": { "id": "e8a3b2c1-6d4f-4a9e-b1c7-5f2d8e0a9b34", "title": "Acme Inc - Plano Pro" },
    "playbook_run": null,
    "assignees": [
      { "id": "2d19889d-6ff9-4782-8165-32e56bb593c0", "name": "Maria Silva", "email": "maria@acme.com" }
    ],
    "labels": [],
    "subtasks": [
      { "id": "5e4d3c2b-1a09-4f8e-9d7c-6b5a4f3e2d1c", "title": "Verificar a aprovação do desconto", "is_completed": true, "position": 0 },
      { "id": "0f1e2d3c-4b5a-4968-8776-a5b4c3d2e1f0", "title": "Enviar o contrato", "is_completed": false, "position": 1 }
    ],
    "created_at": "2026-10-14T13:05:00.000Z",
    "updated_at": "2026-10-16T09:12:00.000Z"
  }
}

Erros ​

StatusCódigoDescrição
400VALIDATION_ERRORid não é um UUID
404NOT_FOUNDTarefa não encontrada, ou não visível para o criador da chave

GetRaze - AI-Powered Lead Generation