TalentOS API
Github
Talent OS
  1. AI
  • 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 productivity leaderboard
    • Get recent activity
  • 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. AI

AI HR assistant chat

POST
/ai/chat
Ask natural-language questions about your team, employees, tasks, and organization.
Uses Google Gemini with full org context. Admin only. Rate limited to 30 req/15min.

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Body Params application/jsonRequired

Example
{
    "question": "Who are our top performers this month and what tasks did they complete?"
}

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 POST '/ai/chat' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "question": "Who are our top performers this month and what tasks did they complete?"
}'

Responses

🟢200
application/json
AI-generated answer
Body

Example
{
    "success": true,
    "data": {
        "answer": "Based on your organization's data, your top performers this month are:\n\n1. **Jane Smith** (Frontend Engineer) - Completed 6 out of 8 tasks with a 92.5% productivity score. Notable completions include the Dashboard UI and Design System implementation.\n\n2. **Bob Johnson** (Backend Engineer) - Completed 5 out of 6 tasks with 85% productivity. Key deliverables were the REST API and database optimization.\n\nRecommendation: Consider recognizing their contributions in the next team meeting."
    }
}
🟠429RateLimited
Modified at 2026-02-22 18:59:05
Previous
Get recent activity
Next
Organization skill gap analysis
Built with