Sign in
Goal relationships

Add a supporting goal relationship

Creates a goal relationship by adding a supporting resource to a given goal.

Returns the newly created goal relationship record.

post/goals/{goal_gid}/addSupportingRelationship

Request

  • Base URL: https://app.asana.com/api/1.0
  • URL: https://app.asana.com/api/1.0/goals/{goal_gid}/addSupportingRelationship
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.asana.com/-/oauth_authorize, token URL https://app.asana.com/-/oauth_token)

Query parameters

opt_fieldsstring[]

This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. Properties can include nested fields. To learn more, see the input/output options guide.

Request body

Example request

{
  "data": {
    "supporting_resource": "12345",
    "insert_before": "1331",
    "insert_after": "1331"
  }
}

Response

Successfully created the goal relationship.

Example response

{
  "data": {
    "gid": "12345",
    "resource_type": "goal_relationship",
    "resource_subtype": "subgoal",
    "supporting_resource": {
      "gid": "12345",
      "resource_type": "project",
      "name": "Stuff to buy",
      "resource_subtype": "default_project"
    },
    "contribution_weight": 1,
    "supported_goal": {
      "gid": "12345",
      "resource_type": "goal",
      "name": "Grow web traffic by 30%",
      "owner": {
        "gid": "12345",
        "resource_type": "user",
        "name": "Greg Sanchez"
      }
    }
  }
}

Changes

No operation changes recorded.