---
title: "Create report permalink"
method: POST
path: "/api/v1/analytics/report/{id}/permalink"
tags: ["Report"]
---

# Create report permalink

`POST /api/v1/analytics/report/{id}/permalink`

Create permanent download link for report. You can only have one valid permalink enabled at a time for each report. Creating a new one will invalidate all existing permalinks.

## Path parameters

- `id` string, required — Resource identifier.

## Request body

- object
  - `permalink` object, required
    - `validUntil` string, date — Date until the permalink is valid
    - `format` 'csv' | 'xlsx' | 'txt' | 'parquet' | 'pdf' — Export format

## Response `200`

Report permalink response

- object
  - `data` object[], nullable, required
    - `reportId` number — ID of the report
    - `validUntil` string, date — Date until the permalink is valid
    - `format` 'csv' | 'xlsx' | 'txt' | 'parquet' | 'pdf' — Export format
    - `token` string — Random string token
    - `createdAt` string, date-time — Creation time
    - `updatedAt` string, date-time — Last update time

## Other responses

- `400` — IETF RFC 9457 Problem API compliant response
- `401` — Unable to authenticate the client
- `403` — Unable to authorize the client
- `404` — Resource was not found or not enough access privileges
- `415` — Resource representation send in the request is not supported.

---

[API](https://skmtc.net/xentral/apis/xentral-api.md) · [All operations](https://skmtc.net/xentral/apis/xentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xentral/xentral-api/versions/8a27ba392442/schema)