# Parse Server REST API Aggregate Documentation (match vs $match, pipeline)

**URL:** <https://community.parseplatform.org/t/parse-server-rest-api-aggregate-documentation-match-vs-match-pipeline/4783>\
**Category:** Uncategorized\
**Created:** [January 30, 2025, 6:10am UTC](https://community.parseplatform.org/t/parse-server-rest-api-aggregate-documentation-match-vs-match-pipeline/4783 "2025-01-30T06:10:56Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![threepwood](https://community.parseplatform.org/letter_avatar_proxy/v4/letter/t/8dc957/32.png) [@threepwood](https://community.parseplatform.org/u/threepwood)\
**Post date:** [January 30, 2025, 6:10am UTC](https://community.parseplatform.org/t/parse-server-rest-api-aggregate-documentation-match-vs-match-pipeline/4783/1 "2025-01-30T06:10:56Z")

</div>

Dear Community,

We have upgraded a legacy project Parse Server from version 2.8 to version 7.3. As we use Parse Server’s REST API, one of the changes we had to implement was to change our aggregate requests.

In this context, we noticed that the [documentation](https://docs.parseplatform.org/rest/guide/#aggregate-queries) does not reflect the latest version’s behaviour.

Could you please advise on the following:

1. Parameters such as `match` or `group` are now rejected. These do still work if passed on as `$match` and `$group`. However, this is not reflected in the documentation.
2. Parameter `pipeline` is new since version 3. However, this also is not reflected in the documentation.
3. We are currently using both approaches (parameters `$match`/`$group` and `pipeline`) in different use cases. Are there any plans to deprecate either?

Thank you for clarifying!

 ![Screenshot 2025-01-30 at 16.57.01](https://parse-community-forum-uploads.s3.dualstack.us-east-1.amazonaws.com/original/2X/7/76fe34afa30143c880b13b7b98fd42e19f02d69a.png)

---

<div class="post-metadata">

**Author:** ![Manuel](https://community.parseplatform.org/user_avatar/community.parseplatform.org/manuel/32/186_2.png) [@Manuel](https://community.parseplatform.org/u/Manuel)\
**Post date:** [January 30, 2025, 9:10am UTC](https://community.parseplatform.org/t/parse-server-rest-api-aggregate-documentation-match-vs-match-pipeline/4783/2 "2025-01-30T09:10:49Z")

</div>

> [@threepwood](#):
>
> Parameters such as `match` or `group` are now rejected. These do still work if passed on as `$match` and `$group`. However, this is not reflected in the documentation.

When you upgrade between major versions, I would recommend to jump only by 1 major version at a time. The changelog of each major release describes these breaking changes.

For the aggregation pipeline operators, this change has been described in the changelog of release [6.0.0](https://github.com/parse-community/parse-server/releases/tag/6.0.0):

> The MongoDB aggregation pipeline requires native MongoDB syntax instead of the custom Parse Server syntax; for example pipeline stage names require a leading dollar sign like `$match` and the MongoDB document ID is referenced using `_id` instead of `objectId` ([#8362](https://github.com/parse-community/parse-server/pull/8362))

But it’s possible we didn’t update (all parts of) the documentation. If you find outdated docs that need to be updated, please open an issue in the docs repository.