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)

Use Asana from Claude / Cursor / ChatGPT

Get a hosted MCP endpoint for Asana. Paste your Asana API key, copy back one URL, drop it into Claude Desktop, Cursor, or any AI client that supports remote MCP. Your AI calls Asana directly with your credentials — no local install, works on mobile.

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

Connect in 60 seconds

Paste your Asana key → get an MCP URL → paste into Claude/Cursor. Hosted by IOX, encrypted at rest.

Connect Asana to your AI →

Asana REST API

API Endpoints

Sponsor this page

Code Examples

Use Asana from Claude / Cursor / ChatGPT

Connect in 60 seconds

Related APIs