Endpoint reference
Every endpoint of the v1 API at a glance, with the interactive explorer for the details.
Last updated 15 August 2026
All paths are relative to https://yourworkspace.temponia.com/api/v1. Reads
need the temponia:read scope, writes need temponia:write. For request and
response schemas, open the API explorer or download the
OpenAPI description.
Time entries
| Method and path | What it does |
|---|---|
GET /timesheets |
List the user's time entries |
GET /timesheets/{id} |
Fetch one entry (returned as a one-element array) |
POST /timesheets |
Create an entry |
PATCH /timesheets/{id} |
Update an entry |
DELETE /timesheets/{id} |
Delete an entry |
GET /timesheets/most_used_tasks |
The task links used most in the last 7 days |
GET /timesheets/find_by_external_id |
Find an entry by an external system's id |
A time entry has time_start, time_end, notes and a task_link_id
pointing at the project and task combination it belongs to. Create and update
requests send these fields at the top level of the JSON body.
Reading your workspace
| Method and path | What it does |
|---|---|
GET /projects |
Projects the user can see |
GET /clients |
Clients the user can see |
GET /tasks |
The company's tasks |
GET /task_links |
Task and project combinations the user can track time on |
GET /assignments |
The user's project assignments |
GET /companies |
The user's company, as a single object |
Expenses
| Method and path | What it does |
|---|---|
GET /expense_types |
The company's active expense types |
GET /expenses |
List the user's expenses |
POST /expenses |
Create an expense |
PATCH /expenses/{id} |
Update an expense |
DELETE /expenses/{id} |
Delete an expense |
Expense create and update requests nest their fields under an expense key.
Filtering lists
List endpoints take an optional q parameter holding a JSON object of
Ransack predicates:
GET /api/v1/timesheets?q={"time_start_gteq":"2026-08-01","time_start_lt":"2026-09-01"}
Predicates combine the field name with a matcher such as _eq, _gteq,
_lt or _cont.