Editar uma meta

Atualizado em 17 de outubro de 2026

Considerações

Exige o escopo objectives:write e a permissão Metas. Não usa Idempotency-Key.
Aceita os mesmos campos do criar, menos draft (para tirar do rascunho, use Publicar um rascunho).
metrics, quando vem, é a lista completa: as métricas que ficarem de fora são desativadas (o histórico fica guardado). Mande o id de cada métrica que deve continuar; sem id, nasce uma nova.
milestones, quando vem, também é a lista completa: com id o marco é atualizado, sem id nasce um novo e os que ficarem de fora saem do plano. O marco com tarefas fecha sozinho; o sem tarefas é marcado em Marcar um marco.
Mudar owner_scope segue a mesma regra do criar: quadro exige board_id; time exige team_id.
status aceita só nao_iniciada e em_andamento; para encerrar, use Encerrar. Voltar a abrir uma meta encerrada apaga o resultado do encerramento.
Com repetição mensal, name é o nome sem o mês. recurrence: null tira a repetição e mantém o nome e as datas atuais.

Referência

PATCH /objectives/{objective} na Referência da API

Como fazer

Trocar a descrição e a prioridade:

cURL

curl -X PATCH "$MICORE_BASE_URL/objectives/58" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Meta de estabilidade do mês",
    "priority": "alta"
}'

Manter a métrica 131, mudar o alvo dela e acrescentar outra:

cURL

curl -X PATCH "$MICORE_BASE_URL/objectives/58" \
  -H "Authorization: Bearer $MICORE_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "metrics": [
        {
            "id": 131,
            "name": "Disponibilidade dos servidores",
            "source": "integration",
            "integration_key": "sentinel.availability",
            "direction": "manter",
            "target_value": 99.9500000000000028421709430404007434844970703125,
            "tolerance_min": 99.9500000000000028421709430404007434844970703125,
            "tolerance_max": 100,
            "unit": "%"
        },
        {
            "name": "Quedas resolvidas em até 1 hora",
            "source": "integration",
            "integration_key": "sentinel.resolved_60m",
            "target_value": 100,
            "unit": "%"
        }
    ]
}'

Resposta

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": "Meta de estabilidade do mês",
        "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": "em_andamento",
        "situation": "on_track",
        "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"
    }
}

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