Edit Incomes

Production

https://{{subdomain}}.daftara.com/api2

PUT

/incomes/{id}{format}

Update an existing income.

This is a partial update — send only the Income fields you want to change. Any field validated on create keeps its rule when supplied (e.g. a supplied amount must be non-zero, a supplied date must fall in an open period). The income id is taken from the path; any id in the body is ignored.

Optionally include JournalTransaction / CostCenterTransaction arrays to replace the account and cost-center allocation, or a RecurringExpense object.

The same operation is also reachable via POST /incomes/{id}.

An income that is locked to another record (e.g. generated from another entity) or already used in an income-distribution transaction cannot be edited.

Access: requires the account owner, or staff with Edit/Delete All Incomes, or Edit/Delete His Own Incomes (for their own records), or Draft (for their own draft records).

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

The income was updated.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff --request PUT 'https://.daftara.com/api2/incomes/14' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--header 'apikey: ' \
--header 'Content-Type: application/json' \
--data '{
  "Income": {
    "amount": 1750,
    "note": "Updated monthly hosting",
    "date": "2026-06-10"
  }
}'

Response Example

200 - Example 1

{
    "result": "successful",
    "code": 200
}

Add New Income

Delete Incomes