API Documentation
Build custom integrations with the Chartav.io REST API. Full CRUD access to employees, departments, and org charts.
Simple Authentication
API key authentication with granular permission scopes. Generate keys from your dashboard.
Real-time Webhooks
Subscribe to events like employee changes, department updates, and org restructures.
Enterprise Security
TLS 1.3 encryption, rate limiting, and IP allowlisting for enterprise deployments.
Quick Start
// Example: Fetch all employees
const response = await fetch('https://api.chartav.io/v1/employees', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
});
const employees = await response.json();
console.log(employees);
// { data: [...], meta: { total: 150, page: 1 } }Base URL
https://api.chartav.io/v1
Authentication
All API requests require authentication using a Bearer token. Generate API keys from your dashboard under Settings → API Keys.
Authorization: Bearer YOUR_API_KEY
Rate Limits
| Plan | Requests/min | Requests/day |
|---|---|---|
| Free | 60 | 1,000 |
| Pro | 300 | 10,000 |
| Enterprise | Custom | Unlimited |
Endpoints Overview
Employees
| GET | /employees | List all employees |
| POST | /employees | Create an employee |
| GET | /employees/:id | Get employee details |
| PATCH | /employees/:id | Update an employee |
| DELETE | /employees/:id | Delete an employee |
Departments
| GET | /departments | List all departments |
| POST | /departments | Create a department |
| GET | /departments/:id | Get department details |
Org Charts
| GET | /org-charts | List org charts |
| GET | /org-charts/:id | Get org chart data |
| GET | /org-charts/:id/export | Export as SVG/PNG |
SDKs & Resources
Official SDKs for JavaScript/TypeScript, Python, and Go coming soon. In the meantime, use any HTTP client with our REST API.