Delete time record with the Everhour API
Removes a time record by setting its duration to zero. The history of the record is kept, and it no longer appears in List time records.
- Identifier
- everhour_delete_time_record
The request
POST https://connect.reportei.com/api/tools/everhour_delete_time_record/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"time_id": 1
}
}Your system sends your customer's connection id and the tool arguments. The headers are the same as the rest of the Connect API: your product's token and your customer's token.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| time_id | integer | Yes | Id of the time record, from List time records. |
Supported connections
Your customer connects their Everhour account once, with one of the modes below. The same connection serves every tool of the toolkit.
API key
Your customer pastes the app's key on a Connect screen, or your system sends the key with POST /api/customer-toolkits, with no screen.
The response
On success, Connect preserves the app's response status and body. HTTP errors returned by the app use the {error, api_error} envelope; authentication or validation can fail before execution. The X-Toolkit-Execution-Id header identifies the recorded execution, available at GET /api/tools/executions/{uuid}.
Ready for AI agents
This tool's input is a JSON Schema, available at GET /api/tools/everhour_delete_time_record. It becomes your agent's tool definition with no conversion.
Other Everhour tools
- List clientsGETLists the clients of the team in a single response, with the ids of their projects and the budget with its usage in progress. Money is in cents and time in seconds.
- Create clientPOSTCreates a client. Names are not deduplicated, so check List clients first. Link the projects whose time is invoiced to this client.
- Update clientPUTChanges a client. Only the fields sent are changed. To link a new project, send the complete projects list, including the ids already linked that List clients shows.
- Update client budgetPUTCreates or replaces the budget of a client. Send the whole budget, because partial updates are not supported. Reaching the threshold emails the admins of the team.
- List projectsGETLists the projects the user has access to, with the client id, billing type, rates and budget with its usage. Ids carry the integration prefix, such as as:1234567890 for Asana or ev:1234567890 for projects created in Everhour. Pages start at 1, and a page shorter than limit is the last one.
- Search tasksGETSearches tasks by name in all projects, or in one project. Returns the task ids, such as ev:3000010034, that the time record tools ask for, with the project ids, status and time totals in seconds.
- List time recordsGETLists the time records of the whole team in a date range, both days included. Without from and to it returns only today. Each record has the time in seconds, the user id, whose name comes from List users, the date, the task with its project ids, and isInvoiced. A page shorter than limit is the last one.
- Create time recordPOSTLogs time on a task for a day. A user has at most one record per task and day: sending the same user, task and date again updates the duration of that record instead of creating another one.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
