---
title: "Create a scoped share link for one report (licence required; up to 90 days; revocable)"
method: POST
path: "/api/share"
---

# Create a scoped share link for one report (licence required; up to 90 days; revocable)

`POST /api/share`

## Request

- Base URL: `https://crawlcheck.io`
- URL: `https://crawlcheck.io/api/share`
- Auth: one of:
  - API key in header `x-crawlcheck-key`
  - HTTP bearer

## Headers

- `x-crawlcheck-key` string, required

## Request body

- object
  - `rid` string, required: Report id, or a report URL
  - `days` integer

## Response `200`

url, rid, expires, revoke

- object, nullable
  - `ok` boolean, nullable
  - `url` string, nullable
  - `rid` string, nullable
  - `expires` string, nullable
  - `revoke` string, nullable

## Other responses

- `400`: No usable report id
- `401`: No valid licence key
- `403`: Report domain is not on this licence
- `404`: No such report

---

[API](https://skmtc.dev/crawlcheck/apis/crawlcheck-api.md) · [All operations](https://skmtc.dev/crawlcheck/apis/crawlcheck-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlcheck/apis/crawlcheck-api/revisions/57acbd6d4489?raw)