Mark a proposal as complete
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
The unique retailer ID. In the Dropship UI this is called the Merchant ID. To find your Merchant ID, click your merchant name in the top nav.
1001
The unique identifier of the proposal. This ID is automatically generated when a proposal is created.
Body
The title or label of the product proposal.
1 - 128
"Eco-Friendly Tumbler Set"
Current state of the proposal in the lifecycle.
draft
, proposed
, revised
, completed
, approved
, declined
, archived
, pricing_approved
, reopened
, withdrawn
"draft"
Indicates where the proposal originated from.
console
, merchandising
"console"
The category of the proposal.
new_product
, cost_update
, image_update
, attribute_update
, legacy
"new_product"
Detailed explanation of the return reason.
"Incorrect pricing on listed item."
Indicates whether the proposal should be pushed to Shopify.
true
The date and time when the proposal ends.
"2025-06-30T23:59:59Z"
Number of items that were skipped during processing.
-2147483648 <= x <= 2147483647
3
Indicates if any items have price changes.
false
Scheduled date for the proposal to go live.
"2025-07-01T00:00:00Z"
Date and time when the proposal becomes active.
"2025-05-01T00:00:00Z"
Date and time when the proposal expires.
"2025-07-31T23:59:59Z"
When the draft was submitted as a proposal.
"2025-04-20T12:00:00Z"
When the proposal was acknowledged.
"2025-04-22T09:00:00Z"
When the proposal was formally proposed.
"2025-04-23T10:00:00Z"
When the proposal was archived.
"2025-08-01T10:00:00Z"
When the proposal was revised.
"2025-04-25T15:00:00Z"
When the proposal received approval.
"2025-05-01T10:00:00Z"
When the proposal was declined.
"2025-05-02T12:00:00Z"
When pricing for the proposal was approved.
"2025-05-03T14:00:00Z"
When the proposal was marked as completed.
"2025-05-05T16:00:00Z"
When the proposal was withdrawn.
"2025-05-06T09:30:00Z"
Reason for withdrawal of the proposal.
300
"Vendor no longer supports product line."
Response
Name of the proposal.
1 - 128
"Winter 2025 Collection Update"
Unique identifier for the proposal. This ID is automatically generated when a proposal is created.
101
Current status of the proposal.
draft
, proposed
, revised
, completed
, approved
, declined
, archived
, pricing_approved
, reopened
, withdrawn
"proposed"
The origin of the proposal.
console
, merchandising
"console"
Type of proposal indicating its purpose.
new_product
, cost_update
, image_update
, attribute_update
, legacy
"new_product"
Recipient of the proposal.
"retailer_456"
Sender who created the proposal.
"supplier_123"
Internal notes or memos associated with the proposal.
"Initial draft submitted by merchandising team."
User or system that created the proposal.
"user_789"
Integration or channel connection identifier.
"integration_abc"
Retailer associated with the proposal.
"Fashion Retail Co."
Brand associated with the products in the proposal.
"FrostWear"
Department to which the proposal belongs.
"Apparel"
Reason the proposal was returned for revisions.
"Insufficient pricing justification"
Additional details explaining the return reason.
"Missing supplier cost comparison documentation."
Products included in the proposal.
"[{ product_id: 202, name: 'Arctic Parka' }]"
Indicates whether the proposal should be pushed to Shopify.
true
Shopify-specific template used.
"default_fashion_template"
Template used for exporting to external platforms.
"standard_export_v1"
Attached files or resources for the proposal.
"[{ filename: 'lookbook.pdf' }]"
Optional end date for the proposal's active status.
"2025-09-30T23:59:59Z"
Summary of identified issues within the proposal.
"Missing product images for 3 items"
Indicates whether the proposal has been acknowledged.
false
Number of approved items in the proposal.
5
Number of deleted items in the proposal.
0
Number of rejected items in the proposal.
1
Number of items skipped during processing.
-2147483648 <= x <= 2147483647
2
Total number of items in the proposal.
"10"
Number of items that have been classified.
"8"
Number of items ready for final review or processing.
"6"
Number of items that failed validation or processing.
"1"
Description of action required from the user.
"Upload missing product photos"
Indicates whether there is a pending action.
"yes"
Flag indicating whether the proposal includes revisions.
"true"
Indicates if the proposal still has unresolved issues.
true
Indicates if there are pricing updates in the proposal.
true
Users collaborating on the proposal.
"user_789, user_321"
Intended go-live date for the proposed changes.
"2025-10-01T00:00:00Z"
Start date of the proposal.
"2025-04-01T00:00:00Z"
Expiration date of the proposal.
"2025-06-01T00:00:00Z"
Timestamp when the proposal was last updated.
"2025-04-22T15:30:00Z"
Timestamp when the proposal was created.
"2025-04-20T08:45:00Z"
Timestamp when the draft was proposed.
"2025-04-10T12:00:00Z"
Timestamp when the proposal was acknowledged.
"2025-04-15T09:30:00Z"
Timestamp when the proposal was officially proposed.
"2025-04-20T10:00:00Z"
Timestamp when the proposal was archived.
"2025-04-22T17:00:00Z"
Timestamp when the proposal was last revised.
"2025-04-21T14:15:00Z"
Timestamp when the proposal was approved.
"2025-04-25T11:00:00Z"
Timestamp when the proposal was declined.
"2025-04-26T10:30:00Z"
Timestamp when pricing was approved.
"2025-04-24T13:45:00Z"
Timestamp when the proposal was completed.
"2025-04-28T16:00:00Z"
Timestamp when the proposal was withdrawn.
"2025-04-27T08:00:00Z"
Reason why the proposal was withdrawn.
300
"The product line was discontinued by the supplier."
Metadata tags for classification or filtering.
"seasonal,featured,high-priority"