Start / End Break

Track break time inside an open entry. Break minutes are deducted from worked time. One break can be in progress at a time; ending it adds the elapsed minutes to the entry's break_minutes total.

Endpoints

POST /v1/staff/time-entries/{id}/break/start
POST /v1/staff/time-entries/{id}/break/end

Authentication

Requires an API key with the staff:write scope.

Response

Success (200 OK)

{
  "data": {
    "id": 13,
    "staff_id": 5,
    "is_on_break": true,
    "break_started_at": "2026-06-13T12:30:00+00:00",
    "break_minutes": 0,
    "worked_minutes": 212
  },
  "meta": { "request_id": "req_abc123", "timestamp": "2026-06-13T12:30:00+00:00" }
}

Errors

Status	Code	Description
404	not_found	Time entry not found
403	forbidden	Entry belongs to another supplier
422	break_start_failed	Entry is clocked out, or a break is already in progress
422	break_end_failed	No break in progress

Example Request

curl -X POST "https://app.equipdash.com/api/v1/staff/time-entries/13/break/start" \
  -H "Authorization: Bearer YOUR_API_KEY"