Timer

Stop the timer

View as Markdown

POSThttps://paysuitett.com/api/v1/timer/stop

Stops the running timer. The body is optional.

Access. Any key, its holder's own timer; a master key anyone's with `user_id`.

Body

A JSON object. Every field is optional.

user_idstring · uuid: Master key only: stop this person's timer.
entry_idstring · uuid: Which running timer. Optional with one timer running; required when several are running (people allowed simultaneous timers).
endstring · date-time: When it ended, if not now. ISO 8601.
descriptionstring: Replace the description as it stops.

Response

200 with a JSON body, as in the example.

curl -X POST "https://paysuitett.com/api/v1/timer/stop" \
  -H "Authorization: Bearer $PAYSUITETT_API_KEY"

Success

{
  "entry": {
    "id": "7b8f0c2e-3c4d-4a51-9a0e-2f1b6c9d8e71",
    "user_id": "1f2e3d4c-5b6a-4789-8a7b-6c5d4e3f2a10",
    "status": "stopped",
    "started_at": "2026-10-05T09:00:00-04:00",
    "ended_at": "2026-10-05T11:30:00-04:00",
    "seconds": 9000,
    "hours": 2.5,
    "description": "LinkedIn search",
    "billable": true,
    "approved": false,
    "task_id": "c0a8012e-0d4b-4e3f-9b1a-7f6e5d4c3b2a",
    "task": "Sourcing",
    "project_id": "a1b2c3d4-e5f6-4789-90ab-cdef12345678",
    "project": "Recruiting Metrics Dashboard",
    "client": "21PG Recruiting",
    "source": "api"
  }
}