Marcar um marco

Atualizado em 17 de outubro de 2026

Considerações

Exige o escopo objectives:write. Não usa Idempotency-Key.
Só vale para marco sem tarefas (automatic: false). done: true marca como atingido agora (done_at); false desfaz.
Marco com tarefas (automatic: true) responde 409 invalid_transition: ele fecha sozinho quando todas as tarefas dele (task_ids) são finalizadas e reabre quando uma volta a ficar aberta. Acompanhe por tasks_total e tasks_done.
Com o alerta "Marco atingido" ligado em alerts, os participantes são avisados, tanto no marco marcado à mão quanto no que fecha sozinho.
Na meta com progress_mode: marcos, cada tarefa principal da meta e cada marco sem tarefas valem um item; progress.items_total e progress.items_done mostram a conta.
Para o marco passar a fechar sozinho, dê tarefas a ele: POST /objectives/{objective}/milestones/{milestone}/tasks cria tarefas dentro do marco e PUT /objectives/{objective}/tasks/{task}/milestone põe uma tarefa existente nele (veja Organizar tarefas nos marcos).
Os marcos (com os ids) vêm em milestones na consulta da meta; criar, renomear ou tirar marcos é pelo Editar uma meta.

Referência

PUT /objectives/{objective}/milestones/{milestone} 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

cURL

curl -X PUT "$MICORE_BASE_URL/objectives/95/milestones/9" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "done": true
}'

Resposta

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
                ],
                "tasks_total": 3,
                "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.