Skip to content

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

accountIdstringrequired
The web hosting account ID (acct_…).

Example

GET /api/v2/shared-hosting/{accountId}/addons/storage
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.

Response 200
{
"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 object
The storage tiers on offer.
idstring
The tier ID. Send it as addonId when you order.
namestring or null
The tier name.
descriptionstring
A short description of the tier.
pricenumber
The price per billing period in currencyCode.
currencyCodestring
The price currency.
billingCyclestring
How often the add-on is billed.
sizeGbnumber
Extra disk space in GB.
availableboolean
Whether this tier can be ordered now.
reasonstring or null
Why not. Null when available is true.
actionsobject
canAddStorageobject
allowedboolean
reasonstring or null
codestring or null
A machine-readable code for why the action is blocked.
accountobject
The account the tiers are for.
idstring
The web hosting account ID.
domainstring or null
The account’s primary domain.
billingobject
billingCyclestring or null
The account’s billing period.

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.