List storage add-ons for web hosting
GET /api/v2/shared-hosting/{accountId}/addons/storage
List the extra disk space you can add to a web hosting account, with the size and yearly price of each tier. Order one with POST /api/v2/shared-hosting/{accountId}/addons/storage and the tier’s id as addonId. The account must be active. A contact needs permission to place orders.
Authentication: An API key with the scope read:services. About keys and scopes
Request
Path parameters
accountIdstringrequiredThe web hosting account ID (
acct_…).Example
curl "https://cloud.hostup.se/api/v2/shared-hosting/acct_01hxa3b4c5d6e7f8g9h0j1k2m3/addons/storage" \ -H "Authorization: Bearer $HOSTUP_API_KEY"Responses
200 The storage tiers and whether storage can be added now.
{ "tiers": [ { "id": "7", "name": "Extra 25 GB storage", "description": "Adds 25 GB disk space to the hosting account.", "price": 120, "currencyCode": "SEK", "billingCycle": "annually", "sizeGb": 25, "available": true, "reason": null }, { "id": "21", "name": "Extra 50 GB storage", "description": "Adds 50 GB disk space to the hosting account.", "price": 216, "currencyCode": "SEK", "billingCycle": "annually", "sizeGb": 50, "available": true, "reason": null } ], "actions": { "canAddStorage": { "allowed": true, "reason": null } }, "account": { "id": "acct_01hxa3b4c5d6e7f8g9h0j1k2m3", "domain": "example.com", "billing": { "billingCycle": "annually" } }}Response fields
tiersarray of objectThe storage tiers on offer.
idstringThe tier ID. Send it as
addonId when you order.namestring or nullThe tier name.
descriptionstringA short description of the tier.
pricenumberThe price per billing period in
currencyCode.currencyCodestringThe price currency.
billingCyclestringHow often the add-on is billed.
sizeGbnumberExtra disk space in GB.
availablebooleanWhether this tier can be ordered now.
reasonstring or nullWhy not. Null when
available is true.actionsobjectcanAddStorageobjectallowedbooleanreasonstring or nullcodestring or nullA machine-readable code for why the action is blocked.
accountobjectThe account the tiers are for.
idstringThe web hosting account ID.
domainstring or nullThe account’s primary domain.
billingobjectbillingCyclestring or nullThe account’s billing period.
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. |