> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/nemo/guardrails/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/nemo/guardrails/_mcp/server.

# nemoguardrails.http.errors

Transport-neutral exceptions raised by the outbound HTTP subsystem.

## Module Contents

### Classes

| Name                                                                             | Description                                                          |
| -------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
| [`HTTPClientError`](#nemoguardrails-http-errors-HTTPClientError)                 | Base class for outbound HTTP failures.                               |
| [`HTTPConnectionError`](#nemoguardrails-http-errors-HTTPConnectionError)         | Raised when the transport cannot establish or maintain a connection. |
| [`HTTPResponseDecodeError`](#nemoguardrails-http-errors-HTTPResponseDecodeError) | Raised when a response body cannot be decoded as JSON.               |
| [`HTTPStatusError`](#nemoguardrails-http-errors-HTTPStatusError)                 | Raised for an unsuccessful HTTP status.                              |
| [`HTTPTimeoutError`](#nemoguardrails-http-errors-HTTPTimeoutError)               | Raised when an outbound request exceeds its total timeout.           |

### API

```python
class nemoguardrails.http.errors.HTTPClientError(
    args: object = ()
)
```

Exception

**Bases:** `Exception`

Base class for outbound HTTP failures.

`retry_count` records how many retries completed before the error was
returned to the caller.

**`retry_count`** `= 0`

---

```python
class nemoguardrails.http.errors.HTTPConnectionError()
```

**Bases:** [HTTPClientError](#nemoguardrails-http-errors-HTTPClientError)

Raised when the transport cannot establish or maintain a connection.

```python
class nemoguardrails.http.errors.HTTPResponseDecodeError(
    response: nemoguardrails.http.types.HTTPResponse
)
```

**Bases:** [HTTPClientError](#nemoguardrails-http-errors-HTTPClientError)

Raised when a response body cannot be decoded as JSON.

```python
class nemoguardrails.http.errors.HTTPStatusError(
    response: nemoguardrails.http.types.HTTPResponse,
    request: nemoguardrails.http.types.HTTPRequest | None = None
)
```

**Bases:** [HTTPClientError](#nemoguardrails-http-errors-HTTPClientError)

Raised for an unsuccessful HTTP status.

**`retry_count`** `= retry_count if isinstance(retry_count, int) else 0`

---

```python
class nemoguardrails.http.errors.HTTPTimeoutError()
```

**Bases:** [HTTPClientError](#nemoguardrails-http-errors-HTTPClientError)

Raised when an outbound request exceeds its total timeout.