v1

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

Stop a timer

Stop the current running timer or a specific timer entry.

post/tracker-entries/timer/stop

Request body

entryIdstring uuid

Unique identifier of the specific timer entry to stop. If not provided, will stop the current running timer for the user

assignedIdstring uuid nullable

Unique identifier of the user whose timer should be stopped. If not provided, will use the authenticated user

stopstring date-time

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

Example request

{
  "entryId": "b3b6e2c2-1f2a-4e3b-9c1d-2a4b6e2c21f2",
  "assignedId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "stop": "2024-04-15T17:00:00.000Z"
}

Response

Timer stopped 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"
      }
    }
  }
}