Create Webspace

Provision a paid webspace by charging the user's saved payment mandate.

Required scope: webspace:provision

Headers

Header	Required	Value
`Authorization`	Yes	`Bearer YOUR_API_KEY`
`Content-Type`	Yes	`application/json`

Request Body

Parameter	Required	Description
`diskGb`	Yes	Disk allocation in GB (5-500).
`databases`	Yes	Number of MariaDB databases (10-50).
`cms`	No	`STATIC` (default), `WORDPRESS`, `JOOMLA`, `DRUPAL`, `TYPO3`.
`interval`	No	`1 month` (default) or `12 months`.
`name`	No	Display name.

Response

{
  "data": {
    "orderId": "507f1f77bcf86cd799439011",
    "orderToken": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "diskGb": 10,
    "databases": 10,
    "cms": "WORDPRESS",
    "interval": "1 month",
    "status": "completed",
    "paymentId": "tr_abc123"
  }
}

Response Fields

Field	Type	Description
`orderId / orderToken`	string	Use these with Get Order Status.
`status`	string	`completed`, `payment_pending`, or `payment_failed`.

Error Responses

Status	Code	Description
400	`INVALID_DISK`	`diskGb` is missing or out of range.
400	`INVALID_DATABASES`	`databases` is missing or out of range.
400	`INVALID_CMS`	`cms` is not one of the allowed values.
403	`no_valid_mandate`	No saved payment method on file.
403	`account_suspended`	Account is suspended.

Example

curl -X POST https://hosting.site.quest/api/v1/webspaces/create \
  -H "Authorization: Bearer sq_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "diskGb": 10, "databases": 10, "cms": "WORDPRESS", "interval": "1 month" }'

MCP

This action is also available via the create_webspace MCP tool.