FAfanvue

Mint a publish/unpublish request token

Changed on

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.

A publish request may narrow the access modes the creator is offered with `allowedAccessModes`; an incoherent constraint (empty, duplicated, or not containing `proposedAccessMode`) is rejected with 400 and a message naming the rule it broke.
post/experiences/request-token

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/experiences/request-token
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: write:experience

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Request body

OR

Example request

{
  "imageUrl": "https://example.com/covers/launch-your-page.jpg",
  "allowedAccessModes": [
    "FREE"
  ],
  "proposedActions": [
    {
      "externalActionId": "spin",
      "title": "Spin the wheel",
      "suggestedPriceCents": 500
    }
  ],
  "proposedExperienceType": "GAME"
}

Response

The minted request token

tokenstring required

The opaque request token to forward to the creator surface for confirmation.

Example response

{
  "token": "req_2f1c…"
}

Changes

  • 79b9aba8a759Revision changes
    • info

      added the new optional request property /

  • 4d08f36ad6c8Revision changes
    • breaking

      added subschema #3 to the response body oneOf list for the response status

    • warning

      the / request property's maxLength was set to 500

    • warning

      the / request property's maxLength was set to 255

    • warning

      the / request property's maxLength was set to 100

    • info

      added the new optional request property /

    • info

      added the new optional request property /