# Versioning

When backward-incompatible changes are made to the API, a new, dated version is released. The current version is `14 (2022-10-12)`.

| Version | Release Date |
| ------- | ------------ |
| 11      | 2018-05-30   |
| 12      | 2021-08-05   |
| 13      | 2022-02-01   |
| 14      | 2022-10-12   |
| 15      | 2025-03-01   |
| 16      | 2026-06-01   |

A change is considered backward-incompatible when under the following conditions:

* Resources or fields are removed from responses
* The meaning (`Type`) of an attribute changes

Note that the version of an API does not increase when new resources are added or when new fields are added to a resource.

All requests use your [partner account API settings](https://app.impact.com/secure/mediapartner/accountSettings/mp-wsapi-flow.ihtml) unless you override the API version.

To set the API version on a specific request, you can add the `IrVersion` query string parameter or `IR-Version` header.

You can visit your [partner account API settings](https://app.impact.com/secure/mediapartner/accountSettings/mp-wsapi-flow.ihtml) to upgrade your API version. As a precaution, use API versioning to test a new API version before committing to an upgrade.

{% hint style="warning" %}
**Warning:** Upgrading your current account API version may break existing API calls that you have in place. As such, use caution when upgrading versions.
{% endhint %}

#### Versioning examples

{% tabs %}
{% tab title="QUERY STRING PARAMETER" %}

```bash
curl 'https://api.impact.com/Mediapartners/<AccountSID>/Actions' \
	-d 'IrVersion=14' \
	-G
```

{% endtab %}

{% tab title="HEADER" %}

```bash
curl 'https://api.impact.com/Mediapartners/<AccountSID>/Actions' \
	-d 'IrVersion=14' \
	-G
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://integrations.impact.com/partner-api-reference/partner-v14/readme/versioning.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.