# Announcing the Mergent V2 API

We're happy to announce the launch of Mergent's new V2 API, which provides improvements to working with Mergent and a _ton_ of behind-the-scenes changes.

There are a few notable changes to the API between V1 and V2.

_As always, feel free to visit our [docs](https://docs.mergent.co) or [API reference](https://api.mergent.co/docs) directly. We're also available at [support@mergent.co](mailto:support@mergent.co) to answer any questions._

**There are new library versions.**

If you're using one of the official Mergent libraries, update to the most recent version to use the new V2 API.

**The API prefix is now `/v2` instead of `/v1`.**

If you're using the API directly, change the API prefix to `/v2`. API endpoints prefixed with `/v1` will become inaccessible on May 31st, 2022.

**The rate limit has been changed to 500 requests per second.**

This is a soft limit, and with increases per project available by emailing [support@mergent.co](mailto:support@mergent.co). We plan on continuing to increase the rate limit over time.

**All resources now require a `queue` attribute when being created.**

By default, the Mergent libraries will set this to `default`. Soon, we will be providing another update with ways to control Tasks within a queue. Stay tuned.

**All resources now return an `id` attribute upon creation.**

Previously, Mergent's APIs used an optional `name` as a primary identifier. Now, Mergent returns an `id` attribute. Please use this for Task/Schedule identification.

**Tasks no longer have a `description` attribute.**

This was a holdover from before Mergent Schedules were separated from Mergent Tasks several months ago. Schedules continue to have a `description` attribute.

**`name` is now strictly used for the deduplication of** _**queued**_ **and** _**working**_ **tasks.**

Before, Mergent used `name` both as a deduplication key and primary identifier for all resources. Due to the way deduplication was handled behind the scenes, `name`s could not be reused once a Task was completed.

With this change, `name` only deduplicates tasks that are either _queued_ or _working_.

Want to Learn More?
-------------------

Check out our [docs](https://docs.mergent.co), our new [API reference](https://api.mergent.co/docs), or send us a note at [support@mergent.co](mailto:support@mergent.co). We're here to help!