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

Encerrar, reabrir e cancelar

Encerra uma meta com o resultado e o aprendizado, reabre uma meta encerrada ou cancela uma meta, com as mesmas regras do painel.

Considerações

  • Exigem o escopo objectives:write e a permissão Metas. Não usam Idempotency-Key.
  • Encerrar: result obrigatório. superada, atingida, parcialmente_atingida e nao_atingida concluem a meta; cancelada cancela. O resultado sugerido pelas faixas vem em progress.suggested_result; se escolher outro, explique em override_reason.
  • Aprendizado: lessons_worked (o que funcionou) e lessons_change (o que mudar), até 5000 caracteres cada; ele é sugerido ao criar uma meta parecida.
  • unfinished_tasks_action decide as tarefas pendentes: ficam na meta (keep, padrão), saem dela (unlink) ou vão para o arquivo (archive). note aceita até 2000 caracteres. O que acontece depois segue on_complete da meta.
  • Reabrir: sem corpo. A meta volta a nao_iniciada e o resultado do encerramento é apagado.
  • Cancelar: tasks_action decide as tarefas ativas não finalizadas: saem da meta (unlink, padrão) ou vão para o arquivo (delete). meta.tasks_affected diz quantas foram tratadas. Meta mensal cancelada para de repetir.
  • Encerrar meta já encerrada, reabrir meta aberta ou cancelar meta já cancelada responde 409 invalid_transition.

Referência

POST /objectives/{objective}/close na Referência da API POST /objectives/{objective}/reopen na Referência da API POST /objectives/{objective}/cancel na Referência da API

Como fazer

Encerrar como superada:

cURL
curl -X POST "$MICORE_BASE_URL/objectives/72/close" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "result": "superada",
    "note": "Fechamos 49 planos.",
    "lessons_worked": "Reunião de apresentação na mesma semana do contato.",
    "lessons_change": "Começar as propostas antes do fim do mês.",
    "unfinished_tasks_action": "keep"
}'

Reabrir:

cURL
curl -X POST "$MICORE_BASE_URL/objectives/72/reopen" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Cancelar, tirando as tarefas da meta:

cURL
curl -X POST "$MICORE_BASE_URL/objectives/58/cancel" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "tasks_action": "unlink"
}'

Resposta

Encerrar:

Resposta · 200
{
    "data": {
        "id": 72,
        "name": "Vendas do trimestre",
        "type": "resultado",
        "priority": "alta",
        "owner_scope": "quadro",
        "team": null,
        "visibility": "empresa",
        "parent": null,
        "progress_mode": "metricas",
        "routine": null,
        "bands": {
            "partial_from": 80,
            "exceeded_from": 120
        },
        "checkin": {
            "cadence": "weekly",
            "weekday": 1
        },
        "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": [],
        "confirmation": null,
        "recurrence": null,
        "recurrence_name": null,
        "recurrence_source_id": null,
        "description": null,
        "achievement_criteria": null,
        "board": {
            "id": 2,
            "name": "Comercial"
        },
        "responsible": {
            "id": 7,
            "name": "Ana Souza"
        },
        "date_start": "2026-10-01",
        "date_end": "2026-12-31",
        "status": "concluida",
        "situation": "done",
        "progress": {
            "percent": 100,
            "achievement": 122.5,
            "suggested_result": "superada",
            "source": "metrics"
        },
        "pace": {
            "elapsed_percent": 46,
            "ideal_percent": 46,
            "days_left": 49,
            "days_total": 92,
            "days_elapsed": 43,
            "projection_percent": 96,
            "achievement": 45
        },
        "closure": {
            "result": "superada",
            "note": "Fechamos 49 planos.",
            "closed_at": "2026-12-31T18:00:00-03:00",
            "unfinished_tasks_action": "keep",
            "lessons_worked": "Reunião de apresentação na mesma semana do contato.",
            "lessons_change": "Começar as propostas antes do fim do mês.",
            "override_reason": null
        },
        "metrics": [
            {
                "id": 140,
                "name": "Planos vendidos",
                "source": "manual",
                "integration_key": null,
                "indicator_key": null,
                "indicator_filters": null,
                "direction": "aumentar",
                "baseline_value": null,
                "tolerance_min": null,
                "tolerance_max": null,
                "weight": null,
                "count_scope": null,
                "target_value": 40,
                "current_value": 18,
                "unit": null,
                "percent": 45,
                "task_template_id": null,
                "user_id": null,
                "frequency": null,
                "frequency_target": null,
                "updated_at": "2026-11-12T10:30:00-03:00"
            }
        ],
        "created_at": "2026-10-01T08:00:00-03:00",
        "updated_at": "2026-11-12T10:30:00-03:00"
    }
}

Cancelar:

Resposta · 200
{
    "data": {
        "id": 58,
        "name": "Disponibilidade do sistema Novembro",
        "type": "resultado",
        "priority": "alta",
        "owner_scope": "quadro",
        "team": null,
        "visibility": "empresa",
        "parent": null,
        "progress_mode": "metricas",
        "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": [],
        "confirmation": null,
        "recurrence": "monthly",
        "recurrence_name": "Disponibilidade do sistema",
        "recurrence_source_id": 41,
        "description": null,
        "achievement_criteria": "Servidores no ar 99,9% do mês.",
        "board": {
            "id": 2,
            "name": "Operação"
        },
        "responsible": {
            "id": 7,
            "name": "Ana Souza"
        },
        "date_start": "2026-11-01",
        "date_end": "2026-11-30",
        "status": "cancelada",
        "situation": "canceled",
        "progress": {
            "percent": 100,
            "achievement": 100,
            "suggested_result": "atingida",
            "source": "metrics"
        },
        "pace": {
            "elapsed_percent": 40,
            "ideal_percent": 40,
            "days_left": 18,
            "days_total": 30,
            "days_elapsed": 12,
            "projection_percent": 100,
            "achievement": 100
        },
        "closure": null,
        "metrics": [
            {
                "id": 131,
                "name": "Disponibilidade dos servidores",
                "source": "integration",
                "integration_key": "sentinel.availability",
                "indicator_key": null,
                "indicator_filters": null,
                "direction": "manter",
                "baseline_value": null,
                "tolerance_min": 99.900000000000005684341886080801486968994140625,
                "tolerance_max": 100,
                "weight": null,
                "count_scope": null,
                "target_value": 99.900000000000005684341886080801486968994140625,
                "current_value": 99.9500000000000028421709430404007434844970703125,
                "unit": "%",
                "percent": 100,
                "task_template_id": null,
                "user_id": null,
                "frequency": null,
                "frequency_target": null,
                "updated_at": "2026-11-12T09:00:00-03:00"
            }
        ],
        "created_at": "2026-11-01T01:00:00-03:00",
        "updated_at": "2026-11-12T09:00:00-03:00"
    },
    "meta": {
        "tasks_affected": 3
    }
}
Precisa de ajuda?Use o request ID e abra um chamado no miCore se encontrar uma divergência.