---
title: "corestack_company_performance_audit_share_link"
url: https://docs.corefinity.com/mcp/tools/corestack_company_performance_audit_share_link
type: tool
last_updated: 2026-11-13
feature: performance-audits
related:
  - https://docs.corefinity.com/guides/tools/performance-audits.md
---
# corestack_company_performance_audit_share_link

**Make a performance audit share link.** Show a performance audit's shared report link, sharing the audit first if it is not; the link stays the same until it is regenerated. Scope: write. Also needs exec when reveal_to_agent is true. The secret opens in the person's browser; set reveal_to_agent to true to receive it yourself (needs exec).

- Scope: `write`
- Also needs `exec` when the share link
- Runs as a task: no
- Returns a secret only when `reveal_to_agent` is set

## 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.

## Inputs

- `audit_id` (integer, ≥ 1, required)
- `reveal_to_agent` (boolean, default `false`): 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.

The link, when shown, is `{url}`.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "audit_id": {
      "minimum": 1,
      "type": "integer"
    },
    "reveal_to_agent": {
      "default": false,
      "description": "Return the secret to you instead of opening it in the person's browser. Needs exec.",
      "type": "boolean"
    }
  },
  "required": [
    "audit_id"
  ],
  "type": "object"
}
```

## Refusals

- `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.
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_company_performance_audit_share_link",
  "arguments": {
    "audit_id": 276
  }
}
```

## Prompt

```text
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.
```

## The same task elsewhere

- Guide: [Performance audits](https://docs.corefinity.com/guides/tools/performance-audits.md)
