Change the service plan
POST
Requires confirm: true. Inspect the resource before retrying an uncertain outcome. Requires Idempotency-Key. Use the same key and payload to replay a completed response. A 409 for a pending or failed attempt requires checking the resource; a new key could duplicate a charge or purchase.
apiToken orders:manageheader
AuthorizationBearer <token>A personal API token: Authorization: Bearer dh_live_…. See Authentication for scopes.
Scope: orders:manage
id*numberIdempotency-Key*stringUnique per account and operation. Reuse only for an identical request. Completed requests replay the encrypted stored response; pending or failed attempts return 409 and are never automatically rerun.
Length
1 <= length <= 128application/json- body
productId*numbercouponCode?stringconfirm*booleanOperation completed or accepted; asynchronous actions may still be running.
application/json- response
applied*booleaninvoiceId*null|numberdiffCents*numberdiscountCents*numbertotalCents*numbercurl -X POST 'https://api.deluxhost.net/v1/orders/0/plan-change' \ -H "Authorization: Bearer $DELUXHOST_TOKEN" \ -H 'Idempotency-Key: string' \ -H 'Content-Type: application/json' \ -d '{ "productId": 0, "confirm": true}'Example Response
{ "applied": true, "invoiceId": null, "diffCents": 0, "discountCents": 0, "totalCents": 0}