​
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

​
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
Example Usage:
“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 workspace
  • optFields (string, optional): Comma-separated fields to include
  • limit (number, optional): Maximum number of teams to return
Example Usage:
“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 workspace
  • optFields (string, optional): Comma-separated fields to include
  • limit (number, optional): Maximum number of projects to return
Example Usage:
“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 workspace
  • optFields (string, optional): Comma-separated fields to include
  • limit (number, optional): Maximum number of tasks to return
  • projectGid (string, optional): Filter tasks by project
  • assigneeGid (string, optional): Filter tasks by assignee
Example Usage:
“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 task
  • workspaceGid (string, required): Globally unique identifier for the workspace
  • notes (string, optional): The notes/description of the task
  • assigneeGid (string, optional): The assignee of the task
  • dueOn (string, optional): Due date (YYYY-MM-DD format)
  • projectGid (string, optional): The project to add the task to
Example Usage:
“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 task
  • name (string, optional): New name for the task
  • notes (string, optional): Updated notes
  • assigneeGid (string, optional): New assignee
  • dueOn (string, optional): New due date (YYYY-MM-DD format)
  • completed (boolean, optional): Mark task as completed
Example Usage:
“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 query
  • workspaceGid (string, required): Globally unique identifier for the workspace
  • optFields (string, optional): Comma-separated fields to include
  • limit (number, optional): Maximum number of tasks to return
Example Usage:
“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 user
  • optFields (string, optional): Comma-separated fields to include
Example Usage:
“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 workspace
  • optFields (string, optional): Comma-separated fields to include
  • limit (number, optional): Maximum number of tags to return
Example Usage:
“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 project
  • workspaceGid (string, required): Globally unique identifier for the workspace
  • notes (string, optional): Project description
  • teamGid (string, optional): The team to add the project to
  • color (string, optional): The color of the project
  • privacy_setting (string, optional): Privacy setting (public, private, secret)
Example Usage:
“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

1. List workspaces to identify your main workspace
2. Get tasks assigned to you
3. Update task status as you work
4. Mark tasks as completed
5. Create new tasks for tomorrow

​
Example 2: Project Setup

1. Create a new project in the appropriate team
2. Add initial tasks to the project
3. Assign tasks to team members
4. Set due dates for milestones
5. Add relevant tags for organization

​
Troubleshooting

IssueSolution
”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
  • Jira - For software development tracking
  • Linear - For modern issue tracking
  • Monday.com - For visual work management

​
Support

For additional help with the Asana integration, contact support@langdock.com