interviews.delete

Cancel an interview

Request: DELETE/api/v1/interviews/{interviewId}
Scope required: interviews:write
Effect: Deletes something. Confirm with a person before calling it.
Acts on: Acts on the account’s own job search.
MCP tool: interviews_delete
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Removes an interview from the card it was scheduled against, together with the notes and feedback recorded on it. Use `interviews.update` instead when the interview happened and only its outcome needs writing down — a deleted interview is gone from the counts the card shows and from the insights figures. Answers 204 with no body.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
interviewId	path	Required	string
If-Match	header	Optional	string — The ETag of the version you read. The write is refused with 412 if the resource has changed since.

Response

Answers 204 with no body.

Examples

Cancel an interview that was called off

Cancel an interview that was called off — request

curl -s -X DELETE https://www.jobapplicationtracking.com/api/v1/interviews/iv_42 \
  -H "Authorization: Bearer $JAT_KEY"

Cancel an interview that was called off — response

null