Goal relationships

A goal relationship is an object representing the relationship between a goal and another goal, a project, or a portfolio.


GoalRelationshipCompact

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
resource_subtypestringThe subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning. Values can be: subgoal, supporting_work.
supporting_resourceobjectThe supporting resource that supports the goal. This can be either a project, task, portfolio, or goal.
supporting_resource.gidstringGlobally unique identifier of the resource, as a string.
supporting_resource.resource_typestringThe base type of this resource.
supporting_resource.namestringName of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
contribution_weightnumberThe weight that the supporting resource's progress contributes to the supported goal's progress. This can be 0, 1, or any value in between.

Example JSON for GoalRelationshipCompact:

{
  "gid": "12345",
  "resource_type": "goal_relationship",
  "resource_subtype": "subgoal",
  "supporting_resource": {
    "gid": "12345",
    "resource_type": "project",
    "name": "Stuff to buy"
  },
  "contribution_weight": 1
}

GoalRelationship

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
resource_subtypestringThe subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning. Values can be: subgoal, supporting_work.
supporting_resourceobjectThe supporting resource that supports the goal. This can be either a project, task, portfolio, or goal.
supporting_resource.gidstringGlobally unique identifier of the resource, as a string.
supporting_resource.resource_typestringThe base type of this resource.
supporting_resource.namestringName of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
contribution_weightnumberThe weight that the supporting resource's progress contributes to the supported goal's progress. This can be 0, 1, or any value in between.
supported_goalobjectThe goal that the supporting resource supports.
supported_goal.gidstringGlobally unique identifier of the resource, as a string.
supported_goal.resource_typestringThe base type of this resource.
supported_goal.namestringThe name of the goal.
supported_goal.ownerobjectA user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
supported_goal.owner.gidstringGlobally unique identifier of the resource, as a string.
supported_goal.owner.resource_typestringThe base type of this resource.
supported_goal.owner.namestringRead-only except when same user as requester. The user’s name.

Example JSON for GoalRelationship:

{
  "gid": "12345",
  "resource_type": "goal_relationship",
  "resource_subtype": "subgoal",
  "supporting_resource": {
    "gid": "12345",
    "resource_type": "project",
    "name": "Stuff to buy"
  },
  "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"
    }
  }
}
Asana Home
Asana helps you manage projects, focus on what's important, and organize work in one place for seamless collaboration.
© 2023 Asana, Inc.