repairshopr-ticket-timer

name	repairshopr-ticket-timer
description	View ticket timers (time tracking entries) in RepairShopr
license	MIT
compatibility	opencode
metadata	{"audience":"technicians, administrators","api":"GET /ticket_timers"}

What I do

I list ticket timers, which are time tracking entries associated with tickets. Timers record start/stop times, durations, and notes for work performed on tickets. They support billing time to customers and internal time tracking.

When to use me

Use this when:

• Auditing time spent on tickets
• Reviewing technician timesheet data
• Checking if a timer is still running (no end_time)
• Filtering timers by date range for reporting
• Looking up which tickets had timer activity

How to use

Required API base URL:

• VITE_REPAIRSHOPR_SUBDOMAIN
• VITE_REPAIRSHOPR_API_KEY

Permission: "Ticket Timers - Overview" required.

List Ticket Timers (GET /ticket_timers) Optional:

• created_at_lt (string) - Filter timers created before this date (e.g., "2019-01-22")
• created_at_gt (string) - Filter timers created after this date
• page (integer) - Page number (25 results per page)

Example call:

const timers = await skill({ name: "repairshopr-ticket-timer" }, {
  created_at_gt: "2024-01-01",
  page: 1
})

Response includes:

{
  "ticket_timers": [
    {
      "id": 1,
      "ticket_id": 123,
      "user_id": 5,
      "start_time": "2013-08-06T13:41:15.000Z",
      "end_time": "2013-08-06T14:41:15.000Z", // null if still running
      "recorded": false,
      "billable": false,
      "notes": "Diagnosed power supply issue",
      "toggl_id": null,
      "product_id": null,
      "comment_id": null,
      "ticket_line_item_id": 
        
    
  
        

Important

• Timers are typically started/stopped from the RepairShopr UI or mobile app
• recorded indicates if the timer has been converted to a timelog/ticket comment
• billable flag determines if time should be billed to customer
• end_time null means the timer is still active
• ticket_line_item_id may link to a specific line item if tracking time against a charge
• There is no create/update/delete via this base endpoint; those operations happen in the UI/app

Related skills

• repairshopr-timelog - For general employee time logs (different from ticket timers)
• repairshopr-ticket - To get ticket details associated with timers
• repairshopr-ticket-comment - After a timer is recorded, it may create a comment