TataTrackAPI v1

API Documentation

Integrate TataTrack with any external system using API tokens.

Authentication

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

Base URL

https://tatatrack.vercel.app

Request Header

Authorization: Bearer tt_live_YOUR_TOKEN_HERE
Content-Type: application/json

Example — curl

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

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