I think the fact this documentation exists now is a big improvement over not existing but I think it could be better. The documentation doesn't provide what parameters are valid for an endpoint leaving it up to a the developer to figure out.
Using this specific API endpoint as an example of how there are important missing details in the endpoint documentation.
https://developer.domo.com/portal/35115c5c48927-datasets-api#share-dataset-with-access-permissions
HTTP body parameters for this endpoint include sendEmail, Type, Access level. What this document doesn't tell us as of 2025-04-11 is what parameters are valid and what they do.
I assembled this quickly for my use case, but I feel that parameters should be included with the documentation provided.
sendEmail
sendEmail value | Comment |
|---|
true | Send an email Notification to the User/Group. |
false | Don’t send an email Notification to the User/Group. When automating I would suggest developer should chose this to be the default choice to avoid spamming users and groups. |
Type
Type value | Comment |
|---|
USER | To share a dataset to a Domo User (User id) You can get this by clicking on the person in the people management page https://{instance}.domo.com/admin/people and getting it from the address bar of the page that opens https://{instance}/admin/people/{UserId}?tab=profile |
GROUP | For use with a Domo Group ID (GroupId) You can get this by clicking on the group in the group management page https://{instance}.domo.com/admin/groups and getting it from the address bar of the page that opens https://{instance}.domo.com/admin/groups/{GroupId}?tab=people |
Access level
Type value | Comment |
|---|
CAN_EDIT | Allows for Editing and Deleting Dataset (same as owner) |
CO_OWNER | Allows for editing and Sharing Dataset, but can’t delete |
CAN_SHARE | Allows for sharing but, can’t edit Dataset at all. |
