Sign in
Library

Update a project incentive

Update the supplied incentive fields.

patch/projects/{projectId}/library/incentives/{incentiveId}

Request

  • Base URL: https://next-api.saturation.io/v1
  • URL: https://next-api.saturation.io/v1/projects/{projectId}/library/incentives/{incentiveId}
  • Auth: HTTP bearer

Path parameters

projectIdstring required

Project ID or slug.

incentiveIdstring required

A stable resource ID, such as prj_…, txn_…, or doc_….

Example:txn_8f2a1c9e

Request body

namestring
isAppliedboolean
accountNumberstring
incentiveType'tax_credit' | 'rebate' | 'grant'
jurisdictionstring
ratenumber
appliedCreditCapinteger nullable
discountPercentnumber
tierOverrideKeystring nullable

Response

The updated project incentive.

idstring required

A stable resource ID, such as prj_…, txn_…, or doc_….

namestring required
jurisdictionstring nullable
incentiveTypestring nullable
sourceType'workspace' | 'saturation' required

Where the project Library item came from.

sourceIdstring

A stable resource ID, such as prj_…, txn_…, or doc_….

sourceIncentiveVersionIdstring

A stable resource ID, such as prj_…, txn_…, or doc_….

isAppliedboolean required

Whether the incentive is currently applied to the project's budget.

accountNumberstring nullable

Budget account number for the incentive.

ratenumber nullable

Credit rate as a percentage. For example, 30 means 30%.

appliedCreditCapinteger nullable

Maximum credit in minor currency units, or null for no limit.

discountPercentnumber nullable

Broker fee deducted from the credit, as a percentage.

tierOverrideKeystring nullable

Selected incentive tier, or null to choose the tier from qualified spend.

Example response

{
  "id": "txn_8f2a1c9e",
  "sourceId": "txn_8f2a1c9e",
  "sourceIncentiveVersionId": "txn_8f2a1c9e",
  "source": {
    "id": "txn_8f2a1c9e",
    "currentVersion": {
      "id": "txn_8f2a1c9e"
    }
  }
}

Changes

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