> For the complete documentation index, see [llms.txt](https://codemash.gitbook.io/codemash/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codemash.gitbook.io/codemash/api-reference/database/aggregates/test-database-aggregate.md).

# Test Database Aggregate

Test-run an aggregation pipeline with caller-supplied tokens.

An **aggregate** is a saved MongoDB aggregation pipeline you can run to compute, group, and summarise data.

Tests the database aggregate.

Needs the right to save aggregates of the schema — `database:create` **or** `database:update` on `database:aggregate:<schemaId>` — plus `database:read` on the collection and on every collection the pipeline joins (`CM-ERRORS-DATABASE-032` / `033` / `034`). Runs in the request's environment.

{% openapi src="/files/0gOkqzp7kyziG9XPpCBy" path="/{version}/database/aggregates/test" method="post" %}
[norbix-hub-swagger.json](https://712692422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHy372bqsaex2cqS3ikhL%2Fuploads%2Fgit-blob-7c7445e68689b62620e59cb01a3523deb46b865b%2Fnorbix-hub-swagger.json?alt=media)
{% endopenapi %}

## In Cloud

Manage this visually in Cloud — see [Database](/codemash/cloud/database/aggregates.md).

## Use it from code

Every Norbix SDK exposes this endpoint as a method — see [Test Database Aggregate](/codemash/sdks/database/aggregates/test-database-aggregate.md) in the SDK reference, with examples in every language.