# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Adobe Workfront Kanbanboard API
  version: 1.0.0
extends: openapi/adobe-suite-kanbanboard-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 10
- target: $.paths['/kanbanboard/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one Kanban board
      effect: read
      questions:
      - How do I get the details of one Workfront Kanban board?
      - Can I pick which fields come back for a single board?
      instructions:
      - text: Show Kanban board {id}.
        slots:
          id: path.id
      - text: Get board {id} with fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/kanbanboard/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update one Kanban board
      effect: write
      questions:
      - Can I rename or reconfigure an existing Kanban board?
      - What's the call to edit a single board by ID?
      instructions:
      - text: Edit Kanban board {id} with my changes.
        slots:
          id: path.id
      - text: Update board {id} and return {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/kanbanboard/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one Kanban board
      effect: destructive
      questions:
      - How do I delete a Kanban board I no longer use?
      - Is there a force option when deleting a board?
      instructions:
      - text: Delete Kanban board {id}.
        slots:
          id: path.id
      - text: Force delete board {id} with force={force}.
        slots:
          id: path.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/kanbanboard'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch several Kanban boards by ID
      effect: read
      questions:
      - Can I retrieve several Kanban boards at once by their IDs?
      - Which call returns a specific list of boards?
      instructions:
      - text: Fetch Kanban boards {id}.
        slots:
          id: query.id
      - text: Get boards {id} showing only {fields}.
        slots:
          id: query.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/kanbanboard'].put
  update:
    x-apievangelist-phrasing:
      intent: Update many Kanban boards at once
      effect: write
      questions:
      - Is there a bulk edit for Kanban boards?
      - Can I change several boards in a single request?
      instructions:
      - text: Bulk edit these Kanban boards with my changes.
      - text: Apply updates to many boards and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/kanbanboard'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Kanban board
      effect: write
      questions:
      - How do I set up a new Kanban board for my team?
      - Can I create a board programmatically?
      instructions:
      - text: Create a new Kanban board with the name I give.
      - text: Add a board and return the fields {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/kanbanboard'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete many Kanban boards
      effect: destructive
      questions:
      - Can I bulk delete Kanban boards by ID?
      - Is there a way to remove several boards together?
      instructions:
      - text: Delete Kanban boards {id}.
        slots:
          id: query.id
      - text: Bulk force delete boards {id} with force={force}.
        slots:
          id: query.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/kanbanboard/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count Kanban boards
      effect: read
      questions:
      - How many Kanban boards match a filter?
      - Can I get the total number of boards?
      instructions:
      - text: Count Kanban boards matching {filters}.
        slots:
          filters: query.filters
      - text: Tell me how many boards there are.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/kanbanboard/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search Kanban boards
      effect: read
      questions:
      - How do I find Kanban boards by name or owner?
      - Can I search boards with paging options?
      instructions:
      - text: Search Kanban boards where {filters}.
        slots:
          filters: query.filters
      - text: Find boards matching {filters} and return {fields}.
        slots:
          filters: query.filters
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/kanbanboard/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run an aggregate report on Kanban boards
      effect: read
      questions:
      - Can I get grouped totals of Kanban boards instead of a list?
      - What returns a report-style summary of boards?
      instructions:
      - text: Run a Kanban board report filtered by {filters}.
        slots:
          filters: query.filters
      - text: Summarize boards as a report with {listOptions}.
        slots:
          listOptions: query.listOptions
      method: generated
      generated: '2026-09-26'