This API creates a single shared resource or multiple shared resources depending on the format of the request data.
To share a resource that you own, omit the owner_id
field, and use the user_email
field to specify the receiver of the share.
To (as an admin) create a share between two users, use the owner_id
field to specify the owner of the shared resource, and the user_email
field to specify the receiver of the share. In either case, the user_email
must exist within the OEM account. If resource_name
is device, then resource_id
must be a dsn.
To create multiple shared resources with a single call to this API, use an array in the request data. The following example request uses the default template:
{ "shares": [ { "resource_name": "", "resource_id": "", "role_name": "", "user_email": "", "owner_id": 0, "operation": "", "start_date_at": "", "end_date_at": "" } ] }
You can create a share using a specific template using the "email_template_id" parameter as a query parameter.
NOTE: A user can’t have more than one share for the same resource_name, resource_id.