Infrastructure
The catalogue of what can be created: the sizes on sale and their monthly list prices, in US dollars before tax. The catalogue is the same for every customer and reads nothing from a project, so any valid API key can read it, whatever its scopes. Answers are cached for a few minutes, so a change to what is on sale can take that long to show. A size's `slug` is what a create call takes to choose it. For what creating a resource would actually be charged — tax and any project credit included — use the preview call next to its create call. App sizes are listed here. Redis plans and regions are listed under [Redis](/docs/api/redis). The sizes, regions and templates a server can be created with, and the sizes, versions and regions of an always-on database, are shown in the control panel's create forms and are not described here yet.
Every size an app can be created on, cheapest first, with its monthly list price.
Send a size's slug as size when saving an app draft, and to Preview what an app will cost
for what creating it would be charged today. Sizes with dedicated CPU are not on sale and
are not listed. To move an existing app to another size, List plans on the app shows the
sizes it can move to.
Auth: any valid project API key — this endpoint enforces no scope.
Authorization
apiKey A project API key. X-API-Key: <key> is accepted as an alternative to the Authorization header.
In: header
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/catalog/apps/sizes"{ "success": true, "data": [ { "name": "string", "slug": "string", "tier_slug": "string", "cpu_type": "string", "cpus": 0, "memory_bytes": -9007199254740991, "bandwidth_allowance_gib": 0, "usd_per_month": "string" } ]}{ "success": false, "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null }, "issues": null, "docsUrl": "http://example.com" }}{ "success": false, "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null }, "issues": null, "docsUrl": "http://example.com" }}{ "success": false, "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null }, "issues": null, "docsUrl": "http://example.com" }}{ "success": false, "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null }, "issues": null, "docsUrl": "http://example.com" }}