Create an audit's share link
Shares the audit's report and answers its link, which anyone who has it can read, after the username and password when the audit sets them. An audit has one link, and its figures are frozen when the audit is first shared: running the audit again does not change them until you refresh the shared report.
POST/ api/ performance-audits/ {audit}/ share-link
Path parameters
auditintegerRequired
The id of an audit. Digits only. At least 1.
Returns
200 The link.
Fields of the 200 answer
shared_atstring or nullRequired
Format: date-time.
urlstringRequired
The link to the report. Anyone who has it can read the report, behind its login when one is set.
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. |
409 | run_in_progress | The audit is running. Wait for it to finish. |
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 POST 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()
->post('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: 'POST',
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.post(
"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{
"shared_at": "2026-11-03T12:30:00+00:00",
"url": "https://manage.corefinity.com/audits/5210/report/ExampleShareLinkTokenNotARealOne1"
}{
"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": "run_in_progress",
"message": "This audit is running. Wait for it to finish, then share it.",
"reason": "run_in_progress"
}{
"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 reveals a secret. Copy the request and run it yourself when you are sure.
Was this helpful?