Request higher Cloud VPS PAYG limits

POST /api/v2/vps/payg/limits/requests

Submit a pay-as-you-go Cloud VPS limit-increase request.

limitType must be one of the documented resource keys, and reason must be at least 10 characters so support can review the request without extra back-and-forth.

Send the target value as requestedLimit, or use the requestedMax object shorthand keyed by limit type; for mailRelayEmails the requested value must be in 1,000-email increments.

Do not use this for regular fixed-cycle VPS plan upgrades; use GET /api/v2/vps/{id}/actions/upgrade for those.

Cloud VPS Limits

Authentication

Required API scope: write:billing

Authenticate with an API key in the Authorization: Bearer <token> header.

Context

Headers

Authorization Bearer <token>
Accept application/json
Content-Type application/json

Body

required
application/json
limitType string · enum required · Example: cpuCores
cpuCores
memoryGb
storageGb
floatingIpCount
vmCount
snapshotCount
privateNetworkCount
mailRelayEmails
currentLimit integer · min: 0 · Example: 16

Optional current limit for context. Defaults to 0 when omitted.

requestedLimit integer · min: 1 · Example: 32

Requested new limit as a whole number greater than zero. Required unless requestedMax provides the value for limitType. For mailRelayEmails, must be in 1,000-email increments.

requestedMax object

Optional shorthand instead of requestedLimit: an object keyed by limit type whose entry for limitType is the requested new limit.

requestedMax.cpuCores integer
requestedMax.memoryGb integer
requestedMax.storageGb integer
requestedMax.floatingIpCount integer
requestedMax.vmCount integer
requestedMax.snapshotCount integer
requestedMax.privateNetworkCount integer
requestedMax.mailRelayEmails integer
reason string required · Example: Need capacity for production traffic increase

Why the higher limit is needed. At least 10 characters.

useCaseDescription string

Optional extra detail about the workload the higher limit will serve.

Responses

200 Limit request submitted.
id string · nullable required · Example: payglim_01hxa3b4c5d6e7f8g9h0j1k2m3

Public ID of the submitted limit request, or null when no reference is available.

status string · enum required · Example: submitted
submitted
400 Invalid request. The response body is an RFC 7807 Problem Details document.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on detail.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when code is invalid_request.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
401 Unauthorized. Authentication is required.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on detail.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when code is invalid_request.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
403 Forbidden. The caller lacks a required scope or does not own the resource.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on detail.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when code is invalid_request.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
404 Not found. The resource does not exist or is not owned by the caller.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on detail.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when code is invalid_request.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
429 Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on detail.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when code is invalid_request.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
500 Internal error. Retry later or contact support if the issue persists.
type string · Example: https://developer.hostup.se/errors/invalid_request
title string · Example: Validation failed
status integer · Example: 400
detail string · Example: The request body failed validation.
code string · Example: invalid_request

Stable machine-readable code. Branch on this field, not on detail.

instance string · Example: /api/v2/orders
requestId string · Example: req_01hxa3b4c5d6e7f8g9h0j1k2m3
timestamp string · Example: 2026-04-27T12:34:56.000Z
errors array<object>

Field-level validation errors when code is invalid_request.

errors[].pointer string required · Example: /items/0/eppCode
errors[].detail string required · Example: `eppCode` is required for this transfer.
errors[].code string required · Example: missing_required
extensions object
POST https://cloud.hostup.se/api/v2/vps/payg/limits/requests
For AI assistants
View as Markdown
cURL 
curl -X POST "https://cloud.hostup.se/api/v2/vps/payg/limits/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "limitType": "cpuCores",
    "currentLimit": 16,
    "requestedLimit": 32,
    "reason": "Need capacity for production traffic increase"
  }'
Response 
{
  "id": "payglim_01hxa3b4c5d6e7f8g9h0j1k2m3",
  "status": "submitted"
}
Request Body Request more CPU capacity 
{
  "limitType": "cpuCores",
  "currentLimit": 16,
  "requestedLimit": 32,
  "reason": "Need capacity for production traffic increase"
}