Skip to main content
POST
Reschedule an interview

Authorizations

Authorization
string
header
required

Company API key minted at Settings → API. Prefix hf_. Accepted on hiring data routes. Not accepted on MCP.

Path Parameters

application_id
string
required

Application UUID.

interview_id
string
required

Interview UUID to cancel.

Body

application/json
host_user_id
string
required

Calendar owner for the new link.

duration_minutes
integer

Length of the meeting.

buffer_after_minutes
integer

Gap after the meeting on the host calendar.

start_hour
integer

Local window start, 24-hour.

end_hour
integer

Local window end, 24-hour.

notice_hours
integer

Minimum notice before a bookable slot.

window_days
integer

How many days ahead to offer.

stage
string

phone_screen, hiring_manager, technical, final, or interview.

note
string

Private note on the link. Not shown to the applicant.

conference
string

meet, zoom, or phone. Phone is a hold with no video link.

guest_user_ids
string[]

Teammates also invited, by user id.

guest_emails
string[]

Other people also invited, by email.

Response

200 - application/json

Success

pending
object | null

The open booking link nobody has booked yet, or null.

scheduled
object[]

Upcoming booked interviews.

booked
object | null

The next booked interview, or null.

past
object[]

Interviews that have ended.

hosts
object[]

Teammates a booking link can be made with.