Delete an audit's share link
Takes the report's link out of service: it answers not found until the audit is shared again, which opens the same link again and asks everyone for the password again. Revoking an audit that is not shared changes nothing and is not refused.
DELETE/ api/ performance-audits/ {audit}/ share-link
Path parameters
auditintegerRequired
The id of an audit. Digits only. At least 1.
Returns
200 The link is revoked. revoked_at is when it was revoked, and null for an audit that was never shared.
Fields of the 200 answer
revoked_atstring or nullRequired
Format: date-time.
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | scope_required | Use a token with the scope named in scope. |
404 | none | Check the id. You see only what your account can reach. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl -X DELETE https://manage.corefinity.com/api/performance-audits/5210/share-link \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->delete('https://manage.corefinity.com/api/performance-audits/5210/share-link');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/performance-audits/5210/share-link', {
method: 'DELETE',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.delete(
"https://manage.corefinity.com/api/performance-audits/5210/share-link",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None{
"revoked_at": "2026-11-03T12:35:00+00:00"
}{
"message": "Unauthenticated."
}{
"code": "scope_required",
"message": "This access token does not have the destructive scope this needs. Use a token with the destructive scope.",
"reason": "scope_required",
"scope": "destructive"
}{
"message": "Not found."
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}Try it
Try it is off for this endpointIt has not been cleared for the console. Copy the request and run it yourself when you are sure.
Was this helpful?