Create an environment

An environment is a named group of stacks and clusters , such as production or staging. Every stack belongs to one.

Post the name of the environment:

curl -X POST "https://api.webscale.com/v2/environments" \
  -H "Authorization: Bearer <my-access-key>" \
  -H "Content-Type: application/json" \
  -d '{"name": "Production"}'

{
  "href": "/v2/environments/3ps666yxcanq",
  "name": "Production",
  "keyword": "production"
}

A stack takes that whole href in its environment field. See Create an EKS stack for an example.

Webscale builds the keyword from the name unless you send your own, as the response above shows. Stacks put it into the names and tags of the resources they create.

Last modified on September 4, 2026