NIninjarmm
Billing

Updates a product

Changed on

Updates a previously created product given its ID and updated content.

The content field structure varies by quantity type and must include all required fields for that type (price, cost, taxable, billing, and type-specific fields). See the create product description for details on required fields per quantity type.

Note: The quantity type cannot be changed after product creation.

put/v2/billing/products/{id}

Request

Path parameters

idinteger required

Request body */*

namestring required

Name of the product.

descriptionstring required

Description of the product.

quantityType'MANUAL' | 'DEVICE_COUNTS' | 'TIME_ENTRIES' | 'END_USER_COUNTS' | 'BACKUP_STORAGE_COUNTS' | 'SOFTWARE_LICENSE' required

Quantity type of the product.

accountIdinteger required

Account ID associated with the product.

groupboolean required

Whether the product should be grouped.

integrationSettingsobject

If 3rd party integration is enabled, the settings needed to export invoices with this product.

contentobject required

Additional content/configuration for the product. Structure varies by quantity type.

taxIdinteger

Tax ID assigned to the product. If null, the product will use the agreement's tax.

inheritTaxFromAgreementboolean

Whether this product inherits its tax configuration from the agreement.

Example request

{
  "name": "Hardware Support",
  "description": "Monthly hardware support service",
  "quantityType": "DEVICE_COUNTS",
  "accountId": 1,
  "group": true,
  "productUserRole": {
    "allowAllTechnicians": true,
    "userRoles": [
      1,
      2
    ]
  },
  "taxId": 5,
  "inheritTaxFromAgreement": true
}

Response

Product successfully updated

idinteger

Unique identifier of the product.

namestring

Name of the product.

descriptionstring

Description of the product.

quantityType'MANUAL' | 'DEVICE_COUNTS' | 'TIME_ENTRIES' | 'END_USER_COUNTS' | 'BACKUP_STORAGE_COUNTS' | 'SOFTWARE_LICENSE'

Quantity type of the product.

contentobject

Additional content/configuration for the product. Structure varies by quantity type. Includes price, cost, taxable, and other type-specific fields.

createTimenumber double

Timestamp when the product was created.

updateTimenumber double

Timestamp when the product was last updated.

accountIdinteger

Account ID associated with the product.

groupboolean

Whether the product is a group product.

taxIdinteger nullable

Tax ID associated with the product. Null if no specific tax is set.

inheritTaxFromAgreementboolean

Whether the product inherits tax from the agreement.

activeboolean

Indicates if the product is active.

Example response

{
  "id": 1,
  "name": "Hardware Support",
  "description": "Monthly hardware support service",
  "quantityType": "DEVICE_COUNTS",
  "accountId": 8,
  "taxId": 1,
  "inheritTaxFromAgreement": true,
  "active": true
}

Changes

  • 753f26d46650Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • dec5d4ed264eRevision changes
    • info

      endpoint added