Asana

Asana Workspaces API

The Asana Workspaces API allows users to access and manipulate data within their Asana workspaces programmatically. With this API, developers can create custom integrations, automate tasks, and build workflow solutions that enhance productivity and collaboration within the Asana platform. Users can retrieve, add, update, and delete projects, tasks, and other elements within their workspace, as well as manage user permissions and notifications.

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

GET /workspaces/{workspace_gid}/tags List the tags in a workspace · Asana Get tags in a workspace #
Ask an LLM
“What tags already exist in a given workspace?”
“Can I page through a workspace's tags?”
Tell an agent
List the tags in workspace {workspace}.
Show all tags defined in workspace {workspace}.
POST /workspaces/{workspace_gid}/tags Create a tag in a specific workspace · Asana Create a tag in a workspace #
Ask an LLM
“How do I create a tag scoped to a particular workspace by its ID?”
“Can a tag be moved to another workspace once created?”
Tell an agent
Create tag {tag} in workspace {workspace}.
Add a new label {tag} to workspace {workspace}.
GET /workspaces List my workspaces · Asana Get multiple workspaces #
Ask an LLM
“Which workspaces and organizations can I access?”
“How do I find my workspace ID?”
Tell an agent
List my workspaces.
Show every workspace and organization I can see.
GET /workspaces/{workspace_gid} Get a workspace's details · Asana Get a workspace #
Ask an LLM
“Is a given workspace an organization?”
“What email domains are tied to a workspace?”
Tell an agent
Show workspace {workspace}.
Fetch the details of workspace {workspace}.
PUT /workspaces/{workspace_gid} Rename a workspace · Asana Update a workspace #
Ask an LLM
“Can I change a workspace's name?”
“Which workspace settings are editable?”
Tell an agent
Rename workspace {workspace} to {name}.
Update workspace {workspace} with {changes}.
POST /workspaces/{workspace_gid}/addUser Add a user to a workspace · Asana Add a user to a workspace or organization #
Ask an LLM
“How do I invite someone to my workspace by email?”
“Can I add a user to an organization using their user ID?”
Tell an agent
Add {user} to workspace {workspace}.
Invite {email} to organization {workspace}.
POST /workspaces/{workspace_gid}/removeUser Remove a user from a workspace · Asana Remove a user from a workspace or organization #
Ask an LLM
“Do I need to be an admin to remove someone from a workspace?”
“Can I remove a user from an organization by email address?”
Tell an agent destructive · confirm first
Remove {user} from workspace {workspace}.
Take {email} out of organization {workspace}.

Documentation

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

Specifications

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

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/asana/refs/heads/main/json-schema/asana-workspace-json-schema.json

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-workspaces-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-workspaces-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 Workspaces 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 (59 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/asana/refs/heads/main/openapi/asana-workspaces-api-openapi.yml