Asana

Asana Projects API

The Asana Projects API is a tool that allows users to programmatically interact with Asana projects, enabling them to create, update, and manage tasks and projects within the Asana platform. By leveraging the API, developers can automate workflow processes, integrate Asana with other tools and applications, and access project data in real-time.

GitHub OpenAPI
Business capability
Project Management BC-900.30

Operations 19

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 /projects List projects filtered by workspace or team · Asana Get multiple projects #
Ask an LLM
“How do I list projects across a workspace or team?”
“Can I exclude archived projects when listing projects?”
Tell an agent
List the projects in workspace {workspace}.
Show projects for team {team} where archived is {archived}.
POST /projects Create a project · Asana Create a project #
Ask an LLM
“How do I create a new project in Asana?”
“Can a project's workspace be changed after it's created?”
Tell an agent
Create a new project called {project}.
Set up a new project with these settings: {fields}.
GET /projects/{project_gid} Get a project's details · Asana Get a project #
Ask an LLM
“What does the full record for one project include?”
“Can I look up a project's owner and due date by its ID?”
Tell an agent
Show the details of project {project}.
Fetch the complete record for project {project}.
PUT /projects/{project_gid} Update a project's settings · Asana Update a project #
Ask an LLM
“How can I rename a project or change its owner?”
“Can I archive a project by updating it?”
Tell an agent
Archive project {project}.
Update project {project} with {changes}.
DELETE /projects/{project_gid} Delete a project · Asana Delete a project #
Ask an LLM
“What happens when I delete a project?”
“Can I remove a project permanently through the API?”
Tell an agent destructive · confirm first
Delete project {project}.
Remove project {project} for good.
POST /projects/{project_gid}/duplicate Duplicate a project · Asana Duplicate a project #
Ask an LLM
“Can I copy a whole project including its tasks and members?”
“Does duplicating a project return a job I have to poll?”
Tell an agent
Duplicate project {project} as {new_project}.
Make a copy of project {project}.
GET /tasks/{task_gid}/projects List the projects a task belongs to · Asana Get projects a task is in #
Ask an LLM
“Which projects is a given task part of?”
“Can I see every project a task has been multi-homed into?”
Tell an agent
List the projects that task {task} is in.
Show which projects contain task {task}.
GET /teams/{team_gid}/projects List a team's projects · Asana Get a team's projects #
Ask an LLM
“What projects does a particular team own?”
“Can I list only a team's archived projects?”
Tell an agent
List the projects for team {team}.
Show team {team}'s projects with archived set to {archived}.
POST /teams/{team_gid}/projects Create a project shared with a team · Asana Create a project in a team #
Ask an LLM
“How do I create a project that belongs to a specific team?”
“Can I make a new project directly under a team?”
Tell an agent
Create a project named {project} in team {team}.
Start a new team project for team {team} with {fields}.
GET /workspaces/{workspace_gid}/projects List all projects in a workspace · Asana Get all projects in a workspace #
Ask an LLM
“Can I get every project in a workspace in one list?”
“Why might listing all of a large workspace's projects time out?”
Tell an agent
List all projects in workspace {workspace}.
Show workspace {workspace}'s projects where archived is {archived}.
POST /workspaces/{workspace_gid}/projects Create a project in a workspace · Asana Create a project in a workspace #
Ask an LLM
“Do I need to supply a team when creating a project in an organization workspace?”
“How do I create a project scoped directly to a workspace?”
Tell an agent
Create a project named {project} in workspace {workspace}.
Add a new workspace project to {workspace} with {fields}.
POST /projects/{project_gid}/addCustomFieldSetting Add a custom field to a project · Asana Add a custom field to a project #
Ask an LLM
“How do I attach a custom field to a project?”
“Can I make a custom field important on a project when I add it?”
Tell an agent
Add custom field {custom_field} to project {project}.
Attach the field {custom_field} to project {project}'s columns.
POST /projects/{project_gid}/removeCustomFieldSetting Remove a custom field from a project · Asana Remove a custom field from a project #
Ask an LLM
“Can I detach a custom field from a project without deleting the field?”
“What's the way to drop a custom field column from one project?”
Tell an agent
Remove custom field {custom_field} from project {project}.
Detach field {custom_field} from project {project}.
GET /projects/{project_gid}/task_counts Count a project's tasks · Asana Get task count of a project #
Ask an LLM
“How many tasks, completed and incomplete, does a project have?”
“Why does the task count come back empty unless I opt in to fields?”
Tell an agent
Count the tasks in project {project}.
Get completed and incomplete task counts for project {project} with fields {fields}.
POST /projects/{project_gid}/addMembers Add members to a project · Asana Add users to a project #
Ask an LLM
“How do I give users access to a project?”
“Will adding someone as a project member also make them a follower?”
Tell an agent
Add members {users} to project {project}.
Give users {users} membership in project {project}.
POST /projects/{project_gid}/removeMembers Remove members from a project · Asana Remove users from a project #
Ask an LLM
“Can I take users out of a project's membership?”
“How do I revoke someone's membership in a project?”
Tell an agent
Remove members {users} from project {project}.
Take users {users} off project {project}'s member list.
POST /projects/{project_gid}/addFollowers Add followers to a project · Asana Add followers to a project #
Ask an LLM
“How do I get users notified when tasks are added to a project?”
“Can I make project members follow the project?”
Tell an agent
Add followers {users} to project {project}.
Have {users} follow project {project} for new-task notifications.
POST /projects/{project_gid}/removeFollowers Remove followers from a project · Asana Remove followers from a project #
Ask an LLM
“Does removing a project follower also remove their membership?”
“How do I stop users from following a project?”
Tell an agent
Remove followers {users} from project {project}.
Stop {users} following project {project} but keep them as members.
POST /projects/{project_gid}/saveAsTemplate Save a project as a project template · Asana Create a project template from a project #
Ask an LLM
“Can I turn an existing project into a reusable template?”
“Is creating a template from a project an asynchronous job?”
Tell an agent
Save project {project} as a template named {template}.
Create a project template from project {project}.

Documentation

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

Specifications

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

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/asana/refs/heads/main/json-schema/asana-project-json-schema.json

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-projects-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-projects-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 Projects 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 (404 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/asana/refs/heads/main/openapi/asana-projects-api-openapi.yml