GuidesAPI Reference
API Reference

Remove a Resource Relation(Home or Link) from a project

Remove the resource from the project. The requested resource may only be linked as a reference, or added as a home from outside of Projects. Removing other home resource requires deleting the resource from the resource service. When relation=home, A resource cannot be removed from a project if it belongs to a Resource Policy. Managers of the resource need to remove any ResourcePolicyAttachments before removing the home.


Access Control:

  • When relation=home,
    • The calling principal must have "manageResourceHome" action permission for the resource "{project}" in the "authorization" service AND all requiredToAddToProjects actions defined by the service for the specified resource.
  • When relation=reference,
    • The calling principal must have "manageResourceReferences" action permission for the resource "{project}" in the "authorization" service. If not, check if caller is a project member, otherwise check if calling principal can effectively manage the resource.
  • The calling principal MUST NOT include a project scope.
Path Params
string
required

HRN identifying the project

string
required

The hrn that identifies the resource.

Query Params
string

Delete only the linkedOption with this matching externalId. Note an empty string value for this parameter matches the linkedOption with no externalId value. If this parameter is omitted, the entire relation and all linkedOptions are removed. Only relevant when relation=reference.

string
enum
required

The relation of the resource. Must be home or reference(link)

Allowed:
Headers
string

Correlates HTTP requests between a client and server. If not present in the incoming request, it will be generated.

Responses

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