---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.ru/dev/webmaster/doc/en/concepts/versions.md
  - https://yandex.ru/dev/webmaster/doc/ru/concepts/versions.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/webmaster/doc/en/llms.txt

# How do I work with the API versions?

## Numbering {#numiration}

The version number consists of two numbers (for example, 4.1). The version number increases with each update:

- The first number is incremented when there are significant changes to the API architecture.

- The second number is incremented when the new version has backward compatibility with previous versions.

## Supported versions {#sup-versions}

- 3.2 — Archived version.

- 4.0 — Archived version.

- 4.1 — Current version.

Archived versions are still supported, but aren't updated with new functionality.

The reference for version 3.2 is available [at this URL](https://yandex.ru/dev/webmaster/doc/v3.2/concepts/About-docpage/). The reference for version 4 is updated to the current version in the current documentation. Changes between versions are shown in the migration guide to the new version. A separate guide is supported for each version:

- [Migration to version 4.0](https://yandex.ru/dev/webmaster/doc/en/concepts/migration-4.0.md)

- [Migration to version 4.1](https://yandex.ru/dev/webmaster/doc/en/concepts/migration-guide.md)

## Using version 4 {#v4}

You can find the query format in the resource reference. When using version 4, you can specify `v4` in the request, unless the format specifies otherwise, to use the current API version by default.

To use an archived version, specify the version explicitly in the request (for example, `v4.0`).