API Reference / Strategy - Roadmaps

Get roadmap by year and scope

get https://api.intelig.ai/api/v1/intelig/strategy/roadmaps/by-scope

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

Looks up a roadmap by its year and scope type (e.g., ORGANIZATION, TEAM) with optional scope ID

Example request

curl -X GET "https://api.intelig.ai/api/v1/intelig/strategy/roadmaps/by-scope?year=1&scopeType=string" \
  -H "Authorization: ApiKey $INTELIG_API_KEY"

Query parameters

NameTypeRequiredDescription
year integer (int32) yes
scopeType string yes
scopeId integer (int64) no

Response 200

application/json · ApiResponseRoadmapResponse

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

Status codes

  • 200 — Roadmap found and returned
  • 401 — Not authenticated
  • 403 — Insufficient permissions to access strategy pillar
  • 404 — Roadmap not found for given year and scope
  • 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.