---
title: "corestack_company_performance_audit_share_link_revoke"
url: https://docs.corefinity.com/mcp/tools/corestack_company_performance_audit_share_link_revoke
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_revoke

**Revoke a performance audit share link.** Take a performance audit's shared report link out of service; sharing the audit again re-opens the same link. Scope: write.

- Scope: `write`
- Runs as a task: no

## When to use it

Take a performance audit's shared report link out of service, as Revoke in the Control Panel's Share Report pop-up does. From then on the link answers "not found", and so does any older link to the audit made before the report existed. Sharing the audit again (corestack_company_performance_audit_share_link) opens the same link again, and anyone who unlocked it with its password before must enter the password again. Nothing to revoke is not an error.

## Inputs

- `audit_id` (integer, ≥ 1, required)

Answers `{revoked_at}`: when the link was revoked, or null when the audit had no live link.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "audit_id": {
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "audit_id"
  ],
  "type": "object"
}
```

## Refusals

- `tenant_mismatch`: no such audit, or it belongs to a company you may not access.
- `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_revoke",
  "arguments": {
    "audit_id": 276
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_company_performance_audit_share_link_revoke with audit_id 276. (Revoke 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)
