Budget

Update phase data for budget lines

Updates up to 500 line and phase entries. If any entry fails, none are changed. Use Idempotency-Key to retry safely.

post/projects/{projectId}/budget/lines/phase-data/bulk

Request

  • Base URL: https://next-api.saturation.io/v1
  • URL: https://next-api.saturation.io/v1/projects/{projectId}/budget/lines/phase-data/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

{
  "items": [
    {
      "lineId": "txn_8f2a1c9e",
      "phaseId": "txn_8f2a1c9e",
      "phaseData": {
        "customUnitId": "txn_8f2a1c9e",
        "fringeIds": [
          "txn_8f2a1c9e"
        ],
        "fringeGroupIds": [
          "txn_8f2a1c9e"
        ],
        "currencyId": "txn_8f2a1c9e"
      }
    }
  ]
}

Response

The updated phase data.

Example response

{
  "data": [
    {
      "lineId": "txn_8f2a1c9e",
      "phaseId": "txn_8f2a1c9e",
      "phaseData": {
        "customUnitId": "txn_8f2a1c9e",
        "fringeIds": [
          "txn_8f2a1c9e"
        ],
        "fringeGroupIds": [
          "txn_8f2a1c9e"
        ],
        "currencyId": "txn_8f2a1c9e"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 4 revisions of this API.