Calendar

Manage events and meetings for your organization.

Get Events

GET/api/events

Get calendar events with optional filters.

Query Param	Type	Required	Description
`start`	string	Optional	Start date filter (ISO)
`end`	string	Optional	End date filter (ISO)

{ "events": [ { "id": "...", "title": "Team Meeting", "date": "2024-01-15", "time": "10:00", "type": "meeting" } ] }

Get Meetings

GET/api/company/meetings

Get company meetings for a specific date.

Query Param	Type	Required	Description
`date`	string	Optional	Date filter (YYYY-MM-DD)

{ "meetings": [ { "id": "...", "title": "Sprint Planning", "description": "Weekly sprint planning", "meetingType": "online", "meetingLink": "https://meet.google.com/...", "date": "2024-01-15", "time": "10:00", "durationMinutes": 60, "participants": ["userId1", "userId2"], "status": "scheduled" } ] }

Create Meeting

POST/api/company/meetings

Create a new meeting.

Field	Type	Required	Description
`title`	string	Required	Meeting title
`description`	string	Optional	Meeting description
`meetingType`	string	Required	Type (online/offsite)
`meetingLink`	string	Optional	Online meeting link
`location`	string	Optional	Physical location
`date`	string	Required	Meeting date (YYYY-MM-DD)
`time`	string	Optional	Meeting time (HH:MM)
`durationMinutes`	number	Optional	Duration in minutes
`participants`	string[]	Required	Array of user IDs

{ "meeting": { "id": "...", "title": "Sprint Planning", "status": "scheduled" } }

Update Meeting

PATCH/api/company/meetings/[id]

Update meeting details or status.

Field	Type	Required	Description
`status`	string	Optional	New status (scheduled/completed/cancelled)

{ "meeting": { ... updated meeting } }

Send Meeting Invite

POST/api/hr/meeting-invite

Send meeting invites to users.

Field	Type	Required	Description
`meetingId`	string	Required	Meeting ID
`userIds`	string[]	Required	Array of user IDs to invite

{ "success": true }