Asana

Overview
Allocations
Attachments
Audit log API
- Get audit log eventsget
Batch API
- Submit parallel requestspost
Custom fields
Custom field settings
- Get a project's custom fieldsget
- Get a portfolio's custom fieldsget
Custom types
- Get all custom types associated with an objectget
Events
- Get events on a resourceget
Goals
Goal relationships
Jobs
- Get a job by idget
Memberships
Organization exports
- Create an organization export requestpost
- Get details on an org export requestget
Portfolios
Portfolio memberships
Projects
Project briefs
Project memberships
- Get a project membershipget
- Get memberships from a projectget
Project statuses
Project templates
Rules
- Trigger a rulepost
Sections
Status updates
Stories
Tags
Tasks
Task templates
Teams
Team memberships
Time periods
- Get a time periodget
- Get time periodsget
Time tracking entries
Typeahead
- Get objects via typeaheadget
Users
User task lists
- Get a user task listget
- Get a user's task listget
Webhooks
Workspaces
Workspace memberships

App Components

Overview
Modal forms
Rule actions
Lookups
- Attach resourcepost
- Get lookup typeahead resultsget
Widgets
- Get widget metadataget

Asana

Overview
Allocations
Attachments
Audit log API
- Get audit log eventsget
Batch API
- Submit parallel requestspost
Custom fields
Custom field settings
- Get a project's custom fieldsget
- Get a portfolio's custom fieldsget
Custom types
- Get all custom types associated with an objectget
Events
- Get events on a resourceget
Goals
Goal relationships
Jobs
- Get a job by idget
Memberships
Organization exports
- Create an organization export requestpost
- Get details on an org export requestget
Portfolios
Portfolio memberships
Projects
Project briefs
Project memberships
- Get a project membershipget
- Get memberships from a projectget
Project statuses
Project templates
Rules
- Trigger a rulepost
Sections
Status updates
Stories
Tags
Tasks
Task templates
Teams
Team memberships
Time periods
- Get a time periodget
- Get time periodsget
Time tracking entries
Typeahead
- Get objects via typeaheadget
Users
User task lists
- Get a user task listget
- Get a user's task listget
Webhooks
Workspaces
Workspace memberships

App Components

Overview
Modal forms
Rule actions
Lookups
- Attach resourcepost
- Get lookup typeahead resultsget
Widgets
- Get widget metadataget

Get parent goals from a goal

get https://app.asana.com/api/1.0/goals/{goal_gid}/parentGoals

Required scope: goals:read

Returns a compact representation of all of the parent goals of a goal.

📘
Customizing the response
Requests to this endpoint return "compact" goal objects (schema) by default. To include more fields in the response, see input/output options.

Path Params

goal_gid

string

required

Globally unique identifier for the goal.

Query Params

opt_fields

array of strings

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.

opt_fields

opt_pretty

boolean

Provides “pretty” output.
Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.

Responses

Response body

object

data

array of objects

data

object

gid

string

Globally unique identifier of the resource, as a string.

resource_type

string

The base type of this resource.

name

string

The name of the goal.

owner

object | null

A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.

Response body

object

errors

array of objects

errors

object

message

string

Message providing more detail about the error that occurred, if available.

help

string

Additional information directing developers to resources on how to address and fix the problem, if available.

phrase

string

500 errors only. A unique error phrase which can be used when contacting developer support to help identify the exact occurrence of the problem in Asana's logs.

Response body

object

errors

array of objects

errors

object

message

string

Message providing more detail about the error that occurred, if available.

help

string

Additional information directing developers to resources on how to address and fix the problem, if available.

phrase

string

500 errors only. A unique error phrase which can be used when contacting developer support to help identify the exact occurrence of the problem in Asana's logs.

Response body

object

errors

array of objects

errors

object

message

string

Message providing more detail about the error that occurred, if available.

help

string

Additional information directing developers to resources on how to address and fix the problem, if available.

phrase

string

500 errors only. A unique error phrase which can be used when contacting developer support to help identify the exact occurrence of the problem in Asana's logs.

Response body

object

errors

array of objects

errors

object

message

string

Message providing more detail about the error that occurred, if available.

help

string

Additional information directing developers to resources on how to address and fix the problem, if available.

phrase

string

500 errors only. A unique error phrase which can be used when contacting developer support to help identify the exact occurrence of the problem in Asana's logs.

Response body

object

errors

array of objects

errors

object

message

string

Message providing more detail about the error that occurred, if available.

help

string

Additional information directing developers to resources on how to address and fix the problem, if available.

phrase

string

500 errors only. A unique error phrase which can be used when contacting developer support to help identify the exact occurrence of the problem in Asana's logs.

Response body

object

errors

array of objects

errors

object

message

string

Message providing more detail about the error that occurred, if available.

help

string

Additional information directing developers to resources on how to address and fix the problem, if available.

phrase

string

500 errors only. A unique error phrase which can be used when contacting developer support to help identify the exact occurrence of the problem in Asana's logs.

Updated 24 days ago

Remove a collaborator from a goal

Goal relationships

Did this page help you?

Language

Credentials

OAuth2

Bearer

Request


xxxxxxxxxx
1
curl --request GET \
2
     --url https://app.asana.com/api/1.0/goals/goal_gid/parentGoals \
3
     --header 'accept: application/json'


xxxxxxxxxx
14
 
1
{
2
  "data": [
3
    {
4
      "gid": "12345",
5
      "resource_type": "goal",
6
      "name": "Grow web traffic by 30%",
7
      "owner": {
8
        "gid": "12345",
9
        "resource_type": "user",
10
        "name": "Greg Sanchez"
11
      }
12
    }
13
  ]
14
}

Updated 24 days ago

Remove a collaborator from a goal

Goal relationships

Did this page help you?

Asana
Overview
Allocations
Create an allocationpost
Get multiple allocationsget
Delete an allocationdelete
Update an allocationput
Get an allocationget
Attachments
Upload an attachmentpost
Get attachments from an objectget
Delete an attachmentdelete
Get an attachmentget
Audit log API
Get audit log eventsget
Batch API
Submit parallel requestspost
Custom fields
Update an enum optionput
Reorder a custom field's enumpost
Create an enum optionpost
Get a workspace's custom fieldsget
Delete a custom fielddelete
Update a custom fieldput
Get a custom fieldget
Create a custom fieldpost
Custom field settings
Get a portfolio's custom fieldsget
Get a project's custom fieldsget
Custom types
Get all custom types associated with an objectget
Events
Get events on a resourceget
Goals
Get parent goals from a goalget
Remove a collaborator from a goalpost
Add a collaborator to a goalpost
Update a goal metricpost
Create a goal metricpost
Create a goalpost
Get goalsget
Delete a goaldelete
Update a goalput
Get a goalget
Goal relationships
Removes a supporting goal relationshippost
Add a supporting goal relationshippost
Get goal relationshipsget
Update a goal relationshipput
Get a goal relationshipget
Jobs
Get a job by idget
Memberships
Delete a membershipdelete
Update a membershipput
Get a membershipget
Create a membershippost
Get multiple membershipsget
Organization exports
Get details on an org export requestget
Create an organization export requestpost
Portfolios
Remove users from a portfoliopost
Add users to a portfoliopost
Remove a custom field from a portfoliopost
Add a custom field to a portfoliopost
Remove a portfolio itempost
Add a portfolio itempost
Get portfolio itemsget
Delete a portfoliodelete
Update a portfolioput
Get a portfolioget
Create a portfoliopost
Get multiple portfoliosget
Portfolio memberships
Get memberships from a portfolioget
Get a portfolio membershipget
Get multiple portfolio membershipsget
Projects
Create a project template from a projectpost
Remove followers from a projectpost
Add followers to a projectpost
Remove users from a projectpost
Add users to a projectpost
Get task count of a projectget
Remove a custom field from a projectpost
Add a custom field to a projectpost
Create a project in a workspacepost
Get all projects in a workspaceget
Create a project in a teampost
Get a team's projectsget
Get projects a task is inget
Duplicate a projectpost
Delete a projectdelete
Update a projectput
Get a projectget
Create a projectpost
Get multiple projectsget
Project briefs
Create a project briefpost
Delete a project briefdelete
Update a project briefput
Get a project briefget
Project memberships
Get memberships from a projectget
Get a project membershipget
Project statuses
Create a project statuspost
Get statuses from a projectget
Delete a project statusdelete
Get a project statusget
Project templates
Instantiate a project from a project templatepost
Get a team's project templatesget
Get multiple project templatesget
Delete a project templatedelete
Get a project templateget
Rules
Trigger a rulepost
Sections
Move or Insert sectionspost
Add task to sectionpost
Create a section in a projectpost
Get sections in a projectget
Delete a sectiondelete
Update a sectionput
Get a sectionget
Status updates
Create a status updatepost
Get status updates from an objectget
Delete a status updatedelete
Get a status updateget
Stories
Create a story on a taskpost
Get stories from a taskget
Delete a storydelete
Update a storyput
Get a storyget
Tags
Create a tag in a workspacepost
Get tags in a workspaceget
Get a task's tagsget
Delete a tagdelete
Update a tagput
Get a tagget
Create a tagpost
Get multiple tagsget
Tasks
Search tasks in a workspaceget
Get a task for a given custom IDget
Remove followers from a taskpost
Add followers to a taskpost
Remove a tag from a taskpost
Add a tag to a taskpost
Remove a project from a taskpost
Add a project to a taskpost
Unlink dependents from a taskpost
Set dependents for a taskpost
Get dependents from a taskget
Unlink dependencies from a taskpost
Set dependencies for a taskpost
Get dependencies from a taskget
Set the parent of a taskpost
Create a subtaskpost
Get subtasks from a taskget
Get tasks from a user task listget
Get tasks from a tagget
Get tasks from a sectionget
Get tasks from a projectget
Duplicate a taskpost
Delete a taskdelete
Update a taskput
Get a taskget
Create a taskpost
Get multiple tasksget
Task templates
Instantiate a task from a task templatepost
Delete a task templatedelete
Get a task templateget
Get multiple task templatesget
Teams
Remove a user from a teampost
Add a user to a teampost
Get teams for a userget
Get teams in a workspaceget
Update a teamput
Get a teamget
Create a teampost
Team memberships
Get memberships from a userget
Get memberships from a teamget
Get team membershipsget
Get a team membershipget
Time periods
Get time periodsget
Get a time periodget
Time tracking entries
Delete a time tracking entrydelete
Update a time tracking entryput
Get a time tracking entryget
Create a time tracking entrypost
Get time tracking entries for a taskget
Typeahead
Get objects via typeaheadget
Users
Get users in a workspace or organizationget
Get users in a teamget
Get a user's favoritesget
Get a userget
Get multiple usersget
User task lists
Get a user's task listget
Get a user task listget
Webhooks
Delete a webhookdelete
Update a webhookput
Get a webhookget
Establish a webhookpost
Get multiple webhooksget
Workspaces
Get workspace eventsget
Remove a user from a workspace or organizationpost
Add a user to a workspace or organizationpost
Update a workspaceput
Get a workspaceget
Get multiple workspacesget
Workspace memberships
Get the workspace memberships for a workspaceget
Get workspace memberships for a userget
Get a workspace membershipget

App Components
Overview
Modal forms
On submit callbackpost
On change callbackpost
Get modal form typeahead resultsget
Get form metadataget
Rule actions
On action submit callbackpost
On action change callbackpost
Get action metadataget
Run actionpost
Get rule action typeahead resultsget
Lookups
Get lookup typeahead resultsget
Attach resourcepost
Widgets
Get widget metadataget

Asana
Overview
Allocations
Create an allocationpost
Get multiple allocationsget
Delete an allocationdelete
Update an allocationput
Get an allocationget
Attachments
Upload an attachmentpost
Get attachments from an objectget
Delete an attachmentdelete
Get an attachmentget
Audit log API
Get audit log eventsget
Batch API
Submit parallel requestspost
Custom fields
Update an enum optionput
Reorder a custom field's enumpost
Create an enum optionpost
Get a workspace's custom fieldsget
Delete a custom fielddelete
Update a custom fieldput
Get a custom fieldget
Create a custom fieldpost
Custom field settings
Get a portfolio's custom fieldsget
Get a project's custom fieldsget
Custom types
Get all custom types associated with an objectget
Events
Get events on a resourceget
Goals
Get parent goals from a goalget
Remove a collaborator from a goalpost
Add a collaborator to a goalpost
Update a goal metricpost
Create a goal metricpost
Create a goalpost
Get goalsget
Delete a goaldelete
Update a goalput
Get a goalget
Goal relationships
Removes a supporting goal relationshippost
Add a supporting goal relationshippost
Get goal relationshipsget
Update a goal relationshipput
Get a goal relationshipget
Jobs
Get a job by idget
Memberships
Delete a membershipdelete
Update a membershipput
Get a membershipget
Create a membershippost
Get multiple membershipsget
Organization exports
Get details on an org export requestget
Create an organization export requestpost
Portfolios
Remove users from a portfoliopost
Add users to a portfoliopost
Remove a custom field from a portfoliopost
Add a custom field to a portfoliopost
Remove a portfolio itempost
Add a portfolio itempost
Get portfolio itemsget
Delete a portfoliodelete
Update a portfolioput
Get a portfolioget
Create a portfoliopost
Get multiple portfoliosget
Portfolio memberships
Get memberships from a portfolioget
Get a portfolio membershipget
Get multiple portfolio membershipsget
Projects
Create a project template from a projectpost
Remove followers from a projectpost
Add followers to a projectpost
Remove users from a projectpost
Add users to a projectpost
Get task count of a projectget
Remove a custom field from a projectpost
Add a custom field to a projectpost
Create a project in a workspacepost
Get all projects in a workspaceget
Create a project in a teampost
Get a team's projectsget
Get projects a task is inget
Duplicate a projectpost
Delete a projectdelete
Update a projectput
Get a projectget
Create a projectpost
Get multiple projectsget
Project briefs
Create a project briefpost
Delete a project briefdelete
Update a project briefput
Get a project briefget
Project memberships
Get memberships from a projectget
Get a project membershipget
Project statuses
Create a project statuspost
Get statuses from a projectget
Delete a project statusdelete
Get a project statusget
Project templates
Instantiate a project from a project templatepost
Get a team's project templatesget
Get multiple project templatesget
Delete a project templatedelete
Get a project templateget
Rules
Trigger a rulepost
Sections
Move or Insert sectionspost
Add task to sectionpost
Create a section in a projectpost
Get sections in a projectget
Delete a sectiondelete
Update a sectionput
Get a sectionget
Status updates
Create a status updatepost
Get status updates from an objectget
Delete a status updatedelete
Get a status updateget
Stories
Create a story on a taskpost
Get stories from a taskget
Delete a storydelete
Update a storyput
Get a storyget
Tags
Create a tag in a workspacepost
Get tags in a workspaceget
Get a task's tagsget
Delete a tagdelete
Update a tagput
Get a tagget
Create a tagpost
Get multiple tagsget
Tasks
Search tasks in a workspaceget
Get a task for a given custom IDget
Remove followers from a taskpost
Add followers to a taskpost
Remove a tag from a taskpost
Add a tag to a taskpost
Remove a project from a taskpost
Add a project to a taskpost
Unlink dependents from a taskpost
Set dependents for a taskpost
Get dependents from a taskget
Unlink dependencies from a taskpost
Set dependencies for a taskpost
Get dependencies from a taskget
Set the parent of a taskpost
Create a subtaskpost
Get subtasks from a taskget
Get tasks from a user task listget
Get tasks from a tagget
Get tasks from a sectionget
Get tasks from a projectget
Duplicate a taskpost
Delete a taskdelete
Update a taskput
Get a taskget
Create a taskpost
Get multiple tasksget
Task templates
Instantiate a task from a task templatepost
Delete a task templatedelete
Get a task templateget
Get multiple task templatesget
Teams
Remove a user from a teampost
Add a user to a teampost
Get teams for a userget
Get teams in a workspaceget
Update a teamput
Get a teamget
Create a teampost
Team memberships
Get memberships from a userget
Get memberships from a teamget
Get team membershipsget
Get a team membershipget
Time periods
Get time periodsget
Get a time periodget
Time tracking entries
Delete a time tracking entrydelete
Update a time tracking entryput
Get a time tracking entryget
Create a time tracking entrypost
Get time tracking entries for a taskget
Typeahead
Get objects via typeaheadget
Users
Get users in a workspace or organizationget
Get users in a teamget
Get a user's favoritesget
Get a userget
Get multiple usersget
User task lists
Get a user's task listget
Get a user task listget
Webhooks
Delete a webhookdelete
Update a webhookput
Get a webhookget
Establish a webhookpost
Get multiple webhooksget
Workspaces
Get workspace eventsget
Remove a user from a workspace or organizationpost
Add a user to a workspace or organizationpost
Update a workspaceput
Get a workspaceget
Get multiple workspacesget
Workspace memberships
Get the workspace memberships for a workspaceget
Get workspace memberships for a userget
Get a workspace membershipget

App Components
Overview
Modal forms
On submit callbackpost
On change callbackpost
Get modal form typeahead resultsget
Get form metadataget
Rule actions
On action submit callbackpost
On action change callbackpost
Get action metadataget
Run actionpost
Get rule action typeahead resultsget
Lookups
Get lookup typeahead resultsget
Attach resourcepost
Widgets
Get widget metadataget

📘Customizing the response

200Successfully retrieved the specified goal's parent goals.

400This usually occurs because of a missing or malformed parameter. Check the documentation and the syntax of your request and try again.

401A valid authentication token was not provided with the request, so the API could not associate a user with the request.

402The request was valid, but the queried object or object mutation specified in the request is above your current premium level.

403The authentication and request syntax was valid but the server is refusing to complete the request. This can happen if you try to read or write to objects or properties that the user does not have access to.

404Either the request method and path supplied do not specify a known action in the API, or the object specified by the request does not exist.

500There was a problem on Asana’s end. In the event of a server error the response body should contain an error phrase. These phrases can be used by Asana support to quickly look up the incident that caused the server error. Some errors are due to server load, and will not supply an error phrase.

📘
Customizing the response