Create a new roadmap

post https://api.intelig.ai/api/v1/intelig/strategy/roadmaps

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

Creates a strategic roadmap for a given year and scope, with auto-generated quarterly planning structure

Example request

curl -X POST "https://api.intelig.ai/api/v1/intelig/strategy/roadmaps" \
  -H "Authorization: ApiKey $INTELIG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "visionId": 1,
    "year": 2026,
    "name": 2026,
    "scopeType": "ORGANIZATION",
    "scopeName": "Engineering"
  }'

Request body

application/json

Field	Type	Required	Description
`visionId`	integer (int64)	no	Optional vision ID to associate with this roadmap Example: 1
`year`	integer (int32)	yes	Year the roadmap covers Example: 2026
`name`	string	yes	Roadmap name Example: 2026
`scopeType`	string	yes	Scope type One of: ORGANIZATION, TEAM, CONTRIBUTOR, PERSONAL Example: ORGANIZATION
`scopeId`	integer (int64)	no	ID of the scope entity Example: 100
`scopeName`	string	yes	Display name of the scope Example: Engineering

Response 200

application/json · ApiResponseRoadmapResponse

Field	Type	Description
`success`	boolean	—
`message`	string	—
`data`	RoadmapResponse	Roadmap with quarters, milestones, and scope information

Status codes

200 — Roadmap created successfully
400 — Invalid request body or validation failure
401 — Not authenticated
403 — Insufficient permissions to access strategy pillar
409 — Roadmap already exists for this 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.