# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Asana Sections API
  version: 1.0.0
extends: openapi/asana-sections-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 7
- target: $.paths['/sections/{section_gid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a section's details
      effect: read
      questions:
      - What does a single section's record contain?
      - Can I look up which project a section belongs to?
      instructions:
      - text: Show section {section}.
        slots:
          section: path.section_gid
      - text: Fetch the details of section {section}.
        slots:
          section: path.section_gid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sections/{section_gid}'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename a section
      effect: write
      questions:
      - How do I rename a section or board column?
      - Can I change a section's name without touching its tasks?
      instructions:
      - text: Rename section {section} to {name}.
        slots:
          section: path.section_gid
          name: requestBody.data
      - text: Update section {section} with {changes}.
        slots:
          section: path.section_gid
          changes: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sections/{section_gid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an empty section
      effect: destructive
      questions:
      - Can I delete a section that still has tasks in it?
      - Is it possible to delete the last remaining section of a project?
      instructions:
      - text: Delete section {section}.
        slots:
          section: path.section_gid
      - text: Remove the empty section {section}.
        slots:
          section: path.section_gid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/projects/{project_gid}/sections'].get
  update:
    x-apievangelist-phrasing:
      intent: List the sections in a project
      effect: read
      questions:
      - What sections or board columns does a project have?
      - Can I list a project's sections in order?
      instructions:
      - text: List the sections in project {project}.
        slots:
          project: path.project_gid
      - text: Show the board columns of project {project}.
        slots:
          project: path.project_gid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/projects/{project_gid}/sections'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a section in a project
      effect: write
      questions:
      - How do I add a new section or column to a project?
      - Can I place a new section before or after an existing one?
      instructions:
      - text: Create a section named {name} in project {project}.
        slots:
          project: path.project_gid
          name: requestBody.data
      - text: Add a new column to project {project} with {fields}.
        slots:
          project: path.project_gid
          fields: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/sections/{section_gid}/addTask'].post
  update:
    x-apievangelist-phrasing:
      intent: Move a task into a section
      effect: write
      questions:
      - How do I move a task into a different section?
      - Where in the section does a moved task end up?
      instructions:
      - text: Move task {task} into section {section}.
        slots:
          section: path.section_gid
          task: requestBody.data
      - text: Put task {task} into board column {section}.
        slots:
          section: path.section_gid
          task: requestBody.data
      method: generated
      generated: '2026-10-01'
- target: $.paths['/projects/{project_gid}/sections/insert'].post
  update:
    x-apievangelist-phrasing:
      intent: Reorder sections in a project
      effect: write
      questions:
      - Can I move one section above or below another?
      - Is it possible to move a section to a different project?
      instructions:
      - text: Reorder sections in project {project} using {placement}.
        slots:
          project: path.project_gid
          placement: requestBody.data
      - text: Move a section within project {project} as {placement}.
        slots:
          project: path.project_gid
          placement: requestBody.data
      method: generated
      generated: '2026-10-01'