[bug/documentation improvement] List Resource Roles API

Tagged as osdk but technically a platform SDK/API topic:
https://www.palantir.com/docs/foundry/api/v2/filesystem-v2-resources/resource-roles/list-resource-roles/

The List Resource Roles API has an optional boolean query param labeled includeInherited, however in practice this is only behaving like a flag param:

e.g. all of the following have the same impact (i.e. to include inherited)
/api/v2/filesystem/resources/{resourceRid}/roles?includeInherited=true
/api/v2/filesystem/resources/{resourceRid}/roles?includeInherited=false
/api/v2/filesystem/resources/{resourceRid}/roles?includeInherited

The only way to limit the result to explicit role grants is to omit the query param.

Unsure if this is a bug or intended behavior but if the latter it might help to clarify that and add a note about default value (e.g. false)

1 Like

Hi @michaelg,

Yes, this appears to be a bug – thanks for flagging it!

We’ll get it fixed ASAP.

Best,
Tom

1 Like

@michaelg – This is now fixed to behave as you would expect it to. The fix will likely take ~1 week to roll out widely. Thanks again for raising this with us!

1 Like