Update Interview

Updates an existing interview’s details. Allows rescheduling, modifying assessment parameters, and updating candidate information before the interview starts.

Most fields can only be updated for scheduled interviews. In-progress or completed interviews have limited update options.

Path Parameters

string

required

Unique interview identifier (e.g., int_abc123def456)

Request Body

scheduled_at

string

ISO 8601 timestamp to reschedule the interview

position

string

Updated job position or role title

skills

array

Updated array of skills to assess

duration_minutes

integer

Updated interview duration in minutes (15-90)

difficulty

string

Updated difficulty level: junior, intermediate, senior, expert

company_name

string

Updated company name for personalization

instructions

string

Updated custom instructions for the AI interviewer

candidate_email

string

Updated candidate email (scheduled interviews only)

send_notification

boolean

default:"true"

Whether to notify candidate of changes via email

reschedule_reason

string

Reason for rescheduling (included in notification email)

Update Rules by Status

Different fields can be updated based on interview status:

Field	Scheduled	In Progress	Completed
`scheduled_at`	✅ Yes	❌ No	❌ No
`candidate_email`	✅ Yes	❌ No	❌ No
`position`	✅ Yes	❌ No	❌ No
`skills`	✅ Yes	❌ No	❌ No
`duration_minutes`	✅ Yes	❌ No	❌ No
`difficulty`	✅ Yes	❌ No	❌ No
`instructions`	✅ Yes	⚠️ Limited	❌ No
`company_name`	✅ Yes	✅ Yes	❌ No

Response

string

Unique interview identifier

status

string

Current interview status

candidate_email

string

Updated candidate email

position

string

Updated job position

skills

array

Updated skills array

scheduled_at

string

Updated schedule timestamp

duration_minutes

integer

Updated duration

difficulty

string

Updated difficulty level

company_name

string

Updated company name

instructions

string

Updated custom instructions

updated_at

string

ISO 8601 timestamp when interview was last updated

notification_sent

boolean

Whether update notification was sent to candidate

Examples

curl -X PATCH "https://backend.jobhive.ai/v1/interviews/int_abc123def456" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduled_at": "2024-01-16T14:00:00Z",
    "reschedule_reason": "Candidate requested time change"
  }'

{
  "success": true,
  "data": {
    "id": "int_abc123def456",
    "status": "scheduled",
    "candidate_email": "[email protected]",
    "position": "Senior Full Stack Developer",
    "skills": ["JavaScript", "React", "Node.js", "TypeScript"],
    "scheduled_at": "2024-01-16T14:00:00Z",
    "duration_minutes": 60,
    "difficulty": "senior",
    "company_name": "TechCorp Inc",
    "instructions": "Focus on TypeScript advanced features and architectural patterns",
    "created_at": "2024-01-15T14:30:00Z",
    "updated_at": "2024-01-15T16:45:00Z",
    "notification_sent": true
  },
  "meta": {
    "timestamp": "2024-01-15T16:45:00Z",
    "request_id": "req_update_int_001"
  }
}

Error Responses

{
  "success": false,
  "error": {
    "code": "INTERVIEW_NOT_FOUND",
    "message": "Interview with ID 'int_invalid123' not found"
  }
}

Webhook Events

Updating an interview triggers webhook events based on the changes:

interview.updated - Sent for any interview update
interview.rescheduled - Sent when scheduled_at is changed
candidate.notified - Sent when notification email is delivered

Best Practices

Rescheduling Guidelines

Professional Communication
Batch Operations
Validation

// Always provide a reason for rescheduling
const rescheduled = await jobhive.interviews.update(interviewId, {
  scheduled_at: newDateTime,
  reschedule_reason: 'Interviewer has a scheduling conflict',
  send_notification: true
});

# Use batch updates for efficiency
async def reschedule_batch(interview_ids, new_time, reason):
    updates = []
    for interview_id in interview_ids:
        try:
            result = await client.interviews.update(
                interview_id,
                scheduled_at=new_time,
                reschedule_reason=reason
            )
            updates.append(result)
        except Exception as e:
            print(f"Failed to update {interview_id}: {e}")
    
    return updates

// Validate before updating
function validateReschedule(newDateTime) {
  const now = new Date();
  const scheduledTime = new Date(newDateTime);
  
  if (scheduledTime <= now) {
    throw new Error('Cannot schedule interview in the past');
  }
  
  if (scheduledTime.getHours() < 9 || scheduledTime.getHours() > 17) {
    throw new Error('Interview must be scheduled during business hours');
  }
  
  return true;
}

Skill Assessment Updates

When updating skills or difficulty:

Preserve Context: Keep related skills together for coherent assessment
Match Difficulty: Ensure difficulty level matches the skills being tested
Update Instructions: Modify custom instructions to reflect new focus areas

Candidates receive email notifications for significant changes (rescheduling, skill updates) unless send_notification: false is specified.

Use the reschedule_reason field to maintain professional communication and reduce candidate confusion about changes.

Getting Started

Core Resources

Advanced Features

Path Parameters

Request Body

Update Rules by Status

Response

Examples

Error Responses

Webhook Events

Best Practices

Rescheduling Guidelines

Skill Assessment Updates

Getting Started

Core Resources

Advanced Features

​Path Parameters

​Request Body

​Update Rules by Status

​Response

​Examples

​Error Responses

​Webhook Events

​Best Practices

​Rescheduling Guidelines

​Skill Assessment Updates

Path Parameters

Request Body

Update Rules by Status

Response

Examples

Error Responses

Webhook Events

Best Practices

Rescheduling Guidelines

Skill Assessment Updates