---
title: "Revisions Client API Overview"
url: "https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/overview"
version: "6.2"
language: "python"
---

# Revisions Client API Overview

> Client language: Python. Also available for [C#](https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/overview.md), [Java](https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/overview.java.md), [PHP](https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/overview.php.md), [Node.js](https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/overview.nodejs.md).
>
> RavenDB publishes an official agent skill for coding assistants at https://docs.ravendb.net/skills/ravendb/SKILL.md (also installable with `npx skills add ravendb/skills`). The skill describes itself as: "Read this before writing any RavenDB query, client call or /databases/ request. Covers server setup, document modelling, the Node.js, .NET and Python clients, RQL, indexes, vector search and AI agents. Code written from recall tends to run and return the wrong rows, because RQL resembles SQL and the clients take field names as plain strings."

> **Note**
>
> - For a general revisions overview see: [Revisions Overview](https://docs.ravendb.net/6.2/document-extensions/revisions/overview.python.md).
>
> - Document revisions can be managed using [Studio](https://docs.ravendb.net/6.2/studio/database/settings/document-revisions.md) or from the **Client API**.
>
> - Find below a list of methods that revisions can be configured and managed by.
>   - [Store Operations](#revisions-store-operations)
>   - [Session Methods](#revisions-session-methods)

## Revisions `store` Operations

- [ConfigureRevisionsOperation](https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/operations/configure-revisions.python.md) - apply a revision configuration
- [GetRevisionsOperation](https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/operations/get-revisions.python.md) - get revisions

## Revisions `session` methods

#### Get revisions:

- Use [get\_for](https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/session/loading.python.md#get-all-revisions)
  to retrieve **all** revisions kept for a document.
- Use [get\_metadata\_for](https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/session/loading.python.md#get-revisions-metadata)
  to retrieve **metadata** for all revisions kept for a document.
- Use [get\_by\_before\_date ](https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/session/loading.python.md#get-revisions-by-creation-time)
  to retrieve revisions by **change vector** or **creation time**.
- Read [here](https://docs.ravendb.net/6.2/client-api/session/how-to/perform-operations-lazily.python.md#getrevisions)
  about **lazy versions** of `get_for`, `get_metadata_for`, and `get_by_before_date`.

#### Count revisions:

Use [get\_count\_for](https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/session/counting.python.md#getcountfor)
to get the number of revisions kept for a document.

#### Force revision creation:

Read [here](https://docs.ravendb.net/6.2/document-extensions/revisions/overview.python.md#force-revision-creation-via-api)
about creating a revision even if revision configuration is disabled.

## See also

- [Document Revisions Overview](https://docs.ravendb.net/6.2/document-extensions/revisions/overview.python.md)
- [Revert Revisions](https://docs.ravendb.net/6.2/document-extensions/revisions/revert-documents-to-revisions/revert-documents-to-specific-time.md)
- [Revisions and Other Features](https://docs.ravendb.net/6.2/document-extensions/revisions/revisions-and-other-features.python.md)
- [Settings: Document Revisions](https://docs.ravendb.net/6.2/studio/database/settings/document-revisions.md)
- [Document Extensions: Revisions](https://docs.ravendb.net/6.2/studio/database/settings/document-revisions.md)
