API Reference / Strategy - Initiative Discovery
Link a candidate to an existing initiative
post
https://api.intelig.ai/api/v1/intelig/strategy/discovery/candidates/{candidateId}/link-to-existing
Auth: Authorization: ApiKey <key> (an API key sent as
Bearer is rejected) or Authorization: Bearer <jwt>
for a dashboard session. operationId: linkToExisting
Use when the discovered work belongs to an initiative that already exists rather than a new one.
Example request
curl -X POST "https://api.intelig.ai/api/v1/intelig/strategy/discovery/candidates/1/link-to-existing" \
-H "Authorization: ApiKey $INTELIG_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"targetInitiativeId": 57,
"linkedCommitCount": 34
}'Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
candidateId | integer (int64) | yes | — |
Request body
application/json
| Field | Type | Required | Description |
|---|---|---|---|
targetInitiativeId | integer (int64) | no | Initiative the candidate's commits belong to. Example: 57 |
linkedCommitCount | integer (int32) | no | How many of the candidate's commits are being moved. Recorded on the audit row. Example: 34 |
Response 200
application/json · ApiResponseVoid
| Field | Type | Description |
|---|---|---|
success | boolean | — |
message | string | — |
data | object | — |
Status codes
200— OK401— —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.