With a Scaleway Web Hosting plan, you can manage your domain, configure your web hosting services, manage your emails and more. Create, list, update and delete your Web Hosting plans with these calls
List all Web Hosting plans
List all of your existing Web Hosting plans. Various filters are available to limit the results, including filtering by domain, status, tag and Project ID.
path Parameters
regionThe region you want to target
query Parameters
pagePage number to return, from the paginated results (must be a positive integer).
page_sizeNumber of Web Hosting plans to return (must be a positive integer lower or equal to 100).
order_bySort order for Web Hosting plans in the response.
tagsTags to filter for, only Web Hosting plans with matching tags will be returned.
statusesStatuses to filter for, only Web Hosting plans with matching statuses will be returned.
domainDomain to filter for, only Web Hosting plans associated with this domain will be returned.
project_idProject ID to filter for, only Web Hosting plans from this Project will be returned.
organization_idOrganization ID to filter for, only Web Hosting plans from this Organization will be returned.
control_panelsName of the control panel to filter for, only Web Hosting plans from this control panel will be returned.
subdomainOptional free subdomain linked to the Web Hosting plan.
List all Web Hosting plans › Responses
total_countNumber of Web Hosting plans returned.
List of Web Hosting plans.
Order a Web Hosting plan
Order a Web Hosting plan, specifying the offer type required via the offer_id parameter.
path Parameters
regionThe region you want to target
Order a Web Hosting plan › Request Body
offer_idID of the selected offer for the Web Hosting plan.
project_idID of the Scaleway Project in which to create the Web Hosting plan.
emailContact email for the Web Hosting client.
tagsList of tags for the Web Hosting plan.
domainDomain name to link to the Web Hosting plan. You must already own this domain name, and have completed the DNS validation process beforehand.
subdomainThe name prefix to use as a free subdomain (for example, mysite) assigned to the Web Hosting plan. The full domain will be automatically created by adding it to the fixed base domain (e.g. mysite.scw.site). You do not need to include the base domain yourself.
List of the Web Hosting plan options IDs with their quantities.
languageDefault language for the control panel interface.
skip_welcome_emailIndicates whether to skip a welcome email to the contact email containing hosting info.
Indicates whether to update hosting domain name servers and DNS records for domains managed by Scaleway Elements (deprecated, use auto_update_* fields instead).
offer_commitment_idOffer commitment ID to which the hosting will be engaged.
Indicates whether to update hosting domain name servers and DNS records for domains managed by Scaleway Elements (deprecated, use auto_config_domain_dns instead).
Order a Web Hosting plan › Responses
idID of the Web Hosting plan.
project_idID of the Scaleway Project the Web Hosting plan belongs to.
updated_atDate on which the Web Hosting plan was last updated. (RFC 3339 format)
created_atDate on which the Web Hosting plan was created. (RFC 3339 format)
statusStatus of the Web Hosting plan.
Details of the Web Hosting plan offer and options.
Details of the hosting platform.
tagsList of tags associated with the Web Hosting plan.
ipv4Current IPv4 address of the hosting. (IPv4 address)
protectedWhether the hosting is protected or not.
Details of the hosting user.
regionRegion where the Web Hosting plan is hosted.
Domain configuration block (subdomain, optional custom domain, and DNS settings).
Commitment details to which the hosting is engaged.
domainMain domain associated with the Web Hosting plan (deprecated, use domain_info).
dns_statusDNS status of the Web Hosting plan (deprecated, use domain_info).
domain_statusMain domain status of the Web Hosting plan (deprecated, use domain_info).
Get a Web Hosting plan
Get the details of one of your existing Web Hosting plans, specified by its hosting_id.
path Parameters
regionThe region you want to target
hosting_idHosting ID.
Get a Web Hosting plan › Responses
idID of the Web Hosting plan.
project_idID of the Scaleway Project the Web Hosting plan belongs to.
updated_atDate on which the Web Hosting plan was last updated. (RFC 3339 format)
created_atDate on which the Web Hosting plan was created. (RFC 3339 format)
statusStatus of the Web Hosting plan.
Details of the Web Hosting plan offer and options.
Details of the hosting platform.
tagsList of tags associated with the Web Hosting plan.
ipv4Current IPv4 address of the hosting. (IPv4 address)
protectedWhether the hosting is protected or not.
Details of the hosting user.
regionRegion where the Web Hosting plan is hosted.
Domain configuration block (subdomain, optional custom domain, and DNS settings).
Commitment details to which the hosting is engaged.
domainMain domain associated with the Web Hosting plan (deprecated, use domain_info).
dns_statusDNS status of the Web Hosting plan (deprecated, use domain_info).
domain_statusMain domain status of the Web Hosting plan (deprecated, use domain_info).
Delete a Web Hosting plan
Delete a Web Hosting plan, specified by its hosting_id. Note that deletion is not immediate: it will take place at the end of the calendar month, after which time your Web Hosting plan and all its data (files and emails) will be irreversibly lost.
path Parameters
regionThe region you want to target
hosting_idHosting ID.
Delete a Web Hosting plan › Responses
idID of the Web Hosting plan.
project_idID of the Scaleway Project the Web Hosting plan belongs to.
updated_atDate on which the Web Hosting plan was last updated. (RFC 3339 format)
created_atDate on which the Web Hosting plan was created. (RFC 3339 format)
statusStatus of the Web Hosting plan.
Details of the Web Hosting plan offer and options.
Details of the hosting platform.
tagsList of tags associated with the Web Hosting plan.
ipv4Current IPv4 address of the hosting. (IPv4 address)
protectedWhether the hosting is protected or not.
Details of the hosting user.
regionRegion where the Web Hosting plan is hosted.
Domain configuration block (subdomain, optional custom domain, and DNS settings).
Commitment details to which the hosting is engaged.
domainMain domain associated with the Web Hosting plan (deprecated, use domain_info).
dns_statusDNS status of the Web Hosting plan (deprecated, use domain_info).
domain_statusMain domain status of the Web Hosting plan (deprecated, use domain_info).
Update a Web Hosting plan
Update the details of one of your existing Web Hosting plans, specified by its hosting_id. You can update parameters including the contact email address, tags, options and offer.
path Parameters
regionThe region you want to target
hosting_idHosting ID.
Update a Web Hosting plan › Request Body
emailNew contact email for the Web Hosting plan.
tagsNew tags for the Web Hosting plan.
List of the Web Hosting plan options IDs with their quantities.
offer_idID of the new offer for the Web Hosting plan.
protectedWhether the hosting is protected or not.
Update a Web Hosting plan › Responses
idID of the Web Hosting plan.
project_idID of the Scaleway Project the Web Hosting plan belongs to.
updated_atDate on which the Web Hosting plan was last updated. (RFC 3339 format)
created_atDate on which the Web Hosting plan was created. (RFC 3339 format)
statusStatus of the Web Hosting plan.
Details of the Web Hosting plan offer and options.
Details of the hosting platform.
tagsList of tags associated with the Web Hosting plan.
ipv4Current IPv4 address of the hosting. (IPv4 address)
protectedWhether the hosting is protected or not.
Details of the hosting user.
regionRegion where the Web Hosting plan is hosted.
Domain configuration block (subdomain, optional custom domain, and DNS settings).
Commitment details to which the hosting is engaged.
domainMain domain associated with the Web Hosting plan (deprecated, use domain_info).
dns_statusDNS status of the Web Hosting plan (deprecated, use domain_info).
domain_statusMain domain status of the Web Hosting plan (deprecated, use domain_info).
Attach a custom domain to a webhosting as an alias to the main domain
path Parameters
regionThe region you want to target
hosting_idHosting ID to which the custom domain is attached to.
Attach a custom domain to a webhosting as an alias to the main domain › Request Body
domain_nameThe custom domain name to attach to the hosting.
Attach a custom domain to a webhosting as an alias to the main domain › Responses
idID of the Web Hosting plan.
project_idID of the Scaleway Project the Web Hosting plan belongs to.
created_atDate on which the Web Hosting plan was created. (RFC 3339 format)
updated_atDate on which the Web Hosting plan was last updated. (RFC 3339 format)
statusStatus of the Web Hosting plan.
protectedWhether the hosting is protected or not.
offer_nameName of the active offer for the Web Hosting plan.
regionRegion where the Web Hosting plan is hosted.
Domain configuration block (subdomain, optional custom domain, and DNS settings).
domainMain domain associated with the Web Hosting plan (deprecated, use domain_info).
dns_statusDNS status of the Web Hosting plan.
domain_statusMain domain status of the Web Hosting plan.
Delete domains from a Web Hosting plan
Remove one or more domains from a Web Hosting plan, specified by its hosting_id. This permanently deletes the domains and all services tied to them, including mailboxes, FTP accounts and DNS zones.
path Parameters
regionThe region you want to target
hosting_idHosting ID of the Web Hosting plan from which to delete domains.
Delete domains from a Web Hosting plan › Request Body
domainsList of domains to delete from the Web Hosting plan.
Delete domains from a Web Hosting plan › Responses
idID of the Web Hosting plan.
project_idID of the Scaleway Project the Web Hosting plan belongs to.
updated_atDate on which the Web Hosting plan was last updated. (RFC 3339 format)
created_atDate on which the Web Hosting plan was created. (RFC 3339 format)
statusStatus of the Web Hosting plan.
Details of the Web Hosting plan offer and options.
Details of the hosting platform.
tagsList of tags associated with the Web Hosting plan.
ipv4Current IPv4 address of the hosting. (IPv4 address)
protectedWhether the hosting is protected or not.
Details of the hosting user.
regionRegion where the Web Hosting plan is hosted.
Domain configuration block (subdomain, optional custom domain, and DNS settings).
Commitment details to which the hosting is engaged.
domainMain domain associated with the Web Hosting plan (deprecated, use domain_info).
dns_statusDNS status of the Web Hosting plan (deprecated, use domain_info).
domain_statusMain domain status of the Web Hosting plan (deprecated, use domain_info).
Migrate a hosting to a new control panel.
path Parameters
regionThe region you want to target
hosting_idHosting ID to migrate to a new control panel.
Migrate a hosting to a new control panel. › Request Body
control_panel_nameThe name of the new control panel. Using the same name as the current. Control panel will migrate the hosting to a new server.
offer_idID of the new offer for the Web Hosting plan after control panel. Migration.
Migrate a hosting to a new control panel. › Responses
idID of the Web Hosting plan.
project_idID of the Scaleway Project the Web Hosting plan belongs to.
created_atDate on which the Web Hosting plan was created. (RFC 3339 format)
updated_atDate on which the Web Hosting plan was last updated. (RFC 3339 format)
statusStatus of the Web Hosting plan.
protectedWhether the hosting is protected or not.
offer_nameName of the active offer for the Web Hosting plan.
regionRegion where the Web Hosting plan is hosted.
Domain configuration block (subdomain, optional custom domain, and DNS settings).
domainMain domain associated with the Web Hosting plan (deprecated, use domain_info).
dns_statusDNS status of the Web Hosting plan.
domain_statusMain domain status of the Web Hosting plan.
Detach a custom domain from a webhosting
path Parameters
regionThe region you want to target
hosting_idHosting ID to which the custom domain is detached from.
Detach a custom domain from a webhosting › Request Body
domain_nameThe custom domain name to detach from the hosting.
Detach a custom domain from a webhosting › Responses
idID of the Web Hosting plan.
project_idID of the Scaleway Project the Web Hosting plan belongs to.
created_atDate on which the Web Hosting plan was created. (RFC 3339 format)
updated_atDate on which the Web Hosting plan was last updated. (RFC 3339 format)
statusStatus of the Web Hosting plan.
protectedWhether the hosting is protected or not.
offer_nameName of the active offer for the Web Hosting plan.
regionRegion where the Web Hosting plan is hosted.
Domain configuration block (subdomain, optional custom domain, and DNS settings).
domainMain domain associated with the Web Hosting plan (deprecated, use domain_info).
dns_statusDNS status of the Web Hosting plan.
domain_statusMain domain status of the Web Hosting plan.
Reset a Web Hosting plan
Reset a Web Hosting plan to its initial state, specified by its hosting_id. This permanently deletes all hosting data including files, databases and emails. The hosting will be re-provisioned.
path Parameters
regionThe region you want to target
hosting_idHosting ID of the Web Hosting plan to reset.
Reset a Web Hosting plan › Responses
idID of the Web Hosting plan.
project_idID of the Scaleway Project the Web Hosting plan belongs to.
updated_atDate on which the Web Hosting plan was last updated. (RFC 3339 format)
created_atDate on which the Web Hosting plan was created. (RFC 3339 format)
statusStatus of the Web Hosting plan.
Details of the Web Hosting plan offer and options.
Details of the hosting platform.
tagsList of tags associated with the Web Hosting plan.
ipv4Current IPv4 address of the hosting. (IPv4 address)
protectedWhether the hosting is protected or not.
Details of the hosting user.
regionRegion where the Web Hosting plan is hosted.
Domain configuration block (subdomain, optional custom domain, and DNS settings).
Commitment details to which the hosting is engaged.
domainMain domain associated with the Web Hosting plan (deprecated, use domain_info).
dns_statusDNS status of the Web Hosting plan (deprecated, use domain_info).
domain_statusMain domain status of the Web Hosting plan (deprecated, use domain_info).
Reset a Web Hosting plan password
path Parameters
regionThe region you want to target
hosting_idUUID of the hosting.
Reset a Web Hosting plan password › Responses
one_time_password_b64New temporary password, encoded in base64.
one_time_passwordNew temporary password (deprecated, use password_b64 instead).
Get the total counts of websites, databases, email accounts, and FTP accounts of a Web Hosting plan
path Parameters
regionThe region you want to target
hosting_idHosting ID.
Get the total counts of websites, databases, email accounts, and FTP accounts of a Web Hosting plan › Responses
databases_countTotal number of active databases in the Web Hosting plan.
mail_accounts_countTotal number of active email accounts in the Web Hosting plan.
ftp_accounts_countTotal number of active FTP accounts in the Web Hosting plan.
websites_countTotal number of active domains in the Web Hosting plan.
Create a user session
Update the free domain of a Web Hosting plan
Change the free domain associated with a Web Hosting plan, specified by its hosting_id.
path Parameters
regionThe region you want to target
hosting_idHosting ID of the Web Hosting plan to update.
Update the free domain of a Web Hosting plan › Request Body
free_domainNew free domain to associate with the Web Hosting plan.
Update the free domain of a Web Hosting plan › Responses
idID of the Web Hosting plan.
project_idID of the Scaleway Project the Web Hosting plan belongs to.
updated_atDate on which the Web Hosting plan was last updated. (RFC 3339 format)
created_atDate on which the Web Hosting plan was created. (RFC 3339 format)
statusStatus of the Web Hosting plan.
Details of the Web Hosting plan offer and options.
Details of the hosting platform.
tagsList of tags associated with the Web Hosting plan.
ipv4Current IPv4 address of the hosting. (IPv4 address)
protectedWhether the hosting is protected or not.
Details of the hosting user.
regionRegion where the Web Hosting plan is hosted.
Domain configuration block (subdomain, optional custom domain, and DNS settings).
Commitment details to which the hosting is engaged.
domainMain domain associated with the Web Hosting plan (deprecated, use domain_info).
dns_statusDNS status of the Web Hosting plan (deprecated, use domain_info).
domain_statusMain domain status of the Web Hosting plan (deprecated, use domain_info).