API Reference / Strategy - Initiatives

Update initiative details

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

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

Partially updates an initiative's name, description, or success criteria

Example request

curl -X PATCH "https://api.intelig.ai/api/v1/intelig/strategy/initiatives/1/details" \
  -H "Authorization: ApiKey $INTELIG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mobile App v3",
    "description": "Rebuild with Flutter for cross-platform support",
    "successCriteria": "60% improvement in app store rating",
    "canonicalId": "INI-57"
  }'

Path parameters

NameTypeRequiredDescription
id integer (int64) yes

Request body

application/json

FieldTypeRequiredDescription
name string no Updated initiative name (max 200 characters) Example: Mobile App v3
description string no Updated initiative description Example: Rebuild with Flutter for cross-platform support
successCriteria string no Updated success criteria Example: 60% improvement in app store rating
canonicalId string no Canonical initiative id (e.g. `INI-57`) used to attribute commits and PRs that reference it. Unique per organization. Omit to leave unchanged; send an empty string to clear it. Example: INI-57

Response 200

application/json · ApiResponseInitiativeDto

FieldTypeDescription
success boolean
message string
data InitiativeDto Initiative details response

Status codes

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