# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for HRIS Subpackage Timesheet Entries API
  version: 1.0.0
extends: openapi/merge-subpackage-timesheetentries-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: 4
- target: $.paths['/hris/v1/timesheet-entries'].get
  update:
    x-apievangelist-phrasing:
      intent: List employees' timesheet entries
      effect: read
      questions:
      - How do I pull all timesheet entries synced from a customer's HRIS?
      - Can I see only the hours one employee logged within a date range?
      - Which timesheet entries started after a given time, newest first?
      instructions:
      - text: List timesheet entries for employee {employee_id}.
        slots:
          employee_id: query.employee_id
      - text: List timesheet entries that started after {started_after} and ended before {ended_before}.
        slots:
          started_after: query.started_after
          ended_before: query.ended_before
      - text: Show timesheet entries Merge synced since {modified_after}, sorted by {order_by}.
        slots:
          modified_after: query.modified_after
          order_by: query.order_by
      method: generated
      generated: '2026-10-01'
- target: $.paths['/hris/v1/timesheet-entries'].post
  update:
    x-apievangelist-phrasing:
      intent: Record a timesheet entry
      effect: write
      questions:
      - How do I log hours worked for an employee in the HRIS?
      - Can a timesheet entry be written asynchronously?
      instructions:
      - text: Create timesheet entry {entry}.
        slots:
          entry: requestBody.model
      - text: Log hours {entry} asynchronously {run_async}.
        slots:
          entry: requestBody.model
          run_async: query.run_async
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hris/v1/timesheet-entries/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a timesheet entry
      effect: read
      questions:
      - Can I look up one timesheet entry by ID?
      - What hours and times are on a single timesheet entry?
      instructions:
      - text: Get timesheet entry {id}.
        slots:
          id: path.id
      - text: Show me the hours recorded in timesheet entry {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hris/v1/timesheet-entries/meta/post'].get
  update:
    x-apievangelist-phrasing:
      intent: Get fields required to record a timesheet entry
      effect: read
      questions:
      - Which fields must I send to create a timesheet entry?
      - What does the HR system accept when posting worked hours?
      instructions:
      - text: Show timesheet entry creation fields for account token {account_token}.
        slots:
          account_token: header.X-Account-Token
      - text: Get the create metadata for timesheet entries.
      method: generated
      generated: '2026-09-26'