---
title: "Create a report share link"
method: POST
path: "/v3/reports/{id}/share/link"
tags: ["Reports"]
---

# Create a report share link

`POST /v3/reports/{id}/share/link`

## Path parameters

- `id` string, required

## Request body

- object
  - `pages` object[], required
    - `image` string, required — Page image data URL
    - `branding` object
      - `x` number
      - `y` number
      - `w` number
      - `h` number
      - `disableWhiteLabel` boolean
  - `pageWidth` number, required
  - `pageHeight` number, required
  - `orientation` 'portrait' | 'landscape'
  - `title` string
  - `author` string

## Response `200`

Default Response

- object
  - `url` string, uri, required
  - `token` string, required

## Changes

- **2026-09-18** `e0163b1c37cb` — 1 breaking, 2 info
  - added required request body
  - api tag `Reports` added
  - added the media type `application/json` for the response with the status `200`

[Change history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/reports/:id/share/link/post.md)

---

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