Goal relationships

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


GoalRelationshipCompact

A Compact object reflects the default fields returned after a successful API request. See input/output options to include more fields in the response.

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
contribution_weightnumberThe weight that the supporting resource's progress contributes to the supported goal's progress. This can be any value between 0 and 1 (inclusive).
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.
supporting_resourceobjectThe supporting resource that supports the goal. This can be either a project, 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.
{
  "gid": "12345",
  "resource_type": "goal_relationship",
  "contribution_weight": 1,
  "resource_subtype": "subgoal",
  "supporting_resource": {
    "gid": "12345",
    "resource_type": "project",
    "name": "Stuff to buy"
  }
}

GoalRelationship

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
contribution_weightnumberThe weight that the supporting resource's progress contributes to the supported goal's progress. This can be any value between 0 and 1 (inclusive).
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.
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.
ownerobject¦nullA user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
owner.gidstringGlobally unique identifier of the resource, as a string.
owner.resource_typestringThe base type of this resource.
owner.namestringRead-only except when same user as requester. The user’s name.
supporting_resourceobjectThe supporting resource that supports the goal. This can be either a project, 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.
{
  "gid": "12345",
  "resource_type": "goal_relationship",
  "contribution_weight": 1,
  "resource_subtype": "subgoal",
  "supported_goal": {
    "gid": "12345",
    "resource_type": "goal",
    "name": "Grow web traffic by 30%",
    "owner": {
      "gid": "12345",
      "resource_type": "user",
      "name": "Greg Sanchez"
    }
  },
  "supporting_resource": {
    "gid": "12345",
    "resource_type": "project",
    "name": "Stuff to buy"
  }
}
Asana Home
Asana helps you manage projects, focus on what's important, and organize work in one place for seamless collaboration.
© 2023 Asana, Inc.