Buscar Tarefa
GET/external/v1/tasks/:idBusca 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âmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | Sim | Identificador 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
| Status | Código | Descrição |
|---|---|---|
| 400 | VALIDATION_ERROR | id não é um UUID |
| 404 | NOT_FOUND | Tarefa não encontrada, ou não visível para o criador da chave |