---
title: "Changes to Execute retention query"
method: POST
path: "/application/{applicationId}/analytics/v1/queries/retention/execute"
---

# Changes to Execute retention query

`POST /application/{applicationId}/analytics/v1/queries/retention/execute`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 21 revisions.

- **2026-10-06** `88d6c93bebca`: 1 info
- **2026-09-26** `8541dcfed596`: 3 breaking, 4 info
- **2026-09-25** `6038ecabdc8b`: 4 info
- **2026-09-02** `801fbad9d8d0`: 1 breaking

## Changes

- **2026-10-06** `88d6c93bebca`: 1 info
  - the request property `breakdowns/items/data/condition/numeric` became optional
- **2026-09-26** `8541dcfed596`: 3 breaking, 4 info
  - removed `subschema #1, subschema #2` from the `time` request property `anyOf` list
  - removed `subschema #4, subschema #9` from the `filters/items/data` request property `oneOf` list
  - removed `subschema #4, subschema #9` from the `metrics/items/data/filter/conditions/items/data` request property `oneOf` list
  - the endpoint scheme security `cookieAuth` was removed from the API
  - added `subschema #1, subschema #2` to the `time` request property `anyOf` list
  - added `subschema #4, subschema #9` to the `filters/items/data` request property `oneOf` list
  - added `subschema #4, subschema #9` to the `metrics/items/data/filter/conditions/items/data` request property `oneOf` list
- **2026-09-25** `6038ecabdc8b`: 4 info
  - api operation id `executeRetentionQuery` was added
  - the endpoint scheme security `personalAccessTokenAuth` was added to the API
  - the endpoint scheme security `serverKeyAuth` was added to the API
  - the endpoint scheme security `clientApiKey` was removed from the API
- **2026-09-02** `801fbad9d8d0`: 1 breaking
  - added the new required `header` request parameter `environment_id`

---

[Operation](https://skmtc.dev/gamebeast/apis/gamebeast-api/docs/application/:applicationId/analytics/v1/queries/retention/execute/post.md) - [API](https://skmtc.dev/gamebeast/apis/gamebeast-api.md) - [Page](https://skmtc.dev/gamebeast/apis/gamebeast-api/changes/application/:applicationId/analytics/v1/queries/retention/execute/post)