meet and rockDeveloper Docs

Timer Management API

Use the Timer Management API to track effort across tasks, start and stop timers, and build accurate time reports for your projects.

Base URL
https://api.meetandrock.com/v1/dev
Authentication

Send your secret API key as a Bearer token in the Authorization header:Authorization: Bearer YOUR_API_KEY

Timer operations

Core endpoints for listing timers, starting new ones, stopping active timers, and deleting entries.

List timers

Retrieve all timers for the week that contains the given date (or the current week by default).

  • date (optional): ISO date used to determine which week to load.
GEThttps://api.meetandrock.com/v1/dev/timer?date=2024-01-15
List timers for a week

Return timers for the week of the provided date.

curl -X GET "https://api.meetandrock.com/v1/dev/timer?date=2024-01-15" \
  -H "Authorization: Bearer YOUR_API_KEY"

Start timer (play)

Start a new timer for ad‑hoc work or a specific task. Optionally attach it to a task or parent timer.

  • task_id (optional): Task ID to associate with the timer.
  • description (optional): Short note describing the work in progress.
  • parent_id (optional): Existing timer to resume or branch from.
POSThttps://api.meetandrock.com/v1/dev/timer/play
Start a timer

Start a new running timer for a task or generic work.

curl -X POST "https://api.meetandrock.com/v1/dev/timer/play" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task_id": "uuid",
    "description": "Working on feature"
  }'

Stop timer

Stop a running timer and compute its final duration.

POSThttps://api.meetandrock.com/v1/dev/timer/:timerId/stop
Stop a timer

Stop a running timer by its ID.

curl -X POST "https://api.meetandrock.com/v1/dev/timer/:timerId/stop" \
  -H "Authorization: Bearer YOUR_API_KEY"

Delete timer

Permanently delete a timer entry by its ID.

DELETEhttps://api.meetandrock.com/v1/dev/timer/:timerId
Delete timer

Delete a timer.

curl -X DELETE "https://api.meetandrock.com/v1/dev/timer/:timerId" \
  -H "Authorization: Bearer YOUR_API_KEY"

Time tracking concepts

Timers are flexible: you can attach them to tasks, keep them free‑form, or resume existing entries using the parent_id field.

  • Use a single active timer per user for clean reports.
  • Group timers by task_id to see how much time features actually take.
  • Combine the timer API with the Reports endpoints in the Finance and Project docs to surface billable vs. non‑billable work.

Reports & analytics

Combine timer data with your project, task, and finance endpoints to build dashboards for team utilisation, billable hours, and project health.

Start by listing timers for a date range, then aggregate by project_id, task_id, or created_by.

Error responses

Typical error payloads you may see when working with the Timer Management API.

400 Bad Request
{
  "message": "Invalid request parameters"
}

401 Unauthorized
{
  "message": "Invalid or missing API key"
}

404 Not Found
{
  "message": "Timer not found"
}

409 Conflict
{
  "message": "Active timer already exists"
}

Contents