Duplicate box

Copies a box and its live expenses into the same budget. Does not copy the account link.

POST/v1/duplicate_box

Body

Field	Type	Required	Default	Description
idempotencyKey	string	Yes	—	Client-generated key (1–128 chars: letters, digits, . _ : -). Same key + same body replays; different body returns 409. Prefer Idempotency-Key HTTP header when calling the Tools API.
budgetId	string	Yes	—	Budget that owns the source box (edit access required).
boxId	string	Yes	—	Source box to duplicate.
name	string	No	—	Name for the copy. Defaults to source name + `(Copy)`.

Response `data`

Field	Type	Description
id	string	New box id.
budgetId	string	Same budget as the source.
name	string	Name of the copy.
sourceBoxId	string	Id of the box that was duplicated.
expenses	array	Copied expenses (`id`, `boxId`, `name`).

Request

curl --request POST \
  --url https://api.getliquify.com/v1/duplicate_box \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"idempotencyKey":"req-1","budgetId":"bud_01","boxId":"box_01"}'

{
  "ok": true,
  "data": {
    "id": "box_02",
    "budgetId": "bud_01",
    "name": "Needs (Copy)",
    "sourceBoxId": "box_01"
  }
}

Body

Response data

Related

Response `data`