Docs

Update Resource

PUT /resources/{resourceId}

PUT/resources/{resourceId}

Required Tokens

FieldTypeRequiredDescription
BearerAuthorization: Bearer <api-key>OptionalYour API key. Pass it as the Bearer token on every request.
Organization tokenx-Organization-TokenOptionalRun **Authorize Organization** in the Authorization folder.

Updates a resource's fields and attribute values. Omitted settlement keeps the stored value.

Requires ResourceInventory.Edit permission.

Path Parameters

FieldTypeRequiredDescription
resourceIdGuidRequiredThe org resource.

Request Body

FieldTypeRequiredDescription
namestringRequiredName.
labelstringOptionalLabel.
identifierstringOptionalSerial or asset tag.
quantityint?OptionalStock.
settlementstringOptional`OwnedCost` or `Invoiceable`.
attributeValuesarrayOptional`{ resourceAttributeId, value }`. Blanking a required Inventory-active attribute is refused. A value already blank before the request never blocks, so legacy records keep saving. A `Variant` or `Unit` blank is judged on the whole resulting set.

Response

200 OK. No response body.

Error Codes

HTTP StatusDescription
400Invalid arguments, or the request blanks a required Inventory attribute ("A value is required for {names}.").
404Resource not found.