Assets

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

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

Request

  • Base URL
    https://apis.roblox.com
  • URL
    https://apis.roblox.com/asset-permissions-api/v1/assets/permissions
  • Auth
    • API key in cookie .ROBLOSECURITY
    • or API key in header x-api-key

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

OK

successAssetIdsinteger[] nullable

The list of asset IDs that granted successfully.

Changes

    • warning

      added the new RequesterNotAConnection enum value to the / response property for the response status

    • warning

      added the new RequesterNotAConnection enum value to the / response property for the response status

    • warning

      added the new RequesterNotAConnection enum value to the / response property for the response status

    • warning

      added the new RequesterNotAConnection enum value to the // response property for the response status

    • info

      removed the RequesterNotConnected enum value from the / response property for the response status

    • info

      removed the RequesterNotConnected enum value from the / response property for the response status

    • info

      removed the RequesterNotConnected enum value from the / response property for the response status

    • info

      removed the RequesterNotConnected enum value from the // response property for the response status

    • warning

      added the new AlreadyHasAccess enum value to the / response property for the response status

    • warning

      added the new AlreadyHasAccess enum value to the / response property for the response status

    • warning

      added the new AlreadyHasAccess enum value to the / response property for the response status

    • warning

      added the new AlreadyHasAccess enum value to the // response property for the response status

    • warning

      added the new AlreadyPending enum value to the / response property for the response status

    • warning

      added the new AlreadyPending enum value to the / response property for the response status

    • warning

      added the new AlreadyPending enum value to the / response property for the response status

    • warning

      added the new AlreadyPending enum value to the // response property for the response status

    • warning

      added the new BatchSizeLimitExceeded enum value to the / response property for the response status

    • warning

      added the new BatchSizeLimitExceeded enum value to the / response property for the response status

    • warning

      added the new BatchSizeLimitExceeded enum value to the / response property for the response status

    • warning

      added the new BatchSizeLimitExceeded enum value to the // response property for the response status

    • warning

      added the new CallerNotOwner enum value to the / response property for the response status

    • warning

      added the new CallerNotOwner enum value to the / response property for the response status

    • warning

      added the new CallerNotOwner enum value to the / response property for the response status

    • warning

      added the new CallerNotOwner enum value to the // response property for the response status

    • warning

      added the new InvalidRequestStatus enum value to the / response property for the response status

    • warning

      added the new InvalidRequestStatus enum value to the / response property for the response status

    • warning

      added the new InvalidRequestStatus enum value to the / response property for the response status

    • warning

      added the new InvalidRequestStatus enum value to the // response property for the response status

    • warning

      added the new NotRequestable enum value to the / response property for the response status

    • warning

      added the new NotRequestable enum value to the / response property for the response status

    • warning

      added the new NotRequestable enum value to the / response property for the response status

    • warning

      added the new NotRequestable enum value to the // response property for the response status

    • warning

      added the new RateLimited enum value to the / response property for the response status

    • warning

      added the new RateLimited enum value to the / response property for the response status

    • warning

      added the new RateLimited enum value to the / response property for the response status

    • warning

      added the new RateLimited enum value to the // response property for the response status

    • warning

      added the new RequestNotFound enum value to the / response property for the response status

    • warning

      added the new RequestNotFound enum value to the / response property for the response status

    • warning

      added the new RequestNotFound enum value to the / response property for the response status

    • warning

      added the new RequestNotFound enum value to the // response property for the response status

    • warning

      added the new RequesterNotConnected enum value to the / response property for the response status

    • warning

      added the new RequesterNotConnected enum value to the / response property for the response status

    • warning

      added the new RequesterNotConnected enum value to the / response property for the response status

    • warning

      added the new RequesterNotConnected enum value to the // response property for the response status