Delete time entry
delete_time_entryPermanently delete a logged time entry for genuinely wrong entries. No undo: removes booked hours from cost reports and the work package's spent time.
Instructions
Permanently delete a logged time entry.
Use only on explicit user instruction, and only for genuinely wrong entries. Deletion removes the booked hours from every cost report and from the work package's aggregated spent time, with no API-side undo.
Returns a small confirmation object once OpenProject accepts the deletion.
Pitfalls. If the entry is merely on the wrong day, has the wrong
duration or the wrong activity, update_time_entry is the better
answer — it keeps the audit trail. Deleting someone else's entry needs
an administrative permission and otherwise fails with
permission_denied. Entries inside a closed cost-reporting period
cannot be deleted.
Cross-references: find the id with list_time_entries; correct
instead of deleting with update_time_entry.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | No | Must be true. Ask the user to confirm first — the API offers no undo. Calling with confirm=false returns a confirmation_required error rather than deleting anything. | |
| time_entry_id | Yes | Id of the time entry to delete permanently. It comes from list_time_entries — confirm the id belongs to the entry you mean before calling, since ids are not human-readable. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Id of the time entry that was deleted. | |
| deleted | Yes | True once OpenProject accepted the deletion. | |
| message | Yes | Human-readable confirmation. |