# 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 Template API
  version: 1.0.0
extends: openapi/adobe-suite-template-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: 20
- target: $.paths['/template/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a single project template
      effect: read
      questions:
      - How do I pull up one Workfront project template by its ID?
      - Can I limit which fields come back for a single template?
      instructions:
      - text: Show me template {id}.
        slots:
          id: path.id
      - text: Get template {id} with just the fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit one project template
      effect: write
      questions:
      - Can I change the details of one specific template?
      - What's the way to update a single template I already built?
      instructions:
      - text: Edit template {id} with my changes.
        slots:
          id: path.id
      - text: Update template {id} and return {fields} afterwards.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one project template
      effect: destructive
      questions:
      - How do I delete a single template?
      - Is there a force option when removing one template that is still referenced?
      instructions:
      - text: Delete template {id}.
        slots:
          id: path.id
      - text: Force-delete template {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template'].get
  update:
    x-apievangelist-phrasing:
      intent: Get several templates by ID
      effect: read
      questions:
      - Can I fetch a handful of templates at once by listing their IDs?
      - Is there a bulk get for templates?
      instructions:
      - text: Fetch templates {id} in one call.
        slots:
          id: query.id
      - text: Bulk-get templates {id} returning fields {fields}.
        slots:
          id: query.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit many templates at once
      effect: write
      questions:
      - Can I push the same edit to a batch of templates in one request?
      - What's the bulk way to update several templates?
      instructions:
      - text: Bulk-edit these templates with the changes I provide.
      - text: Apply my edits to several templates and return {fields} for each.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or copy a project template
      effect: write
      questions:
      - How do I create a new project template?
      - Can I start a new template as a copy of an existing one?
      instructions:
      - text: Create a new project template.
      - text: Create a template copied from template {copySourceID}.
        slots:
          copySourceID: query.copySourceID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete many templates at once
      effect: destructive
      questions:
      - Can I delete a list of templates in one call?
      - What's the bulk delete for templates we no longer use?
      instructions:
      - text: Bulk-delete templates {id}.
        slots:
          id: query.id
      - text: 'Force-delete all of these templates: {id}.'
        slots:
          id: query.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count project templates
      effect: read
      questions:
      - How many templates do we have in Workfront?
      - Can I count only templates matching a filter?
      instructions:
      - text: Count all templates.
      - text: Count the templates matching {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search project templates
      effect: read
      questions:
      - Which templates match a name or owner I'm looking for?
      - Can template search results be paged and trimmed to certain fields?
      instructions:
      - text: Search templates where {filters}.
        slots:
          filters: query.filters
      - text: Find templates matching {filters} and show only {fields}.
        slots:
          filters: query.filters
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run a report on project templates
      effect: read
      questions:
      - Can I get an aggregated report across our templates?
      - What list options apply to a template report?
      instructions:
      - text: Run a template report.
      - text: Build a template report filtered by {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template/{id}/share'].put
  update:
    x-apievangelist-phrasing:
      intent: Share a template with someone
      effect: write
      questions:
      - How do I share one template with a specific user or group?
      - Can I share a template but forbid certain actions on it?
      instructions:
      - text: Share template {id} with {accessorObjCode} {accessorID} at {coreAction} access.
        slots:
          id: path.id
          accessorObjCode: query.accessorObjCode
          accessorID: query.accessorID
          coreAction: query.coreAction
      - text: Give {accessorID} ({accessorObjCode}) {coreAction} rights on template {id} but forbid {forbiddenActions}.
        slots:
          accessorID: query.accessorID
          accessorObjCode: query.accessorObjCode
          coreAction: query.coreAction
          id: path.id
          forbiddenActions: query.forbiddenActions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template/share'].put
  update:
    x-apievangelist-phrasing:
      intent: Share several templates at once
      effect: write
      questions:
      - Can I share a set of templates with the same group in one call?
      - Is there a bulk way to give a specific user access to multiple templates?
      instructions:
      - text: Share templates {id} with {accessorObjCode} {accessorID} at {coreAction} access.
        slots:
          id: query.id
          accessorObjCode: query.accessorObjCode
          accessorID: query.accessorID
          coreAction: query.coreAction
      - text: Batch-share templates {id} to {accessorID} ({accessorObjCode}) with {coreAction} rights.
        slots:
          id: query.id
          accessorID: query.accessorID
          accessorObjCode: query.accessorObjCode
          coreAction: query.coreAction
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template/{id}/unshare'].put
  update:
    x-apievangelist-phrasing:
      intent: Stop sharing a template with someone
      effect: destructive
      questions:
      - How do I take away one user's access to a single template?
      - Can I unshare a template from a particular group?
      instructions:
      - text: Unshare template {id} from {accessorObjCode} {accessorID}.
        slots:
          id: path.id
          accessorObjCode: query.accessorObjCode
          accessorID: query.accessorID
      - text: Remove {accessorID}'s access to template {id} (accessor type {accessorObjCode}).
        slots:
          accessorID: query.accessorID
          id: path.id
          accessorObjCode: query.accessorObjCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template/unshare'].put
  update:
    x-apievangelist-phrasing:
      intent: Stop sharing several templates at once
      effect: destructive
      questions:
      - Can I revoke someone's access to many templates in one request?
      - Is there a batch unshare for templates?
      instructions:
      - text: Unshare templates {id} from {accessorObjCode} {accessorID}.
        slots:
          id: query.id
          accessorObjCode: query.accessorObjCode
          accessorID: query.accessorID
      - text: Batch-revoke {accessorID}'s access to templates {id}, accessor type {accessorObjCode}.
        slots:
          accessorID: query.accessorID
          id: query.id
          accessorObjCode: query.accessorObjCode
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template/{id}/sharePublic'].put
  update:
    x-apievangelist-phrasing:
      intent: Share a template publicly
      effect: write
      questions:
      - Can I make one template available to everyone?
      - What access level does a publicly shared template get?
      instructions:
      - text: Share template {id} publicly with {coreAction} access.
        slots:
          id: path.id
          coreAction: query.coreAction
      - text: Make template {id} public at {coreAction} but forbid {forbiddenActions}.
        slots:
          id: path.id
          coreAction: query.coreAction
          forbiddenActions: query.forbiddenActions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template/sharePublic'].put
  update:
    x-apievangelist-phrasing:
      intent: Share several templates publicly
      effect: write
      questions:
      - Can I make a batch of templates public in one go?
      - Can every user in the organization see several templates if I share them publicly together?
      instructions:
      - text: Publicly share templates {id} with {coreAction} access.
        slots:
          id: query.id
          coreAction: query.coreAction
      - text: Make templates {id} public at {coreAction}, forbidding {forbiddenActions}.
        slots:
          id: query.id
          coreAction: query.coreAction
          forbiddenActions: query.forbiddenActions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template/{id}/unsharePublic'].put
  update:
    x-apievangelist-phrasing:
      intent: Remove public sharing from a template
      effect: destructive
      questions:
      - How do I make a public template private again?
      - Can I turn off public access on just one template?
      instructions:
      - text: Stop publicly sharing template {id}.
        slots:
          id: path.id
      - text: Make template {id} private again.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template/unsharePublic'].put
  update:
    x-apievangelist-phrasing:
      intent: Remove public sharing from several templates
      effect: destructive
      questions:
      - Can I pull a batch of templates out of public view at once?
      - Is there a bulk way to revoke public access on templates?
      instructions:
      - text: Remove public sharing from templates {id}.
        slots:
          id: query.id
      - text: 'Make all of these public templates private: {id}.'
        slots:
          id: query.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template/calculateDataExtension'].put
  update:
    x-apievangelist-phrasing:
      intent: Recalculate a template's custom data
      effect: write
      questions:
      - Can I recalculate the calculated custom fields on a template?
      - What triggers a data extension recalculation for a template?
      instructions:
      - text: Recalculate custom data on template {ID}.
        slots:
          ID: query.ID
      - text: Refresh the calculated custom fields for template {ID}.
        slots:
          ID: query.ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/template/calculateTimeline'].put
  update:
    x-apievangelist-phrasing:
      intent: Recalculate a template's timeline
      effect: write
      questions:
      - Can I recompute the timeline of a template after changing its tasks?
      - Is there a call to recalculate template task dates?
      instructions:
      - text: Recalculate the timeline for template {ID}.
        slots:
          ID: query.ID
      - text: Recompute task dates on template {ID}.
        slots:
          ID: query.ID
      method: generated
      generated: '2026-09-26'