InteliG
Sign Up

API Reference / Strategy - Initiative Link Overrides

Override or unlink an entity's initiative attribution

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

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

Re-assigns the entity to a new initiative, or unlinks it entirely when {@code newInitiativeId} is omitted. The override beats every automatic matcher and survives reconciliation. The matcher's candidate ranking at override time is snapshotted into the audit row as labeled training data.

Example request

curl -X POST "https://api.intelig.ai/api/v1/intelig/strategy/initiatives/link-overrides" \
  -H "Authorization: ApiKey $INTELIG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entityType": "COMMIT",
    "entityId": 8421,
    "newInitiativeId": 57,
    "reason": "Belongs to the reconciliation work, not the ingestion rewrite"
  }'

Request body

application/json

FieldTypeRequiredDescription
entityType string yes What is being relinked. One of: COMMIT, PULL_REQUEST, ACTION_ITEM, DECISION Example: COMMIT
entityId integer (int64) yes Identifier of the commit or pull request. Example: 8421
newInitiativeId integer (int64) no Initiative to link it to. Omit or send null to unlink it entirely. Example: 57
reason string no Why, for the audit trail. Example: Belongs to the reconciliation work, not the ingestion rewrite

Response 200

application/json · ApiResponseResult

FieldTypeDescription
success boolean —
message string —
data Result —

Status codes

  • 200 — Override recorded
  • 400 — Validation failed (e.g. 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.