Sign in
Assets

Grant a subject permission to multiple assets. Authorization is required to grant permissions to the subject and asset IDs in the request.

patch/asset-permissions-api/v1/assets/permissions

Request body

subjectType'Invalid' | 'User' | 'Group' | 'GroupRoleset' | 'All' | 'Universe'
subjectIdstring nullable

The subject ID to grant to. Must be empty for SubjectType 'All'.

action'Invalid' | 'Edit' | 'Use' | 'Download' | 'CopyFromRcc' | 'UpdateFromRcc'

Asset permission actions that can be granted.

Actions:

  • Invalid - default value, not a valid action.
  • Edit - grants the ability to edit and manage the asset.
  • Use - grants the ability to use the asset.
  • Download - grants the ability to download the asset.
  • CopyFromRcc - grants the ability to copy the asset from RCC, used to enable AssetService:CreatePlaceAsync().
  • UpdateFromRcc - grants the ability to update the asset from RCC, used to enable AssetService:UpdatePlaceAsync().

Valid AssetType - SubjectType - Action combinations:

  • Animation - Group/User/Universe - Use
  • Audio - Group/User/Universe - Use
  • Decal - All/Group/User/Universe - Use
  • Image - All/Group/User/Universe - Use
  • Mesh - All/Group/User/Universe - Use
  • MeshPart - Group/User/Universe - Use
  • Model - User - Edit
    • Group/User/Universe - Use
  • Place - All - Download
    • Universe - CopyFromRcc/UpdateFromRcc
  • Video - Group/User/Universe - Use.
assetIdsinteger[] nullable

[Deprecated] The list of asset IDs to grant this permission to. 'requests' will be prioritized over this list.

enableDeepAccessCheckboolean

[Do not use] An optional boolean to indicate if a deep access check should be done. This is not intended for public use.

Response

Success

successAssetIdsinteger[] nullable

The list of asset IDs that granted successfully.