Skip to content

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

accountIdstringrequired
The web hosting account ID (acct_…).

Body

daysintegerrequired
How many days to pause, 7 to 90. 7 to 90.

Example

POST /api/v2/shared-hosting/{accountId}/actions/pause
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.

Response 201
{
"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
pauseDetailsobject
The pause.
pauseStartsAtstring or null
When the pause starts: the end of the paid period or now when that has passed.
resumeAtstring or null
When the pause ends.
daysinteger
The length of the pause in days. 7 to 90.
nextInvoiceAtstring or null
The date the next renewal invoice is created, 7 days before resumeAt. A date without a time.
reminderAtstring or null
The same day as nextInvoiceAt, as a timestamp.

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

400Invalid request. The response body is an RFC 7807 Problem Details document.
401Unauthorized. Authentication is required.
403Forbidden. The caller lacks a required scope or does not own the resource.
404Not found. The resource does not exist or is not owned by the caller; code is shared_hosting_not_found.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.