GET /api/employees

{
  "data": {
    "items": [...],
    "total": 100,
    "page": 1,
    "limit": 20,
    "totalPages": 5
  }
}

GET /api/employees/:id

{
  "data": {
    "id": "cuid",
    "firstName": "John",
    "lastName": "Doe",
    "email": "john@example.com",
    "jobTitle": "Software Engineer",
    "status": "ACTIVE",
    "orgRelations": {
      "primaryManager": {...},
      "teams": [...],
      "departments": [...]
    }
  }
}

POST /api/employees

{
  "firstName": "John",
  "lastName": "Doe",
  "email": "john@example.com",
  "jobTitle": "Software Engineer",
  "employmentType": "FULL_TIME",
  "workMode": "HYBRID",
  "hireDate": "2024-01-15"
}

PATCH /api/employees/:id

DELETE /api/employees/:id

POST /api/org/employees/:id/primary-manager

{
  "managerId": "manager-cuid"
}

DELETE /api/org/employees/:id/primary-manager

POST /api/org/employees/:id/dotted-line-managers

{
  "managerId": "manager-cuid"
}

DELETE /api/org/employees/:id/dotted-line-managers/:managerId

POST /api/org/employees/:id/additional-managers

{
  "managerId": "manager-cuid"
}

DELETE /api/org/employees/:id/additional-managers/:managerId

POST /api/org/employees/:id/teams

{
  "teamId": "team-cuid",
  "role": "Tech Lead"
}

PATCH /api/org/employees/:id/teams/:teamId

{
  "role": "Team Lead"
}

DELETE /api/org/employees/:id/teams/:teamId

POST /api/org/employees/:id/departments

{
  "departmentId": "dept-cuid",
  "isPrimary": true
}

DELETE /api/org/employees/:id/departments/:departmentId

PUT /api/org/employees/:id/departments/:departmentId/primary

POST /api/org/employees/:id/roles

{
  "roleId": "role-cuid",
  "isPrimary": true
}

DELETE /api/org/employees/:id/roles/:roleId

PUT /api/org/employees/:id/roles/:roleId/primary

GET /api/v1/org/employees/chart

{
  "data": {
    "nodes": [...],
    "edges": [
      { "from": "manager-id", "to": "employee-id", "type": "primary" }
    ]
  }
}

GET /api/org/employees/:id/summary

{
  "data": {
    "employee": {...},
    "primaryManager": {...},
    "dottedLineManagers": [...],
    "additionalManagers": [...],
    "departments": [...],
    "teams": [...],
    "roles": [...],
    "directReports": [...]
  }
}

GET /api/teams
GET /api/teams/:id
POST /api/teams
PATCH /api/teams/:id
DELETE /api/teams/:id

GET /api/departments
GET /api/departments/:id
POST /api/departments
PATCH /api/departments/:id
DELETE /api/departments/:id

GET /api/roles
POST /api/roles

GET /api/timeoff/requests

POST /api/timeoff/requests

{
  "policyId": "policy-cuid",
  "startDate": "2024-03-01",
  "endDate": "2024-03-05",
  "reason": "Family vacation"
}

PATCH /api/timeoff/requests/:id

{
  "status": "APPROVED",
  "approverComment": "Approved. Have fun!"
}

{
  "data": {
    "id": "request-cuid",
    "status": "APPROVED",
    "approverId": "employee-cuid",
    "approvedAt": "2024-03-01T10:30:00Z",
    "approverComment": "Approved. Have fun!"
  },
  "error": null
}

GET /api/timeoff/balances
GET /api/timeoff/balances/:employeeId

GET /api/timeoff/calendar

POST /api/ai/chat

{
  "message": "Who is the CTO?",
  "context": {
    "employeeId": "current-employee-id"
  }
}

POST /api/ai/org/explain

{
  "employeeId": "employee-cuid"
}

{
  "data": {
    "summary": "John reports to Sarah (CTO) with a dotted line to...",
    "directManager": {...},
    "dottedLineManagers": [...],
    "teams": [...],
    "directReports": 5
  }
}

POST /api/ai/org/validate

{
  "checkCircular": true,
  "checkOrphans": true,
  "checkOverextended": true,
  "maxReportsThreshold": 15
}

{
  "data": {
    "valid": false,
    "issues": [
      {
        "type": "OVEREXTENDED",
        "severity": "WARNING",
        "employeeId": "manager-id",
        "message": "Manager has 18 direct reports"
      }
    ],
    "summary": {
      "total": 50,
      "withManager": 48,
      "orphans": 2,
      "overextended": 1,
      "circular": 0
    }
  }
}

POST /api/ai/org/generate

{
  "description": "We're a 20-person startup with 3 squads...",
  "teamSize": 20,
  "style": "squads"
}

{
  "data": null,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Email is required",
    "details": {...}
  }
}