List Devices Expand Misdocumentation

[dtmirizzi]

Hello,

I was recently using the devices API and I wanted to use the expand query param defined here (Devices).

When I attempted to make a curl like this one (as defined in the documentation
curl -X GET "https://xxx.okta.com/api/v1/devices?expand=string" -H "Authorization: SSWS xxx"
I get this repose
{"errorCode":"E0000002","errorSummary":"The request was not valid: Invalid expand operation specified: (string)","errorLink":"E0000002","errorId":"oaeRcKYr-mOTL-ykaUAKtUWhA","errorCauses":[]}%

If I set it eq to true it also fails and if I dont supply any query string it works but does not return _embedded.

What am I doing wrong?

[dtmirizzi]

Hey I figured it out,

"https://xxx.okta.com/api/v1/devices?expand=users

You have to specify the expand value!

Might want to clarify the documentation.

[andrea]

Thank you for your feedback! It does seem like we could show examples of possible values for the expand parameter in our documentation. I will pass this along to our documentation team so we can try to prevent future confusion regarding this.