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

Add a supporting goal relationship

Creates a goal relationship by adding a supporting resource to a goal. Provide the supporting resource's identifier in supporting_resource, and optionally use insert_before, insert_after, and contribution_weight to control placement and progress contribution.

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

1 parameter · 1 body field
opt_fieldsarray<string>optional
Comma-separated response properties to include, including nested fields such as `supported_goal.name` and `supporting_resource.resource_subtype`. Values must be selected from the documented optional properties.

The supporting resource to add to the goal, wrapped in a data object.

dataobjectoptional
An object containing the required `supporting_resource` identifier and optional `insert_before`, `insert_after`, and `contribution_weight` values.

6 status codes
200Returns the newly created goal relationship record.
dataobjectoptional
400Returned when `supporting_resource` is missing, a value is malformed, or mutually exclusive placement fields are both provided.
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 or supporting resource 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 created.
errorsarray<object>optional

Error handling

A 400 is returned when supporting_resource is missing or a request value is malformed. supporting_resource must identify a goal, project, task, or portfolio, and insert_before and insert_after cannot both be provided. A 401 is returned without valid authentication, a 403 indicates insufficient access, a 404 indicates a missing goal or resource, and a 500 indicates a server-side failure.