Iniciar um processo num quadro

Atualizado em 17 de outubro de 2026

Considerações

Exige o escopo processes:execute, a permissão Importar processos em Gestão de Espaço e que o usuário administre ou participe do quadro (senão 403 permission_denied).
Envie um Idempotency-Key: repetir a chamada devolve a mesma execução, sem criar outra.
Descubra os papéis com GET /processes/{process}/validation e mande a pessoa de cada um em roles ({"nome do papel": id do usuário}). Papel sem pessoa ou desenho inválido respondem 422 com o motivo.
stage_id é a coluna das Tarefas sem coluna própria; source_task_id é a tarefa que pediu a execução (ex.: a pauta), que é arquivada.
Como no painel, o processo não precisa estar Ativo. A execução congela a versão atual do desenho.

Referência

POST /process-executions na Referência da API

Como fazer

cURL

curl -X POST "$MICORE_BASE_URL/process-executions" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: request-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "process_id": 21,
    "board_id": 4,
    "name": "Reels de novembro",
    "roles": {
        "Criador de conteúdo": 7,
        "Aprovador": 3
    }
}'

Resposta

Resposta · 201

{
  "data": {
    "id": 31,
    "name": "Reels de novembro",
    "status": "running",
    "situation": { "key": "on_time", "label": "No prazo" },
    "process": { "id": 21, "name": "Produção de Reels" },
    "process_version": 3,
    "board": { "id": 4, "name": "Conteúdo" },
    "stage_id": null,
    "source_task_id": null,
    "parent": null,
    "roles": { "Criador de conteúdo": 7, "Aprovador": 3 },
    "steps_total": 2,
    "open_task_ids": [901],
    "created_by": 3,
    "created_at": "2026-11-09T10:00:00-03:00",
    "completed_at": null,
    "canceled_at": null,
    "steps": [
      { "id": 81, "node_id": "roteiro", "order": 1, "type": "task", "name": "Roteiro", "status": "active", "role_name": "Criador de conteúdo", "responsible_user_id": 7, "responsible_name": "Ana", "task_id": 901, "due_date": "2026-11-11", "outcomes": [], "outcome": null, "child_execution_id": null, "activated_at": "2026-11-09T10:00:00-03:00", "completed_at": null },
      { "id": 82, "node_id": "aprovacao", "order": 2, "type": "task", "name": "Aprovação", "status": "pending", "role_name": "Aprovador", "responsible_user_id": 3, "responsible_name": "Bruno", "task_id": 902, "due_date": "2026-11-11", "outcomes": [{ "id": "aprovado", "label": "Aprovado" }, { "id": "ajustar", "label": "Ajustar" }], "outcome": null, "child_execution_id": null, "activated_at": "2026-11-10T15:20:00-03:00", "completed_at": null }
    ]
  }
}

Precisa de ajuda?Use o request ID e abra um chamado no miCore se encontrar uma divergência.