API Reference / Strategy - Initiative Link Overrides

Override the initiative link on N entities in one batch

post https://api.intelig.ai/api/v1/intelig/strategy/initiatives/link-overrides/bulk

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

Used by the Catch-Up screen when a user confirms a cluster. Every item gets the same {@code newInitiativeId} and the same {@code reason}. Each item runs in its own REQUIRES_NEW transaction so one bad item does not roll back the rest of the batch. The response reports {@code successCount} and {@code failures[]} honestly — no Math.max overstatement.

Example request

curl -X POST "https://api.intelig.ai/api/v1/intelig/strategy/initiatives/link-overrides/bulk" \
  -H "Authorization: ApiKey $INTELIG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": "string",
    "newInitiativeId": 57,
    "reason": "Catch-Up confirm — Auth Hardening",
    "batchKey": "0f2b9c1e-6b6f-4f0a-9b1e-2f4d8c7a1234"
  }'

Request body

application/json

Field	Type	Required	Description
`items`	BulkOverrideItemRequest[]	yes	The commits and pull requests to relink. At most 500 per call.
`newInitiativeId`	integer (int64)	no	Initiative to link the whole batch to. Omit or send null to unlink them. Example: 57
`reason`	string	no	Why, for the audit trail. Applied to every row in the batch. Example: Catch-Up confirm — Auth Hardening
`batchKey`	string	yes	Client-supplied identifier that groups the audit rows for this batch. Mirrored verbatim onto the response so you can correlate. Example: 0f2b9c1e-6b6f-4f0a-9b1e-2f4d8c7a1234

Response 200

application/json · ApiResponseBulkOverrideResult

Field	Type	Description
`success`	boolean	—
`message`	string	—
`data`	BulkOverrideResult	—

Status codes

200 — Batch processed (may include per-item failures)
400 — Validation failed (e.g. target initiative not in org)
401 — Not authenticated
403 — Insufficient permissions to access strategy pillar
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.