Grant a consumer access to a media item

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

Scope required: write:media

Grant a specific consumer access to a piece of media owned by the authenticated creator. The grant is idempotent: repeated calls with the same parameters return the existing entitlement. <Info>Scope required: `write:media`</Info>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

uuidstringRequiredformat: "uuid"

Request

This endpoint expects an object.

consumerIdstringRequiredformat: "uuid"

UUID of the consumer to grant media access to

sourcestringRequiredformat: "^[a-z0-9_]+$"1-100 characters

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

sourceRefstringRequired1-255 characters

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

Response

Media access granted (or already existed)

entitlementIdstringformat: "uuid"

UUID of the created or existing entitlement

statusenum

Allowed values:

1	import requests
2
3	url = "https://api.fanvue.com/media/uuid/grant"
4
5	payload = {
6	"consumerId": "string",
7	"source": "spin_the_wheel_reward",
8	"sourceRef": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
9	}
10	headers = {
11	"X-Fanvue-API-Version": "2025-06-26",
12	"Authorization": "Bearer <token>",
13	"Content-Type": "application/json"
14	}
15
16	response = requests.post(url, json=payload, headers=headers)
17
18	print(response.json())

Authentication

Path parameters

Headers

Request

Response

Errors

1	{
2	"entitlementId": "f1e2d3c4-b5a6-9870-fedc-ba0987654321",
3	"status": "granted"
4	}