API Evangelist conversational phrasing for Adobe Workfront Company 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 Company API
  version: 1.0.0
extends: openapi/adobe-suite-company-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['/company/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a single company record
      effect: read
      questions:
      - How do I look up one client or vendor company by its ID?
      - Can I pick which fields come back when I fetch a company?
      instructions:
      - text: Show me company {id}.
        slots:
          id: path.id
      - text: Fetch company {id} with fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/company/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a single company
      effect: write
      questions:
      - How can I update the details of one company in Workfront?
      - Is it possible to edit a company and get certain fields back?
      instructions:
      - text: Edit company {id}.
        slots:
          id: path.id
      - text: Update company {id} and return {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/company/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a single company
      effect: destructive
      questions:
      - How do I delete a company we no longer work with?
      - Can I force delete a company that is still linked to projects?
      instructions:
      - text: Delete company {id}.
        slots:
          id: path.id
      - text: Force delete company {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/company'].get
  update:
    x-apievangelist-phrasing:
      intent: Get several companies by ID at once
      effect: read
      questions:
      - Can I load multiple companies in one request using their IDs?
      - What's the quickest way to fetch a known list of companies?
      instructions:
      - text: Get companies {id}.
        slots:
          id: query.id
      - text: Bulk fetch companies {id} returning {fields}.
        slots:
          id: query.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/company'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit many companies in one request
      effect: write
      questions:
      - Is there a way to bulk update several companies?
      - Can I change a batch of company records at the same time?
      instructions:
      - text: Bulk edit the companies I send.
      - text: Apply edits to multiple companies and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/company'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a company
      effect: write
      questions:
      - How do I add a new client company?
      - Can I create a company record and choose the response fields?
      instructions:
      - text: Create a new company.
      - text: Create a company and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/company'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete several companies at once
      effect: destructive
      questions:
      - Can I bulk delete companies by listing their IDs?
      - Does deleting companies in bulk support a force option?
      instructions:
      - text: Delete companies {id} in bulk.
        slots:
          id: query.id
      - text: Bulk force-delete companies {id}.
        slots:
          id: query.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/company/replace'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a company with another everywhere
      effect: write
      questions:
      - How do I merge a duplicate company into the one we want to keep?
      - Can I swap all references to one company for a replacement company?
      instructions:
      - text: Replace company {id} with company {replacementID}.
        slots:
          id: query.id
          replacementID: query.replacementID
      - text: Repoint everything using company {id} to {replacementID}.
        slots:
          id: query.id
          replacementID: query.replacementID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/company/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count companies matching a filter
      effect: read
      questions:
      - How many companies are set up in Workfront?
      - Can I count only companies that match certain criteria?
      instructions:
      - text: Count all companies.
      - text: Count companies matching {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/company/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search companies with filters
      effect: read
      questions:
      - How do I search companies by name?
      - Can I page through company search results?
      instructions:
      - text: Search companies where {filters}.
        slots:
          filters: query.filters
      - text: Find companies matching {filters} and return {fields}.
        slots:
          filters: query.filters
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/company/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run a report on companies
      effect: read
      questions:
      - Can I get grouped report data about our companies?
      - What does a company report return with a filter?
      instructions:
      - text: Run a company report.
      - text: Report on companies filtered by {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/company/calculateDataExtension'].put
  update:
    x-apievangelist-phrasing:
      intent: Recalculate a company's custom form fields
      effect: write
      questions:
      - How do I force calculated custom fields on a company to refresh?
      - Can I recompute the data extension values for one company?
      instructions:
      - text: Recalculate custom data for company {ID}.
        slots:
          ID: query.ID
      - text: Refresh the calculated fields on company {ID}.
        slots:
          ID: query.ID
      method: generated
      generated: '2026-09-26'