Sample - Asana API
POST/goals/{goal_gid}/removeSupportingRelationship

Remove a supporting goal relationship

Removes a supporting resource relationship from a goal. Provide the resource identifier in supporting_resource within the data block to identify the relationship to remove.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 body field

The supporting resource relationship to remove, wrapped in a data object.

dataobjectoptional
An object containing the required `supporting_resource` identifier of the goal, project, task, or portfolio to detach from the parent goal.

6 status codes
200Returns an empty `data` object after the supporting goal relationship is removed.
dataobjectoptional
An empty object. Some endpoints do not return an object on success. The success is conveyed through a 2-- status code and returning an empty object.
400Returned when `supporting_resource` is missing or the request is malformed.
errorsarray<object>optional
401Returned when the request does not include a valid authentication token.
errorsarray<object>optional
403Returned when the authenticated user does not have access to the goal or supporting resource.
errorsarray<object>optional
404Returned when the goal relationship or specified object does not exist, or the request does not identify a known action.
errorsarray<object>optional
500Returned when a server-side problem prevents the relationship from being removed.
errorsarray<object>optional

Error handling

A 400 is returned when supporting_resource is missing or the request is malformed. supporting_resource must identify a goal, project, task, or portfolio associated with the parent goal. A 401 is returned without valid authentication, a 403 indicates insufficient access, a 404 indicates a missing object or action, and a 500 indicates a server-side failure.