The Taskee REST API
The API is the same interface the Taskee web app talks to, so anything the app can read or change is reachable from your own code.
What the connection gives you
- Move work in and out. Create projects and tasks, update status, priority, deadline, assignee and tags, add checklists and comments.
- Get hours into your billing. Read reported hours per task, per user and per date, and pull the same project and user reports the Reports screen shows.
- Keep the roster in sync. Create users, assign roles and permissions, group people into departments and teams.
- React to what changed. Read notifications, task history and project last-activity to drive a job on your side.
How to connect
- Sign in to Taskee and obtain an access token.
- Send it on every request in the Authorization header — the scheme is a plain API key in the header, not OAuth.
- Point your client at your company subdomain.
- Generate a client from the OpenAPI 3.0 specification, or call the endpoints directly.
The specification is published and browsable, so the endpoint list, request bodies and response shapes can be read before writing any code.
What is covered
The endpoints are grouped the way the app is: Auth, Companies, Departments, Files, Notes, Notifications, Onboarding, Permissions, Projects, Project groups, Project tasks, Task checklists, Task followers, Task tags, Project teams, Reports, Reported hours, Roles, Search, Sections, Task comments, Task statuses, Users and Timezone.
Reports are also available as files — see CSV report export.
Frequently asked questions
A token in the Authorization header. The OpenAPI specification declares a single security scheme of type apiKey, placed in the header.
Yes. The API is described as OpenAPI 3.0 and the specification is published, so clients can be generated automatically for most languages.
Yes. Reported hours are readable per task, per user and per date range, and the project and user reports are available as endpoints. Adding export=true returns the same CSV a manual export produces.
