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
limit
parameter to control result size - Utilize
optFields
to 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