# TalentOS API

## API Docs
- Auth [Register a new organization](https://talentos-api.praneethd.xyz/register-a-new-organization-28423114e0.md): Creates a new organization account and returns a JWT token. No authentication required.
- Auth [Login as organization admin](https://talentos-api.praneethd.xyz/login-as-organization-admin-28423115e0.md): Authenticates an organization admin and returns a JWT token (without `employeeId`).
- Auth [Login as employee](https://talentos-api.praneethd.xyz/login-as-employee-28423116e0.md): Authenticates an employee and returns a JWT token that includes `employeeId` and `roleType`.
- Auth [Change employee password](https://talentos-api.praneethd.xyz/change-employee-password-28423117e0.md): Allows an authenticated employee to change their password. Requires the current password for verification.
- Employees [List all employees](https://talentos-api.praneethd.xyz/list-all-employees-28423118e0.md): Returns all employees in the organization. **Admin only.**
- Employees [Create a new employee](https://talentos-api.praneethd.xyz/create-a-new-employee-28423119e0.md): Creates a new employee in the organization. **Admin only.**
- Employees [Get my profile](https://talentos-api.praneethd.xyz/get-my-profile-28423120e0.md): Returns the authenticated employee's own profile with their tasks. **Employee only.**
- Employees [Get my productivity score](https://talentos-api.praneethd.xyz/get-my-productivity-score-28423121e0.md): Returns the authenticated employee's own productivity score with breakdown. **Employee only.**
- Employees [Get employee by ID](https://talentos-api.praneethd.xyz/get-employee-by-id-28423122e0.md): Returns a single employee with their tasks. **Admin only.**
- Employees [Update employee](https://talentos-api.praneethd.xyz/update-employee-28423123e0.md): Updates an employee's details. All fields are optional. **Admin only.**
- Employees [Delete employee](https://talentos-api.praneethd.xyz/delete-employee-28423124e0.md): Permanently deletes an employee and **all their tasks** (cascade delete). **Admin only.**
- Employees [Get employee productivity score](https://talentos-api.praneethd.xyz/get-employee-productivity-score-28423125e0.md): Returns an employee's productivity score with full breakdown. **Admin only.**
- Tasks [List all tasks](https://talentos-api.praneethd.xyz/list-all-tasks-28423126e0.md): Returns all tasks in the organization with optional filters. **Admin only.**
- Tasks [Create a new task](https://talentos-api.praneethd.xyz/create-a-new-task-28423127e0.md): Creates a new task assigned to an employee. Initial status is `TODO`. **Admin only.**
- Tasks [Get my tasks](https://talentos-api.praneethd.xyz/get-my-tasks-28423128e0.md): Returns all tasks assigned to the authenticated employee. **Employee only.** Automatically scoped — no filters needed.
- Tasks [Get task by ID](https://talentos-api.praneethd.xyz/get-task-by-id-28423129e0.md): Returns a single task with employee details. **Admin only.**
- Tasks [Update task](https://talentos-api.praneethd.xyz/update-task-28423130e0.md): Updates task details. All fields optional. Use the dedicated `/status` endpoint for status changes. **Admin only.**
- Tasks [Delete task](https://talentos-api.praneethd.xyz/delete-task-28423131e0.md): Permanently deletes a task. This action cannot be undone. **Admin only.**
- Tasks [Update task status](https://talentos-api.praneethd.xyz/update-task-status-28423132e0.md): Updates a task's status. **Both admins and employees** can use this endpoint.
- Tasks [Update task transaction hash](https://talentos-api.praneethd.xyz/update-task-transaction-hash-28423133e0.md): Stores a Web3 transaction hash for blockchain verification of task completion.
- Dashboard [Get dashboard statistics](https://talentos-api.praneethd.xyz/get-dashboard-statistics-28423134e0.md): Returns dashboard stats. **Response differs by role:**
- Dashboard [Get productivity leaderboard](https://talentos-api.praneethd.xyz/get-productivity-leaderboard-28423135e0.md): Returns the top 5 employees ranked by productivity score. **Admin only.**
- Dashboard [Get recent activity](https://talentos-api.praneethd.xyz/get-recent-activity-28423136e0.md): Returns recent task activity. **Response differs by role:**
- AI [AI HR assistant chat](https://talentos-api.praneethd.xyz/ai-hr-assistant-chat-28423137e0.md): Ask natural-language questions about your team, employees, tasks, and organization.
- AI [Organization skill gap analysis](https://talentos-api.praneethd.xyz/organization-skill-gap-analysis-28423138e0.md): Analyzes skill gaps across all employees in the organization.
- AI [My personal skill gap analysis](https://talentos-api.praneethd.xyz/my-personal-skill-gap-analysis-28423139e0.md): Returns the authenticated employee's personal skill gap analysis with a 30-day learning plan.
- AI [Get daily AI insight](https://talentos-api.praneethd.xyz/get-daily-ai-insight-28423140e0.md): Returns an AI-generated daily insight based on organization performance data.
- AI [Smart task assignment recommendation](https://talentos-api.praneethd.xyz/smart-task-assignment-recommendation-28423141e0.md): Gets an AI recommendation for the best employee to assign a task to,
- AI [Extract skills from resume PDF](https://talentos-api.praneethd.xyz/extract-skills-from-resume-pdf-28423142e0.md): Upload a PDF resume and extract skills, name, role, and a professional summary using AI.

## Schemas
- [CreateEmployeeRequest](https://talentos-api.praneethd.xyz/createemployeerequest-13027628d0.md): 
- [UpdateEmployeeRequest](https://talentos-api.praneethd.xyz/updateemployeerequest-13027629d0.md): 
- [CreateTaskRequest](https://talentos-api.praneethd.xyz/createtaskrequest-13027630d0.md): 
- [UpdateTaskRequest](https://talentos-api.praneethd.xyz/updatetaskrequest-13027631d0.md): 
- [AuthResponse](https://talentos-api.praneethd.xyz/authresponse-13027632d0.md): 
- [Employee](https://talentos-api.praneethd.xyz/employee-13027633d0.md): 
- [Task](https://talentos-api.praneethd.xyz/task-13027634d0.md):