API Reference / Strategy - Roadmaps

Update a milestone

patch https://api.intelig.ai/api/v1/intelig/strategy/roadmaps/{id}/quarters/{quarter}/milestones/{milestoneId}

Auth: Authorization: ApiKey <key> (an API key sent as Bearer is rejected) or Authorization: Bearer <jwt> for a dashboard session. operationId: updateMilestone

Updates a milestone's name, description, target date, type, or status within a quarter

Example request

curl -X PATCH "https://api.intelig.ai/api/v1/intelig/strategy/roadmaps/1/quarters/string/milestones/1" \
  -H "Authorization: ApiKey $INTELIG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "GA Release",
    "description": "General availability release of the mobile app",
    "targetDate": "2026-04-01",
    "milestoneType": "RELEASE"
  }'

Path parameters

NameTypeRequiredDescription
id integer (int64) yes
quarter string yes
milestoneId integer (int64) yes

Request body

application/json

FieldTypeRequiredDescription
name string no Updated milestone name Example: GA Release
description string no Updated milestone description Example: General availability release of the mobile app
targetDate string (date) no Updated target date Example: 2026-04-01
milestoneType string no Updated milestone type Example: RELEASE
status string no Updated milestone status Example: ACHIEVED

Response 200

application/json · ApiResponseRoadmapResponse

FieldTypeDescription
success boolean
message string
data RoadmapResponse Roadmap with quarters, milestones, and scope information

Status codes

  • 200 — Milestone updated successfully
  • 400 — Invalid request body or validation failure
  • 401 — Not authenticated
  • 403 — Insufficient permissions to access strategy pillar
  • 404 — Roadmap, quarter, or milestone not found
  • 429 — —

Every response is wrapped in { success, message, data }. A 4xx means the request is wrong — do not retry it unchanged. A 429 carries Retry-After in seconds.