---
title: "POST /reports/{id}/share-links"
method: POST
path: "/reports/{id}/share-links"
tags: ["Reports"]
---

# POST /reports/{id}/share-links

`POST /reports/{id}/share-links`

## Path parameters

- `id` string, required

## Request body

- ReportShareLinkCreateRequest
  - `expiresAt` string, date-time
  - `recipientLabel` string — Optional human-readable recipient or customer label.

## Response `200`

Created share link

- ReportShareLinkResponse
  - `data` ReportShareLink, required
    - `accessCount` integer, required
    - `createdAt` string, date-time, required
    - `expiresAt` string, date-time
    - `id` string, required
    - `lastAccessedAt` string, date-time
    - `recipientLabel` string
    - `reportVersionId` string, required
    - `revokedAt` string, date-time
    - `status` 'active' | 'expired' | 'revoked', required
    - `token` string — Returned only when creating a new link.
    - `url` string, required

## Other responses

- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.dev/greentally/apis/esgai-api.md) · [All operations](https://skmtc.dev/greentally/apis/esgai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greentally/esgai-api/revisions/09945036a28b/schema)