Trocar o realizado de uma métrica

Atualizado em 17 de outubro de 2026

Considerações

Trocar exige o escopo objectives:write e a permissão Metas; o histórico, objectives:read. Não usa Idempotency-Key.
value é o novo realizado (zero ou mais); note (até 500 caracteres) vai para o histórico da métrica.
Na métrica manual, é o mesmo ajuste do painel.
Na métrica integration, é o número informado pelo outro sistema: o mesmo valor de antes não grava histórico, e meta encerrada responde 409.
As métricas task_template e indicator não aceitam: o número vem das tarefas finalizadas ou do indicador, e a resposta é 409 invalid_transition.
O histórico lista cada mudança, mais recente primeiro, com o valor depois, a diferença, a observação e quem lançou.
Não sabe o id da meta (ex.: a meta mensal de cada mês)? Use Informar o número por chave de integração.

Referência

PUT /objectives/{objective}/metrics/{metric}/value na Referência da API GET /objectives/{objective}/metrics/{metric}/history na Referência da API

Como fazer

cURL

curl -X PUT "$MICORE_BASE_URL/objectives/72/metrics/140/value" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "value": 18,
    "note": "Contagem conferida"
}'

O histórico da métrica:

cURL

curl "$MICORE_BASE_URL/objectives/72/metrics/140/history" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json"

Resposta

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": "em_andamento",
        "situation": "at_risk",
        "progress": {
            "percent": 45,
            "achievement": 45,
            "suggested_result": "nao_atingida",
            "source": "metrics"
        },
        "pace": {
            "elapsed_percent": 46,
            "ideal_percent": 46,
            "days_left": 49,
            "days_total": 92,
            "days_elapsed": 43,
            "projection_percent": 96,
            "achievement": 45
        },
        "closure": 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"
    }
}

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