GuidesAPI Reference
API Reference

Revoke access to a resource from an entity

delete
https://Use API Lookup for a base URL/grants/resources//entities//actions/

Revoke access to a resource from an entity. The result of this call is that the specified entity will have any directly assigned permission to take the specified action against the specified resource removed.


Access Control:

  • The calling principal must have either "removeGrant:{actionId}" or "share" action permission for the resource "{resourceHrn}" in the "authorization" service.
  • The realm of the calling principal MUST match the realm of the requested entity.
  • The calling principal MUST NOT include a project scope.
Path Params
string
required

The hrn that identifies the resource

string
required

The target entityId to revoke access from

string
required

The action against the resource to revoke access from

Query Params
string
required

The type of the entity to revoke access from. Must be one of user, app, or group

Responses

400

Illegal entity ID.
Illegal action value.
Invalid HERE Resource Name format.
Entity type is required.
Illegal entity type.

403

You do not have permission to perform this action.
Reserved resource prefix is required for this action.
Realm of the entity does not match the realm of the caller.
Realm not found.

404

Resource or App not found

Updated 2 months ago

Language
Credentials
Bearer
JWT
Response 
Click Try It! to start a request and see the response here! Or choose an example:
*/*
application/json
Updated 2 months ago