Can someone post the proper fields for v3 API "share" endpoint?

Can someone post the proper fields for v3 API "share" endpoint?

INPUT_DATA='''{
"share":{
"users":[{"name":"Doe John"}],
"technician_comments":"Request Shared",
"user_comments":"Request Shared",
"user_scope":[]
}
}'''


The above was posted by members of the support team. However, I am getting "users field has invalid value(s) :  [{"name":"Doe John"}] when i try to enter a requests name using "api/v3/requests/" + $workorderid + "/share" as the api endpoint. Ive seen different scripts posted here in the forums with different values after the "users" : [ ] segment of the input data. this info is not returned in the json object when doing a get request web call...whether i view a shared, or unshared request, i cannot see the share endpoint. Am i chasing a pipe dream here, or does the SDP+ not have this v3 api feature? 

Where is the documentation for the v3 share functionality if it exists? Please do not mark this question answered until i respond to any replies. 

$inputReq = @"
{
"share":{
"users":[{"name":"Doe John"}]
}
}
"@

                  New to ADSelfService Plus?