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 ManagementProjectsTask ManagementTasksWorkflowArazzoWorkflows

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
getSectionsForProject
List the project's current sections to find the first one.
2
insertSection
insertSectionForProject
Insert the new section before the current first section.

Source API Descriptions

Arazzo Workflow Specification

asana-insert-section-into-project-workflow.yml 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