After creation, you have two options for updating the rate card: edit the rate card metadata or schedule a rate change.

​
Edit rate card metadata​

When editing the rate card metadata, you can:
  • Change the rate card name
  • Change the rate card description
  • Add or remove rate card aliases
  • Rate new products on your rate card
To edit the rate card metadata, go to the specific rate card from the Offering rate cards page or make a POST request to /contract-pricing/rate-cards/update.

​
Schedule a rate change​

Scheduling a price change is a common workflow for organizations. In traditional billing systems, this process can require significant cross-functional coordination to ensure the change takes place at the right moment. Metronome streamlines this process by allowing you to schedule changes for a specified time period. For example, if you know you’re launching a product next month, you can schedule a rate change to go into effect on the launch day. On the day your rate changes take place, you can focus on your customers, not on their billing configuration. To schedule a rate change through the API, make a POST request to /contract-pricing/rate-cards/addRates. This is the same endpoint used to create new rates. The example below uses the same API call as the prior example, however, it adds two important additions: a starting_at date set for one year after the initial pricing and the updated price. 
curl https://api.metronome.com/v1/contract-pricing/rate-cards/addRates \  
-H "Authorization: Bearer <TOKEN>" \  
-H "Content-Type: application/json" \  
-d '{  
"rate_card_id": "d7abd0cd-4ae9-4db7-8676-e986a4ebd8dc",  
"rates": [  
  {  
    "product_id": "13117714-3f05-48e5-a6e9-a66093f13b4d",  
    "starting_at": "2024-01-01T00:00:00.000Z",  
    "entitled": true,  
    "rate_type": "FLAT",  
    "price": 100,  
    "pricing_group_values": {  
      "region": "us-west-2",  
      "cloud": "aws"  
    }  
  },  
  {  
    "product_id": "13117714-3f05-48e5-a6e9-a66093f13b4d",  
    "starting_at": "2024-01-01T00:00:00.000Z",  
    "entitled": true,  
    "rate_type": "FLAT",  
    "price": 120,  
    "pricing_group_values": {  
      "region": "us-east-2",  
      "cloud": "aws"  
    }  
  }  
]  
}'