# 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 Calendarsection API
  version: 1.0.0
extends: openapi/adobe-suite-calendarsection-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: 12
- target: $.paths['/calendarsection/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a single calendar section
      effect: read
      questions:
      - How do I look up one Workfront calendar section by ID?
      - Can I choose which fields come back for one calendar section?
      instructions:
      - text: Show me calendar section {id}.
        slots:
          id: path.id
      - text: Get calendar section {id} with only {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calendarsection/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit one calendar section
      effect: write
      questions:
      - Can I change the color or filter of one calendar section?
      - What's the way to update a single calendar section?
      instructions:
      - text: Edit calendar section {id} with my changes.
        slots:
          id: path.id
      - text: Update calendar section {id} and return {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calendarsection/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one calendar section
      effect: destructive
      questions:
      - How do I remove a single section from a calendar?
      - Is there a force option when deleting one calendar section?
      instructions:
      - text: Delete calendar section {id}.
        slots:
          id: path.id
      - text: Force-delete calendar section {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calendarsection'].get
  update:
    x-apievangelist-phrasing:
      intent: Get several calendar sections by ID
      effect: read
      questions:
      - Can I fetch several calendar sections at once by their IDs?
      - Is there a bulk get for calendar sections?
      instructions:
      - text: Fetch calendar sections {id} in one call.
        slots:
          id: query.id
      - text: Bulk-get calendar sections {id} returning {fields}.
        slots:
          id: query.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calendarsection'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit many calendar sections at once
      effect: write
      questions:
      - Can I update a batch of calendar sections in one request?
      - What's the bulk edit for calendar sections?
      instructions:
      - text: Bulk-edit these calendar sections with my changes.
      - text: Apply edits to several calendar sections and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calendarsection'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a calendar section
      effect: write
      questions:
      - How do I add a new section to a Workfront calendar?
      - What does creating a calendar section return?
      instructions:
      - text: Create a new calendar section.
      - text: Add a calendar section and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calendarsection'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete many calendar sections at once
      effect: destructive
      questions:
      - Can I delete a list of calendar sections in one call?
      - Is there a bulk delete for calendar sections?
      instructions:
      - text: Bulk-delete calendar sections {id}.
        slots:
          id: query.id
      - text: 'Force-delete all of these calendar sections: {id}.'
        slots:
          id: query.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calendarsection/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count calendar sections
      effect: read
      questions:
      - How many calendar sections exist across our calendars?
      - Can I count only calendar sections that match a filter?
      instructions:
      - text: Count all calendar sections.
      - text: Count calendar sections matching {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calendarsection/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search calendar sections
      effect: read
      questions:
      - Which calendar sections belong to a given calendar?
      - Can I page through calendar section search results?
      instructions:
      - text: Search calendar sections where {filters}.
        slots:
          filters: query.filters
      - text: Find calendar sections matching {filters} showing only {fields}.
        slots:
          filters: query.filters
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calendarsection/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run a report on calendar sections
      effect: read
      questions:
      - Can I get an aggregated report of calendar sections?
      - What list options does the calendar section report accept?
      instructions:
      - text: Run a calendar section report.
      - text: Build a calendar section report filtered by {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calendarsection/getConcatenatedExpressionForm'].put
  update:
    x-apievangelist-phrasing:
      intent: Get a calendar filter expression in concatenated form
      effect: read
      questions:
      - Can I convert a calendar section filter expression into its concatenated form?
      - What does the concatenated version of a calendar expression look like?
      instructions:
      - text: Convert calendar expression {expression} to concatenated form.
        slots:
          expression: query.expression
      - text: Give me the concatenated form of {expression}.
        slots:
          expression: query.expression
      method: generated
      generated: '2026-09-26'
- target: $.paths['/calendarsection/getPrettyExpressionForm'].put
  update:
    x-apievangelist-phrasing:
      intent: Get a readable form of a calendar expression
      effect: read
      questions:
      - Can I turn a calendar section expression into a human-readable form?
      - Is there a way to pretty-print a calendar filter expression?
      instructions:
      - text: Pretty-print calendar expression {expression}.
        slots:
          expression: query.expression
      - text: Show a readable version of expression {expression}.
        slots:
          expression: query.expression
      method: generated
      generated: '2026-09-26'