Errors

import requests

r = requests.post(
    "https://ab12cd34ef.agent37.app/v1/responses",
    headers={
        "X-Agent37-Key": "sk_live_...",
        "Content-Type": "application/json",
    },
    json={
        "input": "Research the top 3 EV makers, write a memo.",
        "session_id": "7f3e0b6c52a949d2b1c4a8e9d0f31726",
    },
)

body = r.json()
if not r.ok or body.get("status") == "failed":
    error = body["error"]
    if isinstance(error, str):
        raise RuntimeError(f"transport error: {error}")  # flat platform error, e.g. container_unavailable
    code = error["code"]
    if code == "session_busy":
        ...  # cancel the running response or start another session
    elif code == "rate_limited":
        ...  # transient: back off and retry
    elif code == "validation_error":
        raise ValueError(f"{error.get('param')}: {error['message']}")
    else:
        ...  # unknown codes are agent-side failures: log code, show message

const res = await fetch("https://ab12cd34ef.agent37.app/v1/responses", {
  method: "POST",
  headers: {
    "X-Agent37-Key": "sk_live_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    input: "Research the top 3 EV makers, write a memo.",
    session_id: "7f3e0b6c52a949d2b1c4a8e9d0f31726",
  }),
});

const body = await res.json();
if (!res.ok || body.status === "failed") {
  const { error } = body;
  if (typeof error === "string") {
    // flat platform error, e.g. "container_unavailable": see the transport table
    throw new Error(`transport error: ${error}`);
  }
  switch (error.code) {
    case "session_busy":
      // cancel the running response or start another session
      break;
    case "rate_limited":
      // transient: back off and retry
      break;
    case "validation_error":
      throw new Error(`${error.param}: ${error.message}`);
    default:
      // unknown codes are agent-side failures: log code, show message
      console.error(error.code, error.message);
  }
}