FAfanvue

Grant a consumer access to a creator's media item

Grant a specific consumer access to a piece of media owned by the specified creator. The grant is idempotent: repeated calls with the same parameters return the existing entitlement.

post/creators/{creatorUserUuid}/media/{uuid}/grant

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/creators/{creatorUserUuid}/media/{uuid}/grant
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: write:creator, write:media

Path parameters

creatorUserUuidstring uuid required
uuidstring uuid required

Headers

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

API version to use for the request

Request body

consumerIdstring uuid required

UUID of the consumer to grant media access to

sourcestring required

Identifier for the granting application or reason (e.g. spin_the_wheel_reward)

sourceRefstring required

Unique identifier within the source, used for idempotency (e.g. spin attempt UUID)

Example request

{
  "source": "spin_the_wheel_reward",
  "sourceRef": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Response

Media access granted (or already existed)

entitlementIdstring uuid required

UUID of the created or existing entitlement

status'granted' required

Changes

No recorded changes to this operation across all 8 revisions of this API.