IXON-API

IXON API documentation

Welcome to the IXON development website. Curious about our API endpoints? Take a look at our endpoint list, you can try-out the API in that section as well. Do you need some guidance on how to use our API? Take a look at the API Documentation. Take a look at our release notes if you're curious what has changed to the API.

Endpoint List    Release Notes

Manage users

You can use the APIv2 to integrate an IXON Cloud user invite in your own online environment. you can also add a list of users, or remove a user using the APIv2. After you have requested the basic information headers, you only need three API requests to complete this action. Use the links below for easy navigation:

User management

To comply with IXONs new user management system, you first need to get the ID's for the role and group you'd like to add a new user to. You can do that using the following request for the role ID. The endpoint is RoleList.

curl --request GET
--url 'https://api.ayayot.com/roles?fields=publicId,name' \
--header 'Api-Version: 2' \
--header 'Api-Application: {applicationId}' \
--header 'Api-Company: {companyId}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {Token}'

To obtain a group ID, you have to use the following request. When you want to assign a user to a company wide role, which has access to all devices you have to use the company group, of which te group ID will be included in the response. The endpoint is GroupList.

curl --request GET 
--url 'https://api.ayayot.com/groups?fields=publicId,name' \
--header 'Api-Version: 2' \
--header 'Api-Application: {ApplicationId}' \
--header 'Api-Company: {companyId}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {Token}'

Invite a user

Now that you have the role ID and group ID, you can send the POST request to the InviteList endpoint to invite a new user. Below you can find an example of how that request should look. The Api-Branding header should contain the URL of your company. The default is portal.ixon.cloud, but the entered URL should be different if you use premium branding.

You also have to include a data field with the role ID, group ID, the email address of the person you'd like to invite. You can optionally add a message that will be included in the invite email as well.

curl --request POST 
--url 'https://api.ayayot.com/invites' \
--header 'Api-Version: 2' \
--header 'Api-Application: {applicationId}' \
--header 'Api-Company: {companyId}' \
--header 'Content-Type: application/json' \
--header 'Api-Branding: portal.ixon.cloud' \
--header 'Authorization: {Token}' \
--data '[
  {
    "groupRoles": [
      {
        "group": {
          "publicId": "{groupId}"
        },
        "role": {
          "publicId": "{roleId}"
        }
      }
    ],
    "emailAddress": "{email address}",
    "message": "{message}"
  }
]'

A successful response to the request will look like the example below. An email with the invite link will be sent to the entered email address. That person can create an account to the IXON Cloud by clicking on the link if he or she currently doesn't have an IXON Cloud account.

{
  "status": "success",
  "type": "InviteResponse",
  "data": {
    "invites": [
      {
        "publicId": "{inviteId}"
      }
    ],
    "userMemberships": [
      {
        "publicId": "{memberId)"
      }
    ]
  }
}

Get a list of users

You can also keep a list of the users in your company in your own administration. To obtain that list you have to send a GET request to the UserList endpoint. You can find an example of this request below.

curl --request GET
--url 'https://api.ayayot.com/users' \
--header 'Api-Version: 2' \
--header 'Api-Application: {applicationId}' \
--header 'Api-Company: {companyId}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {Token}'

Remove a user

The UserList endpoint can be used to remove a user as well. You first have to obtain the User ID with the GET request in the example above. You then have to add that User ID to the DELETE request. An example of that request is given below.

curl --request DELETE
--url 'https://api.ayayot.com/users' \
--header 'Api-Version: 2' \
--header 'Api-Application: {applicationId}' \
--header 'Api-Company: {companyId}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {Token}' \
--data '[{"publicId":"{UserId}"}]'

Updated 8 months ago


Manage users


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.