# Ply | API Documentation

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.getply.com/_mcp/server

## Docs

- [Welcome](https://docs.getply.com/welcome.md): Build powerful integrations with the Ply Public API
- [Authentication](https://docs.getply.com/authentication.md): Secure your API requests with API keys and scopes

## API Docs

- API Reference > Categories [List Material Categories](https://docs.getply.com/api-reference/api-reference/categories/list-categories.md)
- API Reference > Categories [Get Material Category](https://docs.getply.com/api-reference/api-reference/categories/get-category.md)
- API Reference > Categories [Create Material Category](https://docs.getply.com/api-reference/api-reference/categories/create-category.md)
- API Reference > Categories [Update Material Category](https://docs.getply.com/api-reference/api-reference/categories/update-category.md)
- API Reference > Categories [Delete Material Category](https://docs.getply.com/api-reference/api-reference/categories/delete-category.md)
- API Reference > Equipment [List Equipment](https://docs.getply.com/api-reference/api-reference/equipment/list.md)
- API Reference > Equipment [Get Equipment](https://docs.getply.com/api-reference/api-reference/equipment/get.md)
- API Reference > Equipment [List Equipment Units](https://docs.getply.com/api-reference/api-reference/equipment/list-units.md)
- API Reference > Field Requests [List Field Requests](https://docs.getply.com/api-reference/api-reference/field-requests/list.md)
- API Reference > Field Requests [Get Field Request](https://docs.getply.com/api-reference/api-reference/field-requests/get.md)
- API Reference > Field Requests [Create Field Request](https://docs.getply.com/api-reference/api-reference/field-requests/create.md)
- API Reference > Field Requests [Update Field Request](https://docs.getply.com/api-reference/api-reference/field-requests/update.md)
- API Reference > Field Requests [Change Field Request Status](https://docs.getply.com/api-reference/api-reference/field-requests/change-status.md)
- API Reference > Field Requests [Change Field Request Priority](https://docs.getply.com/api-reference/api-reference/field-requests/change-priority.md)
- API Reference > Field Requests [Delete Field Request](https://docs.getply.com/api-reference/api-reference/field-requests/delete.md)
- API Reference > Field Requests [List Field Request Items](https://docs.getply.com/api-reference/api-reference/field-requests/list-items.md)
- API Reference > Field Requests [Add Field Request Item](https://docs.getply.com/api-reference/api-reference/field-requests/create-item.md)
- API Reference > Field Requests [Update Field Request Item](https://docs.getply.com/api-reference/api-reference/field-requests/update-item.md)
- API Reference > Field Requests [Delete Field Request Item](https://docs.getply.com/api-reference/api-reference/field-requests/delete-item.md)
- API Reference > Inventory Counts [List Inventory Counts](https://docs.getply.com/api-reference/api-reference/inventory-counts/list.md)
- API Reference > Inventory Counts [Get Inventory Count](https://docs.getply.com/api-reference/api-reference/inventory-counts/get.md)
- API Reference > Inventory Counts [Create Inventory Count](https://docs.getply.com/api-reference/api-reference/inventory-counts/create.md)
- API Reference > Inventory Counts [Update Inventory Count](https://docs.getply.com/api-reference/api-reference/inventory-counts/update.md)
- API Reference > Inventory Counts [Delete Inventory Count](https://docs.getply.com/api-reference/api-reference/inventory-counts/delete.md)
- API Reference > Inventory Counts [List Inventory Count Items](https://docs.getply.com/api-reference/api-reference/inventory-counts/list-items.md)
- API Reference > Inventory History [Get Location Inventory Snapshot](https://docs.getply.com/api-reference/api-reference/inventory-history/get-location-snapshot.md)
- API Reference > Inventory History [Get Material Inventory Snapshot](https://docs.getply.com/api-reference/api-reference/inventory-history/get-material-snapshot.md)
- API Reference > Jobs [List Jobs](https://docs.getply.com/api-reference/api-reference/jobs/list.md)
- API Reference > Jobs [Get Job](https://docs.getply.com/api-reference/api-reference/jobs/get.md)
- API Reference > Jobs [Create Job](https://docs.getply.com/api-reference/api-reference/jobs/create.md)
- API Reference > Jobs [Update Job](https://docs.getply.com/api-reference/api-reference/jobs/update.md)
- API Reference > Jobs [Delete Job](https://docs.getply.com/api-reference/api-reference/jobs/delete.md)
- API Reference > Jobs [List Materials at Job](https://docs.getply.com/api-reference/api-reference/jobs/list-materials.md)
- API Reference > Jobs [Open or Close a Job](https://docs.getply.com/api-reference/api-reference/jobs/change-status.md)
- API Reference > Jobs [Transfer Material to Job](https://docs.getply.com/api-reference/api-reference/jobs/transfer-material.md)
- API Reference > Jobs [List Equipment at Job](https://docs.getply.com/api-reference/api-reference/jobs/list-equipment.md)
- API Reference > Kits [List Kits](https://docs.getply.com/api-reference/api-reference/kits/list.md)
- API Reference > Kits [Get Kit](https://docs.getply.com/api-reference/api-reference/kits/get.md)
- API Reference > Kits [Create Kit](https://docs.getply.com/api-reference/api-reference/kits/create.md)
- API Reference > Kits [Update Kit](https://docs.getply.com/api-reference/api-reference/kits/update.md)
- API Reference > Kits [Delete Kit](https://docs.getply.com/api-reference/api-reference/kits/delete.md)
- API Reference > Kits [List Kit Materials](https://docs.getply.com/api-reference/api-reference/kits/get-materials.md)
- API Reference > Kits [Add Material to Kit](https://docs.getply.com/api-reference/api-reference/kits/add-material.md)
- API Reference > Kits [Remove Material from Kit](https://docs.getply.com/api-reference/api-reference/kits/remove-material.md)
- API Reference > Locations [List Locations](https://docs.getply.com/api-reference/api-reference/locations/list.md)
- API Reference > Locations [Get Location](https://docs.getply.com/api-reference/api-reference/locations/get.md)
- API Reference > Locations [List Materials at Location](https://docs.getply.com/api-reference/api-reference/locations/list-materials.md)
- API Reference > Materials [List Materials](https://docs.getply.com/api-reference/api-reference/materials/list.md)
- API Reference > Materials [Get Material](https://docs.getply.com/api-reference/api-reference/materials/get.md)
- API Reference > Materials [Create Material](https://docs.getply.com/api-reference/api-reference/materials/create.md)
- API Reference > Materials [Update Material](https://docs.getply.com/api-reference/api-reference/materials/update.md)
- API Reference > Materials [Delete Material](https://docs.getply.com/api-reference/api-reference/materials/delete.md)
- API Reference > Materials [List Material Variations](https://docs.getply.com/api-reference/api-reference/materials/list-variations.md)
- API Reference > Materials [Update Material Variations](https://docs.getply.com/api-reference/api-reference/materials/update-variations.md)
- API Reference > Materials [List Material Availability](https://docs.getply.com/api-reference/api-reference/materials/list-availability.md)
- API Reference > Materials [Get Material Availability](https://docs.getply.com/api-reference/api-reference/materials/get-availability.md)
- API Reference > Pick Lists [List Pick Lists](https://docs.getply.com/api-reference/api-reference/pick-lists/list.md)
- API Reference > Pick Lists [Get Pick List](https://docs.getply.com/api-reference/api-reference/pick-lists/get.md)
- API Reference > Pick Lists [Create Pick List](https://docs.getply.com/api-reference/api-reference/pick-lists/create.md)
- API Reference > Pick Lists [Update Pick List](https://docs.getply.com/api-reference/api-reference/pick-lists/update.md)
- API Reference > Pick Lists [Delete Pick List](https://docs.getply.com/api-reference/api-reference/pick-lists/delete.md)
- API Reference > Pick Lists [List Pick List Materials](https://docs.getply.com/api-reference/api-reference/pick-lists/get-materials.md)
- API Reference > Pick Lists [Add Material to Pick List](https://docs.getply.com/api-reference/api-reference/pick-lists/add-material.md)
- API Reference > Pick Lists [Remove Material from Pick List](https://docs.getply.com/api-reference/api-reference/pick-lists/remove-material.md)
- API Reference > Purchase Orders [List Purchase Orders](https://docs.getply.com/api-reference/api-reference/purchase-orders/list.md)
- API Reference > Purchase Orders [Get Purchase Order](https://docs.getply.com/api-reference/api-reference/purchase-orders/get.md)
- API Reference > Purchase Orders [Create Purchase Order](https://docs.getply.com/api-reference/api-reference/purchase-orders/create.md)
- API Reference > Purchase Orders [Update Purchase Order](https://docs.getply.com/api-reference/api-reference/purchase-orders/update.md)
- API Reference > Purchase Orders [Change Purchase Order Status](https://docs.getply.com/api-reference/api-reference/purchase-orders/change-status.md)
- API Reference > Purchase Orders [Delete Purchase Order](https://docs.getply.com/api-reference/api-reference/purchase-orders/delete.md)
- API Reference > Purchase Orders [List Purchase Order Items](https://docs.getply.com/api-reference/api-reference/purchase-orders/list-items.md)
- API Reference > Purchase Orders [Add Item to Purchase Order](https://docs.getply.com/api-reference/api-reference/purchase-orders/add-item.md)
- API Reference > Purchase Orders [Update Purchase Order Item](https://docs.getply.com/api-reference/api-reference/purchase-orders/update-item.md)
- API Reference > Purchase Orders [Remove Item from Purchase Order](https://docs.getply.com/api-reference/api-reference/purchase-orders/remove-item.md)
- API Reference > Purchase Orders [Receive Purchase Order Lines](https://docs.getply.com/api-reference/api-reference/purchase-orders/reconcile.md)
- API Reference > Purchase Orders [List Received Lines](https://docs.getply.com/api-reference/api-reference/purchase-orders/list-reconcile-items.md)
- API Reference > Reports [Low Stock Report](https://docs.getply.com/api-reference/api-reference/reports/low-stock.md)
- API Reference > Reports [Dead Shelf Analysis](https://docs.getply.com/api-reference/api-reference/reports/dead-shelf.md)
- API Reference > Reports [Inventory Usage Report](https://docs.getply.com/api-reference/api-reference/reports/inventory-usage.md)
- API Reference > Reports [Variance Report](https://docs.getply.com/api-reference/api-reference/reports/variance.md)
- API Reference > Returns [List Returns](https://docs.getply.com/api-reference/api-reference/returns/list.md)
- API Reference > Returns [Get Return](https://docs.getply.com/api-reference/api-reference/returns/get.md)
- API Reference > Returns [Create Return](https://docs.getply.com/api-reference/api-reference/returns/create.md)
- API Reference > Returns [Update Return](https://docs.getply.com/api-reference/api-reference/returns/update.md)
- API Reference > Returns [Change Return Status](https://docs.getply.com/api-reference/api-reference/returns/change-status.md)
- API Reference > Returns [Delete Return](https://docs.getply.com/api-reference/api-reference/returns/delete.md)
- API Reference > Returns [List Return Items](https://docs.getply.com/api-reference/api-reference/returns/list-items.md)
- API Reference > Returns [Add Item to Return](https://docs.getply.com/api-reference/api-reference/returns/create-item.md)
- API Reference > Returns [Update Return Item](https://docs.getply.com/api-reference/api-reference/returns/update-item.md)
- API Reference > Returns [Remove Item from Return](https://docs.getply.com/api-reference/api-reference/returns/delete-item.md)
- API Reference > Rfqs [List RFQs](https://docs.getply.com/api-reference/api-reference/rfqs/list.md)
- API Reference > Rfqs [Get RFQ](https://docs.getply.com/api-reference/api-reference/rfqs/get.md)
- API Reference > Rfqs [Create RFQ](https://docs.getply.com/api-reference/api-reference/rfqs/create.md)
- API Reference > Rfqs [Update RFQ](https://docs.getply.com/api-reference/api-reference/rfqs/update.md)
- API Reference > Rfqs [Update RFQ Status](https://docs.getply.com/api-reference/api-reference/rfqs/update-status.md)
- API Reference > Rfqs [List RFQ Suppliers](https://docs.getply.com/api-reference/api-reference/rfqs/get-suppliers.md)
- API Reference > Rfqs [Add Suppliers to RFQ](https://docs.getply.com/api-reference/api-reference/rfqs/add-suppliers.md)
- API Reference > Rfqs [Remove Supplier from RFQ](https://docs.getply.com/api-reference/api-reference/rfqs/remove-supplier.md)
- API Reference > Suppliers [List Suppliers](https://docs.getply.com/api-reference/api-reference/suppliers/list.md)
- API Reference > Suppliers [Get Supplier](https://docs.getply.com/api-reference/api-reference/suppliers/get.md)
- API Reference > Suppliers [Create Supplier](https://docs.getply.com/api-reference/api-reference/suppliers/create.md)
- API Reference > Suppliers [Update Supplier](https://docs.getply.com/api-reference/api-reference/suppliers/update.md)
- API Reference > Suppliers [Delete Supplier](https://docs.getply.com/api-reference/api-reference/suppliers/delete.md)
- API Reference > Suppliers [List Supplier Categories](https://docs.getply.com/api-reference/api-reference/suppliers/list-supplier-categories.md)
- API Reference > Suppliers [Get Supplier Category](https://docs.getply.com/api-reference/api-reference/suppliers/get-supplier-category.md)
- API Reference > Suppliers [Create Supplier Category](https://docs.getply.com/api-reference/api-reference/suppliers/create-supplier-category.md)
- API Reference > Suppliers [Update Supplier Category](https://docs.getply.com/api-reference/api-reference/suppliers/update-supplier-category.md)
- API Reference > Suppliers [Delete Supplier Category](https://docs.getply.com/api-reference/api-reference/suppliers/delete-supplier-category.md)
- API Reference > Tags [List Material Tags](https://docs.getply.com/api-reference/api-reference/tags/list-tags.md)
- API Reference > Tags [Get Material Tag](https://docs.getply.com/api-reference/api-reference/tags/get-tag.md)
- API Reference > Tags [Create Material Tag](https://docs.getply.com/api-reference/api-reference/tags/create-tag.md)
- API Reference > Tags [Update Material Tag](https://docs.getply.com/api-reference/api-reference/tags/update-tag.md)
- API Reference > Tags [Delete Material Tag](https://docs.getply.com/api-reference/api-reference/tags/delete-tag.md)
- API Reference > Users [List Users](https://docs.getply.com/api-reference/api-reference/users/list.md)
- API Reference > Users [Get User](https://docs.getply.com/api-reference/api-reference/users/get.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.getply.com/openapi.json)
- [OpenAPI YAML](https://docs.getply.com/openapi.yaml)