API Reference

Kova REST API

Integrate Kova with your tools. All endpoints require authentication and respect RBAC permissions.

Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer sk_live_your_api_key_here

Generate API keys in Settings → API Keys (Pro plan required).

Core

100 req/min

Growth

500 req/min

Pro

2000 req/min

GET/api/v1/employeesList employees in your organizationCore+

POST/api/v1/employeesCreate a new employee recordCore+

GET/api/v1/leave/requestsList leave requestsCore+

POST/api/v1/leave/requestsSubmit a leave requestCore+

GET/api/v1/departmentsList departmentsCore+

GET/api/v1/rolesList roles and permissionsCore+

POST/api/v1/ai/hr-assistantQuery the HR Assistant (uses credits)Pro

Try API calls directly from this page. Paste your API key in the Authorize button.