Legacy API Version
This is the legacy v1 API. For new features and enhanced functionality, please use Maniyam API v2.
What is Maniyam API v1?
Maniyam API v1 is the original production backend for the Maniyam HR Management platform. It provides core HRMS functionality including authentication, user management, permissions, and basic HR operations. This version is maintained for backward compatibility while v2 introduces advanced features.
Core Technologies
- • FastAPI - Python async web framework
- • SQLAlchemy - ORM with PostgreSQL
- • Redis - Session caching
- • Pydantic - Data validation
- • JWT - Token-based authentication
Production Features
- • Multi-tenancy - Tenant data isolation
- • RBAC - Role-based access control
- • Rate Limiting - Request throttling
- • Logging - Structured API logging
- • Security - CORS, headers, validation
V1 vs V2 Comparison
API v1 (This System)
devv1.maniyam.com • Legacy
Available Features
- Authentication & JWT
- User Management
- Role Permissions (RBAC)
- Tenant Management
- Dynamic Forms Engine
- Leave Management
- Timesheet & Payroll
- Basic Invoicing
Use Case: Existing integrations
API v2 (Recommended)
devv2.maniyam.com • Next Generation
Additional Features
- All V1 Features Included
- Groups & Departments (Enhanced) NEW
- User Assignments Module NEW
- Work Assignments NEW
- ETL Reporting System NEW
- AI Resume Screening (ATS) WIP
- AI Chatbot Integration WIP
Production Features (v1)
Authentication
ProductionJWT-based authentication with access/refresh tokens, password reset, and session management.
User Management
ProductionComplete user lifecycle management with profiles, permissions, and multi-tenant isolation.
RBAC Permissions
ProductionHierarchical role-based access control with 49,000+ permission records.
Dynamic Forms
ProductionFlexible form builder with templates, field relations, and custom validations.
Leave Management
ProductionEmployee leave requests, approvals, balances, and holiday calendar.
Timesheet & Payroll
ProductionTime tracking, attendance management, and payroll processing.
Business Value
For HR Teams
- ✓ Centralized Data: Single source of truth for all employee information
- ✓ Self-Service: Employees manage their own profiles, leaves, and timesheets
- ✓ Compliance: Audit trails and structured logging for all operations
For IT Teams
- ✓ REST API: Easy integration with existing enterprise systems
- ✓ Multi-tenant: Secure data isolation for different business units
- ✓ Scalable: Async architecture handles high concurrent loads
API Endpoints
Authentication
Login, logout, refresh tokens, password reset
/api/auth/*
Users
User CRUD, profiles, permissions
/api/users/*
Tenants
Tenant management, configuration
/api/tenants/*
Forms
Dynamic forms, templates, fields
/api/forms/*
Leave Management
Leave requests, approvals, balances
/api/leave/*
Timesheet
Time entries, attendance
/api/timesheet/*
Upgrading to v2
API v2 is fully backward compatible with v1 endpoints. New features are added via new endpoints, so existing integrations continue to work without changes.
Update Base URL
Change from devv1.maniyam.com to devv2.maniyam.com
Test Endpoints
Verify existing integrations work with v2 API
Adopt New Features
Gradually integrate new v2 capabilities
Technical Details
Database Schema
Schema: maniyamproddb
Tables: 36
Users: 111