Asana

Asana Teams API

Asana Teams API is a powerful tool that allows users to automate and streamline their team's workflow within the Asana platform. By utilizing this API, developers can create custom integrations and applications that enhance collaboration, communication, and productivity for teams. This API enables users to access and manipulate tasks, projects, calendars, and other essential features within Asana, making it easy to tailor the platform to fit the specific needs and preferences of each team.

GitHub OpenAPI

Operations 7

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /teams Create a team · Asana Create a team #
Ask an LLM
“How do I create a new team in my organization?”
“Can I set a team's description when creating it?”
Tell an agent
Create a team named {team}.
Set up a new team with {fields}.
GET /teams/{team_gid} Get a team's details · Asana Get a team #
Ask an LLM
“What does a team's full record include?”
“Can I look up a team's name and description by ID?”
Tell an agent
Show team {team}.
Fetch the details of team {team}.
PUT /teams/{team_gid} Update a team · Asana Update a team #
Ask an LLM
“Can I rename a team or change its visibility?”
“Which team settings can be edited?”
Tell an agent
Rename team {team} to {name}.
Update team {team} with {changes}.
GET /workspaces/{workspace_gid}/teams List the teams in a workspace · Asana Get teams in a workspace #
Ask an LLM
“What teams exist in my organization?”
“Which teams can I see in a workspace?”
Tell an agent
List the teams in workspace {workspace}.
Show all visible teams in organization {workspace}.
GET /users/{user_gid}/teams List the teams a user belongs to · Asana Get teams for a user #
Ask an LLM
“Which teams is a particular person on?”
“Can I see a user's teams within one organization?”
Tell an agent
List the teams user {user} is on in organization {organization}.
Show which teams {user} belongs to in {organization}.
POST /teams/{team_gid}/addUser Add a user to a team · Asana Add a user to a team #
Ask an LLM
“How do I add someone to a team?”
“Do I have to be a team member myself to add others?”
Tell an agent
Add user {user} to team {team}.
Put {user} on team {team}.
POST /teams/{team_gid}/removeUser Remove a user from a team · Asana Remove a user from a team #
Ask an LLM
“Can I take someone off a team?”
“Can I remove myself from a team?”
Tell an agent
Remove user {user} from team {team}.
Take {user} off team {team}.

Documentation

📖
Documentation
https://developers.asana.com/reference/teams

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/asana/refs/heads/main/openapi/asana-teams-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/asana:asana-teams-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

asana-teams-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: This is the interface for interacting with the Asana Platform. Our API reference is generated from our [OpenAPI spec] (https://raw.githubusercontent.com/Asana/openapi/master/defs/asana_oas.yaml).
  x-public-description: This is the interface for interacting with the [Asana Platform](https://developers.asana.com). Our API reference is generated from our [OpenAPI spec] (https://raw.githubusercontent.com/Asana/openapi/master/defs/asana_oas.yaml).
  title: Asana Teams API
  termsOfService: https://asana.com/terms
  contact:
    name: Asana Support
    url: https://asana.com/support
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
  version: '1.0'
  x-docs-schema-whitelist:
  - AsanaResource
  - AsanaNamedResource
  - AuditLogEvent
  - AttachmentResponse
  - AttachmentCompact
  - BatchResponse
  - CustomFieldSettingResponse
  - CustomFieldSettingCompact
  - CustomFieldResponse
  - CustomFieldCompact
  - EnumOption
  - EventResponse
  - ErrorResponse
  - GoalResponse
  - GoalCompact
  - GoalMembershipCompact
  - GoalMembershipBase
  - GoalMembershipResponse
  - GoalRelationshipResponse
  - GoalRelationshipCompact
  - JobResponse
  - JobCompact
  - OrganizationExportResponse
  - OrganizationExportCompact
  - PortfolioMembershipResponse
  - PortfolioMembershipCompact
  - PortfolioResponse
  - PortfolioCompact
  - ProjectBriefResponse
  - ProjectBriefCompact
  - ProjectMembershipCompactResponse
  - ProjectMembershipNormalResponse
  - ProjectMembershipCompact
  - ProjectResponse
  - ProjectCompact
  - ProjectStatusResponse
  - ProjectStatusCompact
  - ProjectTemplateCompact
  - ProjectTemplateResponse
  - RuleTriggerResponse
  - SectionResponse
  - SectionCompact
  - StatusUpdateResponse
  - StatusUpdateCompact
  - StoryResponse
  - StoryCompact
  - TagResponse
  - TagCompact
  - TaskResponse
  - TaskCompact
  - TaskCountResponse
  - TeamMembershipResponse
  - TeamMembershipCompact
  - TeamResponse
  - TeamCompact
  - TimePeriodResponse
  - TimePeriodCompact
  - UserTaskListResponse
  - UserTaskListCompact
  - UserResponse
  - UserCompact
  - WebhookFilter
  - WebhookResponse
  - WebhookCompact
  - WorkspaceMembershipResponse
  - WorkspaceMembershipCompact
  - WorkspaceResponse
  - WorkspaceCompact
servers:
- url: https://app.asana.com/api/1.0
  description: Main endpoint.
security:
- personalAccessToken: []
- oauth2: []
tags:


# --- truncated at 32 KB (68 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/asana/refs/heads/main/openapi/asana-teams-api-openapi.yml