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

# exc

All the exceptions raised by code in this library are contained in this module.
They all share a base class: [`EmtelliproError`](/nlp/python/reference/exc#emtelliproexcemtelliproerror).

### API

#### `emtellipro.exc.EmtelliproError`

```python
class emtellipro.exc.EmtelliproError
```

**Bases:** `Exception`

**Bases**: `Exception`

Base class for all expections in this library.

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.CancelledError`

```python
class emtellipro.exc.CancelledError
```

**Bases:** [`EmtelliproError`](/nlp/python/reference/exc#emtelliproexcemtelliproerror)

**Bases**: `emtellipro.exc.EmtelliproError`

Exception raised when an annotation task has been cancelled.

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.APIError`

```python
class emtellipro.exc.APIError(reason, task_id=None)
```

**Bases:** [`EmtelliproError`](/nlp/python/reference/exc#emtelliproexcemtelliproerror)

**Bases**: `emtellipro.exc.EmtelliproError`

Exception raised for unexpected API-related errors

**Attributes:**

* `reason`: the reason for the error as provided by the server
* `task_id`: when available, the task ID the error is related to

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.HTTPClientError`

```python
class emtellipro.exc.HTTPClientError(reason, task_id=None)
```

**Bases:** [`APIError`](/nlp/python/reference/exc#emtelliproexcapierror)

**Bases**: `emtellipro.exc.APIError`

Exception for generic client errors (i.e. HTTP 4xx errors).

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.AuthenticationError`

```python
class emtellipro.exc.AuthenticationError(reason, task_id=None)
```

**Bases:** [`HTTPClientError`](/nlp/python/reference/exc#emtelliproexchttpclienterror)

**Bases**: `emtellipro.exc.HTTPClientError`

Exception for authentication errors.

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.TaskNotFoundError`

```python
class emtellipro.exc.TaskNotFoundError(reason, task_id=None)
```

**Bases:** [`APIError`](/nlp/python/reference/exc#emtelliproexcapierror)

**Bases**: `emtellipro.exc.APIError`

Exception indication the server does not know about the task ID it's been
sent.

**Attributes:**

* `reason`: textual representation of why the task was not found as returned by the server

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.TaskFailedError`

```python
class emtellipro.exc.TaskFailedError(reason, task_id=None)
```

**Bases:** [`APIError`](/nlp/python/reference/exc#emtelliproexcapierror)

**Bases**: `emtellipro.exc.APIError`

Exception raised when a task submitted has failed.

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.ServerError`

```python
class emtellipro.exc.ServerError(reason, task_id=None)
```

**Bases:** [`APIError`](/nlp/python/reference/exc#emtelliproexcapierror)

**Bases**: `emtellipro.exc.APIError`

Exception for generic server errors (i.e. HTTP 5xx errors).

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.UnsupportedFormatForParsingError`

```python
class emtellipro.exc.UnsupportedFormatForParsingError
```

**Bases:** [`EmtelliproError`](/nlp/python/reference/exc#emtelliproexcemtelliproerror)

**Bases**: `emtellipro.exc.EmtelliproError`

Exception raised when attempting to parse a result format we don't provide
a parser for in this SDK. This will usually occur when specifying the
result format; if you're interested in using our parsers, leave the result
format unspecified.

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.FileLoadError`

```python
class emtellipro.exc.FileLoadError(msg, filepath, doc_id=None)
```

**Bases:** [`EmtelliproError`](/nlp/python/reference/exc#emtelliproexcemtelliproerror)

**Bases**: `emtellipro.exc.EmtelliproError`

Error raised by file handlers when attempting to load a file.

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

##### `FileLoadError.__str__`

```python
__str__()
```

##### `FileLoadError.__repr__`

```python
__repr__()
```

#### `emtellipro.exc.FiletypeNotSupportedError`

```python
class emtellipro.exc.FiletypeNotSupportedError(msg, filepath, doc_id=None)
```

**Bases:** [`FileLoadError`](/nlp/python/reference/exc#emtelliproexcfileloaderror), `ValueError`

**Bases**: `emtellipro.exc.FileLoadError`, `ValueError`

Raised when the given filepath or filetype is not supported using the
available handlers.

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.DatabaseError`

```python
class emtellipro.exc.DatabaseError
```

**Bases:** [`EmtelliproError`](/nlp/python/reference/exc#emtelliproexcemtelliproerror)

**Bases**: `emtellipro.exc.EmtelliproError`

Base exception which is subclassed by more specific exceptions

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.MissingFullTextSupport`

```python
class emtellipro.exc.MissingFullTextSupport
```

**Bases:** [`DatabaseError`](/nlp/python/reference/exc#emtelliproexcdatabaseerror)

**Bases**: `emtellipro.exc.DatabaseError`

Raised when SQL Server is missing full-text support

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.InvalidURIException`

```python
class emtellipro.exc.InvalidURIException
```

**Bases:** [`DatabaseError`](/nlp/python/reference/exc#emtelliproexcdatabaseerror)

**Bases**: `emtellipro.exc.DatabaseError`

Exception raised when a provided URI is not valid.

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.DatabaseConnectionError`

```python
class emtellipro.exc.DatabaseConnectionError
```

**Bases:** [`DatabaseError`](/nlp/python/reference/exc#emtelliproexcdatabaseerror)

**Bases**: `emtellipro.exc.DatabaseError`

Raised when connections to the database have failed.

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.DatabaseSchemaValidationError`

```python
class emtellipro.exc.DatabaseSchemaValidationError
```

**Bases:** [`DatabaseError`](/nlp/python/reference/exc#emtelliproexcdatabaseerror)

**Bases**: `emtellipro.exc.DatabaseError`

Raised when the schema of the database is not compatible with the schema
defined in this library.

Subclasses of this exception will be more useful to catch.

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.DatabaseMissingVersionError`

```python
class emtellipro.exc.DatabaseMissingVersionError
```

**Bases:** [`DatabaseSchemaValidationError`](/nlp/python/reference/exc#emtelliproexcdatabaseschemavalidationerror)

**Bases**: `emtellipro.exc.DatabaseSchemaValidationError`

Raised when alembic version is missing from the database.

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.DatabaseSchemaMissingColumnsError`

```python
class emtellipro.exc.DatabaseSchemaMissingColumnsError(msg, missing_columns, version, *args, **kwargs)
```

**Bases:** [`DatabaseSchemaValidationError`](/nlp/python/reference/exc#emtelliproexcdatabaseschemavalidationerror)

**Bases**: `emtellipro.exc.DatabaseSchemaValidationError`

Raised when there are columns missing from the database that are requred by
the SDK's schema.

**Attributes:**

* `missing_columns`: List of columns that are missing from the database's schema.
* `version`: Can be one of "missing", "latest", or a specific older schema version identifier.

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.DatabaseSchemaConflict`

```python
class emtellipro.exc.DatabaseSchemaConflict(msg, conflicts, *args, **kwargs)
```

**Bases:** [`DatabaseError`](/nlp/python/reference/exc#emtelliproexcdatabaseerror)

**Bases**: `emtellipro.exc.DatabaseError`

The database contains a schema that conflicts with the models defined in
this library.

**Attributes:**

* `conflicts`: A list of table names that already exist in the database, which are also needed in the library's schema.

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.DatabaseMigrationError`

```python
class emtellipro.exc.DatabaseMigrationError
```

**Bases:** [`DatabaseError`](/nlp/python/reference/exc#emtelliproexcdatabaseerror)

**Bases**: `emtellipro.exc.DatabaseError`

Raised for failed migrations.

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.

#### `emtellipro.exc.DatabaseMissingError`

```python
class emtellipro.exc.DatabaseMissingError
```

**Bases:** [`DatabaseError`](/nlp/python/reference/exc#emtelliproexcdatabaseerror)

**Bases**: `emtellipro.exc.DatabaseError`

This is raised when the database we're connecting to doesn't exist, and the
driver doesn't raise its own error (mostly for Snowflake).

##### Initialization

Initialize self.  See help(type(self)) for accurate signature.