# APPLOI_API_KEY must hold the Partner API key you received from Apploi.
# These examples do not set it for you: set it yourself, in your own
# environment, before running them. For example, in your shell:
#   export APPLOI_API_KEY="<the API key you received from Apploi>"

curl -sS -X PUT https://partners.apploi.com/applicants/265733753/interviews \
  -H "X-Api-Key: $APPLOI_API_KEY" \
  -H "Content-Type: application/json" \
  -w "\nHTTP status: %{http_code}\n" \
  -d '{
    "date": "2026-11-03T14:00:00Z",
    "duration": "45",
    "timezone": "America/New_York",
    "location": "Virtual",
    "interviewerTeamId": "345678",
    "interviewerEmail": "[email protected]"
  }'

import os

import requests

# APPLOI_API_KEY must hold the Partner API key you received from Apploi.
# These examples do not set it for you: set it yourself, in your own
# environment, before running them. For example, in your shell:
#   export APPLOI_API_KEY="<the API key you received from Apploi>"
API_KEY = os.environ["APPLOI_API_KEY"]

def save_interview(application_id, body):
    response = requests.put(
        f"https://partners.apploi.com/applicants/{application_id}/interviews",
        headers={"X-Api-Key": API_KEY},
        json=body,
        timeout=60,
    )
    if response.status_code == 200:
        try:
            return "saved", response.json()
        except ValueError:
            # Some server errors currently arrive as a 200 whose body isn't valid JSON.
            # See "A 200 whose body isn't valid JSON" below.
            return "unconfirmed", response.text
    if response.status_code == 404:
        # The application doesn't exist or, when cancelling, it has no upcoming interview.
        return "not_found", response.text
    # 400: fix the request before sending it again. 403: the application isn't on your
    # teams. 5xx: retry with backoff.
    raise RuntimeError(f"Request failed with status {response.status_code}: {response.text}")

outcome, result = save_interview(265733753, {
    "date": "2026-11-03T14:00:00Z",  # 2:00 PM in "timezone", not UTC
    "duration": "45",  # minutes, as a string
    "timezone": "America/New_York",
    "location": "Virtual",
    "interviewerTeamId": "345678",  # a string, not a number
    "interviewerEmail": "[email protected]",
})
print(outcome, result)

// APPLOI_API_KEY must hold the Partner API key you received from Apploi.
// These examples do not set it for you: set it yourself, in your own
// environment, before running them. For example, in your shell:
//   export APPLOI_API_KEY="<the API key you received from Apploi>"
if (!process.env.APPLOI_API_KEY) {
  throw new Error("Set APPLOI_API_KEY to the Partner API key you received from Apploi");
}
const API_KEY: string = process.env.APPLOI_API_KEY;

type Outcome = "saved" | "unconfirmed" | "not_found";

async function saveInterview(
  applicationId: number,
  body: object,
): Promise<{ outcome: Outcome; result: unknown }> {
  const response = await fetch(
    `https://partners.apploi.com/applicants/${applicationId}/interviews`,
    {
      method: "PUT",
      headers: { "X-Api-Key": API_KEY, "Content-Type": "application/json" },
      body: JSON.stringify(body),
    },
  );
  if (response.status === 200) {
    const text = await response.text();
    try {
      return { outcome: "saved", result: JSON.parse(text) };
    } catch {
      // Some server errors currently arrive as a 200 whose body isn't valid JSON.
      // See "A 200 whose body isn't valid JSON" below.
      return { outcome: "unconfirmed", result: text };
    }
  }
  if (response.status === 404) {
    // The application doesn't exist or, when cancelling, it has no upcoming interview.
    return { outcome: "not_found", result: await response.text() };
  }
  // 400: fix the request before sending it again. 403: the application isn't on your
  // teams. 5xx: retry with backoff.
  throw new Error(`Request failed with status ${response.status}: ${await response.text()}`);
}

const { outcome, result } = await saveInterview(265733753, {
  date: "2026-11-03T14:00:00Z", // 2:00 PM in "timezone", not UTC
  duration: "45", // minutes, as a string
  timezone: "America/New_York",
  location: "Virtual",
  interviewerTeamId: "345678", // a string, not a number
  interviewerEmail: "[email protected]",
});
console.log(outcome, result);

require "json"
require "net/http"
require "uri"

# APPLOI_API_KEY must hold the Partner API key you received from Apploi.
# These examples do not set it for you: set it yourself, in your own
# environment, before running them. For example, in your shell:
#   export APPLOI_API_KEY="<the API key you received from Apploi>"
API_KEY = ENV.fetch("APPLOI_API_KEY")

def save_interview(application_id, body)
  uri = URI("https://partners.apploi.com/applicants/#{application_id}/interviews")
  request = Net::HTTP::Put.new(uri)
  request["X-Api-Key"] = API_KEY
  request["Content-Type"] = "application/json"
  request.body = JSON.generate(body)

  response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true, read_timeout: 60) do |http|
    http.request(request)
  end

  case response.code
  when "200"
    begin
      [:saved, JSON.parse(response.body)]
    rescue JSON::ParserError
      # Some server errors currently arrive as a 200 whose body isn't valid JSON.
      # See "A 200 whose body isn't valid JSON" below.
      [:unconfirmed, response.body]
    end
  # The application doesn't exist or, when cancelling, it has no upcoming interview.
  when "404" then [:not_found, response.body]
  # 400: fix the request before sending it again. 403: the application isn't on your
  # teams. 5xx: retry with backoff.
  else raise "Request failed with status #{response.code}: #{response.body}"
  end
end

outcome, result = save_interview(
  265733753,
  date: "2026-11-03T14:00:00Z", # 2:00 PM in "timezone", not UTC
  duration: "45", # minutes, as a string
  timezone: "America/New_York",
  location: "Virtual",
  interviewerTeamId: "345678", # a string, not a number
  interviewerEmail: "[email protected]"
)
puts outcome, result

curl -sS -X PUT https://partners.apploi.com/applicants/265733753/interviews \
  -H "X-Api-Key: $APPLOI_API_KEY" \
  -H "Content-Type: application/json" \
  -w "\nHTTP status: %{http_code}\n" \
  -d '{
    "date": "2026-11-05T10:30:00Z",
    "duration": "30",
    "timezone": "America/New_York",
    "location": "Virtual",
    "interviewerTeamId": "345678",
    "interviewerEmail": "[email protected]"
  }'

outcome, _result = save_interview(265733753, {
    "date": "2026-11-05T10:30:00Z",
    "duration": "30",
    "timezone": "America/New_York",
    "location": "Virtual",
    "interviewerTeamId": "345678",
    "interviewerEmail": "[email protected]",
})
print(outcome)

const { outcome: rescheduled } = await saveInterview(265733753, {
  date: "2026-11-05T10:30:00Z",
  duration: "30",
  timezone: "America/New_York",
  location: "Virtual",
  interviewerTeamId: "345678",
  interviewerEmail: "[email protected]",
});
console.log(rescheduled);

outcome, _result = save_interview(
  265733753,
  date: "2026-11-05T10:30:00Z",
  duration: "30",
  timezone: "America/New_York",
  location: "Virtual",
  interviewerTeamId: "345678",
  interviewerEmail: "[email protected]"
)
puts outcome

curl -sS -X PUT https://partners.apploi.com/applicants/265733753/interviews \
  -H "X-Api-Key: $APPLOI_API_KEY" \
  -H "Content-Type: application/json" \
  -w "\nHTTP status: %{http_code}\n" \
  -d '{
    "cancel": true,
    "date": "2026-11-05T10:30:00Z",
    "duration": "30",
    "timezone": "America/New_York",
    "interviewerTeamId": "345678",
    "interviewerEmail": "[email protected]"
  }'

cancel_body = {
    "cancel": True,
    # Ignored when cancelling, but still required
    "date": "2026-11-05T10:30:00Z",
    "duration": "30",
    "timezone": "America/New_York",
    "interviewerTeamId": "345678",
    "interviewerEmail": "[email protected]",
}
outcome, _result = save_interview(265733753, cancel_body)
if outcome == "unconfirmed":
    # Send the cancel again: a 404 now means no upcoming interview is left.
    outcome, _result = save_interview(265733753, cancel_body)
if outcome == "not_found":
    print("No upcoming interview is left on this application.")

const cancelBody = {
  cancel: true,
  // Ignored when cancelling, but still required
  date: "2026-11-05T10:30:00Z",
  duration: "30",
  timezone: "America/New_York",
  interviewerTeamId: "345678",
  interviewerEmail: "[email protected]",
};
let { outcome: cancelled } = await saveInterview(265733753, cancelBody);
if (cancelled === "unconfirmed") {
  // Send the cancel again: a 404 now means no upcoming interview is left.
  ({ outcome: cancelled } = await saveInterview(265733753, cancelBody));
}
if (cancelled === "not_found") {
  console.log("No upcoming interview is left on this application.");
}

cancel_body = {
  cancel: true,
  # Ignored when cancelling, but still required
  date: "2026-11-05T10:30:00Z",
  duration: "30",
  timezone: "America/New_York",
  interviewerTeamId: "345678",
  interviewerEmail: "[email protected]"
}
outcome, _result = save_interview(265733753, cancel_body)
# Send the cancel again: a 404 now means no upcoming interview is left.
outcome, _result = save_interview(265733753, cancel_body) if outcome == :unconfirmed
puts "No upcoming interview is left on this application." if outcome == :not_found

{
  "message": "Invalid request body"
}

{
  "error": "Validation Error",
  "message": "Either 'interviewerId' must be provided, or both 'interviewerTeamId' and 'interviewerEmail' must be provided.",
  "details": {
    "validationErrors": [
      "Either 'interviewerId' must be provided, or both 'interviewerTeamId' and 'interviewerEmail' must be provided."
    ]
  }
}

{
  "error": "Bad Request",
  "message": "Invalid request body",
  "validationErrors": {
    "developer_message": "There were one or more field errors",
    "errors": {
      "message": "No user found with the provided interviewer_email and team_id."
    }
  }
}

{
  "data": {
    "id": 265733753,
    "applicant_id": 71207841,
    "applicant_status": "Interview Scheduled",
    "applicant_status_id": 8,
    "date": "2026-11-03T14:00:00+00:00",
    "duration": 45,
    "location": "Virtual",
    "timezone": "America/New_York",
    "interviewer": {
      "id": 123456,
      "full_name": "Jane Doe"
    },
    "job_id": 1470975
  }
}