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

# Errors

## AtotiClientNotFoundError

Thrown when an [AtotiClient](types#atoticlient) identified by a `serverKey` is not provided via [ClientsProvider](context-providers#clientsprovider).

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof AtotiClientNotFoundError) {
    // handle AtotiClientNotFoundError
  }
}
```

## BadRequestError

Thrown when an HTTP status of 400 is received.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof BadRequestError) {
    // handle BadRequestError
  }
}
```

## ClientsNotFoundError

Thrown when no clients are found. They must be provided via [ClientsProvider](context-providers#clientsprovider).

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof ClientsNotFoundError) {
    // handle ClientsNotFoundError
  }
}
```

## ConfigurationNotFoundError

<Warning>
  **Deprecated**

  This error is no longer used and will be removed in version 5.3 of the SDK.
</Warning>

Thrown when no [Configuration](types#configuration) is found. It must be provided using `ConfigurationContext.Provider`.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof ConfigurationNotFoundError) {
    // handle ConfigurationNotFoundError
  }
}
```

## ContentClientNotFoundError

Thrown when no [ContentClient](types#contentclient) is found. It must be provided via [ClientsProvider](context-providers#clientsprovider).

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof ContentClientNotFoundError) {
    // handle ContentClientNotFoundError
  }
}
```

## CubelessQueryError

Thrown when an [MdxSelect](types#mdxselect), an [MdxSubSelect](types#mdxsubselect) or an [MdxDrillthrough](types#mdxdrillthrough) does not specify the name of its target [Cube](types#cube).

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof CubelessQueryError) {
    // handle CubelessQueryError
  }
}
```

## CubeNotFoundError

Thrown when a [Cube](types#cube) cannot be found. This can happen in particular when loading a saved widget after updating a cube's name on the server side.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof CubeNotFoundError) {
    // handle CubeNotFoundError
  }
}
```

## DataModelNotFoundError

Thrown when a [DataModel](types#datamodel) identified by a `serverKey` is not found in the `ClientsContext`.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof DataModelNotFoundError) {
    // handle DataModelNotFoundError
  }
}
```

## DimensionNotFoundError

Thrown when a [Dimension](types#dimension) cannot be found in a [Cube](types#cube). This can happen in particular when loading a saved widget after updating a cube on the server side.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof DimensionNotFoundError) {
    // handle DimensionNotFoundError
  }
}
```

## EmptyDataModelError

Thrown when a [DataModel](types#datamodel) does not contain any cube. This can happen in particular when a user is not granted access to any cube.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof EmptyDataModelError) {
    // handle EmptyDataModelError
  }
}
```

## ExpiredLicenseError

Thrown when the license of a target Atoti server has expired.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof ExpiredLicenseError) {
    // handle ExpiredLicenseError
  }
}
```

## ForbiddenError

Thrown when an HTTP status of 403 is received.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof ForbiddenError) {
    // handle ForbiddenError
  }
}
```

## HierarchyNotFoundError

Thrown when a [Hierarchy](types#hierarchy) cannot be found in a [Dimension](types#dimension). This can happen in particular when loading a saved widget after updating a cube on the server side.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof HierarchyNotFoundError) {
    // handle HierarchyNotFoundError
  }
}
```

## InternalServerError

Thrown when an HTTP status of 500 is received.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof InternalServerError) {
    // handle InternalServerError
  }
}
```

## InvalidConditionalStyleError

Thrown when the conditional style of a field is invalid.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof InvalidConditionalStyleError) {
    // handle InvalidConditionalStyleError
  }
}
```

## InvalidContentError

Thrown when the content fetched from the Content Server is not a valid JSON object.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof InvalidContentError) {
    // handle InvalidContentError
  }
}
```

## InvalidDraggedWidgetError

<Warning>
  **Deprecated**

  This error is no longer used and will be removed in AtotiUI 5.3.
</Warning>

Thrown when a dragged widget was dropped into a dashboard but did not have an initial state attached to it.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof InvalidDraggedWidgetError) {
    // handle InvalidDraggedWidgetError
  }
}
```

## InvalidMdxFilterError

Thrown when an [Mdx](types#mdx) is expected to represent a [Filter](types#filter) but cannot be interpreted as such.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof InvalidMdxFilterError) {
    // handle InvalidMdxFilterError
  }
}
```

## InvalidMemberError

Thrown when `expression` cannot be resolved as a member of cube `cubeName`.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof InvalidMemberError) {
    // handle InvalidMemberError
  }
}
```

## InvalidMetaDataError

Error thrown when a [AMetaData](types#ametadata) object does not contain a `name` attribute.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof InvalidMetaDataError) {
    // handle InvalidMetaDataError
  }
}
```

## InvalidNamePathError

Thrown when a member has an empty namePath. This can happen in case of misconfiguration of a widget.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof InvalidNamePathError) {
    // handle InvalidNamePathError
  }
}
```

## InvalidServiceVersionIdError

Thrown when a [ServiceVersion](types#serviceversion) id is not valid.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof InvalidServiceVersionIdError) {
    // handle InvalidServiceVersionIdError
  }
}
```

## InvalidTupleKeyError

Thrown when a tuple key could not be parsed as a comma-separated list of member compound identifiers.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof InvalidTupleKeyError) {
    // handle InvalidTupleKeyError
  }
}
```

## JwtNotFoundError

Thrown when no JWT is found. It must be provided using [JwtProvider](context-providers#jwtprovider).

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof JwtNotFoundError) {
    // handle JwtNotFoundError
  }
}
```

## LevelNotFoundError

Thrown when a [Level](types#level) cannot be found in a [Hierarchy](types#hierarchy). This can happen in particular when loading a saved widget after updating a cube on the server side.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof LevelNotFoundError) {
    // handle LevelNotFoundError
  }
}
```

## LogoutNotFoundError

Thrown when no logout callback is found. It must be provided using [LogoutProvider](context-providers#logoutprovider).

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof LogoutNotFoundError) {
    // handle LogoutNotFoundError
  }
}
```

## MdxError

Thrown when parsing an invalid Mdx query.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof MdxError) {
    // handle MdxError
  }
}
```

## MissingMetaDataError

Thrown when the metadata file is missing or if the user does not have the permission to read it.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof MissingMetaDataError) {
    // handle MissingMetaDataError
  }
}
```

## ModalNotFoundError

Thrown when a modal identified by `modalKey` is not provided via [ModalsProvider](context-providers#modalsprovider).

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof ModalNotFoundError) {
    // handle ModalNotFoundError
  }
}
```

## ModalsNotFoundError

Thrown when no modals are found. They must be provided via [ModalsProvider](context-providers#modalsprovider).

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof ModalsNotFoundError) {
    // handle ModalsNotFoundError
  }
}
```

## NoResponseError

Thrown when an HTTP request does not trigger any response from the server. This happens when the target server is down.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof NoResponseError) {
    // handle NoResponseError
  }
}
```

## PluginNotFoundError

Thrown when a plugin identified by a `pluginKey` is not found in the registry. This can be caused by the absence of a PluginProvider in the React tree, or by the fact that `pluginKey` is malformed and does not correspond to any provided plugin.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof PluginNotFoundError) {
    // handle PluginNotFoundError
  }
}
```

## QueryError

Thrown when Atoti Server responds to a query with an error message.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof QueryError) {
    // handle QueryError
  }
}
```

## ResourceNotFoundError

Thrown when an HTTP status of 404 is received.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof ResourceNotFoundError) {
    // handle ResourceNotFoundError
  }
}
```

## ThemeNotFoundError

Thrown when a [Theme](types#theme) cannot be found. This can happen in particular if the user's `theme` setting references a theme which does not exist in `configuration.themes`. See [Configuration](types#configuration).

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof ThemeNotFoundError) {
    // handle ThemeNotFoundError
  }
}
```

## UnauthorizedError

Thrown when an HTTP status of 401 is received.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof UnauthorizedError) {
    // handle UnauthorizedError
  }
}
```

## UnsupportedServerVersionError

Thrown when a server version is unsupported.

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof UnsupportedServerVersionError) {
    // handle UnsupportedServerVersionError
  }
}
```

## UserNotFoundError

Thrown when no [User](types#user) is found. It must be provided using [UserProvider](context-providers#userprovider).

```typescript theme={"languages":{"custom":["/engine/python-sdk/0.9/languages/pycon.tmLanguage.json"]}}
try {
} catch (error: Error) {
  if (error instanceof UserNotFoundError) {
    // handle UserNotFoundError
  }
}
```