Clock In

Clock a staff member in. Creates an open time entry and automatically links the staff member's scheduled shift for today (supplier timezone) when one exists. A staff member can only have one open entry at a time.

Endpoint

POST /v1/staff/time-entries/clock-in

Authentication

Requires an API key with the staff:write scope.

Request Body

Field	Type	Required	Description
staff_id	integer	Yes	The staff member to clock in

Response

Success (201 Created)

{
  "data": {
    "id": 13,
    "staff_id": 5,
    "staff": { "id": 5, "first_name": "Jane", "last_name": "Smith" },
    "staff_shift_id": 44,
    "clock_in_at": "2026-06-13T08:58:00+00:00",
    "clock_out_at": null,
    "is_on_break": false,
    "break_started_at": null,
    "break_minutes": 0,
    "worked_minutes": 0,
    "source": "app",
    "notes": null
  },
  "meta": { "request_id": "req_abc123", "timestamp": "2026-06-13T08:58:00+00:00" }
}

Errors

Status	Code	Description
422	validation_failed	Missing or cross-supplier staff_id
422	clock_in_failed	Staff member is already clocked in
403	insufficient_scope	API key lacks staff:write scope

Example Request

curl -X POST "https://app.equipdash.com/api/v1/staff/time-entries/clock-in" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"staff_id": 5}'