Asana · Arazzo Workflow

Asana Insert a Section Into a Project

Version 1.0.0

List a project's sections, then insert a new section at the top of the board.

1 workflow 1 source API 1 provider
View Spec View on GitHub CollaborationProductivityProject ManagementProjectTask ManagementTaskWorkflowsArazzoWorkflows

Provider

asana

Workflows

insert-section-into-project
Insert a new section at the top of a project's board.
Lists a project's sections, then inserts a new section before the first existing section.
2 steps inputs: projectGid, sectionName outputs: projectGid, sectionGid
1
listSections
List the project's current sections to find the first one.
2
insertSection
Insert the new section before the current first section.

Source API Descriptions

Arazzo Workflow Specification

Raw ↑
arazzo: 1.0.1
info:
  title: Asana Insert a Section Into a Project
  summary: List a project's sections, then insert a new section at the top of the board.
  description: >-
    A board-ordering flow. The workflow lists the existing sections of a project
    to capture the current first section and then inserts a new section before
    it, placing the new section at the top of the board. Each request is written
    inline so the ordering can be read and executed without opening the
    underlying OpenAPI description.
  version: 1.0.0
sourceDescriptions:
- name: sectionsApi
  url: ../openapi/asana-sections-api-openapi.yml
  type: openapi
workflows:
- workflowId: insert-section-into-project
  summary: Insert a new section at the top of a project's board.
  description: >-
    Lists a project's sections, then inserts a new section before the first
    existing section.
  inputs:
    type: object
    required:
    - projectGid
    - sectionName
    properties:
      projectGid:
        type: string
        description: Project gid to insert the section into.
      sectionName:
        type: string
        description: Name of the section to insert.
  steps:
  - stepId: listSections
    description: List the project's current sections to find the first one.
    operationId: getSectionsForProject
    parameters:
    - name: project_gid
      in: path
      value: $inputs.projectGid
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      firstSectionGid: $response.body#/data/0/gid
  - stepId: insertSection
    description: Insert the new section before the current first section.
    operationId: insertSectionForProject
    parameters:
    - name: project_gid
      in: path
      value: $inputs.projectGid
    requestBody:
      contentType: application/json
      payload:
        data:
          name: $inputs.sectionName
          before_section: $steps.listSections.outputs.firstSectionGid
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      sectionGid: $response.body#/data/gid
  outputs:
    projectGid: $inputs.projectGid
    sectionGid: $steps.insertSection.outputs.sectionGid

Work with this as data

Every workflow 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 arazzo workflows

4 MCP tools reach this
  • find_arazzoBrowse and filter every workflow in the catalog.
  • 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 workflow
curl "https://apis.io/api/v1/arazzo/asana-insert-section-into-project-workflow"
All arazzo workflows
curl "https://apis.io/api/v1/arazzo?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.

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