Error handling

Specific errors inherit from the common API error type and preserve the HTTP status and detail.

try {
  await client.responses.create({ message: "Hello" });
} catch (error) {
  if (error instanceof InceptivaRateLimitError) console.error(error.retryAfter);
  else if (error instanceof InceptivaApiError) console.error(error.status, error.detail);
}

retryAfter supports both seconds and HTTP dates. SDKs do not retry automatically. Network and cancellation errors remain native to each runtime.

Every API error preserves status, functional code, readable message, and response metadata containing rate-limit and usage headers.

Functional codes