Error - evaluations/aggregates/query: (not)valid dimensions?

[kr_maas]

Beating my head against a wall, hoping I'm missing something obvious. Using api/v2/analytics/evaluations/aggregates/query and attempting to return the evaluationReleaseDate in the groupBy... yes, it's high cardinality, but it's a customer requirement. Seems straightforward enough, right? Where did I go wrong?

Per the documentation

groupBy

( array, optional ): Behaves like a SQL GROUPBY. Allows for multiple levels of grouping as a list of dimensions. Partitions resulting aggregate computations into distinct named subgroups rather than across the entire result set as if it were one group. Valid Values: calibrationId, contextId, conversationId, conversationStart, divisionId, evaluationCreatedDate, evaluationId, evaluationReleaseDate, evaluatorId, formId, queueId, released, rescored, teamId, userId

However...

{"interval": "2021-08-21/2021-08-28",
"groupBy":["conversationId","userId","evaluationReleaseDate"],

"metrics": ["nEvaluations", "nEvaluationsDeleted", "nEvaluationsRescored", "oTotalCriticalScore", "oTotalScore"],
"flattenMultivaluedDimensions": true
}

returns...

{
  **"message": "unsupported groupBy dimension evaluationReleaseDate",**
  "code": "bad.request",
  "status": 400,
  "messageParams": {},
  "contextId": "72618c9c-1eb4-4893-baf7-b232b541882b",
  "details": [],
  "errors": []
}

[Eos_Rios]

"Preview" means it may work for future generations, but for right now it's just there to taunt us with a feature that may or may not ever be implemented and nobody will commit to a release roadmap for.

[Becky_Powell]

Hi Eos - thanks for chiming in! Typically, "preview" means that the feature is in beta status and that there is a definite plan to release the functionality. I promise we don't taunt our users - we're on your side!

I will look into this particular case and provide an answer to the original post as well as any roadmap plan. Thank you!

[Jose_Ruiz]

Hello kr_mass, The ability to query by evaluationReleaseDate dimension for the /api/v2/analytics/evaluations/aggregates/query API is a technical enabler for the agent evaluation widget feature that is currently scheduled to be available in early Q1 2022. Once it becomes available the documentation will be updated accordingly and will no longer be listed as a Preview option.