CorefinityCorefinityDocs
Open the Control PanelControl Panel
Environments · 4 of 5

Get what a new environment starts with

Answers what a new staging environment of the site inherits before you add it, and that HTTP authentication protects it from the start. A part that is not available for the site is answered as null. {site} is any row of the site; a site that cannot take a new environment now is refused as adding one is.

GET/api/corestack/sites/{site}/environments/starts-with

Path parameters

siteintegerRequired

The id of a site row. A website's production site and each of its environments has its own id. Digits only. At least 1.

Returns

200 What the new environment starts with.

Fields of the 200 answer
firewallobject or any or nullRequired

The addresses and presets that reach the new environment. Null while this is not available for the site.

http_authobjectRequired
Fields
enabledbooleanRequired

Always true. A new environment is protected by HTTP authentication from the start.

sshobject or any or nullRequired

The keys the new environment gets. Null while this is not available for the site.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403company_unavailableYour company is unavailable.
403scope_requiredUse a token with the scope named in scope.
403two_factor_requiredTurn on two-factor on your account, then send again.
404feature_offThis feature is not on for your organisation yet.
409deletedThe site, environment or copy has been deleted, or is being deleted. Nothing can be changed on it. Restore a deleted site first if it can still be restored.
409managed_elsewhereThis site is read-only here. Change it in the control panel that manages it.
409provisioningThe site is still being created. Try again in a few minutes.
409site_unadoptedThis site is not ready to be changed from the Control Panel yet. Contact support.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl https://manage.corefinity.com/api/corestack/sites/1042/environments/starts-with \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "firewall": {
    "closed_to_others": false,
    "inherited": 2,
    "items": [
      {
        "cidr": "203.0.113.10/32",
        "layer": "website",
        "owner": {
          "id": 1302,
          "name": "harbourandfinch.example.com",
          "type": "website"
        },
        "scope": "both"
      },
      {
        "cidr": "198.51.100.24/32",
        "layer": "company",
        "owner": {
          "id": 1204,
          "name": "Harbour & Finch",
          "type": "company"
        },
        "scope": "both"
      }
    ],
    "presets": [
      {
        "layer": "company",
        "name": "GitHub Actions",
        "owner": {
          "id": 1204,
          "name": "Harbour & Finch",
          "type": "company"
        },
        "ranges": 1,
        "slug": "github-actions"
      }
    ],
    "stage": "dark"
  },
  "http_auth": {
    "enabled": true
  },
  "ssh": {
    "items": [
      {
        "layer": "company",
        "name": "Deploy key",
        "owner": {
          "id": 1204,
          "name": "Harbour & Finch",
          "type": "company"
        }
      }
    ],
    "keys": 1
  }
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT