# 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 Templatetask API
  version: 1.0.0
extends: openapi/adobe-suite-templatetask-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['/templatetask/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one template task
      effect: read
      questions:
      - How do I look up a single task inside a Workfront project template?
      - Can I pick which fields come back for one template task?
      instructions:
      - text: Get template task {id}.
        slots:
          id: path.id
      - text: Fetch template task {id} with fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templatetask/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a template task
      effect: write
      questions:
      - How do I change the duration or name of one task in a template?
      - Can I update a single template task and see selected fields afterward?
      instructions:
      - text: Edit template task {id} with the changes I give you.
        slots:
          id: path.id
      - text: Update template task {id} and return {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templatetask/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a template task
      effect: destructive
      questions:
      - What's the way to remove one task from a project template?
      - Can I force-delete a template task that has dependencies?
      instructions:
      - text: Delete template task {id}.
        slots:
          id: path.id
      - text: Force-delete template task {id} with force {force}.
        slots:
          id: path.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templatetask'].get
  update:
    x-apievangelist-phrasing:
      intent: Get several template tasks by ID
      effect: read
      questions:
      - Can I fetch multiple template tasks in one call using their IDs?
      - What's the fastest way to pull a known set of template tasks?
      instructions:
      - text: Get template tasks {ids}.
        slots:
          ids: query.id
      - text: Bulk-fetch template tasks {ids} returning {fields}.
        slots:
          ids: query.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templatetask'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit many template tasks at once
      effect: write
      questions:
      - Can I update a batch of template tasks in one request?
      - Is there a bulk edit for tasks across a project template?
      instructions:
      - text: Bulk edit the template tasks I list with my changes.
      - text: Apply my edits to several template tasks and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templatetask'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or copy a template task
      effect: write
      questions:
      - How do I add a new task to a project template?
      - Can I create a template task by copying an existing one?
      instructions:
      - text: Create a template task with the details I provide.
      - text: Create a template task as a copy of {copySourceID}.
        slots:
          copySourceID: query.copySourceID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templatetask'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete several template tasks
      effect: destructive
      questions:
      - Can I delete many template tasks with one call?
      - What's the way to bulk remove tasks from templates by ID?
      instructions:
      - text: Delete template tasks {ids}.
        slots:
          ids: query.id
      - text: Bulk force-delete template tasks {ids} with force {force}.
        slots:
          ids: query.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templatetask/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count template tasks
      effect: read
      questions:
      - How many template tasks exist across our templates?
      - Can I count only template tasks matching a condition?
      instructions:
      - text: Count all template tasks.
      - text: Count template tasks matching {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templatetask/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search template tasks
      effect: read
      questions:
      - How do I find template tasks by name or other criteria?
      - Can I sort and page template task search results?
      instructions:
      - text: Search template tasks where {filters}.
        slots:
          filters: query.filters
      - text: Search template tasks for {filters} with list options {listOptions} and fields {fields}.
        slots:
          filters: query.filters
          listOptions: query.listOptions
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templatetask/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run an aggregate report on template tasks
      effect: read
      questions:
      - Can I get a grouped summary report of template tasks?
      - What's the way to aggregate template tasks by some field?
      instructions:
      - text: Run a template task report filtered by {filters}.
        slots:
          filters: query.filters
      - text: Build a template task report for {filters} using {listOptions}.
        slots:
          filters: query.filters
          listOptions: query.listOptions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templatetask/bulkCopy'].put
  update:
    x-apievangelist-phrasing:
      intent: Copy template tasks into a template
      effect: write
      questions:
      - How do I copy a group of tasks into another project template?
      - Can copied template tasks be placed under a parent task?
      instructions:
      - text: Copy template tasks {templateTaskIDs} into template {templateID}.
        slots:
          templateTaskIDs: query.templateTaskIDs
          templateID: query.templateID
      - text: Bulk copy {templateTaskIDs} into template {templateID} under parent {parentTemplateTaskID}.
        slots:
          templateTaskIDs: query.templateTaskIDs
          templateID: query.templateID
          parentTemplateTaskID: query.parentTemplateTaskID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templatetask/bulkMove'].put
  update:
    x-apievangelist-phrasing:
      intent: Move several template tasks
      effect: write
      questions:
      - How do I move a set of tasks from one template to another?
      - Can I move multiple template tasks under a new parent at once?
      instructions:
      - text: Move template tasks {templateTaskIDs} to template {templateID}.
        slots:
          templateTaskIDs: query.templateTaskIDs
          templateID: query.templateID
      - text: Bulk move {templateTaskIDs} under parent {parentID} in template {templateID}.
        slots:
          templateTaskIDs: query.templateTaskIDs
          parentID: query.parentID
          templateID: query.templateID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templatetask/calculateDataExtension'].put
  update:
    x-apievangelist-phrasing:
      intent: Recalculate a template task's custom data
      effect: write
      questions:
      - How do I recalculate calculated custom fields on a template task?
      - Can I refresh custom form values for one template task?
      instructions:
      - text: Recalculate custom data for template task {ID}.
        slots:
          ID: query.ID
      - text: Refresh the calculated fields on template task {ID}.
        slots:
          ID: query.ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/templatetask/move'].put
  update:
    x-apievangelist-phrasing:
      intent: Move one template task
      effect: write
      questions:
      - Which call moves a single task to a different template?
      - Can I change which parent task one template task sits under?
      instructions:
      - text: Move template task {ID} to template {templateID}.
        slots:
          ID: query.ID
          templateID: query.templateID
      - text: Put template task {ID} under parent {parentID}.
        slots:
          ID: query.ID
          parentID: query.parentID
      method: generated
      generated: '2026-09-26'