API Limits on conversation.participant.search.attribute.item.bytes.max

conversation.participant.search.attribute.item.bytes.max

In the documentation, there is a limit of 20,480 on this resource: api/v2/conversation/participants/attributes/search

But it doesn't say anything about what limit. Is this a limit on the # of bytes in the result set when this endpoint is queried or a limit on the size of the query itself or a limit on the data stored in the object(s) that are being queried? A prospective customer is trying if there large amounts of IVR data that will probably get stored in participant attributes will creating reporting/analytics problems based on seeing this limit so I'm looking for clarification. Thank you.

I believe that's referring to this: https://developer.genesys.cloud/organization/search/conversation-participant-attribute-search#general-information

  • We only store conversations with attributes <20KB

This came up recently in another post: Conversations with attributes >20KB

Thanks Tim! A few follow-up questions to make sure I understand the specific limitations:

  1. Is this total size of all participant data fields and values or per participant data field?
  2. What happens if it is exceeded? Is it capped when the data is written or only when retrieval is attempted?
  3. If it is capped, is no data available, only the newest, or only the oldest?

Hopefully those questions make sense. Thanks again for your help.

It will store partial data, but not partial attributes. When ingesting updates to the attributes, it will add them to the index as long as the indexed data remains under 20KB. If adding an attribute would exceed the limit, it's ignored. The size calculation considers the full size when stored on disk, which is approximately the data represented as key-value pairs in a JSON object then serialized.

The data is stored on a first-come first-serve basis as updates happen, so knowingly exceeding the size limit can cause consistency issues since a collection of conversations with the same attributes may have different attributes written to the search index.

If you expect to be storing data in excess of 20KB, an external indexing solution will be necessary if you require guaranteed data integrity. As stated in the other thread, I understand that's not desirable but the limit is the limit and you have to either work within it or work around it using an external tool. Suggestions to change the limit have to go to the ideas site and complaints about it to your TAM.

That's super helpful, Tim. Thank you! knowing the limits will help us advise our prospective customer on the best way to utilize attributes within the constraints laid out here.

Regarding the PD data which exceeded 20kb. Our PS team told they are cleaning up the data and optimizing the IVR Flows to not exceed 20kb. But don't know what exactly they are doing

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.