Criar um processo

Atualizado em 17 de outubro de 2026

Considerações

Exige processes:write e criar em Gestão de Processos.
Envie um Idempotency-Key: repetir a chamada devolve o mesmo processo.
Sempre nasce em Rascunho, mesmo que outra situação seja enviada.
O desenho é conferido: tipo de peça conhecido, id único, posição numérica e conexões entre peças existentes. Erro responde 422 validation_failed em nodes.
Peça Tarefa: title, templateId (Modelo de tarefa) ou conteúdo próprio, responsibleType (role com roleName ou user com userId), dueDays, stageName, conditions (saídas). Cada saída sai por sourceHandle: condition:{id}; uma saída que volta a uma peça anterior é o "Ajustar".

Referência

Como fazer

cURL

curl -X POST "$MICORE_BASE_URL/processes" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Idempotency-Key: request-2026-0001" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Produção de Reels",
    "description": "Da pauta ao Reels publicado.",
    "nodes": [
        {
            "id": "roteiro",
            "type": "node_task",
            "position": {
                "x": 0,
                "y": 0
            },
            "data": {
                "title": "Roteiro",
                "templateId": 2,
                "responsibleType": "role",
                "roleName": "Criador de conteúdo"
            }
        },
        {
            "id": "aprovacao",
            "type": "node_task",
            "position": {
                "x": 380,
                "y": 0
            },
            "data": {
                "title": "Aprovação",
                "responsibleType": "role",
                "roleName": "Aprovador",
                "dueDays": 1,
                "conditions": [
                    {
                        "id": "aprovado",
                        "name": "Aprovado"
                    },
                    {
                        "id": "ajustar",
                        "name": "Ajustar"
                    }
                ]
            }
        }
    ],
    "edges": [
        {
            "source": "roteiro",
            "target": "aprovacao"
        },
        {
            "source": "aprovacao",
            "sourceHandle": "condition:ajustar",
            "target": "roteiro"
        }
    ]
}'

Resposta

Resposta · 201

{
  "data": {
    "id": 21,
    "name": "Produção de Reels",
    "description": "Da pauta ao Reels publicado.",
    "status": "Rascunho",
    "current_version": 1,
    "board_id": null,
    "sector_id": null,
    "responsible_user_id": null,
    "created_at": "2026-11-05T09:00:00-03:00",
    "updated_at": "2026-11-05T09:00:00-03:00",
    "flow": {
      "nodes": [
        { "id": "roteiro", "type": "node_task", "position": { "x": 0, "y": 0 }, "width": null, "height": null, "zIndex": 0, "data": { "title": "Roteiro", "templateId": 2, "responsibleType": "role", "roleName": "Criador de conteúdo" } },
        { "id": "aprovacao", "type": "node_task", "position": { "x": 380, "y": 0 }, "width": null, "height": null, "zIndex": 0, "data": { "title": "Aprovação", "responsibleType": "role", "roleName": "Aprovador", "dueDays": 1, "conditions": [{ "id": "aprovado", "name": "Aprovado" }, { "id": "ajustar", "name": "Ajustar" }] } }
      ],
      "edges": [
        { "id": "roteiro-out-aprovacao", "source": "roteiro", "sourceHandle": "out", "target": "aprovacao", "targetHandle": "in" },
        { "id": "aprovacao-condition:ajustar-roteiro", "source": "aprovacao", "sourceHandle": "condition:ajustar", "target": "roteiro", "targetHandle": "in" }
      ]
    }
  }
}

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