Sign in

v1

latestOpenAPI 3.1.0AGPL-3.0 license2026-07-1210336283.6 KB
Tracker Timer

Start a timer

Start a new timer or continue from a paused entry.

post/tracker-entries/timer/start

Request body

projectIdstring uuid required

Unique identifier of the project to track time for

assignedIdstring uuid nullable

Unique identifier of the user to assign the timer to. If not provided, will use the authenticated user

descriptionstring nullable

Optional description for the timer session

startstring date-time

Start time in ISO 8601 format. If not provided, will use current time

continueFromEntrystring uuid

Continue from a specific paused entry ID

Example request

{
  "projectId": "b3b6e2c2-1f2a-4e3b-9c1d-2a4b6e2c21f2",
  "assignedId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "description": "Working on implementing timer feature",
  "start": "2024-04-15T09:00:00.000Z",
  "continueFromEntry": "c4d5e6f7-2a3b-4c5d-8e9f-3a4b5c6d7e8f"
}

Response

Timer started successfully.

Example response

{
  "data": {
    "id": "b3b6e2c2-1f2a-4e3b-9c1d-2a4b6e2c21f2",
    "createdAt": "2024-04-15T09:00:00.000Z",
    "duration": -1,
    "start": "2024-04-15T09:00:00.000Z",
    "stop": "2024-04-15T17:00:00.000Z",
    "teamId": "team-1234",
    "description": "Worked on implementing user authentication feature",
    "rate": 75,
    "currency": "USD",
    "date": "2024-04-15",
    "user": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "fullName": "Jane Doe",
      "avatarUrl": "https://cdn.midday.ai/avatar.jpg"
    },
    "project": {
      "id": "b3b6e2c2-1f2a-4e3b-9c1d-2a4b6e2c21f2",
      "createdAt": "2024-03-01T10:00:00.000Z",
      "rate": 75,
      "currency": "USD",
      "status": "in_progress",
      "description": "Complete website redesign with modern UI/UX",
      "name": "Website Redesign Project",
      "billable": true,
      "estimate": 120,
      "customer": {
        "id": "customer-1234",
        "name": "Acme Corporation"
      }
    }
  }
}