Web Hosting API

Scaleway provides several Web Hosting plans for individuals, professionals, and everyone in between. Our Web Hosting plans include:

• A domain name
• A configurable webhosting service
• The management of your emails, including anti-spam, antivirus and filter systems
• Unlimited sub-domains
• An FTP account to upload your website
• At least one database

Concepts

Refer to our dedicated concepts pageOpen in new context to find definitions of all Web Hosting-related terminology.

Quickstart

1. Configure your environment variables.

   Note

   This is an optional step that seeks to simplify your usage of the Web Hosting API.

   Code
   export SCW_SECRET_KEY="<API secret key>"
   export SCW_PROJECT_ID="<Scaleway Project ID>"

2. Choose a Web Hosting offer: run the following command to list all Web Hosting offers. The | jq appendage at the end of the command makes the output easier to read.

   Code
   curl -X GET \
       -H "X-Auth-Token: $SCW_SECRET_KEY" \
       -H "Content-Type: application/json" \
       "https://api.scaleway.com/webhosting/v1/regions/fr-par/offers?without_options=true" | jq

   Note

   In the above example, we choose to get offers only. Adjust the query parameter if you would also like to get information about the different options you can add to offers.

3. Order a Web Hosting plan: run the following command to create a Web Hosting plan. You can customize the details in the payload to your needs, using the table below to help.

   Code
   curl -X POST \
       -H "X-Auth-Token: $SCW_SECRET_KEY" \
       -H "Content-Type: application/json" \
       "https://api.scaleway.com/webhosting/v1/regions/fr-par/hostings" \
       -d '{
       "domain": "mydomain.net",
       "offer_id": "f5c2ae8f-7625-4bca-b711-b44bb3d08694",
       "project_id": "'"$SCW_PROJECT_ID"'",
       "tags": ["my-tag"]
   }'

   Parameter	Description	Valid values OR Example
   domain	The domain name you would like to link to your Web Hosting account. You must already own this domain name and have completed the DNS validation process beforehand.	mydomain.net
   offer_id	The offer ID of the desired offer. Use one of the offer IDs returned in step 2	f5c2ae8f-7625-4bca-b711-b44bb3d08694
   project_id	The ID of the Scaleway Project to create the Web Hosting plan in.	277ed74e-ea73-11ed-a05b-0242ac120003
   tags	Any tags you would like to associate with this Web Hosting plan	my-tag

   Tip

   Once you've ordered your Web Hosting plan, check out our dedicated documentationOpen in new context to get started with your configuration.

4. Delete your Web Hosting plan: run the following command to delete your Web Hosting plan. Ensure that you replace {hosting-id} in the URL with the ID of the Web Hosting plan you want to delete.

   Code
   curl -X DELETE \
       -H "Content-Type: application/json" \
       -H "X-Auth-Token: $SCW_SECRET_KEY" \
       "https://api.scaleway.com/rest-of-endpoint/{hosting-id}"

Technical information

All Scaleway Web Hosting plans now offer a choice between cPanel and Plesk for website management. Both tools provide a graphical interface and fast access icons, allowing you to configure and monitor your hosting solutions with ease. You can access cPanel or Plesk via the Scaleway consoleOpen in new context.

Regions

The Scaleway Web Hosting API is a regional API, meaning that each call must specify in its path parameters the region for the resources concerned by the call.

Scaleway Web Hosting is available only in the fr-par region.

Going further

For more help using Scaleway Web Hosting, check out the following resources:

• Our main documentationOpen in new context
• The #webhosting-early-access channel on our Slack CommunityOpen in new context
• Our support ticketing systemOpen in new context.