Sign in
latestOpenAPI 3.1.02026-08-08243131.9 MB

c5ddcd5c7e72

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

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