# Changelog

<details>

<summary>[v3] New endpoints: Job Management</summary>

When you need to export a large amount of data from impact.com, such as a detailed performance report, requesting all the data at once can lead to timeouts or API rate-limiting errors. You can use the `Jobs` endpoint to schedule a job to extract data and fetch the results once complete. Jobs will protect you from hitting rate limits and will ensure a smoother data retrieval experience.<br>

</details>

<details>

<summary>[v3] Scoped Tokens</summary>

impact.com lets you create scoped tokens: API credentials with detailed, fine-tuned permissions that limit or allow access to specific API endpoints. This improves security, enhances access control, and simplifies token management.

To get started, explore:

* [Best practices for scoped tokens](https://help.impact.com/en/support/solutions/articles/155000005478).
* [How to migrate to scoped tokens](https://help.impact.com/en/support/solutions/articles/155000005518).
* [How to manage API access effectively](https://help.impact.com/en/support/solutions/articles/155000004768).

</details>

<details>

<summary>[v3] Migrate to ReportExport</summary>

If you export large volumes of report data via the impact.com API, now is the time to switch to the more efficient ReportExport API endpoint—especially with upcoming limits to the legacy Reports API on September 1, 2025.

</details>

<details>

<summary>[v3] Ensure your data is always fresh!</summary>

Previously, you may have run the risk of receiving incorrect or outdated information if your client cached data in your API requests, especially for dynamic, user-specific, or time-sensitive data. You will now receive the following header values to indicate to your client that the response data from your queries should not be cached, and ensure that you always fetch the latest data:

```
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
```

Ensure that your data is always fresh by checking that your API client expects these new header values.\
This update will affect all headers.

</details>

<details>

<summary>[v3] Changes to the Reports endpoint pagination</summary>

After 2 October 2023, any requests made to the `/Reports` API endpoint that specify a page size other than 20,000 will return a page size of exactly 20,000 records. If any of your integrations with the `/Reports` API specifies a page size less than 20,000, we recommend either of the following updates:

* Specify a `PageSize` of 20,000.
* Remove the `PageSize` parameter from the request altogether.

</details>

<details>

<summary>[v2] New endpoint: Export a Report</summary>

There is a new endpoint in the reports section of our API reference documentation.

The `ReportExport` endpoint schedules a job to export reports asynchronously.

</details>


---

# 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/agency-v3/agency-v2/readme/changelog.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.