API Reference / Code - Commit Narrative
Generate a commit's narrative
post
https://api.intelig.ai/api/v1/intelig/code/commits/{commitId}/narrative/generate
Auth: Authorization: ApiKey <key> (an API key sent as
Bearer is rejected) or Authorization: Bearer <jwt>
for a dashboard session. operationId: generate
Generates (or regenerates) the narrative for a commit and returns it. Responds 404 when the commit does not exist in this organization. This calls a language model, so it is slower than a read and is rate limited like any other write.
Example request
curl -X POST "https://api.intelig.ai/api/v1/intelig/code/commits/1/narrative/generate" \
-H "Authorization: ApiKey $INTELIG_API_KEY"Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
commitId | integer (int64) | yes | — |
Response 200
application/json · CommitNarrativeResponse
| Field | Type | Description |
|---|---|---|
id | string (uuid) | — |
commitId | integer (int64) | — |
commitSha | string | — |
status | string | — |
body | object | — |
promptVersion | string | — |
modelUsed | string | — |
generationMode | string | — |
inputTokens | integer (int32) | — |
outputTokens | integer (int32) | — |
latencyMs | integer (int64) | — |
failureReason | string | — |
failureDetail | string | — |
generatedAt | string (date-time) | — |
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.