API Evangelist conversational phrasing for Adobe Workfront Externalsection API

# 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 Externalsection API
  version: 1.0.0
extends: openapi/adobe-suite-externalsection-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: 14
- target: $.paths['/externalsection/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one external section by ID
      effect: read
      questions:
      - How do I look up a single external page section in Workfront?
      - Can I choose which fields are returned for one external section?
      instructions:
      - text: Show me external section {id}.
        slots:
          id: path.id
      - text: Get external section {id} returning only {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalsection/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit an external section
      effect: write
      questions:
      - How do I change the settings of an existing external page section?
      - Can I update the URL or name of one embedded external section?
      instructions:
      - text: Update external section {id} with the new settings I give you.
        slots:
          id: path.id
      - text: Edit external section {id} and return {fields} after saving.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalsection/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an external section
      effect: destructive
      questions:
      - How do I remove one embedded external page section?
      - Can I force the removal of an external section that is still in use?
      instructions:
      - text: Delete external section {id}.
        slots:
          id: path.id
      - text: Force remove external section {id} even if it is referenced.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalsection'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch several external sections by ID
      effect: read
      questions:
      - Can I retrieve a batch of external sections using a list of IDs?
      - Is there a way to load many external page sections in one request?
      instructions:
      - text: Fetch external sections {ids} together.
        slots:
          ids: query.id
      - text: Load the external sections with IDs {ids} and include {fields}.
        slots:
          ids: query.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalsection'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk edit external sections
      effect: write
      questions:
      - Can I update many external page sections in a single bulk call?
      - How do I mass-change settings across external sections?
      instructions:
      - text: Bulk update these external sections with my changes.
      - text: Mass edit the external sections and return {fields} for each.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalsection'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or copy an external section
      effect: write
      questions:
      - How do I add a new external page section that embeds another site?
      - Can I create an external section by copying an existing one?
      instructions:
      - text: Create a new external section with the URL and name I provide.
      - text: Copy external section {source} into a new one.
        slots:
          source: query.copySourceID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalsection'].delete
  update:
    x-apievangelist-phrasing:
      intent: Bulk delete external sections
      effect: destructive
      questions:
      - Can I delete several external page sections at once?
      - Is there a bulk removal for external sections?
      instructions:
      - text: Delete all of external sections {ids}.
        slots:
          ids: query.id
      - text: Remove the batch of external sections {ids} in one request.
        slots:
          ids: query.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalsection/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count external sections
      effect: read
      questions:
      - How many external page sections are configured?
      - Can I count only the external sections matching a filter?
      instructions:
      - text: Count all external sections.
      - text: Tell me how many external sections match {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalsection/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search external sections
      effect: read
      questions:
      - How do I find external sections that match certain criteria?
      - Can I sort and page through external section search results?
      instructions:
      - text: Search external sections where {filters}.
        slots:
          filters: query.filters
      - text: Find external sections matching {filters} and show {fields}.
        slots:
          filters: query.filters
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalsection/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run an aggregated report on external sections
      effect: read
      questions:
      - Can I get grouped report data about external sections?
      - What report options can summarize external section records?
      instructions:
      - text: Run an external section report for {filters}.
        slots:
          filters: query.filters
      - text: Produce an aggregated external sections report with options {options}.
        slots:
          options: query.listOptions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalsection/calculateIframeURL'].put
  update:
    x-apievangelist-phrasing:
      intent: Build the iframe URL for one external section
      effect: write
      questions:
      - How do I get the resolved iframe URL an external section will embed for an object?
      - Can I compute the embedded frame address for a section on a specific record?
      instructions:
      - text: Calculate the iframe URL for external section {section} on {obj_type} {obj}.
        slots:
          section: query.externalSectionID
          obj_type: query.objCode
          obj: query.objID
      - text: Resolve the embedded frame address of section {section}.
        slots:
          section: query.externalSectionID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalsection/calculateIframeURLS'].put
  update:
    x-apievangelist-phrasing:
      intent: Build iframe URLs for several external sections
      effect: write
      questions:
      - Can I compute the iframe URLs for multiple external sections at once?
      - Is there a batch way to resolve embedded frame addresses for many sections on one record?
      instructions:
      - text: Calculate iframe URLs for external sections {sections} on {obj_type} {obj}.
        slots:
          sections: query.externalSectionIDs
          obj_type: query.objCode
          obj: query.objID
      - text: Resolve all embedded frame links for sections {sections} in one call.
        slots:
          sections: query.externalSectionIDs
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalsection/calculateURL'].put
  update:
    x-apievangelist-phrasing:
      intent: Resolve the plain URL of one external section
      effect: write
      questions:
      - How do I get the final target URL, not the iframe version, for an external section?
      - Can I resolve the link an external section points to for a given object?
      instructions:
      - text: Calculate the target URL of external section {section} for {obj_type} {obj}.
        slots:
          section: query.externalSectionID
          obj_type: query.objCode
          obj: query.objID
      - text: Work out the plain link external section {section} opens.
        slots:
          section: query.externalSectionID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/externalsection/calculateURLS'].put
  update:
    x-apievangelist-phrasing:
      intent: Resolve plain URLs for several external sections
      effect: write
      questions:
      - Can I resolve the target links of several external sections together?
      - Is there a batch call that returns the non-iframe URLs for many sections?
      instructions:
      - text: Calculate the target URLs of sections {sections} for {obj_type} {obj}.
        slots:
          sections: query.externalSectionIDs
          obj_type: query.objCode
          obj: query.objID
      - text: Work out the plain links for external sections {sections} at once.
        slots:
          sections: query.externalSectionIDs
      method: generated
      generated: '2026-09-26'