corestack_ enterprise_ variable_ reveal
Show a CoreStack Enterprise build variable.
When to use it
Show the value of one of a CoreStack Enterprise environment's build variables. By default it opens in the person's
browser on a secret page, and nothing is read until they press Show. Only with exec and reveal_to_agent: true is the
value returned to you, as {name, value}. A cleared variable's value is "". The reveal is recorded. This is the only
way a stored value is shown: the variables list and the set's answer never carry one. For a CoreStack or CoreCluster
site, use corestack_ by site_id instead.
The public API's POST / answers the value to the token's own
user, as reveal_to_agent does here; both share the credentials budget of 10 reveals a minute.
Ask for it
Using the Corefinity MCP server, call corestack_enterprise_variable_reveal with enterprise_env_id 1530, name API_TOKEN. (Show a CoreStack Enterprise build variable.) Tell me what it returned.Inputs
A CoreStack Enterprise environment's id; for CoreStack or CoreCluster use the corestack_deployment_* tools. At least 1.
The variable's name from corestack_enterprise_variables_list, as it was saved. A variable saved before today's name rules (with a hyphen, say) can still be shown by that name.
Return the secret to you instead of opening it in the person's browser. Needs exec. Defaults to false.
Example call
{
"name": "corestack_enterprise_variable_reveal",
"arguments": {
"enterprise_env_id": 1530,
"name": "API_TOKEN"
}
}If it is refused
| Reason | What to do |
|---|---|
not_available | The stored value can no longer be read ("This value can no longer be read. Set it again."); set it again with corestack_enterprise_variable_set. |
rate_limited | More than 10 reveals in a minute. |
invalid_arguments | A CoreStack or CoreCluster environment; use the corestack_deployments_* tools by site_id. |
tenant_mismatch | The environment does not exist, is not the person's, or is hidden from them; and a name the environment has no variable of, before any link is offered. Both answers are the same, so read corestack_enterprise_variables_list to tell them apart. |
pin_refused | The grant is limited to chosen clusters, sites or environments, and this call is outside them. Open the link in the answer to widen it. |
scope_required | The token lacks a scope this call needs. Open the link in the answer to add it, then call again. |
temporarily_unavailable | The Control Panel could not answer just now. Nothing was started; try again shortly. |
internal_error | Something went wrong on our side. Quote the trace id to support. |