TimeTracks API (1.0.0)

Authenticates the user using their email and password credentials. Returns a long-lived access token (valid for 1 day) and a refresh token (valid for 7 days) to enable continuous access without requiring frequent re-authentication. This flow is suitable for interactive user sessions such as web or mobile clients.

Exchanges a valid refresh token for a new access token and refresh token pair. The access token is valid for 1 day, and the refresh token expires 7 days after the session start time. To maintain continuous access, clients must call this endpoint before the refresh token expires.

Logs in a user and returns a short-lived JWT along with a refresh token. Intended for programmatic access such as CLI tools, scripts, or temporary sessions requiring frequent token rotation.

Exchanges a short-lived refresh token for a new access token and refresh token pair. The access token is valid for 15 minutes, while the refresh token remains valid for 1 day from the session start time. This flow is optimized for automated scripts or background jobs that require frequent token renewal and short-lived access, with security in mind.

Retrieves all active sessions (access and refresh tokens) created by users within the authenticated organisation. This endpoint is typically used by administrators to monitor or audit user sessions across the entire team. Requires a valid access token with administrative privileges.

Completes the signup process for an invited user using a one-time invitation link. Creates the user account and removes the invitation if it is valid and not expired.

Retrieves an organisation by its ID.

Updates an organisation's details.

Deletes an organisation by its ID.

Retrieves all users under your organisation

Creates a new user entry

Retrieves a user by their ID.

Updates a user's details.

Deletes a user by their ID.

Allows a user to update their own password.

Allows an admin to reset a user's password.

Retrieves all API keys owned by user

Generates a new API key for the authenticated user. The plain-text key is returned once in the response and must be stored securely. The response also includes metadata about the key for future reference.

Retrieves metadata for a specific API key, including its name, creation time, last usage timestamp, and masked identifier (last 4 characters).i The actual secret value of the API key is not returned for security reasons.

Invalidates the existing API key and generates a new one. The original key is permanently deleted, and a new key is returned in the response. The new key must be stored securely, as it will not be shown again. Useful when rotating credentials for security or automation purposes.

Permanently deletes an API key identified by its ID. This action revokes access for any client using the key. Once deleted, the key cannot be recovered.

Retrieves all projects.

Creates a new project entry.

Retrieves a project by its ID.

Updates a project's details.

Deletes a project by its ID

Retrieve all tasks associated with a specific project.

Adds a new task and assigns it to the specified project by project ID.

Updates the task's project association by assigning it to a different project. This operation is useful for reorganizing tasks across projects without modifying the task content.

Permanently deletes a task from the specified project. This operation cannot be undone and will remove the task and its time tracking data entirely.

Removes the association between the task and its project, but keeps the task and its data intact.

Associates an existing standalone task with the specified project. This operation updates the task's project reference without modifying other task data.

Retrieves all tasks

Creates a new task entry.

Retrieves a task by its ID.

Updates a task's details

Deletes a task by its ID.

Starts time tracking for task ID

Ends time tracking for task ID.

Starts time tracking using task name. If tasks does not exist, it gets created first

Starts time tracking using external ID. This ID typically comes from an integrated third-party project management system such as Jira, Trello, Asana, or GitHub. If tasks does not exists, it gets created first

Retrieves all time tracking entries associated with the specified task. Useful for reporting, auditing, or displaying time spent on a specific task.

Starts a new time tracking entry for the specified task. Records the start time and, optionally, the end time if provided.

Retrieves a specific time tracking entry associated with the given task ID and time track ID. Useful for viewing detailed time tracking information for a single entry.

Modifies an existing time tracking entry associated with the specified task. Typically used to set or adjust the end time, duration, or correct tracking errors.

Permanently removes a specific time tracking entry associated with the given task. This action cannot be und

Retrieves all invitations under your organisation