Interviews

Manage interview invitations, summaries, and scorecards.

Invite Applicant To Interview

Endpoint: POST /jobs/{jobId}/applicants/{applicantEmail}/interview-invitations

Creates and sends an interview invitation for an applicant.

Field	Type	Required	Description
stage	number	No	Pipeline stage index. Defaults to the applicant's current stage.
expiresAt	string	No	ISO date when the invitation expires.
generateInterviewStructure	boolean	No	Whether Juno should generate the interview structure.
emailTemplateId	string	No	Invitation email template ID.
customHtml	string	No	Custom invitation HTML.
customSubject	string	No	Custom invitation subject.

curl -X POST "https://api.usejuno.io/v1/developer/jobs/job_123/applicants/jane@example.com/interview-invitations" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "stage": 1,
    "generateInterviewStructure": true
  }'

View Interview Summary

Endpoint: GET /interviews/{interviewId}/summary

Returns the interview, transcript summary/report when available, scorecards, and final assessment.

curl -X GET "https://api.usejuno.io/v1/developer/interviews/interview_123/summary" \
  -H "X-API-Key: your_api_key_here"

Create Or Update Scorecard Template

Endpoint: PUT /interviews/{interviewId}/scorecard-template

Assigns an assessment template or writes a custom scorecard template snapshot for an interview.

curl -X PUT "https://api.usejuno.io/v1/developer/interviews/interview_123/scorecard-template" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "assessmentTemplateId": "template_123"
  }'

Score Applicant

Endpoint: POST /interviews/{interviewId}/scorecards

Creates or updates the authenticated API user's scorecard for an interview.

curl -X POST "https://api.usejuno.io/v1/developer/interviews/interview_123/scorecards" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": {
      "summary": "Strong backend fundamentals."
    },
    "overallScore": 8,
    "overallRecommendation": "Hire",
    "isBlindSubmitted": true
  }'

Related Resources

• Jobs - List jobs, view job details, submit applications, and close jobs.
• Applicants - View applicants, scores, decisions, and stage movement.