API Evangelist conversational phrasing for Clickup Time Tracking API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Clickup Time Tracking API
  version: 1.0.0
extends: openapi/clickup-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: 23
- target: $.paths['/v2/team/{team_Id}/time_entries'].get
  update:
    x-apievangelist-phrasing:
      intent: List time entries in a date range (v2)
      effect: read
      questions:
      - How do I pull every time entry my team logged in ClickUp between two dates?
      - Can I filter the v2 time entries report down to billable time only?
      - Which time entries were logged against a particular Space, Folder or List last month?
      instructions:
      - text: Using the v2 endpoint, list time entries in Workspace {team_Id} from {start_date} to {end_date}.
        slots:
          team_Id: path.team_Id
          start_date: query.start_date
          end_date: query.end_date
      - text: Show only billable v2 time entries for assignee {assignee} in Workspace {team_Id}, with approval history included.
        slots:
          assignee: query.assignee
          team_Id: path.team_Id
      - text: Get v2 time entries logged on list {list_id} in Workspace {team_Id}.
        slots:
          list_id: query.list_id
          team_Id: path.team_Id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/team/{team_Id}/time_entries'].post
  update:
    x-apievangelist-phrasing:
      intent: Log a manual time entry (v2)
      effect: write
      questions:
      - Can I log time after the fact with a start time and duration through the v2 API?
      - Is it possible to record billable hours for a teammate rather than myself in v2?
      instructions:
      - text: Log {duration} ms starting at {start} on task {tid} in Workspace {team_Id} via v2.
        slots:
          duration: requestBody.duration
          start: requestBody.start
          tid: requestBody.tid
          team_Id: path.team_Id
      - text: Record a billable v2 time entry for user {assignee} in Workspace {team_Id} described as {description}, starting {start}, lasting {duration}.
        slots:
          assignee: requestBody.assignee
          team_Id: path.team_Id
          description: requestBody.description
          start: requestBody.start
          duration: requestBody.duration
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/team/{team_id}/time_entries/{timer_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve one time entry (v2)
      effect: read
      questions:
      - What details come back for a single time entry in the v2 API?
      - Can I see the approval details and task tags on one specific tracked-time record?
      instructions:
      - text: Fetch v2 time entry {timer_id} from Workspace {team_id}.
        slots:
          timer_id: path.timer_id
          team_id: path.team_id
      - text: Show time entry {timer_id} in Workspace {team_id} including its task tags and location names.
        slots:
          timer_id: path.timer_id
          team_id: path.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/team/{team_id}/time_entries/{timer_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a time entry (v2)
      effect: write
      questions:
      - Can I change the duration or description of a time entry already logged, using v2?
      - Is there a way to add or remove tags on an existing time record while editing it in v2?
      instructions:
      - text: Change the description of v2 time entry {timer_id} in Workspace {team_id} to {description}, keeping tags {tags}.
        slots:
          timer_id: path.timer_id
          team_id: path.team_id
          description: requestBody.description
          tags: requestBody.tags
      - text: Set v2 time entry {timer_id} in {team_id} to duration {duration} and apply tag action {tag_action} with tags {tags}.
        slots:
          timer_id: path.timer_id
          team_id: path.team_id
          duration: requestBody.duration
          tag_action: requestBody.tag_action
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/team/{team_id}/time_entries/{timer_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a time entry (v2)
      effect: destructive
      questions:
      - How can I remove a time entry that was logged by mistake with the v2 API?
      - Does deleting a tracked-time record through v2 take it out of the whole Workspace?
      instructions:
      - text: Delete v2 time entry {timer_id} from Workspace {team_id}.
        slots:
          timer_id: path.timer_id
          team_id: path.team_id
      - text: Remove the mistaken tracked-time record {timer_id} in Workspace {team_id} using v2.
        slots:
          timer_id: path.timer_id
          team_id: path.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/team/{team_id}/time_entries/{timer_id}/history'].get
  update:
    x-apievangelist-phrasing:
      intent: View the change history of a time entry
      effect: read
      questions:
      - Who changed a time entry and what did they change?
      - Can I audit the edits made to one logged time record?
      instructions:
      - text: Show the change history for time entry {timer_id} in Workspace {team_id}.
        slots:
          timer_id: path.timer_id
          team_id: path.team_id
      - text: List every edit made to timer {timer_id} in {team_id}.
        slots:
          timer_id: path.timer_id
          team_id: path.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/team/{team_id}/time_entries/current'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the currently running timer (v2)
      effect: read
      questions:
      - Is my ClickUp timer running right now, and on which task?
      - Can I check whether a specific teammate has a v2 timer ticking at the moment?
      instructions:
      - text: Show my running timer in Workspace {team_id} via v2.
        slots:
          team_id: path.team_id
      - text: Check whether user {assignee} has a timer going right now in Workspace {team_id}, v2.
        slots:
          assignee: query.assignee
          team_id: path.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/team/{team_id}/time_entries/tags'].get
  update:
    x-apievangelist-phrasing:
      intent: List time entry labels (v2)
      effect: read
      questions:
      - Which labels have been applied to time entries across the Workspace, per the v2 API?
      - What tag names are in use on tracked time right now?
      instructions:
      - text: List every label used on v2 time entries in Workspace {team_id}.
        slots:
          team_id: path.team_id
      - text: Show the tag vocabulary for tracked time in {team_id} with v2.
        slots:
          team_id: path.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/team/{team_id}/time_entries/tags'].put
  update:
    x-apievangelist-phrasing:
      intent: Rename a time entry label
      effect: write
      questions:
      - Can I rename a time-tracking label and change its colors at the same time?
      - How do I fix a typo in a tag used on time entries?
      instructions:
      - text: Rename time entry label {name} to {new_name} in Workspace {team_id} with background {tag_bg} and text color {tag_fg}.
        slots:
          name: requestBody.name
          new_name: requestBody.new_name
          team_id: path.team_id
          tag_bg: requestBody.tag_bg
          tag_fg: requestBody.tag_fg
      - text: Change the tracked-time tag {name} to read {new_name} in {team_id}, colors {tag_bg} and {tag_fg}.
        slots:
          name: requestBody.name
          new_name: requestBody.new_name
          team_id: path.team_id
          tag_bg: requestBody.tag_bg
          tag_fg: requestBody.tag_fg
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/team/{team_id}/time_entries/tags'].post
  update:
    x-apievangelist-phrasing:
      intent: Label time entries (v2)
      effect: write
      questions:
      - Can I apply the same label to several time entries in one v2 call?
      - What's the way to tag a batch of logged hours as client work via v2?
      instructions:
      - text: Apply tags {tags} to time entries {time_entry_ids} in Workspace {team_id} through v2.
        slots:
          tags: requestBody.tags
          time_entry_ids: requestBody.time_entry_ids
          team_id: path.team_id
      - text: Label v2 tracked-time records {time_entry_ids} in {team_id} with {tags}.
        slots:
          time_entry_ids: requestBody.time_entry_ids
          team_id: path.team_id
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/team/{team_id}/time_entries/tags'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove labels from time entries
      effect: destructive
      questions:
      - Can I strip a label off some time entries without deleting the label from the Workspace?
      - How do I untag several tracked-time records at once?
      instructions:
      - text: Remove tags {tags} from time entries {time_entry_ids} in Workspace {team_id}.
        slots:
          tags: requestBody.tags
          time_entry_ids: requestBody.time_entry_ids
          team_id: path.team_id
      - text: Untag records {time_entry_ids} in {team_id}, dropping the {tags} labels.
        slots:
          time_entry_ids: requestBody.time_entry_ids
          team_id: path.team_id
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/team/{team_Id}/time_entries/start'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a new timer (v2)
      effect: write
      questions:
      - How do I start tracking time on a task from a script with the v2 API?
      - Can a v2 timer be started as billable with a description attached?
      instructions:
      - text: Start a v2 timer on task {tid} in Workspace {team_Id}.
        slots:
          tid: requestBody.tid
          team_Id: path.team_Id
      - text: Begin tracking billable time in {team_Id} with note {description} using v2.
        slots:
          team_Id: path.team_Id
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/team/{team_id}/time_entries/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop my running timer (v2)
      effect: write
      questions:
      - What call stops the clock on my current v2 timer?
      - Can I end the time tracking I have going without knowing the entry ID, in v2?
      instructions:
      - text: Stop my running v2 timer in Workspace {team_id}.
        slots:
          team_id: path.team_id
      - text: End the time tracking currently ticking for me in {team_id} via the v2 endpoint.
        slots:
          team_id: path.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team/{team_id}/time_entries'].get
  update:
    x-apievangelist-phrasing:
      intent: List time entries by date (legacy path)
      effect: read
      questions:
      - On the legacy unversioned path, how do I fetch time logged between two dates?
      - Does the older time entries endpoint let me filter by assignee and task?
      instructions:
      - text: On the legacy path, fetch time logs for Workspace {team_id} between {start_date} and {end_date}.
        slots:
          team_id: path.team_id
          start_date: query.start_date
          end_date: query.end_date
      - text: Pull legacy time logs for task {task_id} in {team_id}.
        slots:
          task_id: query.task_id
          team_id: path.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team/{team_id}/time_entries'].post
  update:
    x-apievangelist-phrasing:
      intent: Log a manual time entry (legacy path)
      effect: write
      questions:
      - Does the older unversioned endpoint accept manual time logs with a start and duration?
      - Can I mark a manually logged record billable on the legacy path?
      instructions:
      - text: 'On the legacy path, add a manual time log to task {tid} in {team_id}: start {start}, duration {duration}.'
        slots:
          tid: requestBody.tid
          team_id: path.team_id
          start: requestBody.start
          duration: requestBody.duration
      - text: Using the older endpoint, record {duration} of work beginning {start} in Workspace {team_id}.
        slots:
          duration: requestBody.duration
          start: requestBody.start
          team_id: path.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team/{team_id}/time_entries/{timer_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve one time entry (legacy path)
      effect: read
      questions:
      - How do I look up a time log by its ID on the legacy unversioned path?
      - What does the older single time entry endpoint return?
      instructions:
      - text: Look up legacy time log {timer_id} in Workspace {team_id}.
        slots:
          timer_id: path.timer_id
          team_id: path.team_id
      - text: Using the older endpoint, read time record {timer_id} from {team_id}.
        slots:
          timer_id: path.timer_id
          team_id: path.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team/{team_id}/time_entries/{timer_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Edit a time entry (legacy path)
      effect: write
      questions:
      - Can the older unversioned endpoint change a time log's start and end?
      - Is billable status editable on a legacy time record?
      instructions:
      - text: On the legacy path, move time log {timer_id} in {team_id} to start {start} and end {end}.
        slots:
          timer_id: path.timer_id
          team_id: path.team_id
          start: requestBody.start
          end: requestBody.end
      - text: Using the older endpoint, rewrite the note on record {timer_id} in {team_id} as {description}.
        slots:
          timer_id: path.timer_id
          team_id: path.team_id
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team/{team_id}/time_entries/{timer_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a time entry (legacy path)
      effect: destructive
      questions:
      - Is deleting a time log through the older unversioned endpoint permanent?
      - Can a legacy time record be recovered after I remove it?
      instructions:
      - text: Permanently erase legacy time log {timer_id} in Workspace {team_id}.
        slots:
          timer_id: path.timer_id
          team_id: path.team_id
      - text: Using the older endpoint, wipe out record {timer_id} from {team_id}.
        slots:
          timer_id: path.timer_id
          team_id: path.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team/{team_id}/time_entries/current'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the running timer (legacy path)
      effect: read
      questions:
      - Does the legacy unversioned path tell me which timer is active for me?
      - On the older endpoint, can I see a colleague's active clock?
      instructions:
      - text: On the legacy path, report my active clock in Workspace {team_id}.
        slots:
          team_id: path.team_id
      - text: Using the older endpoint, see if {assignee} has an active clock in {team_id}.
        slots:
          assignee: query.assignee
          team_id: path.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team/{team_id}/time_entries/start/{timer_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Start the timer for a time entry (legacy)
      effect: write
      questions:
      - What happens to my other running timer if I start one on the legacy path?
      - Can I resume timing a specific existing time entry by its ID?
      instructions:
      - text: Resume timing existing entry {timer_id} in Workspace {team_id} on the legacy path.
        slots:
          timer_id: path.timer_id
          team_id: path.team_id
      - text: Restart the clock on entry {timer_id} in {team_id} against task {tid}.
        slots:
          timer_id: path.timer_id
          team_id: path.team_id
          tid: requestBody.tid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team/{team_id}/time_entries/stop'].post
  update:
    x-apievangelist-phrasing:
      intent: Stop my running timer (legacy path)
      effect: write
      questions:
      - Which legacy unversioned endpoint halts my active clock?
      - Does the older API let me stop timing without passing an entry ID?
      instructions:
      - text: On the legacy path, halt my active clock in Workspace {team_id}.
        slots:
          team_id: path.team_id
      - text: Using the older endpoint, finish my current timing session in {team_id}.
        slots:
          team_id: path.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team/{team_id}/time_entries/tags'].get
  update:
    x-apievangelist-phrasing:
      intent: List time entry tags (legacy path)
      effect: read
      questions:
      - On the older unversioned path, what tags exist on time logs?
      - Can the legacy API list the tag names people put on their hours?
      instructions:
      - text: On the legacy path, enumerate tags found on time logs in Workspace {team_id}.
        slots:
          team_id: path.team_id
      - text: Using the older endpoint, get the hour-tracking tag names for {team_id}.
        slots:
          team_id: path.team_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/team/{team_id}/time_entries/tags'].post
  update:
    x-apievangelist-phrasing:
      intent: Tag time entries (legacy path)
      effect: write
      questions:
      - Can I attach tags to multiple time logs through the older unversioned endpoint?
      - Does the legacy path support bulk tagging of hours?
      instructions:
      - text: On the legacy path, attach {tags} to time logs {time_entry_ids} in Workspace {team_id}.
        slots:
          tags: requestBody.tags
          time_entry_ids: requestBody.time_entry_ids
          team_id: path.team_id
      - text: Using the older endpoint, bulk-tag hours {time_entry_ids} in {team_id} as {tags}.
        slots:
          time_entry_ids: requestBody.time_entry_ids
          team_id: path.team_id
          tags: requestBody.tags
      method: generated
      generated: '2026-09-26'