TalentOS API
Github
Talent OS
  1. Employees
  • Auth
    • Register a new organization
      POST
    • Login as organization admin
      POST
    • Login as employee
      POST
    • Change employee password
      POST
  • Employees
    • List all employees
      GET
    • Create a new employee
      POST
    • Get my profile
      GET
    • Get my productivity score
      GET
    • Get employee by ID
      GET
    • Update employee
      PUT
    • Delete employee
      DELETE
    • Get employee productivity score
      GET
  • Tasks
    • List all tasks
      GET
    • Create a new task
      POST
    • Get my tasks
      GET
    • Get task by ID
      GET
    • Update task
      PUT
    • Delete task
      DELETE
    • Update task status
      PATCH
    • Update task transaction hash
      PATCH
  • Dashboard
    • Get dashboard statistics
      GET
    • Get productivity leaderboard
      GET
    • Get recent activity
      GET
  • AI
    • AI HR assistant chat
      POST
    • Organization skill gap analysis
      GET
    • My personal skill gap analysis
      GET
    • Get daily AI insight
      GET
    • Smart task assignment recommendation
      POST
    • Extract skills from resume PDF
      POST
  • Schemas
    • CreateEmployeeRequest
    • UpdateEmployeeRequest
    • CreateTaskRequest
    • UpdateTaskRequest
    • AuthResponse
    • Employee
    • Task
Github
Talent OS
  1. Employees

List all employees

GET
/employees
Returns all employees in the organization. Admin only.

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/employees' \
--header 'Authorization: Bearer <token>'

Responses

🟢200
application/json
List of employees
Body

Example
{
    "success": true,
    "data": [
        {
            "id": "cm5emp001",
            "orgId": "cm5abc123def456",
            "name": "Jane Smith",
            "email": "emp1@org.com",
            "role": "Frontend Engineer",
            "department": "Engineering",
            "skills": [
                "React",
                "TypeScript",
                "Tailwind CSS"
            ],
            "walletAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD38",
            "roleType": "EMPLOYEE",
            "isActive": true,
            "createdAt": "2026-02-20T10:30:00.000Z",
            "updatedAt": "2026-02-20T10:30:00.000Z"
        },
        {
            "id": "cm5emp002",
            "orgId": "cm5abc123def456",
            "name": "Bob Johnson",
            "email": "emp2@org.com",
            "role": "Backend Engineer",
            "department": "Engineering",
            "skills": [
                "Node.js",
                "PostgreSQL",
                "Docker"
            ],
            "walletAddress": null,
            "roleType": "EMPLOYEE",
            "isActive": true,
            "createdAt": "2026-02-20T10:35:00.000Z",
            "updatedAt": "2026-02-20T10:35:00.000Z"
        }
    ]
}
🟠401Unauthorized
🟠403AdminOnly
Modified at 2026-02-22 18:59:05
Previous
Change employee password
Next
Create a new employee
Built with