Remove a grant from an asset type
DELETE /asset_types/{ref}/acls/{principal_type}/{principal_id}/{permission}
Removes one grant from an asset type: the one with exactly this principal type, principal id and level. Other grants, including other levels for the same principal, stay.
You need to be signed in with system.asset_types.admin or
system.admin granted globally; others get 403. When no grant
matches, including on a second request or for a ref with no type,
the answer is 404.
principal_type and permission match in any case. principal_id
isn’t checked, only matched exactly as stored, so write it as the
list shows it. Expired grants can be removed too.
While the type has any grant left, even an expired one, it stays
restricted: it’s listed for holders of system.admin granted
globally and for people covered by a remaining grant that hasn’t
expired. Removing the type’s last grant, expired ones included,
shows the type to everyone again. Nobody is notified, and no
activity or audit entry is recorded. A ref that isn’t a whole
number gets a plain-text 400, and server errors a plain-text 500.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”The asset type’s ref.
The principal type of the grant to remove, as listed.
The principal id of the grant to remove, exactly as listed.
The level of the grant to remove, as listed.
Responses
Section titled “ Responses ”The grant was removed.
Authentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}Authenticated but missing required capabilities
object
Human-readable error summary
Example
the request could not be completedResource not found
object
Human-readable error summary
Example
the request could not be completed