Skip to navigation

Remove workspace access from an asset

Beta

Remove the workspace-wide share from an asset, so members of the workspace no longer get access through it. Needs edit access to the asset. Removing a folder’s share also removes it from the assets inside the folder. People and groups the asset is shared with directly keep their access. Calling it on an asset with no workspace share, or on one in the trash, succeeds with the same answer.

Authentication

X-API-KEYstring
API Key authentication via header

Path parameters

asset_idstringRequired
Unique identifier of the asset

Headers

X-Athena-Session-CredentialstringOptional

Response

Workspace share removed
asset_idstring
ID of the asset
workspace_accessstring

Workspace access level now on the asset: ‘view’, ‘edit’, or ‘none’ when the workspace-wide share was removed

Errors

403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error