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

# Python SDK Changelog

> Changelog of updates to Oso Cloud Python SDK.

### 2.6.0

* Add `list_paginated()` method for paginated list queries. Returns a `ListResult` with `results` and `next_page_token` for fetching subsequent pages. `page_size` is a required parameter.

### 2.5.2

* Remove unused internal API.

### 2.5.1

* Add support for new agent APIs

### 2.5.0

* Stable release of `ParityHandle` for use with [`Oso Migrate`](/develop/local-dev/oso-migrate).
* Return OsoException instead of Exception for Oso-specific errors.

### 2.5.0.dev1

* Update `oso.authorize()` and `oso.authorize_local()` `ParityHandle` args to `parity_handle`.

### 2.5.0.dev0

* Add `ParityHandle` for use with `Oso Migrate`.

### 2.4.3

* Deduplicate results in QueryBuilder evaluation.

### 2.4.2

* Standardize HTTP error code handling to treat all non-2xx responses as errors.

### 2.4.1

* Added missing dependency on `typing_extensions`.

### 2.4.0

* Use Fallback, if configured, for `.evaluate_local_select` and `.evaluate_local_filter`
  if Oso Cloud returns an error (Requires [Fallback 1.0.0](#fallback-1.0.0) or later).

### 2.3.0

* Use Fallback, if configured, for `.get_policy_metadata` if Oso Cloud returns
  an error (Requires [Fallback 1.0.0](#fallback-1.0.0) or later).

### 2.2.0

* Add `.evaluate_local_select` and `.evaluate_local_filter` functions to the Query
  Builder to support querying with Local Authorization.

### 2.1.0

* Use Fallback, if configured, for `.get`, Query Builder, and local check APIs
  if Oso Cloud returns an error (Requires [Fallback 0.3.1](#fallback-0.3.1) or later)
* Use Fallback, if configured, if Oso Cloud returns an HTTP error (400, 5xx).

### 2.0.1

Add support for context fact in Local Authorization methods.

### 2.0.0

This release contains several breaking changes. There's a [migration
guide](/reference/sdks/migration-guide) for upgrading from
version 1.x, and don't hesitate to reach out if you run into any issues.

#### Simplified Fact Management API

Reduced the number of methods for managing facts in Oso Cloud from five to
three:

* `tell` is now `insert`.
* `delete` has been upgraded to support wildcard deletions.
* `bulk`, `bulkTell`, and `bulkDelete` have been replaced with a new
  transactional `batch` API.

See the [API docs](/reference/sdks/overview) and the [migration guide](/reference/sdks/migration-guide) for more details.

#### Powerful New QueryBuilder API for Querying Arbitrary Rules in Your Policy

See the [API docs](/reference/sdks/overview)
and the [migration guide](/reference/sdks/migration-guide) for more details.

### 1.5.1

* Add `X-Request-ID` header to uniquely identify individual API requests; include this ID in error messages for better debugging.

### 1.5.0

* Added new [`oso.actions_local()`](/reference/api/local-check-api/post-actions_query) method.
* Accept `bool` and `int` as fact args. These are converted to the appropriate Polar type.

### 1.4.1

Update error message wording.

### 1.4.0

Added support for the local check API:

* Added new [`oso.list_local()`](/reference/api/local-check-api/post-list_query) method.
* Added new [`oso.authorize_local()`](/reference/api/local-check-api/post-authorize_query) method.
* Added optional `data_bindings` argument to
  the `Oso` constructor (defaults to `None`).

### 1.3.x

Along with support for fetching [policy metadata](/develop/enforce/authorize-requests),
`oso-cloud` 1.3.0 introduced more specific parameter and return types
for the Python client to be used with typecheckers like `mypy`.

Releases 1.3.1 - 1.3.3 addressed bugs or gaps found with the new types that were added.