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
| Name | Type | Required | Description |
|---|---|---|---|
id | integer (int64) | yes | — |
Request body
application/json
| Field | Type | Required | Description |
|---|---|---|---|
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
| Field | Type | Description |
|---|---|---|
success | boolean | — |
message | string | — |
data | InitiativeDto | Initiative details response |
Status codes
200— Initiative details updated successfully400— Invalid request body or validation failure401— Not authenticated403— Insufficient permissions to access strategy pillar404— Initiative not found429— —
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.