Interviews

Manage interview scheduling, status updates, and feedback collection.

Get All Interviews

GET/api/recruitment/interviews

Get all interviews with optional filters.

{ "interviews": [ { "id": "...", "candidate": { "id": "...", "firstName": "John" }, "job": { "id": "...", "title": "Software Engineer" }, "interviewer": { "id": "...", "name": "HR User" }, "roundType": "technical", "scheduledAt": "2024-01-20T14:00:00Z", "meetingLink": "https://meet.google.com/...", "status": "scheduled", "feedback": null } ] }

Update Interview

PATCH/api/recruitment/interviews/[id]

Update interview status or reschedule.

Field	Type	Required	Description
`id`	string	Required	Interview ID (path param)
`status`	string	Optional	New status (scheduled/completed/cancelled/rescheduled)
`scheduledAt`	string	Optional	Reschedule date/time (ISO)
`meetingLink`	string	Optional	Updated meeting link

{ "interview": { ... updated interview } }

Submit Feedback

PATCH/api/recruitment/interviews/[id]/feedback

Submit interview feedback.

Field	Type	Required	Description
`technicalSkills`	number	Required	Rating (1-5)
`communication`	number	Required	Rating (1-5)
`problemSolving`	number	Required	Rating (1-5)
`cultureFit`	number	Required	Rating (1-5)
`overallRecommendation`	string	Required	Recommendation (strong-hire/hire/hold/reject)
`notes`	string	Optional	Additional notes

{ "interview": { ... updated interview with feedback } }

Interview Statuses

Status	Description
`scheduled`	Interview is scheduled
`completed`	Interview completed
`cancelled`	Interview cancelled
`rescheduled`	Interview rescheduled

Round Types

Type	Description
`screening`	Initial screening
`technical`	Technical interview
`manager`	Manager round
`hr`	HR interview