Create budget item

post https://api.intelig.ai/api/v1/intelig/budgets/{budgetId}/items

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

Adds a new item to the budget at the end of the list

Example request

curl -X POST "https://api.intelig.ai/api/v1/intelig/budgets/1/items" \
  -H "Authorization: ApiKey $INTELIG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane Doe",
    "role": "Senior Engineer",
    "employmentType": "FULL_TIME",
    "rateType": "MONTHLY",
    "rateAmount": 12000
  }'

Path parameters

Name	Type	Required	Description
`budgetId`	integer (int64)	yes	—

Request body

application/json

Field	Type	Required	Description
`name`	string	no	Contributor or line item name Example: Jane Doe
`role`	string	no	Role or title Example: Senior Engineer
`employmentType`	string	yes	Employment type One of: FULL_TIME, PART_TIME, CONTRACTOR, AI_AGENT Example: FULL_TIME
`rateType`	string	yes	Rate type (monthly, hourly, annual) One of: HOURLY, MONTHLY, ANNUAL Example: MONTHLY
`rateAmount`	number	yes	Rate amount Example: 12000
`hoursPerMonth`	integer (int32)	no	Hours per month (for hourly rates) Example: 160
`contributorId`	integer (int64)	no	Optional linked contributor ID Example: 42

Response 200

application/json · ApiResponseLong

Field	Type	Description
`success`	boolean	—
`message`	string	—
`data`	integer (int64)	—

Status codes

200 — Budget item created successfully
400 — Invalid request body
401 — Not authenticated
403 — Insufficient permissions to access finance pillar
404 — Budget not found
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.