API Reference / Finance - Initiatives

Upsert an initiative's revenue target

put https://api.intelig.ai/api/v1/intelig/finance/initiatives/{initiativeId}/revenue-target

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

Creates or updates the revenue target for an initiative. Returns 201 on insert, 200 on update.

Example request

curl -X PUT "https://api.intelig.ai/api/v1/intelig/finance/initiatives/1/revenue-target" \
  -H "Authorization: ApiKey $INTELIG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "expectedRevenueCents": 30000000,
    "actualRevenueCents": 25000000,
    "currency": "USD",
    "revenueBasis": "ONE_TIME"
  }'

Path parameters

NameTypeRequiredDescription
initiativeId integer (int64) yes

Request body

application/json

FieldTypeRequiredDescription
expectedRevenueCents integer (int64) no Expected revenue in cents. Nullable. Example: 30000000
actualRevenueCents integer (int64) no Actual revenue realized to date, in cents. Nullable. Example: 25000000
currency string no ISO 4217 currency code. Defaults to USD. Example: USD
revenueBasis string no Whether the declared revenue is one-time or annual. One of: ONE_TIME, ANNUAL Example: ONE_TIME
investmentMode string no Classification of the investment. One of: BUILD, MAINTAIN, COMPLIANCE, EXPERIMENT Example: BUILD
notes string no Optional free-text notes (max 2000 chars). Example: Target agreed with the CFO in the Q3 planning review

Response 200

application/json · ApiResponseRevenueTargetResponse

FieldTypeDescription
success boolean
message string
data RevenueTargetResponse

Status codes

  • 200 — OK
  • 401 — —
  • 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.