Missing documentation for Trello API option "fields=all"

[Octopus]

I was creating an API integration to use the endpoint GET /1/organizations/{id}/members but I kept getting only ID, fullName and username, while the documentation https://developer.atlassian.com/cloud/trello/rest/api-group-organizations/#api-organizations-id-members-get was telling me that I was supposed to get an Array<Member>, with plenty of data such as bio, avatarUrl, etc etc.

[{"id":"123456789","fullName":"Xxxxx","username":"xxxx123"},{"id":"987654321","fullName":"Yyyy Zzzz","username":"yyyyyyy"}]

Just by pure chance I looked at another endpoint and some examples in the forum and I saw that those other endpoints were using a fields=all query parameter, and lo and behold, after I added this to my URL, I got a full set of data.

Could this be missing from the documentation page?

Oh, and one more thing: I’m still not seeing member email, which I use to identify each member. I am reading that perhaps Trello does not give you access to other people’s emails, is this correct? Is there any way to authorize my app so that I can read this information?

Thank you very much!

[Octopus]

I don’t feel like this is a big enough question for another thread, and maybe the person replying to my first question will be able to answer this small question: What is aaEmail? How is it different to the regular email? This is not clear in the documentation and a google search of trello api aaEmail or just trello aaEmail returns nothing useful.

Thanks!

[bentley]

@Octopus

I’m still not seeing member email , which I use to identify each member. I am reading that perhaps Trello does not give you access to other people’s emails, is this correct? Is there any way to authorize my app so that I can read this information?

Correct. There is a little call out on this page (https://developer.atlassian.com/cloud/trello/guides/rest-api/authorization/) that highlights this:

[bentley]

@Octopus

Could this be missing from the documentation page?

This is an example of what we refer to as a “Nested Resource”, I think we normally link to the object’s nested resource documentation here: https://developer.atlassian.com/cloud/trello/guides/rest-api/nested-resources/#members-nested-resource

So we are missing that on this one. Something we can get updated, though!

[bentley]

@Octopus

What is aaEmail?

This is referring to the Atlassian Account email. Looking at my own account, I see it returning null so I’m not sure whether this field’s value is ever an actual email or address or a boolean… I’d guess the latter.