grants-invite

 

Request parameters:

namevalue

mandatory

domain Full qualified domain name

 yes

email

Email of user to be invited to accept a role for 'domain'

 yes

role

Role offered (@admin/@billing/@tech/@creator)

 yes

client-uid     

receiving Joker.com user id as shown on Joker.com - also conforms to reseller-id

 no

nick-name

Name or comment for this role/grant for later identification (defaults to email)

 no

 

With this request you can assign 'Roles' (permissions) of domains to other Joker.com users. The special role "creator" is an equivalent to an internal transfer of that domain to another Joker.com user. In this case, the domain is assigned to the receiving account's portfolio, including all rights and permissions on this domain.

There are two variants to use this functionality: If the client-uid (Joker.com user account id) is given, and the client-uid matches the associated user's email address in our system, the role is applied immediately - there will be no request for confirmation on the receiver's side. In case the client-uid is not given, but only the email address, the transaction has to be acknowledged by the receiving user. For this, he will get an email ('invitation'), containing a link and a key. Either the link has to be clicked, or the key has to be applied using Joker.com (=> Transfer). This can also be used for users which do not yet have a Joker.com account.

 

Please see more details: How to grant roles (= grant permissions to others)?.

Returns status only (ok or not). Email is sent if request was succesfull.

 

Tags: contacts, DMAPI, grants, invitations, permissions, roles, transfer

Related entries:

You cannot comment on this entry