# Revoke Dashboard Share Link

Soft-revoke a dashboard share link. The slug immediately stops resolving. Idempotent — revoking an already-revoked link is a no-op. Requires the `report-create` capability.

## Parameters

### Path Parameters

**`dashboard_id`** string required

ID of the dashboard (prefixed with `dsh_`).

**`link_id`** string required

ID of the share link to revoke.

## Returns

Returns `204 No Content` on success.

## cURL


```bash
curl -X DELETE "https://api.aitronos.com/v1/dashboards/dsh_a1b2c3d4e5f6/share-links/slink_a1b2c3d4" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Python SDK


```python
from aitronos import Aitronos  # pip install aitronos-sdk

client = Aitronos(api_key="your-api-key")
client.dashboards.revoke_share_link(
    dashboard_id="dsh_a1b2c3d4e5f6", link_id="slink_a1b2c3d4"
)
```

## Python


```python
import requests

resp = requests.delete(
    "https://api.aitronos.com/v1/dashboards/dsh_a1b2c3d4e5f6/share-links/slink_a1b2c3d4",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(resp.status_code)  # 204
```

## JavaScript


```javascript
const resp = await fetch(
  "https://api.aitronos.com/v1/dashboards/dsh_a1b2c3d4e5f6/share-links/slink_a1b2c3d4",
  { method: "DELETE", headers: { "Authorization": "Bearer YOUR_API_KEY" } },
);
console.log(resp.status); // 204
```

## Response

### Success — `204 No Content`

No response body.

### Error — `404 Not Found`


```json
{
  "success": false,
  "error": {
    "code": "DASHBOARD_NOT_FOUND",
    "message": "The requested dashboard could not be found.",
    "system_message": "No dashboard exists for the supplied dashboard_id, or the caller lacks access.",
    "type": "client_error",
    "status": 404,
    "details": {"dashboard_id": "dsh_a1b2c3d4e5f6"},
    "trace_id": "...",
    "timestamp": "..."
  }
}
```

## Related Resources

- [Create Dashboard Share Link](/docs/api-reference/dashboards/create-dashboard-share-link)
- [Run Dashboard](/docs/api-reference/dashboards/run-dashboard)