# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Jira Cloud platform REST Time tracking API
  version: 1.0.0
extends: openapi/jira-time-tracking-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: 5
- target: $.paths['/rest/api/3/configuration/timetracking'].get
  update:
    x-apievangelist-phrasing:
      intent: See which time tracking provider is active
      effect: read
      questions:
      - Which time tracking provider is currently selected on my site?
      - Is time tracking turned on at all?
      instructions:
      - text: Show the currently selected time tracking provider.
      - text: Tell me which time tracking implementation is active.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/configuration/timetracking'].put
  update:
    x-apievangelist-phrasing:
      intent: Choose the time tracking provider
      effect: write
      questions:
      - How do I switch to a different time tracking provider?
      - Can I change time tracking to one installed from an app?
      instructions:
      - text: Select time tracking provider {key}.
        slots:
          key: requestBody.key
      - text: Switch time tracking to the provider with key {key}.
        slots:
          key: requestBody.key
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/configuration/timetracking/list'].get
  update:
    x-apievangelist-phrasing:
      intent: List available time tracking providers
      effect: read
      questions:
      - What time tracking providers can I choose from?
      - Are there time tracking providers besides the built-in one installed?
      instructions:
      - text: List all the time tracking providers.
      - text: Show the time tracking implementations I could select.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/configuration/timetracking/options'].get
  update:
    x-apievangelist-phrasing:
      intent: Get time tracking settings
      effect: read
      questions:
      - What time format and default unit does time tracking use?
      - How many working hours per day are configured for time tracking?
      instructions:
      - text: Show the time tracking settings.
      - text: Get the configured working days, hours and time format for time tracking.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rest/api/3/configuration/timetracking/options'].put
  update:
    x-apievangelist-phrasing:
      intent: Change time tracking settings
      effect: write
      questions:
      - How do I change the working hours per day used for time tracking?
      - Can I set the default time unit to hours instead of minutes?
      instructions:
      - text: Set time tracking to {workingHoursPerDay} hours a day, {workingDaysPerWeek} days a week, format {timeFormat}, default unit {defaultUnit}.
        slots:
          workingHoursPerDay: requestBody.workingHoursPerDay
          workingDaysPerWeek: requestBody.workingDaysPerWeek
          timeFormat: requestBody.timeFormat
          defaultUnit: requestBody.defaultUnit
      - text: 'Update time tracking options: default unit {defaultUnit}, time format {timeFormat}, {workingDaysPerWeek} days by {workingHoursPerDay} hours.'
        slots:
          defaultUnit: requestBody.defaultUnit
          timeFormat: requestBody.timeFormat
          workingDaysPerWeek: requestBody.workingDaysPerWeek
          workingHoursPerDay: requestBody.workingHoursPerDay
      method: generated
      generated: '2026-09-26'