Asana

Asana Sections API

The Asana Sections API provides developers with the ability to programmatically interact with and manage sections within Asana projects. This API allows users to create, update, and delete sections as well as retrieve information about existing sections. By utilizing the Sections API, developers can streamline project management processes, automate tasks, and integrate Asana with other third-party applications.

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 /sections/{section_gid} Get a section's details · Asana Get a section #
Ask an LLM
“What does a single section's record contain?”
“Can I look up which project a section belongs to?”
Tell an agent
Show section {section}.
Fetch the details of section {section}.
PUT /sections/{section_gid} Rename a section · Asana Update a section #
Ask an LLM
“How do I rename a section or board column?”
“Can I change a section's name without touching its tasks?”
Tell an agent
Rename section {section} to {name}.
Update section {section} with {changes}.
DELETE /sections/{section_gid} Delete an empty section · Asana Delete a section #
Ask an LLM
“Can I delete a section that still has tasks in it?”
“Is it possible to delete the last remaining section of a project?”
Tell an agent destructive · confirm first
Delete section {section}.
Remove the empty section {section}.
GET /projects/{project_gid}/sections List the sections in a project · Asana Get sections in a project #
Ask an LLM
“What sections or board columns does a project have?”
“Can I list a project's sections in order?”
Tell an agent
List the sections in project {project}.
Show the board columns of project {project}.
POST /projects/{project_gid}/sections Create a section in a project · Asana Create a section in a project #
Ask an LLM
“How do I add a new section or column to a project?”
“Can I place a new section before or after an existing one?”
Tell an agent
Create a section named {name} in project {project}.
Add a new column to project {project} with {fields}.
POST /sections/{section_gid}/addTask Move a task into a section · Asana Add task to section #
Ask an LLM
“How do I move a task into a different section?”
“Where in the section does a moved task end up?”
Tell an agent
Move task {task} into section {section}.
Put task {task} into board column {section}.
POST /projects/{project_gid}/sections/insert Reorder sections in a project · Asana Move or Insert sections #
Ask an LLM
“Can I move one section above or below another?”
“Is it possible to move a section to a different project?”
Tell an agent
Reorder sections in project {project} using {placement}.
Move a section within project {project} as {placement}.

Documentation

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

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/asana/refs/heads/main/openapi/asana-sections-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-sections-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-sections-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 Sections 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 (53 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/asana/refs/heads/main/openapi/asana-sections-api-openapi.yml