TataTrackAPI v1

API Documentation

Integrate TataTrack with any external system using API tokens.

Back to App →

Authentication

Generate an API token from your Profile → API Tokens page. Include it in every request as a Bearer token.

Base URL

https://www.tatatrack.cloud

Request Header

Authorization: Bearer tt_live_YOUR_TOKEN_HERE
Content-Type: application/json

Example — curl

curl -X GET https://www.tatatrack.cloud/api/tasks \
  -H "Authorization: Bearer tt_live_YOUR_TOKEN" \
  -H "Content-Type: application/json"

How TataTrack flow works

This is the real end-to-end app flow from onboarding to daily delivery.

1) Authentication and workspace context

User signs in, gets a session, and app loads the active company/workspace context from auth token.

2) Team and roles

Owner/Admin invite members, set role, and optionally restrict project access for member-level accounts.

3) Projects and tasks

Teams create projects, then tasks with status/priority/assignees/due dates. Access checks are enforced in APIs.

4) Collaboration

Notifications, comments, KB, and whiteboards keep updates and decisions visible across the workspace.

5) Workspace operations

Users can create their own workspace, switch workspace sessions, and continue work without re-login.

6) Billing

Workspace owner/admin can upgrade plan through PayPal subscription flow and manage plan state per company.

How core functions map to APIs

Quick reference for what each app function does and which endpoint powers it.

App function	What it does	Primary API
Auth / Sessions	Sign in/out and keep active session per device/workspace.	`/api/auth/login, /api/auth/logout, /api/auth/sessions`
Workspace Management	List workspaces, create new one, and switch active workspace.	`/api/workspaces, /api/workspaces/create, /api/workspaces/switch`
Projects	Create and manage project records and project details.	`/api/projects, /api/projects/:id`
Tasks	Create, assign, update, and delete tasks inside projects.	`/api/tasks, /api/tasks/:id`
Team	Invite members, update role, remove member, and resend invite.	`/api/team, /api/team/resend`
Knowledge Base	Create and manage articles/categories.	`/api/kb, /api/kb/:id`
Whiteboards	Create/share whiteboards and open shared boards.	`/api/whiteboards, /api/whiteboards/share`
Profile	Read and update user profile + preferences.	`/api/profile, /api/notification-preferences`
Billing	Create or cancel subscription and process webhook updates.	`/api/billing/create-subscription, /api/billing/cancel-subscription, /api/billing/webhook`
Search	Global search across available workspace data.	`/api/search`

Tasks

GET/api/tasksList all tasks for your company (with projects and team members)

Response

{ tasks: [...], projects: [...], users: [...] }

POST/api/tasksCreate a new task

Request Body

{ "title": "string", "status": "todo|in_progress|done", "priority": "low|medium|high", "projectId": 1, "assigneeId": 2, "dueDate": "2026-05-01" }

PATCH/api/tasks/:idUpdate task status, priority, assignee, or due date

Request Body

{ "status": "done", "assigneeId": 3 }

DELETE/api/tasks/:idDelete a task

Projects

GET/api/projectsList all projects for your company

POST/api/projectsCreate a new project

Request Body

{ "name": "string", "description": "string", "emoji": "🚀", "startDate": "2026-04-01", "endDate": "2026-06-30" }

GET/api/projects/:idGet a project with its tasks, team, and media

PATCH/api/projects/:idUpdate project details

Request Body

{ "name": "New name", "description": "Updated desc" }

Team

GET/api/teamList all team members and their invite status

POST/api/teamInvite a new team member

Request Body

{ "fullName": "string", "email": "string", "role": "admin|member" }

PATCH/api/teamChange a member role

Request Body

{ "userId": 1, "role": "admin" }

DELETE/api/teamRemove a member from the workspace

Request Body

{ "userId": 1 }

Knowledge Base

GET/api/kbList all articles and categories

POST/api/kbCreate a new article or category

Request Body

{ "title": "string", "content": "string", "type": "article|category", "parentId": 1 }

PATCH/api/kb/:idUpdate article title or content

Request Body

{ "title": "string", "content": "string", "isDraft": false }

DELETE/api/kb/:idDelete an article

Profile

GET/api/profileGet current user profile, role, and company info

PATCH/api/profileUpdate full name or avatar

Request Body

{ "fullName": "string", "avatarData": "data:image/png;base64,..." }

Error Codes

Code	Meaning
`401`	Unauthorized — missing or invalid token
`403`	Forbidden — token lacks permission for this action
`404`	Not found — resource does not exist in your company
`400`	Bad request — check your request body
`500`	Server error — contact support