POST
/
v1
/
contract-pricing
/
products
/
update
Update a product
curl --request POST \
  --url https://api.metronome.com/v1/contract-pricing/products/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "product_id": "d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc",
  "name": "My Updated Product",
  "starting_at": "2020-01-01T00:00:00.000Z"
}'
{
  "data": {
    "id": "d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Updates a product's configuration while maintaining billing continuity for active customers. Use this endpoint to modify product names, metrics, pricing rules, and composite settings without disrupting ongoing billing cycles. Changes are scheduled using the starting_at timestamp, which must be on an hour boundary–set future dates to schedule updates ahead of time, or past dates for retroactive changes. Returns the updated product ID upon success.

Usage guidance: Product type cannot be changed after creation. For incorrect product types, create a new product and archive the original instead.

The body is of type object.

Response

Success

The response is of type object.