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

# Versioning

<Note>
  The current Orum API version is `v2022-09-21`. `v2021-10-01` is deprecated.
</Note>

To specify the version, set the version in the custom header: `Orum-Version: v2022-09-21`.

Orum releases new API versions when breaking, backward-incompatible changes are made to the API. Backward-compatible changes will be announced in the [Changelog](/changelog) but will not prompt a new API version.

**Non-breaking changes include:**

* Adding new API endpoints

* Adding new optional parameters or fields to API requests

* Adding new fields to API or webhook responses

* Adding new webhook `event_types`

* Adding new enums

* Changing the `message` field in [Error responses](/guides/errors)

* Updating request fields or query parameters to be optional instead of required

* Adding new REST methods to existing endpoints

**Breaking changes include:**

* Removing an endpoint

* Adding new required request fields, parameters, or headers to an endpoint

* Removing or changing response fields

* Adding new validation rules to request fields or parameters

* Updating request fields or query parameters to be required instead of optional