action vtex_post_api_catalog_pvt_specification {
  label: "Create Specification"
  description: "Creates a new Product or SKU Specification. 
\n## Request body example
\n
\n```json
\n{
\n    \"FieldTypeId\": 1,
\n    \"CategoryId\": 4,
\n    \"FieldGroupId\": 20,
\n    \"Name\": \"Material\",
\n    \"Description\": \"Composition of the product.\",
\n    \"Position\": 1,
\n    \"IsFilter\": true,
\n    \"IsRequired\": true,
\n    \"IsOnProductDetails\": false,
\n    \"IsStockKeepingUnit\": false,
\n    \"IsActive\": true,
\n    \"IsTopMenuLinkActive\": false,
\n    \"IsSideMenuLinkActive\": true,
\n    \"DefaultValue\": \"Cotton\"
\n}
\n```
\n
\n## Response body example
\n
\n```json
\n{
\n    \"Id\": 88,
\n    \"FieldTypeId\": 1,
\n    \"CategoryId\": 4,
\n    \"FieldGroupId\": 20,
\n    \"Name\": \"Material\",
\n    \"Description\": \"Composition of the product.\",
\n    \"Position\": 1,
\n    \"IsFilter\": true,
\n    \"IsRequired\": true,
\n    \"IsOnProductDetails\": false,
\n    \"IsStockKeepingUnit\": false,
\n    \"IsWizard\": false,
\n    \"IsActive\": true,
\n    \"IsTopMenuLinkActive\": false,
\n    \"IsSideMenuLinkActive\": true,
\n    \"DefaultValue\": \"Cotton\"
\n}
\n```
\n"
  provider: vtex
  method: POST
  path: "/api/catalog/pvt/specification"
  encoding: json
  input: {
    type: "object"
    properties: {
      Accept: {
        type: "string"
      }
      CategoryId: {
        type: "integer"
        description: "Category ID associated with this specification."
      }
      "Content-Type": {
        type: "string"
      }
      DefaultValue: {
        type: "string"
        description: "Specification default value."
      }
      Description: {
        type: "string"
      }
      FieldGroupId: {
        type: "integer"
        description: "ID of the group of specifications that contains the new specification."
      }
      FieldTypeId: {
        type: "integer"
        description: "Field Type ID can be `1 - Text`, `2 - Multi-Line Text`, `4 - Number`, `5 - Combo`, `6 - Radio`, `7 - Checkbox`, `8 - Indexed Text`, `9 - Indexed Multi-Line Text`."
      }
      IsActive: {
        type: "boolean"
        description: "Enable (`true`) or disable (`false`) specification."
      }
      IsFilter: {
        type: "boolean"
        description: "Store Framework - Deprecated.
\nLegacy CMS Portal - To allow the specification to be used as a facet (filter) on the search navigation bar.
\n"
      }
      IsOnProductDetails: {
        type: "boolean"
        description: "Store Framework - Deprecated.
\nLegacy CMS Portal -If specification is visible on the product page.
\n"
      }
      IsRequired: {
        type: "boolean"
        description: "Makes the specification mandatory (`true`) or optional (`false`)."
      }
      IsSideMenuLinkActive: {
        type: "boolean"
        description: "Store Framework - Deprecated.
\nLegacy CMS Portal - To make the specification field clickable in the search navigation bar.
\n"
      }
      IsStockKeepingUnit: {
        type: "boolean"
        description: "If `true`, it will be added as a SKU specification. If `false`, it will be added as a product specification field."
      }
      IsTopMenuLinkActive: {
        type: "boolean"
        description: "Store Framework - Deprecated.
\nLegacy CMS Portal - To make the specification visible in the store's upper menu.
\n"
      }
      IsWizard: {
        type: "boolean"
      }
      Name: {
        type: "string"
        description: "Specification name."
      }
      Position: {
        type: "integer"
        description: "Store Framework - Deprecated.
\nLegacy CMS Portal - This position number is used in ordering the specifications both in the navigation menu and in the specification listing on the product page.
\n"
      }
    }
    required: ["Accept", "Content-Type", "FieldGroupId", "FieldTypeId", "Name"]
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      CategoryId: {
        type: "integer"
        description: "Category ID associated with this specification."
      }
      DefaultValue: {
        type: "string"
        description: "Specification default value."
      }
      Description: {
        type: "string"
      }
      FieldGroupId: {
        type: "integer"
        description: "ID of the group of specifications that contains the new specification."
      }
      FieldTypeId: {
        type: "integer"
        description: "Field Type ID can be `1 - Text`, `2 - Multi-Line Text`, `4 - Number`, `5 - Combo`, `6 - Radio`, `7 - Checkbox`, `8 - Indexed Text`, `9 - Indexed Multi-Line Text`."
      }
      Id: {
        type: "integer"
        description: "Specification ID."
      }
      IsActive: {
        type: "boolean"
        description: "Enable (`true`) or disable (`false`) specification."
      }
      IsFilter: {
        type: "boolean"
        description: "Store Framework - Deprecated.
\nLegacy CMS Portal - To allow the specification to be used as a facet (filter) on the search navigation bar.
\n"
      }
      IsOnProductDetails: {
        type: "boolean"
        description: "Store Framework - Deprecated.
\nLegacy CMS Portal -If specification is visible on the product page.
\n"
      }
      IsRequired: {
        type: "boolean"
        description: "Makes the specification mandatory (`true`) or optional (`false`)."
      }
      IsSideMenuLinkActive: {
        type: "boolean"
        description: "Store Framework - Deprecated.
\nLegacy CMS Portal - To make the specification field clickable in the search navigation bar.
\n"
      }
      IsStockKeepingUnit: {
        type: "boolean"
        description: "If `true`, it will be added as a SKU specification. If `false`, it will be added as a product specification field."
      }
      IsTopMenuLinkActive: {
        type: "boolean"
        description: "Store Framework - Deprecated.
\nLegacy CMS Portal - To make the specification visible in the store's upper menu.
\n"
      }
      IsWizard: {
        type: "boolean"
      }
      Name: {
        type: "string"
        description: "Specification name."
      }
      Position: {
        type: "integer"
        description: "Store Framework - Deprecated.
\nLegacy CMS Portal - This position number is used in ordering the specifications both in the navigation menu and in the specification listing on the product page.
\n"
      }
    }
  }
}