---
title: "Schedule Interview"
method: POST
path: "/api/interview/join/{token}/schedule"
tags: ["interview-join"]
---

# Schedule Interview

`POST /api/interview/join/{token}/schedule`

## Request

- Base URL: `https://api.thebetterhire.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebetterhire.ai/api/interview/join/{token}/schedule`
- Auth: none declared

Candidate self-schedules their screening interview.

PUBLIC endpoint - updates the interview with the candidate's chosen time.

## Path parameters

- `token` string, required

## Request body

- BackendRoutersInterviewJoinScheduleInterviewRequest: Request to schedule an interview (candidate self-scheduling)
  - `scheduled_at` string, required

## Response `200`

Successful Response

- BackendRoutersInterviewJoinScheduleInterviewResponse: Response after scheduling
  - `success` boolean, required
  - `message` string, required
  - `scheduled_at` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api.md) · [All operations](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/revisions/c8ad03e900ea?raw)