Update a product in a product group

put

https://{hostname}/v1/contracts/{contract_id}/product_groups/{product_group_id}/products/{product_id}

Use this endpoint to update a specific product within a specific product group in the contract. See Products for more information.

Path Params

contract_id

integer

required

The unique ID of the contract.

product_group_id

integer

required

The unique ID of the product group.

product_id

integer

required

The unique ID of the product.

Body Params

Request body parameters used for updating a product to a product group in a contract.

_private_ownerside

object

Contract product attributes that are private to the ownerside.

counterparty_lock

boolean

Defaults to false

If true, the counterpart can edit products in the contract.

description

string

length between 0 and 3000

The product description.

integer

The product ID.

name

string

length between 1 and 80

The product name. When creating a new product, it is mandatory to provide a product name.

price_1

object | null

The object holds all price-related information for an individual product. Note that base_amount must be larger than discount_amount, except if the base_amount is 0, which is an exception to allow negative prices. See Products.

price_2

object | null

quantity

object

The object holds information about the quantity of an individual product. The default quantity type is multiple_choice. If the quantity type is single_choice or multiple_choice, the amount must be set to 0 or 1. If the quantity type is set to single_choice, the amount must be set to 1 at least for one product, and 0 for the rest of the products in the same product group with the quantity type single_choice.

Headers

x-oneflow-api-token

string

required

length between 40 and 40

The API key of your Oneflow account.

x-oneflow-user-email

string

required

The email address of a registered Oneflow user.

Responses

400

Invalid format or content of the request.

404

A required entity is missing.

409

A conflict occurred with the current state of the target resource.

200Returns the newly updated product.