Developers
Acessar miCore Começar
Atualizado em 17 de outubro de 2026
SOLUÇÃO

Organizar tarefas nos marcos

Liga à meta uma tarefa que já existe, cria tarefas novas dentro de um marco, move uma tarefa da meta entre marcos ou tira a tarefa da meta. O marco com tarefas fecha sozinho quando todas são finalizadas.

Considerações

  • Exigem o escopo objectives:write. Não usam Idempotency-Key.
  • Ligar à meta × mover entre marcos. Ligar (POST /objectives/{objective}/tasks) traz para a meta uma tarefa que ainda não é dela. Mover (PUT /objectives/{objective}/tasks/{task}/milestone) só troca o marco de uma tarefa que já é da meta.
  • Ligar uma tarefa que já existe: task_id obrigatório e milestone_id opcional (com ele, a tarefa já entra no marco). É o mesmo caminho do campo "Meta" do modal da tarefa no painel: as subtarefas vão junto e fica o registro no histórico da tarefa. Se a tarefa era de outra meta, sai dos marcos de lá. Funciona também em meta da empresa ou de time, sem quadro.
  • Ligar responde 422 para subtarefa, tarefa excluída ou inexistente, e 403 quando quem liga não faz parte do quadro da tarefa (o administrador sempre pode).
  • Tirar da meta (DELETE /objectives/{objective}/tasks/{task}): a tarefa principal deixa de ser da meta e dos marcos dela, com as subtarefas junto, e continua no quadro. Tarefa que não é desta meta responde 422.
  • Criar no marco: tasks traz uma tarefa por linha, na sintaxe das tarefas iniciais (- para subtarefa, # para comentário, 01/12/2026 - Tarefa para o prazo), até 20000 caracteres. As tarefas nascem no quadro da meta e as principais ficam ligadas ao marco; meta.created_task_ids traz os ids delas. Meta sem quadro responde 422.
  • Mover: milestone_id é o marco de destino, ou null para tirar a tarefa de todos os marcos (ela continua na meta). A tarefa fica em um marco só.
  • Só tarefa principal desta meta pode ser movida; as outras respondem 422 (ligue-a antes à meta).
  • Os marcos de origem e de destino são reconferidos: um marco cujas tarefas ficaram todas finalizadas fecha, e um que recebeu tarefa aberta reabre.
  • No projeto por marcos, cada tarefa principal conta um item em progress.items_total, com ou sem marco.

Referência

POST /objectives/{objective}/tasks na Referência da API DELETE /objectives/{objective}/tasks/{task} na Referência da API POST /objectives/{objective}/milestones/{milestone}/tasks na Referência da API PUT /objectives/{objective}/tasks/{task}/milestone na Referência da API

Como fazer

Ligar à meta a tarefa 4512, que já existe no quadro, já no marco 8:

cURL
curl -X POST "$MICORE_BASE_URL/objectives/95/tasks" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "task_id": 4512,
    "milestone_id": 8
}'

Tirar a tarefa 4512 da meta (ela continua no quadro):

cURL
curl -X DELETE "$MICORE_BASE_URL/objectives/95/tasks/4512" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Criar duas tarefas (uma com subtarefa) no marco 8:

cURL
curl -X POST "$MICORE_BASE_URL/objectives/95/milestones/8/tasks" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "tasks": "Texto da home\nTexto da página Sobre\n- Revisão final"
}'

Mover a tarefa 505 para o marco 7:

cURL
curl -X PUT "$MICORE_BASE_URL/objectives/95/tasks/505/milestone" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "milestone_id": 7
}'

Tirar a tarefa 505 de todos os marcos:

cURL
curl -X PUT "$MICORE_BASE_URL/objectives/95/tasks/505/milestone" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "milestone_id": null
}'

Resposta

Ligar à meta (a tarefa 4512 entrou no marco 8, que ganhou mais um item):

Resposta · 200
{
    "data": {
        "id": 95,
        "name": "Lançar o site novo",
        "type": "projeto",
        "priority": "alta",
        "owner_scope": "quadro",
        "team": null,
        "visibility": "empresa",
        "parent": null,
        "progress_mode": "marcos",
        "routine": null,
        "bands": {
            "partial_from": 80,
            "exceeded_from": 120
        },
        "checkin": {
            "cadence": null,
            "weekday": null
        },
        "alerts": {
            "off_pace": {
                "on": true,
                "pct": 10
            },
            "deadline": {
                "on": true,
                "days": 3
            },
            "milestone": {
                "on": false
            },
            "checkin_late": {
                "on": false
            },
            "recipients": [
                "responsavel",
                "gestor"
            ]
        },
        "on_complete": {
            "next": true,
            "notify": true,
            "report": false,
            "archive_open_tasks": false
        },
        "participants": [],
        "milestones": [
            {
                "id": 7,
                "name": "Layout aprovado",
                "due_date": "2026-11-01",
                "done_at": "2026-10-30T16:00:00-03:00",
                "automatic": true,
                "task_ids": [
                    501,
                    502
                ],
                "tasks_total": 2,
                "tasks_done": 2
            },
            {
                "id": 8,
                "name": "Conteúdo das páginas",
                "due_date": "2026-11-20",
                "done_at": null,
                "automatic": true,
                "task_ids": [
                    503,
                    504,
                    505,
                    4512
                ],
                "tasks_total": 4,
                "tasks_done": 1
            },
            {
                "id": 9,
                "name": "Domínio apontado",
                "due_date": "2026-12-15",
                "done_at": "2026-11-13T10:00:00-03:00",
                "automatic": false,
                "task_ids": [],
                "tasks_total": 0,
                "tasks_done": 0
            }
        ],
        "confirmation": null,
        "recurrence": null,
        "recurrence_name": null,
        "recurrence_source_id": null,
        "description": null,
        "achievement_criteria": null,
        "board": {
            "id": 4,
            "name": "Marketing"
        },
        "responsible": {
            "id": 7,
            "name": "Ana Souza"
        },
        "date_start": "2026-10-15",
        "date_end": "2026-12-15",
        "status": "em_andamento",
        "situation": "on_track",
        "progress": {
            "percent": 57.1400000000000005684341886080801486968994140625,
            "achievement": 57.1400000000000005684341886080801486968994140625,
            "suggested_result": "nao_atingida",
            "source": "marcos",
            "items_total": 7,
            "items_done": 4
        },
        "pace": {
            "elapsed_percent": 47,
            "ideal_percent": 47,
            "days_left": 32,
            "days_total": 61,
            "days_elapsed": 29,
            "projection_percent": 100,
            "achievement": 66.6700000000000017053025658242404460906982421875
        },
        "closure": null,
        "metrics": [],
        "created_at": "2026-10-15T08:00:00-03:00",
        "updated_at": "2026-11-13T10:00:00-03:00"
    }
}

Criar no marco:

Resposta · 201
{
    "data": {
        "id": 95,
        "name": "Lançar o site novo",
        "type": "projeto",
        "priority": "alta",
        "owner_scope": "quadro",
        "team": null,
        "visibility": "empresa",
        "parent": null,
        "progress_mode": "marcos",
        "routine": null,
        "bands": {
            "partial_from": 80,
            "exceeded_from": 120
        },
        "checkin": {
            "cadence": null,
            "weekday": null
        },
        "alerts": {
            "off_pace": {
                "on": true,
                "pct": 10
            },
            "deadline": {
                "on": true,
                "days": 3
            },
            "milestone": {
                "on": false
            },
            "checkin_late": {
                "on": false
            },
            "recipients": [
                "responsavel",
                "gestor"
            ]
        },
        "on_complete": {
            "next": true,
            "notify": true,
            "report": false,
            "archive_open_tasks": false
        },
        "participants": [],
        "milestones": [
            {
                "id": 7,
                "name": "Layout aprovado",
                "due_date": "2026-11-01",
                "done_at": "2026-10-30T16:00:00-03:00",
                "automatic": true,
                "task_ids": [
                    501,
                    502
                ],
                "tasks_total": 2,
                "tasks_done": 2
            },
            {
                "id": 8,
                "name": "Conteúdo das páginas",
                "due_date": "2026-11-20",
                "done_at": null,
                "automatic": true,
                "task_ids": [
                    503,
                    504,
                    505,
                    506,
                    507
                ],
                "tasks_total": 5,
                "tasks_done": 1
            },
            {
                "id": 9,
                "name": "Domínio apontado",
                "due_date": "2026-12-15",
                "done_at": "2026-11-13T10:00:00-03:00",
                "automatic": false,
                "task_ids": [],
                "tasks_total": 0,
                "tasks_done": 0
            }
        ],
        "confirmation": null,
        "recurrence": null,
        "recurrence_name": null,
        "recurrence_source_id": null,
        "description": null,
        "achievement_criteria": null,
        "board": {
            "id": 4,
            "name": "Marketing"
        },
        "responsible": {
            "id": 7,
            "name": "Ana Souza"
        },
        "date_start": "2026-10-15",
        "date_end": "2026-12-15",
        "status": "em_andamento",
        "situation": "on_track",
        "progress": {
            "percent": 50,
            "achievement": 50,
            "suggested_result": "nao_atingida",
            "source": "marcos",
            "items_total": 8,
            "items_done": 4
        },
        "pace": {
            "elapsed_percent": 47,
            "ideal_percent": 47,
            "days_left": 32,
            "days_total": 61,
            "days_elapsed": 29,
            "projection_percent": 100,
            "achievement": 66.6700000000000017053025658242404460906982421875
        },
        "closure": null,
        "metrics": [],
        "created_at": "2026-10-15T08:00:00-03:00",
        "updated_at": "2026-11-13T10:00:00-03:00"
    },
    "meta": {
        "created_task_ids": [
            506,
            507
        ]
    }
}

Mover (o marco 7 recebeu uma tarefa aberta e reabriu):

Resposta · 200
{
    "data": {
        "id": 95,
        "name": "Lançar o site novo",
        "type": "projeto",
        "priority": "alta",
        "owner_scope": "quadro",
        "team": null,
        "visibility": "empresa",
        "parent": null,
        "progress_mode": "marcos",
        "routine": null,
        "bands": {
            "partial_from": 80,
            "exceeded_from": 120
        },
        "checkin": {
            "cadence": null,
            "weekday": null
        },
        "alerts": {
            "off_pace": {
                "on": true,
                "pct": 10
            },
            "deadline": {
                "on": true,
                "days": 3
            },
            "milestone": {
                "on": false
            },
            "checkin_late": {
                "on": false
            },
            "recipients": [
                "responsavel",
                "gestor"
            ]
        },
        "on_complete": {
            "next": true,
            "notify": true,
            "report": false,
            "archive_open_tasks": false
        },
        "participants": [],
        "milestones": [
            {
                "id": 7,
                "name": "Layout aprovado",
                "due_date": "2026-11-01",
                "done_at": null,
                "automatic": true,
                "task_ids": [
                    501,
                    502,
                    505
                ],
                "tasks_total": 3,
                "tasks_done": 2
            },
            {
                "id": 8,
                "name": "Conteúdo das páginas",
                "due_date": "2026-11-20",
                "done_at": null,
                "automatic": true,
                "task_ids": [
                    503,
                    504
                ],
                "tasks_total": 2,
                "tasks_done": 1
            },
            {
                "id": 9,
                "name": "Domínio apontado",
                "due_date": "2026-12-15",
                "done_at": "2026-11-13T10:00:00-03:00",
                "automatic": false,
                "task_ids": [],
                "tasks_total": 0,
                "tasks_done": 0
            }
        ],
        "confirmation": null,
        "recurrence": null,
        "recurrence_name": null,
        "recurrence_source_id": null,
        "description": null,
        "achievement_criteria": null,
        "board": {
            "id": 4,
            "name": "Marketing"
        },
        "responsible": {
            "id": 7,
            "name": "Ana Souza"
        },
        "date_start": "2026-10-15",
        "date_end": "2026-12-15",
        "status": "em_andamento",
        "situation": "on_track",
        "progress": {
            "percent": 66.6700000000000017053025658242404460906982421875,
            "achievement": 66.6700000000000017053025658242404460906982421875,
            "suggested_result": "nao_atingida",
            "source": "marcos",
            "items_total": 6,
            "items_done": 4
        },
        "pace": {
            "elapsed_percent": 47,
            "ideal_percent": 47,
            "days_left": 32,
            "days_total": 61,
            "days_elapsed": 29,
            "projection_percent": 100,
            "achievement": 66.6700000000000017053025658242404460906982421875
        },
        "closure": null,
        "metrics": [],
        "created_at": "2026-10-15T08:00:00-03:00",
        "updated_at": "2026-11-13T10:00:00-03:00"
    }
}
Precisa de ajuda?Use o request ID e abra um chamado no miCore se encontrar uma divergência.