# Specs

Specs are name-value pairs, typically captured during user input when adding a product to an order. A spec value may have a price markup or markdown associated with it. In more advanced scenarios, specs can define a specific product variant. For example, a product may be available in 3 colors and 3 sizes and therefore have a total of 9 variants. OrderCloud will choose the correct variant to add based on the user-selected values, in this example color and size.

 - [GET /specs](https://api-docs.sitecore.com/ordercloud/specs/specs.list.md)
 - [POST /specs](https://api-docs.sitecore.com/ordercloud/specs/specs.create.md)
 - [GET /specs/{specID}](https://api-docs.sitecore.com/ordercloud/specs/specs.get.md)
 - [PUT /specs/{specID}](https://api-docs.sitecore.com/ordercloud/specs/specs.save.md): If an object with the same ID already exists, it will be overwritten.
 - [DELETE /specs/{specID}](https://api-docs.sitecore.com/ordercloud/specs/specs.delete.md)
 - [PATCH /specs/{specID}](https://api-docs.sitecore.com/ordercloud/specs/specs.patch.md)
 - [GET /specs/{specID}/options](https://api-docs.sitecore.com/ordercloud/specs/specs.listoptions.md)
 - [POST /specs/{specID}/options](https://api-docs.sitecore.com/ordercloud/specs/specs.createoption.md): A Spec can have multiple Options-- for example, if the spec is called 'Color', the options might be 'Blue', 'Red', and 'Green'.
 - [GET /specs/{specID}/options/{optionID}](https://api-docs.sitecore.com/ordercloud/specs/specs.getoption.md)
 - [PUT /specs/{specID}/options/{optionID}](https://api-docs.sitecore.com/ordercloud/specs/specs.saveoption.md)
 - [DELETE /specs/{specID}/options/{optionID}](https://api-docs.sitecore.com/ordercloud/specs/specs.deleteoption.md)
 - [PATCH /specs/{specID}/options/{optionID}](https://api-docs.sitecore.com/ordercloud/specs/specs.patchoption.md)
 - [DELETE /specs/{specID}/productassignments/{productID}](https://api-docs.sitecore.com/ordercloud/specs/specs.deleteproductassignment.md)
 - [GET /specs/productassignments](https://api-docs.sitecore.com/ordercloud/specs/specs.listproductassignments.md)
 - [POST /specs/productassignments](https://api-docs.sitecore.com/ordercloud/specs/specs.saveproductassignment.md)