Sign in
Budget

Create budget lines

Changed on

Creates up to 100 budget lines with optional phase data. If any line fails, none are created. Use Idempotency-Key to retry safely.

post/projects/{projectId}/budget/lines/bulk

Request

  • Base URL: https://next-api.saturation.io/v1
  • URL: https://next-api.saturation.io/v1/projects/{projectId}/budget/lines/bulk
  • Auth: HTTP bearer

Path parameters

projectIdstring required

Project ID or slug.

Headers

Idempotency-Keystring required

A 16 to 255 character key for safe retries. Reusing the key with a different request returns 409 idempotency_conflict.

Request body

Example request

{
  "lines": [
    {
      "description": "Camera Package",
      "type": "line",
      "accountId": "1110",
      "parentId": "lin_7c1a2f",
      "contactId": "con_panavision",
      "phaseData": {
        "phs_estimate": {
          "rate": 25000,
          "quantity": 4,
          "multiplier": 1
        }
      }
    }
  ]
}

Response

The created budget lines in request order.

Example response

{
  "data": [
    {
      "id": "lin_7c1a2f",
      "accountId": "1100",
      "path": "1100",
      "type": "account",
      "description": "Camera",
      "parentId": "lin_root",
      "depth": 0,
      "sort": 0,
      "contactId": null,
      "tagIds": [
        "tag_vfx"
      ],
      "sourceId": null
    }
  ]
}

Changes