corestack_ company_ performance_ audit_ share_ link
Make a performance audit share link.
When to use it
Show a performance audit's shared report link, as the Control Panel's Share Report does. If the audit is not shared yet, this shares it: its report figures are frozen at that moment, and refreshing them later is corestack_company_performance_audit_report_refresh. The audit keeps the same link until it is regenerated (corestack_company_performance_audit_share_link_regenerate), so asking again gives the same link; a revoked link opens again at the same address. Anyone who has the link can read the report, after a username and password if the audit sets one (corestack_company_performance_audit_update).
The link opens in the person's browser: nothing is shared until they press Show there, and they can press it again later. Set reveal_to_agent only when the person asks for the link to be given to you.
Ask for it
Using the Corefinity MCP server, call corestack_company_performance_audit_share_link with audit_id 276. (Make a performance audit share link.) Tell me what it returned.Inputs
At least 1.
Return the link to you instead of opening it in the person's browser. Needs exec. The audit is shared at that moment if it is not already. Defaults to false.
The link, when shown, is {url}.
Example call
{
"name": "corestack_company_performance_audit_share_link",
"arguments": {
"audit_id": 276
}
}If it is refused
| Reason | What to do |
|---|---|
tenant_mismatch | No such audit, or it belongs to a company you may not access. |
run_in_progress | The audit has not been shared before and a run is still writing its results; wait for it to finish (corestack_company_performance_audit_get), then share it. |
rate_limited | The person's performance audit changes (10 a minute, shared with the API) are used up; wait a minute. |
invalid_arguments | The arguments do not match the tool's input schema, or the Control Panel refused a field. Fix the fields named in the answer and call again. |
scope_required | The token lacks a scope this call needs. Open the link in the answer to add it, then call again. |
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. |
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. |