Error Handling

The iNwealth API returns errors in two ways depending on when they occur:

Before streaming starts — standard HTTP JSON errors
During streaming — SSE error events

HTTP errors

These are returned as standard JSON responses before any streaming begins.

401 — Authentication failed

{
  "detail": "Authentification requise"
}

Causes:

Missing Authorization header
Invalid or revoked API key
Malformed Bearer token

400 — Invalid parameters

{
  "detail": "Invalid effort: xyz. Must be one of ['low', 'medium', 'high', 'max']"
}

Returned when a parameter has an invalid value (e.g. unsupported effort level).

422 — Missing required fields

{
  "detail": [
    {
      "type": "missing",
      "loc": ["body", "messages"],
      "msg": "Field required"
    }
  ]
}

Returned when required fields (messages, session_id) are missing or have the wrong type.

SSE error events

Some errors occur after the stream has started (HTTP 200 already sent). These are delivered as SSE events:

429 — Rate limit exceeded

event: error
data: {"type": "error", "data": {"error": "Limite quotidienne organisation atteinte (1,000,000 tokens). Reset dans 3h42.", "error_type": "RateLimitExceeded"}}

Your organization’s daily token quota has been exhausted. The error message includes the time until reset (midnight UTC).

500 — Internal error

event: error
data: {"type": "error", "data": {"error": "Erreur interne du serveur"}}

An unexpected server-side error occurred during response generation. If this persists, contact your account manager.

Handling errors in code

JavaScript

const response = await fetch("https://api.inwealth.fr/api/agent", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk_live_your_key_here"
  },
  body: JSON.stringify({
    messages: [{ role: "user", content: "Your question" }],
    session_id: "session-001"
  })
});

// Handle HTTP errors (401, 400, 422)
if (!response.ok) {
  const error = await response.json();
  console.error(`HTTP ${response.status}:`, error.detail);
  return;
}

// Handle SSE stream (including SSE error events)
const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;

  const chunk = decoder.decode(value);
  for (const line of chunk.split("\n")) {
    if (!line.startsWith("data: ")) continue;
    const data = JSON.parse(line.slice(6));

    if (data.type === "error") {
      // SSE error (429 rate limit, 500 internal)
      console.error(data.data.error);
      if (data.data.error_type === "RateLimitExceeded") {
        // Wait until quota resets at midnight UTC
      }
      return;
    }

    if (data.type === "delta" && data.delta?.content) {
      // Normal delta — append to display
    }
  }
}

Python

import httpx
import json

with httpx.stream(
    "POST",
    "https://api.inwealth.fr/api/agent",
    headers={"Authorization": "Bearer sk_live_your_key_here"},
    json={
        "messages": [{"role": "user", "content": "Your question"}],
        "session_id": "session-001",
    },
) as response:
    # Handle HTTP errors
    if response.status_code != 200:
        print(f"HTTP {response.status_code}: {response.read()}")
    else:
        # Handle SSE stream
        for line in response.iter_lines():
            if not line.startswith("data: "):
                continue
            data = json.loads(line[6:])
            if data.get("type") == "error":
                print(f"SSE error: {data['data']['error']}")
                break

Summary

Code	Type	When	Format
`401`	HTTP	Before stream	`{"detail": "..."}`
`400`	HTTP	Before stream	`{"detail": "..."}`
`422`	HTTP	Before stream	`{"detail": [...]}`
`429`	SSE event	During stream	`event: error` with `RateLimitExceeded`
`500`	SSE event	During stream	`event: error`

Getting Started

Endpoints

Guides

Error Handling

Error Handling

HTTP errors

401 — Authentication failed

400 — Invalid parameters

422 — Missing required fields

SSE error events

429 — Rate limit exceeded

500 — Internal error

Handling errors in code

JavaScript

Python

Summary

​Error Handling

​HTTP errors

​401 — Authentication failed

​400 — Invalid parameters

​422 — Missing required fields

​SSE error events

​429 — Rate limit exceeded

​500 — Internal error

​Handling errors in code

​JavaScript

​Python

​Summary

Error Handling

HTTP errors

401 — Authentication failed

400 — Invalid parameters

422 — Missing required fields

SSE error events

429 — Rate limit exceeded

500 — Internal error

Handling errors in code

JavaScript

Python

Summary