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.
write:creator— Modify creator profiles, settings, and creator-specific data.write:media— Upload, modify, and manage media files and content assets. Also required for vault folder management.
Authorizations
OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.
Headers
API version to use for the request
"2025-06-26"
Body
UUID of the consumer to grant media access to
Identifier for the granting application or reason (e.g. spin_the_wheel_reward)
1 - 100^[a-z0-9_]+$"spin_the_wheel_reward"
Unique identifier within the source, used for idempotency (e.g. spin attempt UUID)
1 - 255"a1b2c3d4-e5f6-7890-abcd-ef1234567890"