Delete a deployment variable
Removes the variable from the environment and answers the list that is left. The next deployment no longer has it.
Path parameters
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.
The variable's name, without the CF_ prefix builds see it with: letters, digits and underscores, starting with a letter or underscore, at most 64 characters. Any other name is refused 422 invalid on name.
Returns
200 The environment's variables after the removal.
Fields of the 200 answer
Fields of each item
Whether the value may appear in deployment logs. hidden masks it there.
hiddenshownnullThe mask shown in place of the value. A value of 16 characters or more also shows its last four.
The name, without the CF_ prefix builds see it with.
The company whose variable of the same name this one takes the place of. Null when there is none.
Whether the name is one CoreStack sets itself, so this value replaces the platform's.
A sentence saying the build tool named never reads this variable, when the name is one a build tool reads its own credentials from and no stage reads it. Null otherwise.
When the variable last changed, in UTC. Format: date-time.
Always null at present.
The deployment stages whose commands read the variable.
builddatabasepost_deployThe company variables that reach this environment. Present while deployment templates are on for your company.
Fields of each item
Fields
At least 1.
Whose variable it is, such as owner for the company that owns the site.
Whether the environment has a variable of its own with this name, whose value is used instead.
Whether an agency shares it with the companies it manages.
The deployment stages whose commands read it.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | company_unavailable | Your company is unavailable. |
403 | scope_required | Use a token with the scope named in scope. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
404 | feature_off | This feature is not on for your organisation yet. |
409 | managed_elsewhere | This site is read-only here. Change it in the control panel that manages it. |
422 | invalid | Fix the field named in field; errors says why. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X DELETE https://manage.corefinity.com/api/corestack/sites/1042/deployments/variables/API_TOKEN \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->delete('https://manage.corefinity.com/api/corestack/sites/1042/deployments/variables/API_TOKEN');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/sites/1042/deployments/variables/API_TOKEN', {
method: 'DELETE',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.delete(
"https://manage.corefinity.com/api/corestack/sites/1042/deployments/variables/API_TOKEN",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"data": [
{
"log_visibility": "shown",
"masked": "••••••••.com",
"name": "API_URL",
"overrides": null,
"replaces_platform": false,
"tool_credential": null,
"updated_at": "2026-11-09T10:42:07Z",
"updated_by": null,
"used_in": []
}
],
"inherited": []
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "managed_elsewhere",
"message": "This site is managed by another control panel",
"reason": "managed_elsewhere"
}{
"code": "invalid",
"errors": {
"name": [
"The name argument is not in the expected format."
]
},
"field": "name",
"message": "Some arguments are not valid.",
"reason": "invalid"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}Try it is off for this endpointIt deletes data that cannot be brought back. Copy the request and run it yourself when you are sure.