Update a company deployment variable
Creates the variable when the company does not have it and changes it otherwise, then answers the whole list with each value masked. A new variable needs a value; an agency can also share a variable with the sites it manages for its clients (shared_with_managed).
Path parameters
The id of a company you belong to or manage. 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.
Body
For an agency only, also give the variable to the sites it manages for its clients.
The value, kept exactly as sent. Leave out to change only shared_with_managed. Up to 2,048 characters.
Returns
200 The company's variables after the change.
Fields of the 200 answer
Whether the company can share variables with sites it manages. True for an agency.
Fields of each item
The mask shown in place of the value. A value of 16 characters or more also shows its last four.
Whether an agency shares the variable with the sites it manages for its clients.
A sentence saying the build tool named never reads this variable, when the name is one a build tool reads its own credentials from. Null otherwise.
The name of the person who last changed it.
Fields
Environments the variable reaches.
Environments whose commands read the variable and do not receive it.
Environments that have a variable of their own with this name.
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 | forbidden | The person is not allowed to do this. |
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. |
422 | invalid | Fix the field named in field; errors says why. |
422 | variable_invalid | Use at most 2,048 characters, with no line breaks, control or invisible formatting characters. |
422 | variable_reserved | CF_RELEASE is set by CoreStack. Choose another name. |
422 | too_many_variables | This company already has the most deployment variables it can hold. |
422 | variable_tool_credential | Builds see the variable under another name, so the tool it is meant for never reads it. Add the credentials under Deployments, Private registries, instead. |
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 PUT https://manage.corefinity.com/api/corestack/companies/1204/deploy-variables/SLACK_URL \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"value": "example-value-not-a-real-secret"
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->put('https://manage.corefinity.com/api/corestack/companies/1204/deploy-variables/SLACK_URL', [
'value' => 'example-value-not-a-real-secret',
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/companies/1204/deploy-variables/SLACK_URL', {
method: 'PUT',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
value: 'example-value-not-a-real-secret',
}),
});
// 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.put(
"https://manage.corefinity.com/api/corestack/companies/1204/deploy-variables/SLACK_URL",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"value": "example-value-not-a-real-secret",
},
)
data = res.json() if res.content else None{
"can_share": true,
"data": [
{
"masked": "••••••••.com",
"name": "API_URL",
"shared_with_managed": true,
"tool_credential": null,
"updated_at": "2026-11-09T10:42:07Z",
"updated_by": "Maya Okafor",
"used_by": {
"environments": 1,
"not_set_on": 0,
"overridden_on": 0
}
},
{
"masked": "••••••••cret",
"name": "SLACK_URL",
"shared_with_managed": false,
"tool_credential": null,
"updated_at": "2026-11-09T10:42:07Z",
"updated_by": "Maya Okafor",
"used_by": {
"environments": 1,
"not_set_on": 0,
"overridden_on": 0
}
}
]
}{
"message": "Unauthenticated."
}{
"code": "company_unavailable",
"message": "Your company is unavailable.",
"reason": "company_unavailable"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"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 has not been cleared for the console. Copy the request and run it yourself when you are sure.