> ## Documentation Index
> Fetch the complete documentation index at: https://pleo-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Vendor API Scopes

> The following table specifies the scopes required to access the Vendors API endpoints:

| Operation | Scopes |
| :- | :- |
| Create a new vendor | vendors:write |
| Fetch a list of vendors | vendors:read |
| Retrieve a vendor | vendors:read |
| Update a vendor | vendors:write |
| Archive a vendor | vendors:write |
| Post a vendor status | vendors:write |

> [!NOTE]
>
> ⚠️ **Note: At the moment, the vendor records are stored at the company level.**
>
> Hence, if any customer has multiple entities (Organisation level), they would need to use the `company_id` to send request to a specific entity of the organisation.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.