include_has_explicit_shared_members returns false

Ashley B.15

Hi,

I was wondering if there was any documentation around include_has_explicit_shared_members? Should this return true for the following example

 

I have a shared folder with a number of files.  If I share the file with another user that is not included on the orginal share. Should this return true indicating I need to make a request to get the extra members this file is shared with?

 

If not, when would this return true?

 

Thanks

Greg-DB

Hi Ashley, "include_has_explicit_shared_members" is a parameter that you can set on some endpoints, such as /2/files/get_metadata. The documenation there documents it as:

 

"include_has_explicit_shared_members Boolean If true, the results will include a flag for each file indicating whether or not that file has any explicit members. The default for this field is False."

 

If you click on the "FileMetadata" return type to expand it, you'll also see the corresponding "has_explicit_shared_members" response field, which is documented as:

 

"has_explicit_shared_members Boolean? This flag will only be present if include_has_explicit_shared_members is true in list_folder or get_metadata. If this flag is present, it will be true if this file has any explicit shared members. This is different from sharing_info in that this could be true in the case where a file has explicit members but is not contained within a shared folder. This field is optional."

 

You asked about what "include_has_explicit_shared_members" would return, but that's the argument, not part of the response. To summarize though, "has_explicit_shared_members" will only be returned if you did set "include_has_explicit_shared_members" to true in the call, and then the value of "has_explicit_shared_members" will only be true if the file has explicit shared members. That should include the particular scenario you described.