---
title: "PATCH /ver2/MaterialService.svc/materials/{materialIdOrName}"
method: PATCH
path: "/ver2/MaterialService.svc/materials/{materialIdOrName}"
tags: ["Material"]
---

# PATCH /ver2/MaterialService.svc/materials/{materialIdOrName}

`PATCH /ver2/MaterialService.svc/materials/{materialIdOrName}`

## Request

- Base URL: `https://api.enviance.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.enviance.com/ver2/MaterialService.svc/materials/{materialIdOrName}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/enviance/apis/restapi/docs/ver2/MaterialService.svc/materials/:materialIdOrName/patch.ts> (a function with typed inputs; its response is checked against the schema)

envianceSdk.materials.updateMaterial
```
[
  "Material Name",
  {
    "name": "Material Name",
    "description": "Material Description",
    "templateIdOrName": "Template Name",
    "materialAvailabilityFlag": "true",
    "fields": [
      {
        "name": "Aspect",
        "values": [
          "Air pollution control waste"
        ]
      },
      {
        "name": "Start Date",
        "values": [
          "2012-09-19T20:00:00"
        ]
      },
      {
        "name": "Type",
        "values": [
          "Spill",
          "Near Miss"
        ]
      }
    ],
    "chemicals": [
      {
        "chemicalIdOrAlias": "Chemical Alias",
        "chemicalConcentrationHistory": [
          {
            "beginDate": "2012-01-19T20:00:00",
            "present": "true",
            "minConc": "0",
            "avgConc": "1",
            "maxConc": "2"
          },
          {
            "beginDate": "2013-01-19T20:00:00",
            "present": "true",
            "minConc": "2",
            "avgConc": "3",
            "maxConc": "6"
          }
        ]
      }
    ],
    "properties": [
      {
        "propertyIdOrName": "property name",
        "valueHistory": [
          {
            "beginDate": "2012-01-19T20:00:00",
            "value": "1"
          },
          {
            "beginDate": "2012-02-20T20:00:00",
            "value": "2"
          }
        ]
      }
    ]
  },
  "onsuccess",
  "onerror"
]
```
envianceSdk.materialGroups.updateMaterialGroup
```
[
  "Material Group Name",
  {
    "name": "Material Group Name",
    "description": "Material Group Description",
    "materialIdOrNames": [
      "Material Name 1",
      "Material Name 2"
    ]
  },
  "onsuccess",
  "onerror"
]
```
envianceSdk.materialTemplates.updateMaterialTemplate
```
[
  "Material Template Name",
  {
    "name": "Material Template Name",
    "description": "Material Template Description",
    "fields": [
      "field name 1",
      "field name 2"
    ]
  },
  "onsuccess",
  "onerror"
]
```
envianceSdk.materialProperties.updateMaterialProperty
```
[
  "Material Property Name",
  {
    "name": "PFBP Property Name",
    "description": "VBP Description",
    "dataType": "Numeric",
    "formulaHistory": [
      {
        "beginDate": "2012-01-01T20:00:00",
        "Script": "1 \u002B SUM([Chem_MW])"
      },
      {
        "beginDate": "2013-01-01T20:00:00",
        "Script": "1 \u002B [Prop_PFBP1]"
      }
    ]
  },
  "onsuccess",
  "onerror"
]
```

## Path parameters

- `materialIdOrName` string, required

## Headers

- `EnvApi-Systemid` string
- `EnvApi-Packageid` string
- `EnvApi-Udf-DateTime-Iso-In-CustomFields` string
- `EnvApi-Udf-DateTime-ReadInUserTz` string
- `EnvApi-Udf-Value-Invariant` string
- `EnvApi-Localization-All` string
- `x-client-request-id` string

## Request body

- UpdateMaterial
  - `materialInfo` EnvianceRestServicesVer2MaterialActivityMaterialsMaterialInfo
    - `id` string, guid
    - `name` string
    - `description` string
    - `templateIdOrName` string
    - `materialAvailabilityFlag` boolean
    - `chemicals` EnvianceRestServicesVer2MaterialActivityMaterialsMaterialChemicalMapInfo[]
      - `chemicalIdOrAlias` string
      - `chemicalConcentrationHistory` EnvianceRestServicesVer2MaterialActivityMaterialsChemicalConcentrationHistoryInfo[]
        - `id` string, guid
        - `beginDate` string, date-time
        - `present` boolean
        - `minConc` number, double
        - `avgConc` number, double
        - `maxConc` number, double
        - `created` string, date-time
    - `fields` EnvianceRestServicesUdfsProperty[]
      - `name` string
      - `urlItems` EnvianceBusinessUdfRestUrlItem[]
        - `label` string
        - `url` string
      - `values` string[]
      - `beginDate` string, date-time
      - `endDate` string, date-time
      - `caption` string
      - `captionLocalized` string
    - `properties` EnvianceRestServicesVer2MaterialActivityMaterialsMaterialPropertyMapInfo[]
      - `propertyIdOrName` string
      - `valueHistory` EnvianceRestServicesVer2MaterialActivityMaterialsMaterialValueHistoryInfo[]
        - `id` string, guid
        - `beginDate` string, date-time
        - `value` number, double

## Response `default`

not available

- string, guid

---

[API](https://skmtc.dev/enviance/apis/restapi.md) - [All operations](https://skmtc.dev/enviance/apis/restapi/llms.txt) - [OpenAPI document](https://skmtc.dev/enviance/apis/restapi/revisions/45b2200a8cf2?raw)