Project Management Bearer Token

Asana REST API

Project management API for tasks, projects, and teams

Asana is a web and mobile work management platform that helps teams organize, track, and manage their work. The Asana REST API enables developers to programmatically access and manipulate tasks, projects, portfolios, teams, and workspaces. Developers use this API to build custom integrations, automate workflows, sync data with other tools, and create tailored project management solutions that extend Asana's capabilities.

Base URL https://app.asana.com/api/1.0

API Endpoints

Method	Endpoint	Description
GET	`/tasks/{task_gid}`	Returns the complete task record for a single task
POST	`/tasks`	Creates a new task in a workspace or project
PUT	`/tasks/{task_gid}`	Updates an existing task with new field values
DELETE	`/tasks/{task_gid}`	Deletes a task and removes it from all projects
GET	`/projects/{project_gid}/tasks`	Returns all tasks within a specific project
GET	`/projects/{project_gid}`	Returns the complete record for a single project
POST	`/projects`	Creates a new project in a workspace or team
GET	`/workspaces`	Returns all workspaces the authenticated user has access to
GET	`/users/me`	Returns the full user record for the currently authenticated user
GET	`/teams/{team_gid}`	Returns the complete record for a single team
POST	`/tasks/{task_gid}/subtasks`	Creates a new subtask and adds it to the parent task
POST	`/tasks/{task_gid}/stories`	Adds a comment or story to a task
GET	`/portfolios/{portfolio_gid}`	Returns the complete portfolio record with its projects
POST	`/webhooks`	Creates a webhook to receive real-time notifications about resource changes
GET	`/tasks/{task_gid}/attachments`	Returns all attachments associated with a task

Code Examples

curl -X GET 'https://app.asana.com/api/1.0/tasks/1234567890' \
  -H 'Authorization: Bearer 0/1a2b3c4d5e6f7g8h9i0j' \
  -H 'Accept: application/json'

const response = await fetch('https://app.asana.com/api/1.0/tasks/1234567890', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer 0/1a2b3c4d5e6f7g8h9i0j',
    'Accept': 'application/json'
  }
});

const data = await response.json();
console.log(data);

import requests

url = 'https://app.asana.com/api/1.0/tasks/1234567890'
headers = {
    'Authorization': 'Bearer 0/1a2b3c4d5e6f7g8h9i0j',
    'Accept': 'application/json'
}

response = requests.get(url, headers=headers)
data = response.json()
print(data)

Connect Asana to AI

Deploy a Asana MCP server on IOX Cloud and connect it to Claude, ChatGPT, Cursor, or any AI client. Your AI assistant gets direct access to Asana through these tools:

create_task Create a new task in Asana with specified name, description, assignee, due date, and project

update_task_status Update the completion status or custom field values of an existing task

get_project_tasks Retrieve all tasks from a specific project with filtering and sorting options

add_task_comment Add a comment or update to a task's activity stream

search_tasks Search for tasks across workspaces using text queries, assignee, due date, and other filters

Deploy in 60 seconds

Describe what you need, AI generates the code, and IOX deploys it globally.

Deploy Asana MCP Server →

Asana REST API

API Endpoints

Code Examples

Connect Asana to AI

Deploy in 60 seconds

Related APIs