Asana

Asana Goals API

The Asana Goals API is a powerful tool that allows developers to programmatically interact with and manipulate goals within the Asana platform. By utilizing the API, users can create, update, and track progress on goals, as well as set key results and milestones to measure success. This enables teams to align on business objectives, monitor performance, and adjust strategies as needed.

GitHub OpenAPI
Business capability
Strategy Execution Management BC-100.20

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /goals/{goal_gid} Get a goal's details · Asana Get a goal #
Ask an LLM
“What does the full record of a goal show?”
“Can I look up a goal's owner, status and metric by ID?”
Tell an agent
Show the details of goal {goal}.
Fetch goal {goal}.
PUT /goals/{goal_gid} Update a goal · Asana Update a goal #
Ask an LLM
“How do I change a goal's status, owner or due date?”
“Do fields I leave out of a goal update stay the same?”
Tell an agent
Set goal {goal}'s status to {status}.
Update goal {goal} with {changes}.
DELETE /goals/{goal_gid} Delete a goal · Asana Delete a goal #
Ask an LLM
“Can I delete a goal that's no longer relevant?”
“What does deleting a goal return?”
Tell an agent destructive · confirm first
Delete goal {goal}.
Remove goal {goal} permanently.
GET /goals List goals by team, project or time period · Asana Get goals #
Ask an LLM
“Which goals does a team have this quarter?”
“Can I list only workspace-level goals?”
Tell an agent
List goals for team {team} in time periods {periods}.
Show workspace-level goals in workspace {workspace}.
POST /goals Create a goal · Asana Create a goal #
Ask an LLM
“How do I create a new goal for my team?”
“Can a goal be created at the workspace level instead of under a team?”
Tell an agent
Create a goal named {goal} in my workspace.
Set a new team goal with {fields}.
POST /goals/{goal_gid}/setMetric Set the metric that tracks a goal · Asana Create a goal metric #
Ask an LLM
“How do I attach a numeric target to a goal?”
“Will setting a metric replace one the goal already has?”
Tell an agent
Set a metric on goal {goal} with target {metric}.
Replace goal {goal}'s metric with {metric}.
POST /goals/{goal_gid}/setMetricCurrentValue Record a goal metric's current value · Asana Update a goal metric #
Ask an LLM
“How do I report progress on a goal's metric?”
“What happens if I update the current value on a goal with no metric?”
Tell an agent
Set goal {goal}'s current metric value to {value}.
Record progress of {value} on goal {goal}.
POST /goals/{goal_gid}/addFollowers Add collaborators to a goal · Asana Add a collaborator to a goal #
Ask an LLM
“How do I add collaborators to a goal?”
“Can several people follow a goal?”
Tell an agent
Add collaborators {followers} to goal {goal}.
Have {followers} follow goal {goal}.
POST /goals/{goal_gid}/removeFollowers Remove collaborators from a goal · Asana Remove a collaborator from a goal #
Ask an LLM
“Can I take a collaborator off a goal?”
“How do I stop people following a goal?”
Tell an agent
Remove collaborators {followers} from goal {goal}.
Stop {followers} following goal {goal}.
GET /goals/{goal_gid}/parentGoals List a goal's parent goals · Asana Get parent goals from a goal #
Ask an LLM
“Which higher-level goals does this goal roll up to?”
“Can I see the parent goals of a goal?”
Tell an agent
List the parent goals of goal {goal}.
Show what goal {goal} rolls up into.

Documentation

📖
Documentation
https://developers.asana.com/reference/goals

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/asana/refs/heads/main/openapi/asana-goals-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/asana:asana-goals-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

asana-goals-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: This is the interface for interacting with the Asana Platform. Our API reference is generated from our [OpenAPI spec] (https://raw.githubusercontent.com/Asana/openapi/master/defs/asana_oas.yaml).
  x-public-description: This is the interface for interacting with the [Asana Platform](https://developers.asana.com). Our API reference is generated from our [OpenAPI spec] (https://raw.githubusercontent.com/Asana/openapi/master/defs/asana_oas.yaml).
  title: Asana Goals API
  termsOfService: https://asana.com/terms
  contact:
    name: Asana Support
    url: https://asana.com/support
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
  version: '1.0'
  x-docs-schema-whitelist:
  - AsanaResource
  - AsanaNamedResource
  - AuditLogEvent
  - AttachmentResponse
  - AttachmentCompact
  - BatchResponse
  - CustomFieldSettingResponse
  - CustomFieldSettingCompact
  - CustomFieldResponse
  - CustomFieldCompact
  - EnumOption
  - EventResponse
  - ErrorResponse
  - GoalResponse
  - GoalCompact
  - GoalMembershipCompact
  - GoalMembershipBase
  - GoalMembershipResponse
  - GoalRelationshipResponse
  - GoalRelationshipCompact
  - JobResponse
  - JobCompact
  - OrganizationExportResponse
  - OrganizationExportCompact
  - PortfolioMembershipResponse
  - PortfolioMembershipCompact
  - PortfolioResponse
  - PortfolioCompact
  - ProjectBriefResponse
  - ProjectBriefCompact
  - ProjectMembershipCompactResponse
  - ProjectMembershipNormalResponse
  - ProjectMembershipCompact
  - ProjectResponse
  - ProjectCompact
  - ProjectStatusResponse
  - ProjectStatusCompact
  - ProjectTemplateCompact
  - ProjectTemplateResponse
  - RuleTriggerResponse
  - SectionResponse
  - SectionCompact
  - StatusUpdateResponse
  - StatusUpdateCompact
  - StoryResponse
  - StoryCompact
  - TagResponse
  - TagCompact
  - TaskResponse
  - TaskCompact
  - TaskCountResponse
  - TeamMembershipResponse
  - TeamMembershipCompact
  - TeamResponse
  - TeamCompact
  - TimePeriodResponse
  - TimePeriodCompact
  - UserTaskListResponse
  - UserTaskListCompact
  - UserResponse
  - UserCompact
  - WebhookFilter
  - WebhookResponse
  - WebhookCompact
  - WorkspaceMembershipResponse
  - WorkspaceMembershipCompact
  - WorkspaceResponse
  - WorkspaceCompact
servers:
- url: https://app.asana.com/api/1.0
  description: Main endpoint.
security:
- personalAccessToken: []
- oauth2: []
tags:


# --- truncated at 32 KB (113 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/asana/refs/heads/main/openapi/asana-goals-api-openapi.yml