# 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 Team API
  version: 1.0.0
extends: openapi/adobe-suite-team-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['/team/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Workfront team
      effect: read
      questions:
      - Who is on a particular team in Workfront?
      - Can I fetch only selected fields of one team?
      instructions:
      - text: Show team {id}.
        slots:
          id: path.id
      - text: Get fields {fields} of team {id}.
        slots:
          fields: query.fields
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a Workfront team
      effect: write
      questions:
      - How do I update the details of one team?
      - Can I change a single team and get its updated fields back?
      instructions:
      - text: Edit team {id}.
        slots:
          id: path.id
      - text: Update team {id} and return {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Workfront team
      effect: destructive
      questions:
      - How do I delete one team from Workfront?
      - Can I force-delete a team that still has references?
      instructions:
      - text: Delete team {id}.
        slots:
          id: path.id
      - text: Force-delete team {id} with force {force}.
        slots:
          id: path.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team'].get
  update:
    x-apievangelist-phrasing:
      intent: Get several teams by ID
      effect: read
      questions:
      - Can I load a batch of teams at once when I already know their IDs?
      - What's the way to fetch multiple Workfront teams in one request?
      instructions:
      - text: Get teams {id}.
        slots:
          id: query.id
      - text: Fetch fields {fields} for teams with IDs {id}.
        slots:
          fields: query.fields
          id: query.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk edit teams
      effect: write
      questions:
      - Can I update many teams in a single call?
      - Is there a bulk edit for Workfront teams?
      instructions:
      - text: Bulk edit several teams in one request.
      - text: Apply changes to multiple teams and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Workfront team
      effect: write
      questions:
      - How do I create a new team in Workfront?
      - Can I create a team and pick which fields come back?
      instructions:
      - text: Create a new team.
      - text: Add a team and return fields {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team'].delete
  update:
    x-apievangelist-phrasing:
      intent: Bulk delete teams
      effect: destructive
      questions:
      - Can I delete a group of teams at once?
      - What does force do when bulk deleting teams?
      instructions:
      - text: Delete teams {id}.
        slots:
          id: query.id
      - text: Bulk delete teams {id} with force {force}.
        slots:
          id: query.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count Workfront teams
      effect: read
      questions:
      - How many teams do we have in Workfront?
      - Can I count only teams matching certain conditions?
      instructions:
      - text: Count all teams.
      - text: Count teams matching {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search Workfront teams
      effect: read
      questions:
      - Which teams match a given set of filter conditions?
      - Can I search teams by name and page the results?
      instructions:
      - text: Search teams where {filters}.
        slots:
          filters: query.filters
      - text: Find teams matching {filters} with list options {listOptions}.
        slots:
          filters: query.filters
          listOptions: query.listOptions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run a report on teams
      effect: read
      questions:
      - Can I get an aggregated report across our teams?
      - What does a grouped report of Workfront teams return?
      instructions:
      - text: Run a team report for {filters}.
        slots:
          filters: query.filters
      - text: Build a report over teams using options {listOptions}.
        slots:
          listOptions: query.listOptions
      method: generated
      generated: '2026-09-26'