Time Clock: Delete Time Activity API

You can now delete a single time activity — a punch shift or a manual break — directly through the External API.

New Endpoint

• DELETE /time-clock/v1/time-clocks/{timeClockId}/time-activities/{timeActivityId} — Delete one shift or manual break by its unique ID.

Key Features

• Delete by ID: Uses the same activity id returned by Get Time Activities and used in Update Time Activities.
• Server-side owner resolution: You supply only the time clock and the activity ID — no userId needed.
• Targeted deletes: Removing a manual break leaves its parent shift intact.
• Idempotent: Deleting an already-removed or non-existent activity returns a clean 404 TIME_ACTIVITY_NOT_FOUND.
• Locked-day protection: Activities on locked or approved timesheet days are blocked with HAS_LOCKED_DAYS.

Authentication

• API Key (X-API-KEY header), or
• OAuth 2.0 with scope time_clock.delete

Use Cases

• Correct bad imports: Remove shifts or breaks created in error from an external system.
• Sync deletions: Mirror deletions made in a third-party time-tracking tool back into Connecteam.
• Clean up duplicates: Delete duplicate punches before finalizing payroll.

For full details and examples, see the Time Activities guide and the API Reference.