---
title: "Mint a publish/unpublish request token"
method: POST
path: "/experiences/request-token"
---

# Mint a publish/unpublish request token

`POST /experiences/request-token`

Mints a short-lived, opaque "request token" the app's creator surface forwards to Fanvue to ask the creator to confirm a publish or unpublish.

    The token is bound to the calling app (a token can only be minted for the app whose credentials make the call — otherwise 403) and to the acting creator, so it can only drive that creator's native confirmation modal.

## Headers

- `X-Fanvue-API-Version` string, required

## Request body

- union
  - object
    - `action` 'publish', required
    - `externalExperienceId` string, required
    - `title` string, required
    - `description` string, required
    - `imageUrl` string, uri, nullable — Public https URL of the experience cover image. Fanvue downloads and re-hosts it when the creator confirms the publish.
    - `proposedAccessMode` 'FREE' | 'SUBSCRIPTION' | 'PAID' | 'HIDDEN', required
    - `deliveryMode` 'EMBEDDED' | 'EXTERNAL', required
    - `externalUrl` string, nullable
    - `appUuid` string, uuid, required
  - object
    - `action` 'unpublish', required
    - `experienceUuid` string, uuid, required
    - `title` string, required
    - `appUuid` string, uuid, required

## Response `200`

The minted request token

- object
  - `token` string, required — The opaque request token to forward to the creator surface for confirmation.

## Other responses

- `400` — Bad Request - API version not supported OR validation failed
- `401` — Unauthorized Response
- `403` — Unauthorized Response
- `410` — API version no longer supported (sunset)
- `429` — Too many requests - rate limit exceeded
- `502` — Failed to mint the request token with the upstream
- `503` — Developer API upstream is not configured

---

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