# 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 Timesheet API
  version: 1.0.0
extends: openapi/adobe-suite-timesheet-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['/timesheet/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a single timesheet
      effect: read
      questions:
      - How do I pull up one timesheet by its ID in Workfront?
      - Can I choose which fields to return for a timesheet?
      instructions:
      - text: Show timesheet {id}.
        slots:
          id: path.id
      - text: Get timesheet {id} with fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/timesheet/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a single timesheet
      effect: write
      questions:
      - How do I update one existing timesheet?
      - Can I edit a timesheet and get selected fields back?
      instructions:
      - text: Update timesheet {id} with these changes.
        slots:
          id: path.id
      - text: Edit timesheet {id} and return {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/timesheet/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a single timesheet
      effect: destructive
      questions:
      - How do I delete one timesheet?
      - Can I force-delete a timesheet that's blocked from normal deletion?
      instructions:
      - text: Delete timesheet {id}.
        slots:
          id: path.id
      - text: Force delete timesheet {id} with force={force}.
        slots:
          id: path.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/timesheet'].get
  update:
    x-apievangelist-phrasing:
      intent: Get several timesheets by ID
      effect: read
      questions:
      - Can I fetch multiple timesheets at once if I know their IDs?
      - What's the bulk way to load a set of timesheets?
      instructions:
      - text: Fetch timesheets {id}.
        slots:
          id: query.id
      - text: Bulk get timesheets {id} with only {fields}.
        slots:
          id: query.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/timesheet'].put
  update:
    x-apievangelist-phrasing:
      intent: Bulk edit multiple timesheets
      effect: write
      questions:
      - How do I update many timesheets in one request?
      - Can I apply the same change across a batch of timesheets?
      instructions:
      - text: Apply these edits to my timesheets in one bulk update.
      - text: Bulk edit timesheets and return fields {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/timesheet'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a timesheet
      effect: write
      questions:
      - How do I create a new timesheet for a user?
      - Can I create a timesheet and get specific fields back in the response?
      instructions:
      - text: Create a new timesheet from these details.
      - text: Create a timesheet and return {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/timesheet'].delete
  update:
    x-apievangelist-phrasing:
      intent: Bulk delete timesheets
      effect: destructive
      questions:
      - Can I delete several timesheets in one call?
      - How do I force-remove a batch of timesheets?
      instructions:
      - text: Delete timesheets {id}.
        slots:
          id: query.id
      - text: Force bulk-delete timesheets {id} with force={force}.
        slots:
          id: query.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/timesheet/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count timesheets matching filters
      effect: read
      questions:
      - How many timesheets are still open this period?
      - Can I count timesheets that match a filter?
      instructions:
      - text: Count all timesheets.
      - text: Count timesheets matching {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/timesheet/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search timesheets with filters
      effect: read
      questions:
      - How do I find timesheets for a certain user or date range?
      - Can I sort and page through timesheet search results?
      instructions:
      - text: Search timesheets where {filters}.
        slots:
          filters: query.filters
      - text: Search timesheets matching {filters} with list options {listOptions}.
        slots:
          filters: query.filters
          listOptions: query.listOptions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/timesheet/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run a report over timesheets
      effect: read
      questions:
      - Can I get a grouped or aggregated report of timesheets?
      - What does a timesheet report query return compared with a search?
      instructions:
      - text: Run a timesheet report filtered by {filters}.
        slots:
          filters: query.filters
      - text: Generate a timesheet report with list options {listOptions}.
        slots:
          listOptions: query.listOptions
      method: generated
      generated: '2026-09-26'