Pause running time tracker

Pauses a running time tracker by ending its current active interval. The interval end time is set to the current time.

After pausing, the tracker stops accumulating time but can be resumed later using the resume endpoint. This is useful for breaks or when switching to other work.

If the tracker is not currently running, this endpoint has no effect.

POST/account/time-tracker/{id}/pause

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Path parameters

idstringrequired

Query parameters

fieldsToReturnstring

Comma-separated list of top-level response fields to return. Overrides the endpoint compact default unless responseShape=full is used.

responseShapestring

Advanced override. Omit for the endpoint compact default. Use full only when you need the complete endpoint response, including nested fields that are not selectable with fieldsToReturn.

Allowed:compactfull

Header parameters

LT-Response-Shapestring

Advanced override. Set to full only when you need the complete endpoint response, including nested fields that are not selectable with fieldsToReturn.

Allowed:full

Responses

200

activityIdobject | nullrequired

UUID of the activity category (e.g., Development, Testing, Management). Used for categorizing work in reports. Can be null.

autoEndedbooleanrequired

Whether any interval was automatically ended at the end of the day. This happens when a running interval started on a previous day and was not manually stopped.

commentobject | nullrequired

Optional comment or description of the work being tracked. Helps provide context when reviewing time entries later.

correctionnumberrequired

Manual time adjustment in minutes. Positive values add time, negative values subtract time. Useful for correcting tracking errors or adding time that was not tracked. Default is 0.

createdAtstringrequired

Timestamp when the tracker was created, in ISO 8601 format (UTC)

hoursnumberrequired

Total tracked time in hours, calculated from all intervals plus any correction. Minimum value is 0.0166667 (1 minute).

hoursPaddedstringrequired

Hours portion of the tracked time, formatted as a zero-padded string (e.g., "02", "12", "00")

idstringrequired

Unique identifier for the time tracker (UUID)

intervalsTimeTrackerIntervalDto[]required

Array of time intervals that make up the total tracked time. Each interval represents a continuous period of tracking (start to end). If an interval has no end, it is currently active. Intervals are automatically ended at end of day if they span midnight.

Show properties

Array of TimeTrackerIntervalDto

endstringrequired

Interval end time in ISO 8601 format (UTC). For active (running) intervals, this is set to the current time. For completed intervals, this marks when tracking stopped. Intervals that span midnight are automatically ended at end of day.

startstringrequired

Interval start time in ISO 8601 format (UTC). This is when the time tracking period began.

isOldbooleanrequired

Whether the tracker contains intervals from previous days. True if any interval start time is not from today.

isRunningbooleanrequired

Whether the tracker currently has an active (running) interval. True if any interval has no end time, meaning time is being tracked right now.

minutesPaddedstringrequired

Minutes portion of the tracked time, formatted as a zero-padded string (e.g., "05", "30", "59")

projectIdobject | nullrequired

UUID of the project this tracker is associated with. Can be null if tracking general work.

taskIdobject | nullrequired

UUID of the task this tracker is associated with. Only used when timeTrackingType is Task. Can be null for project-level tracking.

timeTrackingTypestringrequired

Type of time tracking: Task (tracking time on a specific task) or Project (tracking time at project level). Determines whether taskId is required.

Allowed:TaskProject

401Unauthorized - Invalid or missing authentication token

403Forbidden - Insufficient API scopes or permissions

404Tracker not found or does not belong to user

Request

curl -X POST "https://leadtime.app/api/public/account/time-tracker/string/pause" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const response = await fetch("https://leadtime.app/api/public/account/time-tracker/string/pause", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/account/time-tracker/string/pause",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN"
    },
)

Response

{
  "activityId": "550e8400-e29b-41d4-a716-446655440003",
  "autoEnded": false,
  "comment": "Working on feature implementation",
  "correction": 0,
  "createdAt": "2024-01-15T10:00:00Z",
  "hours": 2.5,
  "hoursPadded": "02",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "intervals": [
    {
      "end": "2024-01-15T11:30:00Z",
      "start": "2024-01-15T10:00:00Z"
    }
  ],
  "isOld": false,
  "isRunning": true,
  "minutesPadded": "30",
  "projectId": "550e8400-e29b-41d4-a716-446655440001",
  "taskId": "550e8400-e29b-41d4-a716-446655440002",
  "timeTrackingType": "Task"
}