---
title: "Revoke a Pages preview link"
method: DELETE
path: "/api/pages/{siteId}/preview-links"
tags: ["pages"]
---

# Revoke a Pages preview link

`DELETE /api/pages/{siteId}/preview-links`

## Request

- Base URL: `https://app.goosybear.ai`
- URL: `https://app.goosybear.ai/api/pages/{siteId}/preview-links`
- Auth: HTTP bearer

Revokes a preview token for a site in the API key's workspace. This REST-only endpoint has no MCP-tool equivalent; the token belongs only in the JSON body.

## Path parameters

- `siteId` string, uuid, required

## Request body

- object
  - `token` string, required
  - `workspace` string

## Response `200`

The request succeeded. Read the `data` Result field.

- object
  - `ok` true, required
  - `data` object, required
    - `siteId` string, uuid, required

## Other responses

- `400`: The site id or JSON request body did not match the endpoint's strict schema.
- `401`: No bearer credential, or one that did not resolve.
- `403`: Programmatic access is unavailable to this holder, the named workspace is outside the key's scope, or the holder lacks `pages.manage` there. `workspace_ambiguous` and `workspace_unreachable` also answer here, and the slugs this key may pass are appended to `error.message`.
- `429`: The API key is over its rate limit. Wait for `Retry-After` before retrying.
- `500`: An unexpected server error occurred while handling the request.

---

[API](https://skmtc.dev/goosybear/apis/goosy-bear-api.md) · [All operations](https://skmtc.dev/goosybear/apis/goosy-bear-api/llms.txt) · [OpenAPI document](https://skmtc.dev/goosybear/apis/goosy-bear-api/revisions/6d82fb124064?raw)