---
title: "Assign tier to a vendor"
method: PUT
path: "/vendor/tier"
tags: ["vendors"]
---

# Assign tier to a vendor

`PUT /vendor/tier`

## Request

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

Assign tier to a vendor. To remove a tier pass a value of zero.

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)

## Query parameters

- `vendor_primary_hostname` string, required
- `tier` integer, required

## 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)