Errors & Status Codes

{
  "error": "Human-readable error message",
  "code": "error_type:context"
}

{
  "error": "Validation failed",
  "code": "bad_request:api",
  "details": {
    "name": "Name is required",
    "email": "Invalid email format"
  }
}

const response = await fetch("https://app.illumichat.com/api/assistants", {
  credentials: "include",
});

if (!response.ok) {
  const { error, code } = await response.json();

  switch (response.status) {
    case 401:
      window.location.href = "/login";
      break;
    case 403:
      showError("You don't have access to this resource.");
      break;
    case 429:
      await delay(getBackoffMs(retryCount));
      break;
    default:
      console.error(`API error [${code}]: ${error}`);
      showError(error);
  }
}

if (code === "not_found:chat") {
  router.push("/chats");
} else if (code === "forbidden:api") {
  showUpgradePrompt();
}

function getBackoffMs(retryCount) {
  return Math.min(1000 * Math.pow(2, retryCount), 30000);
}