API Reference / Strategy - Vision

Update a vision

patch https://api.intelig.ai/api/v1/intelig/strategy/vision/{id}

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

Partially updates a vision's title, statement, strategic mode, date range, or prioritization signals

Example request

curl -X PATCH "https://api.intelig.ai/api/v1/intelig/strategy/vision/1" \
  -H "Authorization: ApiKey $INTELIG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Build the engineering intelligence platform v2",
    "statement": "Every engineering decision is traceable from intent to outcome, and priced",
    "strategicMode": "GROWTH",
    "startDate": "2026-01-01",
    "endDate": "2026-12-31"
  }'

Path parameters

NameTypeRequiredDescription
id integer (int64) yes

Request body

application/json

FieldTypeRequiredDescription
title string yes Updated vision title Example: Build the engineering intelligence platform v2
statement string no Updated vision statement Example: Every engineering decision is traceable from intent to outcome, and priced
strategicMode string yes Updated strategic mode One of: STABILIZATION, PLATFORM_MATURATION, GROWTH, SCALE, COST_OPTIMIZATION, PRE_EXIT_OPTIMIZATION Example: GROWTH
startDate string (date) yes Updated start date Example: 2026-01-01
endDate string (date) yes Updated end date Example: 2026-12-31
optimizingFor string[] no Updated list of priorities to optimize for Example: ["Developer velocity","Code quality"]
deprioritizing string[] no Updated list of areas being intentionally deprioritized Example: ["Feature breadth"]

Response 200

application/json · ApiResponseVisionDto

FieldTypeDescription
success boolean
message string
data VisionDto Strategic vision response with scope, priorities, and timeline

Status codes

  • 200 — Vision updated successfully
  • 400 — Invalid request body or validation failure
  • 401 — Not authenticated
  • 403 — Insufficient permissions to access strategy pillar
  • 404 — Vision 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.