---
title: "Create an audit's share link"
url: https://docs.corefinity.com/api/reference/logs/create-performance-audit-share-link
type: endpoint
last_updated: 2026-11-13
feature: performance-audits
related:
  - https://docs.corefinity.com/guides/tools/performance-audits.md
---
# 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.

```http
POST /api/performance-audits/{audit}/share-link
```

- Scope: `write`
- Rate limit: 10 a minute
- Try it in the console: off. It reveals a secret. Copy the request and run it yourself when you are sure.

## Path parameters

- `audit` (integer, required): The id of an audit. Digits only.

## Request

### curl

```bash
curl -X POST https://manage.corefinity.com/api/performance-audits/5210/share-link \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
```

### PHP

```php
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();
```

### Node

```javascript
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);
```

### Python

```python
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
```

## Responses

### 200 The link.

```json
{
  "shared_at": "2026-11-03T12:30:00+00:00",
  "url": "https://manage.corefinity.com/audits/5210/report/ExampleShareLinkTokenNotARealOne1"
}
```

### 401 No token, or a token that is not valid.

```json
{
  "message": "Unauthenticated."
}
```

### 403 The token lacks the `write` scope (`scope_required`).

```json
{
  "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"
}
```

### 404 The id does not exist, or it is something you cannot see. Both answer the same body.

```json
{
  "message": "Not found."
}
```

### 409 The audit is shared for the first time while a run is still writing its results (`run_in_progress`).

```json
{
  "code": "run_in_progress",
  "message": "This audit is running. Wait for it to finish, then share it.",
  "reason": "run_in_progress"
}
```

### 429 Too many requests (`rate_limited`). Wait for the number of seconds in `Retry-After`, which `retry_after_seconds` repeats.

```json
{
  "code": "rate_limited",
  "message": "Too many requests. Try again in 60 seconds.",
  "reason": "rate_limited",
  "retry_after_seconds": 60
}
```

## If it is refused

| Status | Reason | What to do |
|---|---|---|
| 401 |  | Send a valid token as `Authorization: Bearer <token>`. |
| 403 | `scope_required` | Use a token with the scope named in `scope`. |
| 404 |  | 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`. |

## The same task elsewhere

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