DeluxHostAPI Reference
Orders & renewals

Preview a plan change discount

POST
/v1/orders/{id}/plan-change/coupon

Authorization

apiToken orders:read
headerAuthorizationBearer <token>

A personal API token: Authorization: Bearer dh_live_…. See Authentication for scopes.

Scope: orders:read

Path Parameters

id*number

Request Body

application/json
  1. body
productId*number
code*string

Response Body

Operation completed or accepted; asynchronous actions may still be running.

application/json
  1. response
code*string
description*null|string
diffCents*number
discountCents*number
totalCents*number
curl -X POST 'https://api.deluxhost.net/v1/orders/0/plan-change/coupon' \  -H "Authorization: Bearer $DELUXHOST_TOKEN" \  -H 'Content-Type: application/json' \  -d '{  "productId": 0,  "code": "string"}'
Example Response
{  "code": "string",  "description": null,  "diffCents": 0,  "discountCents": 0,  "totalCents": 0}

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.

Cancel a pending plan change 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.