Update RFQ Status | Ply | API Documentation

Transitions an RFQ to a new status. Returns the updated RFQ. Invalid status values return 400 with a list of valid values.

Requires scope: rfqs:write

API_KEYstring

API Key authentication via header

idUUIDRequired

RFQ ID.

This endpoint expects an object.

statusenumRequired

The target status for this RFQ. Returns 400 with a list of valid values if an unrecognized status is provided.

This endpoint returns an object.

idUUID

Unique identifier for the RFQ.

namestring

Display name of the RFQ.

statusenum

Current status of the RFQ.

supplierCountinteger

Number of suppliers added to this RFQ.

materialCountinteger

Number of material line items in this RFQ.

createdAtdatetime

ISO 8601 timestamp when the record was created.

updatedAtdatetime

ISO 8601 timestamp when the record was last updated.

rfqNumberlong

Auto-generated sequential reference number for the RFQ.

typestring

RFQ type classification.

priorityStatusstring

Priority level (e.g. LOW, MEDIUM, HIGH, URGENT).

noteForSupplierstring

Note or instructions visible to suppliers.

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

$	curl -X PATCH https://api.getply.com/api/v1/rfqs/f8a9b0c1-d2e3-4567-fabc-890123456789/status \
>	-H "API_KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"status": "SENT"
>	}'

1	{
2	"id": "f8a9b0c1-d2e3-4567-fabc-890123456789",
3	"name": "Q2 2026 Plumbing Supplies",
4	"status": "SENT",
5	"supplierCount": 2,
6	"materialCount": 5,
7	"createdAt": "2026-03-20T11:00:00Z",
8	"updatedAt": "2026-03-20T15:10:00Z",
9	"rfqNumber": 1015,
10	"type": "STANDARD",
11	"priorityStatus": "MEDIUM",
12	"noteForSupplier": "Please quote best available pricing for Q2."
13	}