# 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 Hour API
  version: 1.0.0
extends: openapi/adobe-suite-hour-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: 13
- target: $.paths['/hour/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one logged hour entry
      effect: read
      questions:
      - How can I look up a single time entry logged in Workfront?
      - Can I choose which fields come back for one hour entry?
      instructions:
      - text: Show hour entry {id}.
        slots:
          id: path.id
      - text: Get hour entry {id} with fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hour/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a single hour entry
      effect: write
      questions:
      - How do I correct the time on one logged hour entry?
      - Can I update a single hour entry and get specific fields back?
      instructions:
      - text: Update hour entry {id} with my corrections.
        slots:
          id: path.id
      - text: Edit hour entry {id} and return fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hour/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one hour entry
      effect: destructive
      questions:
      - How do I remove a time entry that was logged by mistake?
      - Can I force-delete a single hour entry?
      instructions:
      - text: Delete hour entry {id}.
        slots:
          id: path.id
      - text: Force delete hour entry {id} with force={force}.
        slots:
          id: path.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hour'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch several hour entries by ID
      effect: read
      questions:
      - Can I retrieve several logged hour entries at once by their IDs?
      - What does a bulk get of hour entries return?
      instructions:
      - text: Fetch hour entries {id} in one call.
        slots:
          id: query.id
      - text: Bulk get hour entries {id} with fields {fields}.
        slots:
          id: query.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hour'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit many hour entries in one request
      effect: write
      questions:
      - Is there a way to update a batch of time entries together?
      - Can I bulk edit hour entries instead of one by one?
      instructions:
      - text: Bulk update these hour entries.
      - text: Apply my edits to multiple hour entries and return fields {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hour'].post
  update:
    x-apievangelist-phrasing:
      intent: Log a new hour entry
      effect: write
      questions:
      - How do I log time worked through the API?
      - What gets created when I add an hour entry?
      instructions:
      - text: Log a new hour entry for my work.
      - text: Create an hour entry and return fields {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hour'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete several hour entries at once
      effect: destructive
      questions:
      - Can I delete multiple time entries in one call?
      - Is there a bulk removal option for hour entries?
      instructions:
      - text: Delete hour entries {id} in bulk.
        slots:
          id: query.id
      - text: Bulk delete hour entries {id} with force={force}.
        slots:
          id: query.id
          force: query.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hour/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count logged hour entries
      effect: read
      questions:
      - How many hour entries have been logged?
      - Can I count only the time entries matching a filter?
      instructions:
      - text: Count all logged hour entries.
      - text: Count hour entries where {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hour/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search logged hours with filters
      effect: read
      questions:
      - How do I find time entries by user, project or date?
      - Can I page through hour search results?
      instructions:
      - text: Search hour entries matching {filters}.
        slots:
          filters: query.filters
      - text: Find hours matching {filters} and return {fields}.
        slots:
          filters: query.filters
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hour/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run an aggregate report on logged hours
      effect: read
      questions:
      - Can I get totals of logged hours grouped for a report?
      - What summary figures can I build across time entries?
      instructions:
      - text: Run an hours report filtered by {filters}.
        slots:
          filters: query.filters
      - text: Report on logged hours using list options {listOptions}.
        slots:
          listOptions: query.listOptions
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hour/approve'].put
  update:
    x-apievangelist-phrasing:
      intent: Approve a logged hour entry
      effect: write
      questions:
      - How do I approve time someone logged?
      - Can a manager sign off on a single hour entry via the API?
      instructions:
      - text: Approve hour entry {hourID}.
        slots:
          hourID: query.hourID
      - text: Sign off on the time logged in hour {hourID}.
        slots:
          hourID: query.hourID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hour/calculateDataExtension'].put
  update:
    x-apievangelist-phrasing:
      intent: Recalculate custom data on an hour entry
      effect: write
      questions:
      - How do I refresh calculated custom fields on a time entry?
      - Can I trigger a recalculation of an hour's custom data?
      instructions:
      - text: Recalculate the custom data on hour {ID}.
        slots:
          ID: query.ID
      - text: Refresh calculated custom fields for hour entry {ID}.
        slots:
          ID: query.ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hour/unapprove'].put
  update:
    x-apievangelist-phrasing:
      intent: Unapprove a logged hour entry
      effect: write
      questions:
      - How do I reverse the approval on a time entry?
      - Can I leave a comment explaining why I unapproved an hour?
      instructions:
      - text: Unapprove hour entry {hourID}.
        slots:
          hourID: query.hourID
      - text: Unapprove hour {hourID} with the comment {comment}.
        slots:
          hourID: query.hourID
          comment: query.comment
      method: generated
      generated: '2026-09-26'