timesheets.current
A person's running clock in a shop, or null when they are not clocked in. A field worker sees only their own.
When to use it
Keep the crew's time: timesheets.clockIn starts a clock on a job (category work) or for drive, shop or break time, and timesheets.clockOut stops it; one clock runs per person per shop (pass stop_running to switch). Forgotten time goes in with timesheets.add (start and end, at most 24 hours per entry); time never overlaps the same person's other time.
What to tell the owner
Tell them what you found in plain words. Don't read back raw fields.
| Field | Type | Required |
|---|
shop_id | string (uuid) | yes |
person_id | string (uuid) | no |
Example
GET https://doingwork.work/v1/timesheets/current?shop_id=00000000-0000-4000-8000-000000000000
Output
| Field | Type | Always there |
|---|
shop_id | string (uuid) | yes |
person_id | string (uuid) | yes |
running | | yes |
running_minutes | ['integer', 'null'] | yes |
{
"shop_id": "00000000-0000-4000-8000-000000000000",
"person_id": "00000000-0000-4000-8000-000000000000",
"running": "...",
"running_minutes": "..."
}
Errors
| Code | Status | What to do |
|---|
invalid_input, invalid_token, rate_limited | | Can happen on any call. See errors. |