Regenerate an audit's share link
Gives the report a new link. The current link, and a link made before the report existed, stop working for good, so send the audit's name, typed exactly, as confirm_name.
POST/ api/ performance-audits/ {audit}/ share-link/ regenerate
Path parameters
auditintegerRequired
The id of an audit. Digits only. At least 1.
Body
confirm_namestringRequired
The audit's name, typed exactly. Up to 255 characters.
Returns
200 The new 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. |
422 | confirm_mismatch | Send the confirmation exactly as the field named in field asks for it. |
422 | invalid | Fix the field named in field; errors says why. |
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/regenerate \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"confirm_name": "Before and after the move"
}'use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->post('https://manage.corefinity.com/api/performance-audits/5210/share-link/regenerate', [
'confirm_name' => 'Before and after the move',
]);
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/performance-audits/5210/share-link/regenerate', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
confirm_name: 'Before and after the move',
}),
});
// 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/regenerate",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
json={
"confirm_name": "Before and after the move",
},
)
data = res.json() if res.content else None{
"shared_at": "2026-11-03T12:35:00+00:00",
"url": "https://manage.corefinity.com/audits/5210/report/ExampleShareLinkTokenNotARealOne2"
}{
"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 regenerate its link.",
"reason": "run_in_progress"
}{
"code": "confirm_mismatch",
"errors": {
"confirm_name": [
"The name you typed does not match this audit's name. The link was not changed."
]
},
"field": "confirm_name",
"message": "The name you typed does not match this audit's name. The link was not changed.",
"reason": "confirm_mismatch"
}{
"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 deletes data that cannot be brought back. Copy the request and run it yourself when you are sure.
Was this helpful?