/api/v2/users/search, can you expand the expand?

[whoff]

Hello!

I am looking at the documentation here: https://developer.genesys.cloud/useragentman/users/#post-api-v2-users-search

What I noticed was in the response schema for a 200 OK, there seems to be additional details that can be returned inside of an expand, but I am not finding a way to actually accomplish this. Is this just a documentation error?

{
  "query": [
    {
      "type": "EXACT",
      "fields": [
        "addresses.voice"
      ],
      "value": "+17085551014"
    }
  ],
  "expand": [
    "groups",
    "routingStatus"
  ]
}

Say I wanted to expand the search results to include groups, but also return the name of the group. By the docs this seems possible. I have tried this and other iterations with no positive result:

{
  "query": [
    {
      "type": "EXACT",
      "fields": [
        "addresses.voice"
      ],
      "value": "+17085551014"
    }
  ],
  "expand": [
    "groups": ["name"],
    "routingStatus"
  ]
}

[Eos_Rios]

Where does the documentation imply this is possible?

[plmcgrn]

Expand is pretty flat (can't use it for nested relationship values), and group membership is a gap with the user list/search API's. So yeah, documentation is wrong there, because it's just auto-generated from the API spec. I hit this limit too, even with the normal /api/v2/users/get API call.