使用此端點前，請先完成入門指南以取得您的 API 金鑰和公司 ID。
前置條件
- ✅ 已核准工作區成員的有效 Bearer 權杖
- ✅ 從
GET {{URL}}/accounts/companies取得的公司 ID - ✅ 您要更新的訂單的訂單 ID（專案 ID，
pid）
端點
multipart/form-data — 即使不附加檔案，也請使用此格式以滿足伺服器的 multipart 解析器要求。
標頭
查詢參數
string
必填
要更新的訂單 / 專案 ID。以查詢字串參數形式傳遞。
請求主體欄位
string
更新訂單標題。最少 2 個字元。
string
訂單的新狀態。必須為以下之一：
Pending、Ongoing、Review、Completed、Cancelled。允許的狀態轉換：Review只能在Ongoing或另一個Review之後。從Pending直接跳至Review將回傳400 ValidationError。- 已為
Completed或Cancelled的訂單無法更新。 - 客戶無法取消已超過
Pending狀態的訂單。
number
總預算數字。必須
≥ 0。除非同時提供 currency，否則使用訂單現有的貨幣。string
預算的貨幣代碼。範例：
USD、CAD、EUR。number
套件購買的單位數量。必須
≥ 1。string
訂單到期日的 ISO 8601 日期字串。範例：
"2025-12-31T00:00:00.000Z"。string
專案開始日期的 ISO 8601 日期字串。
string
供您團隊查看的內部備註。
string
客戶簡報或專案摘要。
array
指派至此訂單的專案經理成員 ID 完整清單。新增的 ID 將加入團隊；移除的 ID 將被刪除。每個 ID 必須屬於同一公司內具有
projectManager 角色的成員。boolean
當
status 為 Completed 或 Cancelled 時必填。為 true 時，狀態變更後訂單中的所有任務均標記為完成。為 false 時，任務保持其目前狀態。boolean
僅在
status 為 Completed 或 Cancelled 時允許。為 true 時，狀態更新後所有未完成的客戶請求任務將被拒絕。number
僅在變更重複頻率時，訂閱訂單需要填寫。與
repeatDuration 搭配使用。string
訂閱訂單時與
repeatCount 一起使用。以下之一：day、week、month、year。number
定期計費週期的選填上限。預設為
0（無限制）。string
每個計費週期的處理方式。以下之一：
createOrderWithTask、noChange。file
零個或多個檔案附件。檔案附加至訂單的系統資料夾；現有檔案不會被覆寫。使用
multipart/form-data 編碼，並在 files 欄位下附加每個檔案。範例請求
回應
成功回應
業務規則與副作用
- 狀態轉換受到限制。
Review只能在Ongoing或另一個Review之後。嘗試Pending → Review將回傳400 ValidationError。 - 將狀態從
Pending移至Ongoing、Review或Completed會啟動訂單的檔案資料夾，使上傳的檔案對專案團隊可存取。 - 將
status設定為Completed或Cancelled必須明確地將markTasksAsDone設定為true或false。 - 狀態變更為
Review、Completed或Cancelled會自動觸發客戶通知：- Review — 通知客戶需要進行審查。
- Completed — 向客戶傳送
orderCompletion通知。 - Cancelled — 向客戶傳送
orderCancellation通知。
- 每次成功的更新都會觸發一個帶有更新後訂單文件和附件元資料的
ORDER.UPDATEDwebhook 事件（如果您有已訂閱該事件的活躍 webhook）。