Skip to main content
HTTP API connector An HTTP API described by an OpenAPI spec, not an MCP server. Calls go to https://app.asana.com/api/1.0 and carry an OAuth 2.0 token obtained with Sign in with Asana on the cloud edition, or an API key or custom header on a self-hosted installation, which offers no sign-in flow.

​
What the skill can do

API connector: 189 actions, as they appear in the skill panel. 101 of them create, change or delete something in Asana; mark those under These actions need approval when you add the skill to an agent.
  • Goal and portfolio management (26): Relationships Management Get Goal Relationships, Goals Management Get Goal By Id, Goals Management Get Compact Goals, Goals Management Add Followers To Goal, Goals Management Get Parent Goals, Goals Management Remove Followers From Goal, Goals Management Set Goal Metric, Portfolios Management Get Portfolio By Id, Relationships Management Add Supporting Relationship, Goals Management Update Metric Current Value, Goals Management Update Goal, Portfolios Management Update Portfolio, Portfolios Management Get Portfolio Items, Portfolios Management Add Members To Portfolio, and 12 more
  • Task and story management (24): Events Management Get All Events Since Sync Token, Tasks Management Get Tasks For Section, Project Templates Instantiate Project From Template, Tasks Management Get Tasks For Project, Tasks Management Get Filtered Tasks, Tasks Management Create New Task, Stories Management Get Story By Id, Stories Management Update Story, Tasks Management Get Tasks For Tag, Tasks Management Get Task By Id, Tasks Management Update Task, Tasks Management Add Followers To Task, Tasks Management Create New Subtask, Tasks Management Set Parent Task, and 10 more
  • Resource details management (21): Allocations Management Get Allocation By Id, Custom Fields Management Get Custom Field By Id, Attachments Management Get Attachment By Id, Goal Relationships Management Get Goal Relationship By Id, Jobs Management Get Job By Id, Organization Exports Get Export Details, Project Briefs Get Project Brief By Id, Project Templates Get Project Template By Id, Project Statuses Get Project Status By Id, Sections Management Get Section By Id, Tags Management Get Tag By Id, Task Templates Get Task Template By Id, Time Periods Get Time Period By Id, User Task Lists Get User Task List By Id, and 7 more
  • Resource creation management (19): Allocations Management Create New Allocation, Attachments Management Upload Attachment, Custom Fields Management Create New Custom Field, Goals Management Create New Goal, Organization Exports Create Export Request, Memberships Management Create New Membership, Portfolios Management Create New Portfolio, Project Statuses Create New Project Status, Sections Management Create New Section, Projects Management Create New Project, Project Briefs Create New Project Brief, Tags Management Create New Tag, Status Updates Create New Status Update, Projects Management Create Project For Workspace, and 5 more
  • Resource removal management (17): Allocations Management Delete Allocation, Attachments Management Delete Attachment, Custom Fields Management Delete Custom Field, Goals Management Delete Goal, Portfolios Management Delete Portfolio, Project Briefs Delete Project Brief, Project Statuses Delete Project Status, Project Templates Delete Project Template, Projects Management Delete Project, Sections Management Delete Section, Stories Management Delete Story, Tags Management Delete Tag, Status Updates Delete Status Update, Task Templates Delete Task Template, and 3 more
  • Resource listing management (16): Allocations Management Get Allocations By Project Or User, Attachments Management Get Attachments By Parent, Batch Requests Make Multiple Requests In Parallel, Project Templates Get Project Templates, Projects Management Duplicate Project, Project Statuses Get Project Statuses, Sections Management Get Project Sections, Projects Management Get Task Counts, Projects Management Save Project As Template, Task Templates Instantiate Task From Template, Tags Management Get Filtered Tags, Task Templates Get Task Templates, Tags Management Get Tags For Task, Project Templates Get Team Project Templates, and 2 more
  • Team and membership management (14): Portfolios Management Get Portfolios For User, Projects Management Get Filtered Projects, Teams Management Get Teams For User, Custom Fields Get Custom Fields For Workspace, Get Team Memberships For Team, Time Periods Get Time Periods, Workspace Memberships Get Workspace Memberships For User, Projects Management Get Projects For Workspace, Workspace Memberships Get Workspace Memberships, Projects Management Get Projects For Team, Webhooks Management Get Webhooks For User, Workspace Memberships Get Workspace Membership By Id, Memberships Get Team Memberships, Memberships Get Team Memberships For User
  • Resource update management (12): Allocations Management Update Allocation, Custom Fields Management Update Custom Field, Custom Fields Management Update Enum Option, Goal Relationships Management Update Goal Relationship, Project Briefs Update Project Brief, Rules Management Trigger Rule, Sections Management Update Section, Tags Management Update Tag, Time Tracking Entries Update Time Tracking Entry, Webhooks Management Update Webhook, Teams Management Update Team, Workspaces Management Update Workspace
  • User and workspace management (12): Teams Management Remove User From Team, Audit Log Api Get Audit Log Events, Workspaces Management Remove User From Workspace, Users Management Get All Users, Users Management Get User Favorites, Teams Management Get Teams For Workspace, Typeahead Search Get Typeahead Results, Teams Management Add User To Team, Workspaces Management Get All Workspaces, Workspaces Management Add User To Workspace, Users Management Get Users For Workspace, Users Management Get Users For Team
  • Resource modification management (11): Goal Relationships Management Remove Supporting Relationship, Sections Management Add Task To Section, Sections Management Move Sections, Tasks Management Add Dependents To Task, Tasks Management Remove Task From Project, Tasks Management Add Dependencies To Task, Tasks Management Remove Dependencies From Task, Tasks Management Remove Dependents From Task, Tasks Management Add Task To Project, Tasks Management Add Tag To Task, Tasks Management Remove Tag From Task
  • Membership details management (10): Memberships Management Delete Membership, Memberships Management Update Membership, Portfolio Memberships Get Portfolio Membership By Id, Memberships Management Get Goal Or Project Memberships, Memberships Management Get Membership By Id, Portfolio Memberships Get Portfolio Memberships For User, Project Memberships Get Project Membership By Id, Portfolio Memberships Get Portfolio Memberships For Portfolio, Project Memberships Get Project Memberships, Team Memberships Get Team Membership By Id
  • Custom field and enum management (7): Fields Management Create Enum Option, Fields Management Move Enum Option, Portfolios Management Add Item To Portfolio, Portfolios Management Remove Item From Portfolio, Portfolios Management Remove Custom Field Setting, Portfolios Management Add Custom Field Setting, Projects Management Remove Custom Field Setting

​
Authentication Options

​
Generate an Asana API Key

  1. Log in to your Asana developer console.
  2. Click Create New Token and give your token a name. Img 1
  3. Your access token will be displayed, make sure to copy and store it securely.

​
Connect Asana in xpander

  1. In Xpander Chat, open the agent’s settings and click Add skill.
  2. Search for Asana and select it.
  3. Click Other auth options.
  4. Enter a connection name, e.g., “xpander-asana”.
  5. Choose Organization access (one shared account) or Personal (your own account, so the agent acts with your permissions where systems allow). On an agent other people use, a personal connection runs their requests as you unless the binding requires each person’s own sign-in; see whose credential a shared agent uses.
  6. Choose API Key as the authentication method.
  7. Paste your Asana access token into the provided field.
  8. Set the Type to Bearer.
  9. Click Connect.

​
Give an agent the Asana skill

Once Asana is connected, any agent you can edit may be given the skill: open the agent’s settings, click Add skill, and choose Asana. The skill panel lists the Asana actions by group. Enable only the groups the agent needs, and mark the actions that should wait for a named person’s sign-off under These actions need approval. Which skills exist for your organization, and who may add them, is decided by your admins; see Skills.