Errors & pagination - Engini Developer Docs

Error hierarchy

Identical class names in both languages (instanceof-discriminable in TS):

EnginiError
├── EnginiNetworkError           transport failure before a response (DNS, connection, timeout)
├── EnginiAPIError               any non-2xx with a parseable body
│   ├── EnginiAuthError          401, 403
│   ├── EnginiNotFoundError      404
│   ├── EnginiValidationError    400, 422
│   ├── EnginiRateLimitError     429
│   ├── EnginiConflictError      409
│   └── EnginiServerError        5xx
├── EnginiClientError            SDK misuse (bad arguments, conflicting options)
├── EnginiConnectionError        no connection resolvable / no default set
├── EnginiToolsetError           unknown toolset id, ambiguous connection name
├── EnginiTimeoutError           a polled async job (refresh, OAuth) didn't finish in time
└── EnginiToolExecutionError     the tool ran but reported isSuccess == false

API errors expose the envelope’s errorCode and message. EnginiToolExecutionError additionally carries error_message, execution_info, and history_id (errorMessage/executionInfo/historyId in TS).

from engini.errors import EnginiRateLimitError, EnginiToolExecutionError

try:
    result = client.tools.execute("monday_create_item", {"name": "x"})
except EnginiToolExecutionError as e:
    print("tool failed:", e.error_message, "history:", e.history_id)
except EnginiRateLimitError:
    ...  # back off and retry

import { EnginiRateLimitError, EnginiToolExecutionError } from "@engini/sdk";

try {
  const result = await client.tools.execute("monday_create_item", { name: "x" });
} catch (e) {
  if (e instanceof EnginiToolExecutionError) console.error("tool failed:", e.errorMessage);
  else if (e instanceof EnginiRateLimitError) { /* back off and retry */ }
  else throw e;
}

The SDKs do not retry automatically. If your workload can hit rate limits or transient 5xx, wrap calls with your own retry/backoff and honor Retry-After on 429s.

Pagination

You don’t page manually: every list-style method auto-paginates internally and returns the complete array (tools.get, connections.list, connections.objects, applications.list, toolsets.list). Use the REST API directly with offset/top if you need manual paging over very large sets - see the pagination contract.

​Error hierarchy

​Pagination

Error hierarchy

Pagination