A goal relationship is an object representing the relationship between a goal and another goal, a project, or a portfolio.
GoalRelationshipCompact
Property | Type | Description |
---|---|---|
gid | string | Globally unique identifier of the resource, as a string. |
resource_type | string | The base type of this resource. |
resource_subtype | string | The 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_resource | object | The supporting resource that supports the goal. This can be either a project, task, portfolio, or goal. |
supporting_resource.gid | string | Globally unique identifier of the resource, as a string. |
supporting_resource.resource_type | string | The base type of this resource. |
supporting_resource.name | string | Name 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_weight | number | The 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
Property | Type | Description |
---|---|---|
gid | string | Globally unique identifier of the resource, as a string. |
resource_type | string | The base type of this resource. |
resource_subtype | string | The 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_resource | object | The supporting resource that supports the goal. This can be either a project, task, portfolio, or goal. |
supporting_resource.gid | string | Globally unique identifier of the resource, as a string. |
supporting_resource.resource_type | string | The base type of this resource. |
supporting_resource.name | string | Name 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_weight | number | The 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_goal | object | The goal that the supporting resource supports. |
supported_goal.gid | string | Globally unique identifier of the resource, as a string. |
supported_goal.resource_type | string | The base type of this resource. |
supported_goal.name | string | The name of the goal. |
supported_goal.owner | object | A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks. |
supported_goal.owner.gid | string | Globally unique identifier of the resource, as a string. |
supported_goal.owner.resource_type | string | The base type of this resource. |
supported_goal.owner.name | string | Read-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"
}
}
}