REST API Reference

Base URL: https://api.keito.ai/v1

All requests and responses use JSON. Authenticate with a Bearer token in the Authorization header.

Conventions

• Dates — ISO 8601 format: YYYY-MM-DD for dates, full ISO for timestamps.
• IDs — prefixed strings: prj_, tsk_, usr_, te_, exp_.
• Pagination — cursor-based. Responses include next_cursor when more results exist.
• Errors — consistent error object (see Error Handling).

Endpoints

Method	Endpoint	Description
POST	/v1/time-entries	Create a time entry
GET	/v1/time-entries	List time entries
GET	/v1/time-entries/:id	Get a single time entry
PATCH	/v1/time-entries/:id	Update a time entry
DELETE	/v1/time-entries/:id	Delete a time entry
POST	/v1/expenses	Create an expense
GET	/v1/expenses	List expenses
GET	/v1/expenses/:id	Get a single expense
GET	/v1/projects	List projects
GET	/v1/projects/:id	Get a single project
GET	/v1/users	List users
GET	/v1/users/:id	Get a single user

Common Query Parameters

Parameter	Type	Description
source	string	Filter by source: web, cli, api, agent
project_id	string	Filter by project
user_id	string	Filter by user
from	string	Start date (YYYY-MM-DD)
to	string	End date (YYYY-MM-DD)
cursor	string	Pagination cursor
limit	number	Results per page (default 50, max 200)