10Duke Enterprise release 3 documentation is no longer being updated

Example objects and operations

Example objects and operations for the 10Duke Identity Management Graph API.

Login

Logs in the user and establishes an authenticated session.

POST /graph?operation=Login

Parameters:

Parameter In Type Required
userName: The login email address or user name query or form string true
password: The password query or form string true

Profile

Generic operations: POST, GET, PUT, DELETE

Register a user

Creates and initializes a new user in the system.

POST /graph?operation=RegisterUser

Parameters:

Parameter In Type Required
body: The Profile object specifying the user to create body Profile true

Change login email

Changes the user’s email address that is used as the login name.

POST /graph?operation=ChangeLoginEmail

Parameters:

Parameter In Type Required
profileId: The id of the profile for which the login email is changed query or form UUID true
recoveryEmailId: query or form    

Change contact info email

Changes the user’s email address that is used as the contact email that can be displayed to other users.

POST /graph?operation=ChangeContactInfoEmail

Parameters:

Parameter In Type Required
profileId: The id of the profile for which the contact info email is changed query or form UUID true
recoveryEmailId query or form    

Add a user to a group or organization

Adds a user to a ProfileGroup. Adding a user to an organization is done by adding the user to a ProfileGroup that represents the organization members.

POST /graph?operation=AddToProfileGroups

Parameters:

Parameter In Type Required
profileId: The id of the profile to be added in the group query or form UUID true
profileGroupId: The id of the group to which the user is added query or form UUID true
allowAlreadyAdded: Controls how the operation behaves if the user is already in the group. If true, the operation doesn’t give an error response in this case. query or form boolean false

Remove a user from a group or organization

Removes a user from a ProfileGroup. Removing a user from an organization is done by removing the user from a ProfileGroup that represents the organization members.

POST /graph?operation=RemoveFromProfileGroups

Parameters:

Parameter In Type Required
profileId: The id of the profile to be removed from the group query or form UUID true
profileGroupId: The id of the group from which the user is removed query or form UUID true
allowAlreadyRemoved: Controls how the operation behaves if the user is not in the group. If true, the operation doesn’t give an error response in this case. query or form boolean false

Add a user to an organization role

Adds a user to an OrganizationRole, that is, to a role that is used for granting permissions in the scope of an organization.

POST /graph?operation=AddToRole

Parameters:

Parameter In Type Required
profileId: The id of the profile to be added in the role query or form UUID true
organizationId: The id of the organization scoping the role and the attached permissions query or form UUID true
organizationRoleId: The id of the role in which the user is added query or form UUID true

Related objects:

  • ~ManyToOne/Person

  • ~OneToMany/ContactInformation

  • ~Membership/ProfileGroup

  • ~OneToMany/Property:ProfileProperty

  • ~ManyToMany/Role

  • ~ManyToMany/OrganizationRole

  • ~ManyToMany/ConsumerRole

Organization

Generic operations: POST, GET, PUT, DELETE

Specific operations:

GET/graph/Organization[@id='ID_GOES_HERE']
GET /graph/Organization[@name='NAME_GOES_HERE']

Related objects:

  • ~OneToMany/OrganizationContactInformation

  • ~OneToMany/OrganizationRole

  • ~OneToMany/ProfileGroup

  • ~OneToMany/VatNumber

  • ~ServicePartnership/Organization

EmailAddress

Generic operations: POST, GET, PUT, DELETE

Specific operations:

POST /graph

operation=ChangeContactInfoEmail&profileId=[PROFILE_ID]&recoveryEmailId=[EMAIL_ID]

{
  "__objType": "ChangeContactInfoEmailResult", 
  "resultCode": "Success"
}

Related objects:

  • ~ManyToOne/ContactInformation

ProfileGroup

Generic operations: POST, GET, PUT, DELETE

Related objects:

  • ~ManyToOne/Organization

  • ~Membership/Profile

  • ~OneToMany/ProfileGroupRole

  • ~GroupMembership/ProfileGroup

VatNumber

Generic operations: POST, GET, PUT, DELETE

Related objects:

  • ~ManyToOne/Organization

DunsNumber

Generic operations: POST, GET, PUT, DELETE

Related objects:

  • ~ManyToOne/Organization

Person

Generic operations: POST, GET, PUT, DELETE

Related objects:

  • ~OneToMany/Profile

  • ~OneToMany/EmailAndPassword

TechnicalActor

Generic operations: POST, GET, PUT, DELETE

Related objects:

  • ~OneToMany/EmailAndPassword