---
title: "Assign or update the attributes for a vendor"
method: PUT
path: "/vendor/attributes"
tags: ["vendors"]
---

# Assign or update the attributes for a vendor

`PUT /vendor/attributes`

## Request

- Base URL: `https://cyber-risk.upguard.com/api/public`
- URL: `https://cyber-risk.upguard.com/api/public/vendor/attributes`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/docs/vendor/attributes/put.ts> (a function with typed inputs; its response is checked against the schema)

Assign or update the attributes for a vendor. To remove an attribute use null as its value in the payload.

The vendor must be monitored. If your account keeps vendors without monitoring them, the vendor can also be one that you keep without monitoring.

Required API key permissions: `VendorRisk` (select when creating API key in Account Settings)

## Request body

- UpdateVendorAttributesV1RequestBody
  - `attributes` object: The attributes to assign to the vendor. If you want to reset an attribute pass null as value. For multi select attributes use a comma separated list of values. If any of the values contains a comma you can escape it with \,
  - `vendor_primary_hostname` string, required: The primary hostname of the vendor to update attribute for.

## Response `204`

Successful response is empty

## Other responses

- `403`: Your API key does not have permission to perform this action.
- `422`: An invalid parameter was supplied or a mandatory parameter was missing
- `429`: Too many requests have been made to this endpoint.
- `500`: An internal system error occurred

---

[API](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api.md) - [All operations](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upguard/apis/upguard-cyberrisk-api/revisions/d044bf6dc61e?raw)