Skip to content

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.

ref
required
integer format: int64

The asset type’s ref.

principal_type
required
string
Allowed values: user role team

The principal type of the grant to remove, as listed.

principal_id
required
string
<= 64 characters

The principal id of the grant to remove, exactly as listed.

permission
required
string
Allowed values: read write admin

The level of the grant to remove, as listed.

The grant was removed.

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed