> ## Documentation Index
> Fetch the complete documentation index at: https://tryagentai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Errors

> Handle API and network errors from the SDK.

# Errors

The SDK throws `ApiError` for non-2xx API responses and network failures.

```typescript theme={null}
import { ApiError, TryAgent } from "@tryagent/sdk";

const tryagent = new TryAgent({
  apiKey: process.env.TRYAGENT_API_KEY!,
});

try {
  await tryagent.escalate("orders.auth_doc", input);
} catch (error) {
  if (error instanceof ApiError) {
    console.error(error.status, error.requestId, error.body);
    throw error;
  }

  throw error;
}
```

`ApiError.status` is `0` for network failures. For API responses, `status` is the HTTP status code, `body` contains the parsed response when available, and `requestId` is populated from the response headers when present.

## WebhookSignatureError

`webhooks.constructEvent` throws `WebhookSignatureError` when the
`x-tryagent-signature` header fails HMAC verification. Treat it as a `401` — a
verified event is safe to act on, an unverified one is not.

```typescript theme={null}
import { WebhookSignatureError } from "@tryagent/sdk";

try {
  const event = await tryagent.webhooks.constructEvent({
    payload: body,
    signature: request.headers.get("x-tryagent-signature"),
    secret: process.env.TRYAGENT_WEBHOOK_SECRET!,
  });
} catch (error) {
  if (error instanceof WebhookSignatureError) {
    return Response.json({ error: "Invalid signature" }, { status: 401 });
  }
  throw error;
}
```