Scaleway's APIs are key part of the Scaleway Ecosystem: anything you can do from the web console can be done through APIs. APIs give you access to all Scaleway products, including storage, compute and much more.

Accessing Cloud APIs

APIs can be accessed via conventional HTTP request or via provided client library.

Every Scaleway API can be access through a single endpoint: api.scaleway.com. Each endpoints follow this pattern: api.scaleway.com/{product}/{version}/...

Request and Response are JSON based. See product reference pages to get more details.

Each request made to Scaleway APIs must be authenticated. Scaleway APIs handle this with a X-Auth-Token HTTP header that must be provided with the request. You can generate an X-Auth-Token token by visiting the credential section of the Scaleway web console. It is absolutely essential that you keep your token private as it gives access to everything in your Scaleway account.

Tokens are bound to projects, be careful to use the right token with the right project_id value.

Scaleway's products are hosted in multiple datacenters around the world.

For both performance and legal reasons, some products are available in different Regions and/or Availability Zones. This allows you to choose the location that best fits your needs (based on country, latency, environmental considerations etc).

Region Definition

A Region is represented as a geographical area such as France (Paris) or the Netherlands (Amsterdam). It can contain multiple Availability Zones.

For regionalized products, you can specify the region in the endpoint via this pattern: api.scaleway.com/{product}/{version}/regions/{region}/....

Available regions

Region idDescription
fr-parParis, France
nl-amsAmsterdam, The Netherlands
pl-wawWarsaw, Poland

To allow for the deployment of highly available applications, a region can contain multiple Availability Zones (AZ). Latency between multiple AZs within the same region is low as they share a common network layer.

For zoned products, you can specify the Availability Zone in the endpoint via this pattern: api.scaleway.com/{product}/{version}/zones/{zone}/....

Available zones

  • fr-par-1
  • fr-par-2
  • fr-par-3
  • nl-ams-1
  • pl-waw-1

We use conventional HTTP response codes to indicate success or failure of an API request.

In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that resulted from the provided information (e.g., a required parameter is missing), and codes in the 5xx range indicate an error with our servers.

  • 200 OK - Everything worked as expected.
  • 201 No Content - Everything worked and response do not contain a body.
  • 400 Bad Request - Often missing a required parameter.
  • 401 Unauthorized - No valid API key provided.
  • 403 Forbidden - Insufficient privileges to access requested resource.
  • 404 Not Found - The requested item does not exist.
  • 429 Too many requests - You made too many request too quickly.
  • 50x Server errors - Something went wrong on our side 😢.

Most non-2xx status codes are provided with a message in the body giving more detail about the cause of the issue.