Overview
Asana is a comprehensive work management platform that helps teams organize, track, and manage their work. Through Langdock’s integration, you can manage workspaces, projects, tasks, and teams directly from your conversations.Authentication: OAuth
Category: Productivity & Collaboration
Availability: All workspace plans
Category: Productivity & Collaboration
Availability: All workspace plans
Available Actions
List Workspaces
asana.listWorkspaces
Get all accessible workspaces in your Asana account.
Requires Confirmation: Yes
Parameters:
limit(number, optional): Limit number of results (1-100)optFields(string, optional): Comma-separated fields to include
“List all my Asana workspaces”
Get Teams for Workspace
asana.getTeamsForWorkspace
List all teams in a specific workspace.
Requires Confirmation: Yes
Parameters:
workspaceGid(string, required): Globally unique identifier for the workspaceoptFields(string, optional): Comma-separated fields to includelimit(number, optional): Maximum number of teams to return
“Show me all teams in workspace 12345”
Get Projects for Workspace
asana.getProjectsForWorkspace
List all projects in a workspace.
Requires Confirmation: Yes
Parameters:
workspaceGid(string, required): Globally unique identifier for the workspaceoptFields(string, optional): Comma-separated fields to includelimit(number, optional): Maximum number of projects to return
“Get all projects in my marketing workspace”
Get Tasks
asana.getTasks
List tasks with optional filtering by project or assignee.
Requires Confirmation: Yes
Parameters:
workspaceGid(string, required): Globally unique identifier for the workspaceoptFields(string, optional): Comma-separated fields to includelimit(number, optional): Maximum number of tasks to returnprojectGid(string, optional): Filter tasks by projectassigneeGid(string, optional): Filter tasks by assignee
“Show me all tasks assigned to me in the Q4 Planning project”
Create Task
asana.createTask
Create a new task in Asana.
Requires Confirmation: Yes
Parameters:
name(string, required): The name of the taskworkspaceGid(string, required): Globally unique identifier for the workspacenotes(string, optional): The notes/description of the taskassigneeGid(string, optional): The assignee of the taskdueOn(string, optional): Due date (YYYY-MM-DD format)projectGid(string, optional): The project to add the task to
“Create a task ‘Review Q4 budget’ due on 2024-03-15 and assign it to john@company.com”
Update Task
asana.updateTask
Update an existing task’s details.
Requires Confirmation: Yes
Parameters:
taskGid(string, required): Globally unique identifier for the taskname(string, optional): New name for the tasknotes(string, optional): Updated notesassigneeGid(string, optional): New assigneedueOn(string, optional): New due date (YYYY-MM-DD format)completed(boolean, optional): Mark task as completed
“Mark task 123456 as completed and update the notes”
Search Tasks
asana.searchTasks
Search for tasks using natural language queries.
Requires Confirmation: Yes
Parameters:
query(string, required): The search queryworkspaceGid(string, required): Globally unique identifier for the workspaceoptFields(string, optional): Comma-separated fields to includelimit(number, optional): Maximum number of tasks to return
“Search for all tasks mentioning ‘budget review’ in the Finance workspace”
Get User
asana.getUser
Get detailed information about a specific user.
Requires Confirmation: Yes
Parameters:
userGid(string, required): Globally unique identifier for the useroptFields(string, optional): Comma-separated fields to include
“Get information about user 789012”
Get Tags in Workspace
asana.getTagsInWorkspace
List all tags available in a workspace.
Requires Confirmation: Yes
Parameters:
workspaceGid(string, required): Globally unique identifier for the workspaceoptFields(string, optional): Comma-separated fields to includelimit(number, optional): Maximum number of tags to return
“Show all tags in the Marketing workspace”
Create Project
asana.createProject
Create a new project in a workspace.
Requires Confirmation: Yes
Parameters:
name(string, required): The name of the projectworkspaceGid(string, required): Globally unique identifier for the workspacenotes(string, optional): Project descriptionteamGid(string, optional): The team to add the project tocolor(string, optional): The color of the projectprivacy_setting(string, optional): Privacy setting (public, private, secret)
“Create a new project called ‘Q1 Marketing Campaign’ in the Marketing team”
Common Use Cases
Project Management
- Create and organize projects
- Track project progress
- Manage project timelines
Task Tracking
- Create and assign tasks
- Update task status
- Set due dates and priorities
Team Collaboration
- Organize teams and workspaces
- Assign work to team members
- Track team productivity
Workflow Automation
- Search and filter tasks
- Bulk update task properties
- Generate status reports
Best Practices
Performance Tips:
- Use
limitparameter to control result size - Utilize
optFieldsto reduce data transfer - Cache workspace and project GIDs for repeated use
- Use search for complex filtering needs
Important Considerations:
- GIDs are permanent unique identifiers
- Due dates must be in YYYY-MM-DD format
- Completed tasks remain in the system
- Rate limits apply per OAuth token
Workflow Examples
Example 1: Daily Task Management
Example 2: Project Setup
Troubleshooting
| Issue | Solution |
|---|---|
| ”Workspace not found” | Verify workspace GID using List Workspaces |
| ”Invalid date format” | Use YYYY-MM-DD format for dates |
| ”Permission denied” | Check OAuth token permissions |
| ”Task not found” | Ensure task GID is correct and accessible |
Related Integrations
- Jira - For software development tracking
- Linear - For modern issue tracking
- Monday.com - For visual work management