API Evangelist conversational phrasing for Adobe Workfront Hourtype 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 Hourtype API
  version: 1.0.0
extends: openapi/adobe-suite-hour-type-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 16
- target: $.paths['/hourtype/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one hour type by ID
      effect: read
      questions:
      - How can I see the details of a single Workfront hour type?
      - Can I limit which fields are returned for one hour type?
      instructions:
      - text: Show hour type {id}.
        slots:
          id: path.id
      - text: Get hour type {id} with fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hourtype/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a single hour type
      effect: write
      questions:
      - How do I change the name or settings of one existing hour type?
      - Can I update a single hour type and get specific fields back?
      instructions:
      - text: Update hour type {id} with my changes.
        slots:
          id: path.id
      - text: Edit hour type {id} and return fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hourtype/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete one hour type
      effect: destructive
      questions:
      - How do I remove a single hour type I no longer use?
      - Can I force-delete an hour type that is still referenced?
      instructions:
      - text: Delete hour type {id}.
        slots:
          id: path.id
      - text: Force delete hour type {id} with force={force}.
        slots:
          id: path.id
          force: query.force
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hourtype'].get
  update:
    x-apievangelist-phrasing:
      intent: Fetch several hour types by ID
      effect: read
      questions:
      - Can I retrieve a batch of hour types by passing multiple IDs at once?
      - What does a bulk get of hour types return?
      instructions:
      - text: Fetch hour types {id} in one call.
        slots:
          id: query.id
      - text: Bulk get hour types {id} with fields {fields}.
        slots:
          id: query.id
          fields: query.fields
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hourtype'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit many hour types in one request
      effect: write
      questions:
      - Is there a way to update several hour types together in a single request?
      - Can I bulk edit hour types rather than one at a time?
      instructions:
      - text: Bulk update these hour types in one request.
      - text: Apply my edits to multiple hour types and return fields {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hourtype'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new hour type
      effect: write
      questions:
      - How do I add a new hour type for people to log time against?
      - What happens when I create an hour type in Workfront?
      instructions:
      - text: Create a new hour type.
      - text: Add an hour type and return fields {fields}.
        slots:
          fields: query.fields
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hourtype'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete several hour types at once
      effect: destructive
      questions:
      - Can I delete multiple hour types in a single call?
      - Is there a bulk removal option for hour types?
      instructions:
      - text: Delete hour types {id} in bulk.
        slots:
          id: query.id
      - text: Bulk delete hour types {id} with force={force}.
        slots:
          id: query.id
          force: query.force
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hourtype/replace'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace hour types with another hour type
      effect: write
      questions:
      - How do I swap references to old hour types over to a replacement hour type?
      - Can I merge retired hour types into a single replacement?
      instructions:
      - text: Replace hour types {id} with hour type {replacementID}.
        slots:
          id: query.id
          replacementID: query.replacementID
      - text: Move everything using hour type {id} over to {replacementID}.
        slots:
          id: query.id
          replacementID: query.replacementID
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hourtype/count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count hour types
      effect: read
      questions:
      - How many hour types are defined?
      - Can I count only hour types that match a filter?
      instructions:
      - text: Count the hour types.
      - text: Count hour types where {filters}.
        slots:
          filters: query.filters
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hourtype/search'].get
  update:
    x-apievangelist-phrasing:
      intent: Search hour types with filters
      effect: read
      questions:
      - How do I find hour types by name or other attributes?
      - Can I page through hour type search results?
      instructions:
      - text: Search hour types matching {filters}.
        slots:
          filters: query.filters
      - text: Find hour types matching {filters} and return {fields}.
        slots:
          filters: query.filters
          fields: query.fields
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hourtype/report'].get
  update:
    x-apievangelist-phrasing:
      intent: Run an aggregate report on hour types
      effect: read
      questions:
      - Can I get grouped report data about hour types?
      - What summary figures can I produce across hour types?
      instructions:
      - text: Run an hour type report filtered by {filters}.
        slots:
          filters: query.filters
      - text: Report on hour types using list options {listOptions}.
        slots:
          listOptions: query.listOptions
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hourtype/defaultOpTaskHourType'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the default hour type for issues
      effect: read
      questions:
      - Which hour type is used by default when logging time on an issue?
      - What is the default issue (op task) hour type?
      instructions:
      - text: Show the default hour type for issues.
      - text: Get the default op task hour type.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hourtype/defaultProjectHourType'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the default hour type for projects
      effect: read
      questions:
      - Which hour type applies by default when time is logged against a project?
      - What is the project-level default hour type?
      instructions:
      - text: Show the default project hour type.
      - text: Get the hour type projects use by default.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hourtype/defaultTaskHourType'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the default hour type for tasks
      effect: read
      questions:
      - Which hour type is the default for time logged on tasks?
      - What is the task default hour type?
      instructions:
      - text: Show the default task hour type.
      - text: Get the hour type tasks use by default.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hourtype/globalHourTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List global hour types
      effect: read
      questions:
      - Which hour types are global rather than tied to a project?
      - Where do I see the system-wide hour types?
      instructions:
      - text: List the global hour types.
      - text: Show all system-wide hour types.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hourtype/objectHourTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List hour types available on an object
      effect: read
      questions:
      - Which hour types can a user log against a specific project, task or issue?
      - Can I check the hour types available to a particular user on an object?
      instructions:
      - text: List hour types available on {objCode} {objID}.
        slots:
          objCode: query.objCode
          objID: query.objID
      - text: Show which hour types user {userID} can use on {objCode} {objID}.
        slots:
          userID: query.userID
          objCode: query.objCode
          objID: query.objID
      method: generated
      generated: '2026-10-01'