> The complete documentation index is at [llms.txt](/llms.txt). A typed API error kind, deserialized from the `type` and `context` fields of an error response. Raised on an HTTP 404 response from the API. Raised on an HTTP 405 response from the API. Raised on an HTTP 502 response from the API. Raised on an HTTP 400 response from the API. Base class for all bauplan SDK exceptions. ## BauplanHTTPError ```python bauplan.exceptions.BauplanHTTPError(code: int, type: str, message: str, kind: [ApiErrorKind](/reference/bauplan-exceptions#bauplan-exceptions-apierrorkind) | None) ``` Bases: `[BauplanError](/reference/bauplan-exceptions#bauplan-exceptions-bauplanerror)` An HTTP error from the API. **Attributes:** - `code` (int) - `kind` ([ApiErrorKind](/reference/bauplan-exceptions#bauplan-exceptions-apierrorkind) | None) - `message` (str) - `type` (str) Base class for errors raised by bauplan job execution. Raised when a query job fails. Raised when creating a [`bauplan.schema.Branch`](/reference/bauplan-schema#bauplan-schema-branch) that already exists. Raised when the [`bauplan.schema.Branch`](/reference/bauplan-schema#bauplan-schema-branch) head hash has changed since it was last read. Raised when the referenced [`bauplan.schema.Branch`](/reference/bauplan-schema#bauplan-schema-branch) does not exist. Raised on an HTTP 409 response from the API. Raised when the caller is not permitted to create a [`bauplan.schema.Branch`](/reference/bauplan-schema#bauplan-schema-branch). Raised when the caller is not permitted to create a [`bauplan.schema.Namespace`](/reference/bauplan-schema#bauplan-schema-namespace). Raised when the caller is not permitted to create a [`bauplan.schema.Tag`](/reference/bauplan-schema#bauplan-schema-tag). Raised when the caller is not permitted to delete a [`bauplan.schema.Branch`](/reference/bauplan-schema#bauplan-schema-branch). Raised when the caller is not permitted to delete a [`bauplan.schema.Namespace`](/reference/bauplan-schema#bauplan-schema-namespace). Raised when the caller is not permitted to delete tables. Raised when the caller is not permitted to delete a [`bauplan.schema.Tag`](/reference/bauplan-schema#bauplan-schema-tag). Raised on an HTTP 403 response: the caller is not permitted to perform the action. Raised on an HTTP 504 response from the API. Raised on an HTTP 500 response from the API. Raised on an HTTP 400 response from the API. Raised when a pipeline or table-create plan is invalid. Raised when the provided string is not a valid [`bauplan.schema.Ref`](/reference/bauplan-schema#bauplan-schema-ref). Raised when a merge cannot be completed due to conflicting changes. Raised when the caller is not permitted to merge a [`bauplan.schema.Branch`](/reference/bauplan-schema#bauplan-schema-branch). Raised on an HTTP 405 response from the API. Raised when creating a [`bauplan.schema.Namespace`](/reference/bauplan-schema#bauplan-schema-namespace) that already exists on the target [`bauplan.schema.Ref`](/reference/bauplan-schema#bauplan-schema-ref). Raised when attempting to delete a [`bauplan.schema.Namespace`](/reference/bauplan-schema#bauplan-schema-namespace) that still contains tables. Raised when the referenced [`bauplan.schema.Namespace`](/reference/bauplan-schema#bauplan-schema-namespace) does not exist on the given [`bauplan.schema.Ref`](/reference/bauplan-schema#bauplan-schema-ref). Raised when a [bauplan.schema.Namespace](/reference/bauplan-schema#bauplan-schema-namespace) is specified both in the table name (e.g. ns.table) and through an explicit namespace parameter, resulting in an ambiguous reference. Raised when a query returns no results. Raised when the provided [`bauplan.schema.Ref`](/reference/bauplan-schema#bauplan-schema-ref) is not of type BRANCH. Raised when the provided [`bauplan.schema.Ref`](/reference/bauplan-schema#bauplan-schema-ref) is not of type TAG. Raised when a write operation is attempted against a [bauplan.schema.Ref](/reference/bauplan-schema#bauplan-schema-ref) that is not of type BRANCH. Raised on an HTTP 404 response from the API. Raised when the referenced [`bauplan.schema.Ref`](/reference/bauplan-schema#bauplan-schema-ref) does not exist. Raised when the caller is not permitted to rename a [`bauplan.schema.Branch`](/reference/bauplan-schema#bauplan-schema-branch). Raised when the caller is not permitted to rename a [`bauplan.schema.Tag`](/reference/bauplan-schema#bauplan-schema-tag). Raised when a requested catalog resource does not exist. Raised when the destination of a revert operation already exists. Raised when the source and destination of a revert point to the same table snapshot. Raised when the caller is not permitted to revert tables. Raised when the source and destination [`bauplan.schema.Ref`](/reference/bauplan-schema#bauplan-schema-ref) resolve to the same commit hash, making the operation a no-op. Raised on an HTTP 503 response from the API. ## TableCreatePlanApplyStatusError ```python bauplan.exceptions.TableCreatePlanApplyStatusError(message: str, state: [TableCreatePlanApplyState](/reference/bauplan-state#bauplan-state-tablecreateplanapplystate)) ``` Bases: `[BauplanError](/reference/bauplan-exceptions#bauplan-exceptions-bauplanerror)` Raised when a table-create plan apply job finishes in a non-success state. **Attributes:** - `message` (str) - `state` ([TableCreatePlanApplyState](/reference/bauplan-state#bauplan-state-tablecreateplanapplystate)) Base class for errors raised during a table-create plan workflow. ## TableCreatePlanStatusError ```python bauplan.exceptions.TableCreatePlanStatusError(message: str, state: [TableCreatePlanState](/reference/bauplan-state#bauplan-state-tablecreateplanstate)) ``` Bases: `[TableCreatePlanError](/reference/bauplan-exceptions#bauplan-exceptions-tablecreateplanerror)` Raised when a table-create plan job finishes in a non-success state. **Attributes:** - `message` (str) - `state` ([TableCreatePlanState](/reference/bauplan-state#bauplan-state-tablecreateplanstate)) Raised when creating a table that already exists on the target [`bauplan.schema.Ref`](/reference/bauplan-schema#bauplan-schema-ref). Raised when the referenced table does not exist on the given [`bauplan.schema.Ref`](/reference/bauplan-schema#bauplan-schema-ref). Raised when creating a [`bauplan.schema.Tag`](/reference/bauplan-schema#bauplan-schema-tag) that already exists. Raised when the referenced [`bauplan.schema.Tag`](/reference/bauplan-schema#bauplan-schema-tag) does not exist. Raised on an HTTP 429 response from the API. Raised on an HTTP 401 response: missing or invalid credentials. Raised when an update conflicts with the current catalog state.