Update Interview

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"
  }'

curl -X PATCH "https://backend.jobhive.ai/v1/interviews/int_abc123def456" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "skills": ["JavaScript", "React", "Node.js", "TypeScript"],
    "difficulty": "senior",
    "instructions": "Focus on TypeScript advanced features and architectural patterns"
  }'

// Reschedule interview
const updated = await jobhive.interviews.update('int_abc123def456', {
  scheduled_at: '2024-01-16T14:00:00Z',
  reschedule_reason: 'Interviewer unavailable',
  send_notification: true
});

console.log(`Interview rescheduled to: ${updated.scheduled_at}`);

// Update assessment parameters
const enhanced = await jobhive.interviews.update('int_def456ghi789', {
  skills: ['Python', 'Django', 'PostgreSQL', 'Redis'],
  difficulty: 'expert',
  duration_minutes: 60,
  instructions: 'Include system design questions about caching strategies'
});

# Bulk reschedule for weather emergency
interviews_to_reschedule = client.interviews.list(
    scheduled_after='2024-01-15T08:00:00Z',
    scheduled_before='2024-01-15T18:00:00Z',
    status='scheduled'
)

for interview in interviews_to_reschedule.data:
    # Reschedule to next day, same time
    original_time = datetime.fromisoformat(interview.scheduled_at.replace('Z', '+00:00'))
    new_time = original_time + timedelta(days=1)
    
    client.interviews.update(
        interview.id,
        scheduled_at=new_time.isoformat(),
        reschedule_reason='Office closed due to weather emergency',
        send_notification=True
    )

print(f"Rescheduled {len(interviews_to_reschedule.data)} interviews")

{
  "success": true,
  "data": {
    "id": "int_abc123def456",
    "status": "scheduled",
    "candidate_email": "john.doe@example.com",
    "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"
  }
}

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

string

ISO 8601 timestamp to reschedule the interview

string

Updated job position or role title

array

Updated array of skills to assess

integer

Updated interview duration in minutes (15-90)

string

Updated difficulty level: junior, intermediate, senior, expert

string

Updated company name for personalization

string

Updated custom instructions for the AI interviewer

string

Updated candidate email (scheduled interviews only)

boolean

default:"true"

Whether to notify candidate of changes via email

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

string

Current interview status

string

Updated candidate email

string

Updated job position

array

Updated skills array

string

Updated schedule timestamp

integer

Updated duration

string

Updated difficulty level

string

Updated company name

string

Updated custom instructions

string

ISO 8601 timestamp when interview was last updated

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"
  }'

curl -X PATCH "https://backend.jobhive.ai/v1/interviews/int_abc123def456" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "skills": ["JavaScript", "React", "Node.js", "TypeScript"],
    "difficulty": "senior",
    "instructions": "Focus on TypeScript advanced features and architectural patterns"
  }'

// Reschedule interview
const updated = await jobhive.interviews.update('int_abc123def456', {
  scheduled_at: '2024-01-16T14:00:00Z',
  reschedule_reason: 'Interviewer unavailable',
  send_notification: true
});

console.log(`Interview rescheduled to: ${updated.scheduled_at}`);

// Update assessment parameters
const enhanced = await jobhive.interviews.update('int_def456ghi789', {
  skills: ['Python', 'Django', 'PostgreSQL', 'Redis'],
  difficulty: 'expert',
  duration_minutes: 60,
  instructions: 'Include system design questions about caching strategies'
});

# Bulk reschedule for weather emergency
interviews_to_reschedule = client.interviews.list(
    scheduled_after='2024-01-15T08:00:00Z',
    scheduled_before='2024-01-15T18:00:00Z',
    status='scheduled'
)

for interview in interviews_to_reschedule.data:
    # Reschedule to next day, same time
    original_time = datetime.fromisoformat(interview.scheduled_at.replace('Z', '+00:00'))
    new_time = original_time + timedelta(days=1)
    
    client.interviews.update(
        interview.id,
        scheduled_at=new_time.isoformat(),
        reschedule_reason='Office closed due to weather emergency',
        send_notification=True
    )

print(f"Rescheduled {len(interviews_to_reschedule.data)} interviews")

{
  "success": true,
  "data": {
    "id": "int_abc123def456",
    "status": "scheduled",
    "candidate_email": "john.doe@example.com",
    "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"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_OPERATION",
    "message": "Cannot update a completed interview",
    "details": {
      "current_status": "completed",
      "completed_at": "2024-01-15T16:30:00Z",
      "allowed_updates": []
    }
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid update parameters",
    "details": {
      "scheduled_at": "Cannot schedule interview in the past",
      "duration_minutes": "Must be between 15 and 90 minutes"
    }
  }
}

{
  "success": false,
  "error": {
    "code": "INTERVIEW_IN_PROGRESS", 
    "message": "Cannot update core parameters while interview is active",
    "details": {
      "current_status": "in_progress",
      "started_at": "2024-01-15T15:32:00Z",
      "allowed_updates": ["company_name", "instructions"]
    }
  }
}

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

​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