Buscar Execução de Playbook
GET/external/v1/playbook-runs/:idBusca uma execução com todas as etapas. Cada etapa é uma tarefa: conclua-a com Concluir Tarefa usando o task_id dela, e a execução avança.
Autenticação
Requer permissão playbooks:read.
Parâmetros de Caminho
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | Sim | Identificador da execução (UUID) |
Requisição
bash
curl --request GET \
--url "https://app.getraze.com/external/v1/playbook-runs/3ef8c1c3-c081-4187-a6aa-657fbf1a813b" \
--header "X-API-Key: YOUR_API_KEY"javascript
const axios = require('axios');
const runId = '3ef8c1c3-c081-4187-a6aa-657fbf1a813b';
const response = await axios.get(
`https://app.getraze.com/external/v1/playbook-runs/${runId}`,
{ headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);
console.log(response.data);python
import requests
run_id = '3ef8c1c3-c081-4187-a6aa-657fbf1a813b'
response = requests.get(
f'https://app.getraze.com/external/v1/playbook-runs/{run_id}',
headers={'X-API-Key': 'YOUR_API_KEY'}
)
print(response.json())Resposta
Os campos de Listar Execuções de Playbook, mais steps.
json
{
"success": true,
"data": {
"id": "3ef8c1c3-c081-4187-a6aa-657fbf1a813b",
"playbook": { "id": "9d2c7a1e-4b3f-4e8a-a6d5-1c0b9f8e7d62", "name": "Onboarding" },
"status": "in_progress",
"is_overdue": true,
"progress": { "steps_done": 1, "steps_total": 3, "overdue_steps": 1 },
"steps": [
{
"position": 1,
"task_id": "97f785b0-d1ce-4a2b-8142-89c2fb88d501",
"title": "Ligação de boas-vindas",
"task_type": "call",
"priority": "high",
"status": "completed",
"is_overdue": false,
"due_date": "2026-10-13T14:00:00.000Z",
"completed_at": "2026-10-13T13:40:00.000Z",
"completed_by": { "id": "2d19889d-6ff9-4782-8165-32e56bb593c0", "name": "Maria Silva" },
"assignees": [{ "id": "2d19889d-6ff9-4782-8165-32e56bb593c0", "name": "Maria Silva" }],
"subtasks": { "done": 0, "total": 0 }
},
{
"position": 2,
"task_id": "a8e9f0b1-c2d3-4e5f-8a9b-0c1d2e3f4a5b",
"title": "Enviar o kit de onboarding",
"task_type": "email",
"priority": "medium",
"status": "pending",
"is_overdue": true,
"due_date": "2026-10-14T14:00:00.000Z",
"completed_at": null,
"completed_by": null,
"assignees": [],
"subtasks": { "done": 1, "total": 3 }
}
]
}
}Campos das Etapas
| Campo | Tipo | Descrição |
|---|---|---|
position | integer | Ordem da etapa (começando em 1) |
task_id | string | A tarefa que esta etapa criou (veja Buscar Tarefa) |
title / task_type / priority | string | Campos da tarefa |
status | string | pending, in_progress, completed ou cancelled |
is_overdue | boolean | Aberta e com due_date vencido |
due_date | string | Timestamp em UTC |
completed_at / completed_by | string / object | Nullable |
assignees | array | Usuários responsáveis pela etapa |
subtasks | object | Progresso do checklist dentro da etapa |
Erros
| Status | Código | Descrição |
|---|---|---|
| 400 | VALIDATION_ERROR | id não é um UUID |
| 404 | NOT_FOUND | Execução não encontrada nesta conta |