Grant Roles/Domain Permissions, Internal Transfer

Introduction

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, including all rights and permissions on this domain.

There are two variants to use this functionality: If the user id (Joker.com user account id) is given, and the account id matches the associated email address, the role is applied immediately - there will be no request for confirmation on the receiver's side. In case the user id is not given, but only the email address, the transaction has to be acknowledged by the receiver. For this, he will get an email, 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.

You have to provide the following parameters:

  • domain name (the domain you want to grant somebody else permissions on)
  • destination client email (the email address of the user you want to receive permissions)

The following parameters are optional:

  • destination client id (ID of Joker.com account - always shown in the upper right on Joker.com, also conforms to "reseller id" - must match the 'destination client email')
  • desired role (type of permission you want to assign to "client email" resp. "client id" - one of  "admin|tech|billing|creator"; "creator" means "all permissions" and is equivalent to an internal transfer or 'assignment' - also see 'roles ')  

Request fields

mailsubject: joker-internal-transfer [your reference id]

Definition of this request

Valid values for <tld>: all Joker.com tlds

request-field valid values required
fqdn [a-z0-9-]{1,63}\.<tld>  yes

destination-client-email

 @email

 yes

destination-client-id

 [0-9]+

 no

desired-role

 admin|tech|billing|creator (if omitted, default is 'creator')

 no

 

Example 1: assign 'billing'-role to user 123456 (direct)

 

subject: joker-internal-transfer [your reference id]

body:
fqdn:exampledomain.com
destination-client-email:example-user@gmail.com
destination-client-id:123456
desired-role:billing

Example 2: assign 'creator'-role to user 'example-user@gmail.com' (internal transfer with invitation)

subject: joker-internal-transfer [your reference id]

body:

fqdn:exampledomain.com
destination-client-email:example-user@gmail.com
desired-role:creator


Tags: permissions, roles, transfer, grants

Related entries:

You cannot comment on this entry