---
title: "Rotate the public results link"
method: POST
path: "/forms/{formId}/results-share/rotate"
tags: ["Forms"]
---

# Rotate the public results link

`POST /forms/{formId}/results-share/rotate`

## Request

- Base URL: `https://api.clipform.io/v1`
- URL: `https://api.clipform.io/v1/forms/{formId}/results-share/rotate`
- Auth: HTTP bearer

Mints a fresh public results token for a form, invalidating the previous link.

## Path parameters

- `formId` string, uuid, required

## Response `200`

New results share token

- object
  - `form_id` string, uuid
  - `results_share_id` string: 24-character lowercase hex token used in the public results URL.

## Other responses

- `429`: Rate limit exceeded.

---

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