Pause web hosting
POST /api/v2/shared-hosting/{accountId}/actions/pause
Pause a web hosting account for 7 to 90 days. Check GET /api/v2/shared-hosting/{accountId}/actions/pause first. An account can be paused once every 12 months. The pause starts when the paid period ends. When that date has passed, it starts now and the account is suspended right away. Automatic renewal is turned off. The account’s expiry date moves to resumeAt. The next renewal invoice is created 7 days before resumeAt (nextInvoiceAt). An unpaid renewal invoice for the account is cancelled. A running or scheduled pause returns 400 invalid_request. So does a used yearly pause. A scheduled plan change on the account returns 409 scheduled_change_in_progress. End a pause early with DELETE /api/v2/shared-hosting/{accountId}/actions/pause. The account must be active. Contacts cannot manage pauses.
Authentication: An API key with the scopes write:billing and write:services. About keys and scopes
Request
Path parameters
accountIdstringrequiredacct_…).Body
daysintegerrequiredExample
curl -X POST "https://cloud.hostup.se/api/v2/shared-hosting/acct_01hxa3b4c5d6e7f8g9h0j1k2m3/actions/pause" \ -H "Authorization: Bearer $HOSTUP_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "days": 30 }'Responses
201 The pause was created. It is running already when the paid period had ended.
{ "pauseDetails": { "pauseStartsAt": "2026-12-01T00:00:00.000Z", "resumeAt": "2026-12-31T00:00:00.000Z", "days": 30 }, "nextInvoiceAt": "2026-12-24", "reminderAt": "2026-12-24T00:00:00.000Z"}Response fields
pauseDetailsobjectpauseStartsAtstring or nullresumeAtstring or nulldaysintegernextInvoiceAtstring or nullresumeAt. A date without a time.reminderAtstring or nullnextInvoiceAt, as a timestamp.Errors
Errors are Problem Details with a stable code. Branch on the code, not on the text.
| 400 | Invalid request. The response body is an RFC 7807 Problem Details document. |
| 401 | Unauthorized. Authentication is required. |
| 403 | Forbidden. The caller lacks a required scope or does not own the resource. |
| 404 | Not found. The resource does not exist or is not owned by the caller; code is shared_hosting_not_found. |
| 429 | Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers. |
| 500 | Internal error. Retry later or contact support if the issue persists. |