CorefinityCorefinityDocs
Open the Control PanelControl Panel
Integrations · 32 of 39

corestack_company_performance_audit_share_link

Make a performance audit share link.

Scope writeAlso exec to reveal secretsCan return a secret
On this page

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

Prompt
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

audit_idintegerRequired

At least 1.

reveal_to_agentboolean

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

tools/call
{
  "name": "corestack_company_performance_audit_share_link",
  "arguments": {
    "audit_id": 276
  }
}

If it is refused

ReasonWhat to do
tenant_mismatchNo such audit, or it belongs to a company you may not access.
run_in_progressThe 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_limitedThe person's performance audit changes (10 a minute, shared with the API) are used up; wait a minute.
invalid_argumentsThe 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_requiredThe token lacks a scope this call needs. Open the link in the answer to add it, then call again.
pin_refusedThe 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_unavailableThe Control Panel could not answer just now. Nothing was started; try again shortly.
internal_errorSomething went wrong on our side. Quote the trace id to support.

The same task elsewhere

Was this helpful?
Open in ClaudeOpen in ChatGPT