UserService

Manage user information.

Symitar eDocs References: User Control, Creating a new user, Performing a User Inquiry, Reserved user numbers

Operations

getUserSelectFields

post

Retrieves information about a user with selected fields.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

UserNumberintegerRequired

The user number for the activity.

Responses

200

Successful operation.

application/json

post/getUserSelectFields

HTTPcURLJavaScriptPython

POST /nexum/627/persistent/user/getUserSelectFields HTTP/1.1
Host: naas.ymcu.libum.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 338

{
  "Credentials": {
    "AdministrativeCredentials": {
      "Password": {
        "symx-administrative-password": null
      }
    }
  },
  "UserNumber": 1995,
  "SelectableFields": {
    "IncludeAllUserFields": false,
    "UserFields": {
      "Number": true,
      "Name": true,
      "Type": true,
      "ActiveMode": true,
      "LastLogonDate": true,
      "LastLogonTime": true
    }
  },
  "nxAttributes": {
    "customFields": {
      "appId": "{application-id}"
    }
  }
}

200

Successful operation.

{
  "User": {
    "ActiveMode": 0,
    "LastLogonDate": "2025-07-05",
    "LastLogonTime": 1806,
    "Name": "NAAS PLAYGROUND",
    "Number": 1995,
    "Type": 0
  },
  "MessageId": "getUserSelectFields"
}

getUserSelectFieldsFilterChildren

post

Retrieves information about a user with selected fields and filters children.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

UserNumberintegerRequired

The user number for the activity.

Responses

200

Successful operation.

application/json

post/getUserSelectFieldsFilterChildren

HTTPcURLJavaScriptPython

POST /nexum/627/persistent/user/getUserSelectFieldsFilterChildren HTTP/1.1
Host: naas.ymcu.libum.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 663

{
  "Credentials": {
    "AdministrativeCredentials": {
      "Password": {
        "symx-administrative-password": null
      }
    }
  },
  "UserNumber": 1995,
  "SelectableFields": {
    "IncludeAllUserFields": false,
    "UserFields": {
      "Number": true,
      "Name": true,
      "Type": true,
      "ActiveMode": true
    },
    "ActivitySelectableFields": {
      "IncludeAllActivityFields": false,
      "ActivityFields": {
        "UserNumber": true,
        "Date": true,
        "Time": true,
        "Console": true
      }
    },
    "UserTrackingSelectableFields": {
      "IncludeAllUserTrackingFields": false,
      "UserTrackingFields": {
        "Locator": true,
        "Type": true,
        "CreationDate": true
      }
    }
  },
  "ChildrenSearchFilter": {
    "ActivityFilter": {
      "Query": ""
    },
    "UserTrackingFilter": {
      "Query": ""
    }
  },
  "nxAttributes": {
    "customFields": {
      "appId": "{application-id}"
    }
  }
}

200

Successful operation.

{
  "User": {
    "ActiveMode": 0,
    "Name": "NAAS PLAYGROUND",
    "Number": 1995,
    "Type": 0,
    "ActivityList": null,
    "UserTrackingList": null
  },
  "Version_1": null,
  "_value_1": null,
  "MessageId": "getUserSelectFieldsFilterChildren"
}

getActivityPagedListSelectFields

post

Retrieves a paged list of selected fields for activities.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

UserNumberintegerRequired

The user number for the activity.

Responses

200

Successful operation.

application/json

TokenstringOptional

The tokenized value for the activity.

post/getActivityPagedListSelectFields

HTTPcURLJavaScriptPython

POST /nexum/627/persistent/user/getActivityPagedListSelectFields HTTP/1.1
Host: naas.ymcu.libum.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 429

{
  "Credentials": {
    "AdministrativeCredentials": {
      "Password": {
        "symx-administrative-password": null
      }
    }
  },
  "UserNumber": 1995,
  "PagingRequestContext": {
    "NumberOfRecordsToReturn": 3,
    "NumberOfRecordsToSkip": 0
  },
  "SelectableFields": {
    "IncludeAllActivityFields": false,
    "ActivityFields": {
      "UserNumber": true,
      "Date": true,
      "Time": true,
      "Branch": true,
      "Console": true,
      "Session": true,
      "HelpCode": true
    }
  },
  "nxAttributes": {
    "customFields": {
      "appId": "{application-id}"
    }
  }
}

200

Successful operation.

{
  "Activity": [],
  "Token": null,
  "MessageId": "getActivityPagedListSelectFields"
}

searchActivityPagedSelectFields

post

Searches activities with pagination and selected fields.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

UserNumberintegerRequired

The user number for the activity.

Responses

200

Successful operation.

application/json

TokenstringOptional

The tokenized value for the activity.

post/searchActivityPagedSelectFields

HTTPcURLJavaScriptPython

POST /nexum/627/persistent/user/searchActivityPagedSelectFields HTTP/1.1
Host: naas.ymcu.libum.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 335

{
  "Credentials": {
    "AdministrativeCredentials": {
      "Password": {
        "symx-administrative-password": null
      }
    }
  },
  "UserNumber": 1995,
  "SearchFilter": {
    "Query": ""
  },
  "PagingRequestContext": {
    "NumberOfRecordsToReturn": 1,
    "NumberOfRecordsToSkip": 0
  },
  "SelectableFields": {
    "IncludeAllActivityFields": true
  },
  "nxAttributes": {
    "customFields": {
      "appId": "{application-id}"
    }
  }
}

200

Successful operation.

{
  "Activity": [],
  "Token": null,
  "Version_1": null,
  "_value_1": null,
  "MessageId": "searchActivityPagedSelectFields"
}

getUserTrackingSelectFields

post

Retrieves information about user tracking with selected fields.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

UserNumberintegerRequired

The user number for the activity.

UserTrackingLocatorintegerRequired

The locator for user tracking.

Responses

200

Successful operation.

application/json

post/getUserTrackingSelectFields

HTTPcURLJavaScriptPython

POST /nexum/627/persistent/user/getUserTrackingSelectFields HTTP/1.1
Host: naas.ymcu.libum.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 349

{
  "Credentials": {
    "AdministrativeCredentials": {
      "Password": {
        "symx-administrative-password": null
      }
    }
  },
  "UserNumber": 1234,
  "UserTrackingLocator": 1,
  "SelectableFields": {
    "IncludeAllUserTrackingFields": false,
    "UserTrackingFields": {
      "Locator": true,
      "TrackingCode": true,
      "UserChar1": true,
      "UserCode1": true
    }
  },
  "nxAttributes": {
    "customFields": {
      "appId": "{application-id}"
    }
  }
}

200

Successful operation.

{
  "UserTracking": {
    "Locator": 1,
    "TrackingCode": 1,
    "UserChar1": "NAAS WAVE1 UPDATED",
    "UserCode1": 2,
    "Version_1": null,
    "_value_1": null
  },
  "Version_1": null,
  "_value_1": null,
  "MessageId": "getUserTrackingSelectFields"
}

getUserTrackingPagedListSelectFields

post

Retrieves a paged list of selected fields for user tracking.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

UserNumberintegerRequired

The user number for the activity.

Responses

200

Successful operation.

application/json

TokenstringOptional

The tokenized value for the activity.

post/getUserTrackingPagedListSelectFields

HTTPcURLJavaScriptPython

POST /nexum/627/persistent/user/getUserTrackingPagedListSelectFields HTTP/1.1
Host: naas.ymcu.libum.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 440

{
  "Credentials": {
    "AdministrativeCredentials": {
      "Password": {
        "symx-administrative-password": null
      }
    }
  },
  "UserNumber": 1995,
  "PagingRequestContext": {
    "NumberOfRecordsToReturn": 3,
    "NumberOfRecordsToSkip": 0
  },
  "SelectableFields": {
    "IncludeAllUserTrackingFields": false,
    "UserTrackingFields": {
      "Locator": true,
      "Type": true,
      "UserId": true,
      "CreationDate": true,
      "CreationTime": true,
      "RecordChangeDate": true
    }
  },
  "nxAttributes": {
    "customFields": {
      "appId": "{application-id}"
    }
  }
}

200

Successful operation.

{
  "UserTracking": [],
  "Token": null,
  "MessageId": "getUserTrackingPagedListSelectFields"
}

searchUserTrackingPagedSelectFields

post

Searches user tracking with pagination and selected fields.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

UserNumberintegerRequired

The user number for the activity.

Responses

200

Successful operation.

application/json

TokenstringOptional

The tokenized value for the activity.

post/searchUserTrackingPagedSelectFields

HTTPcURLJavaScriptPython

POST /nexum/627/persistent/user/searchUserTrackingPagedSelectFields HTTP/1.1
Host: naas.ymcu.libum.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 339

{
  "Credentials": {
    "AdministrativeCredentials": {
      "Password": {
        "symx-administrative-password": null
      }
    }
  },
  "UserNumber": 1995,
  "SearchFilter": {
    "Query": ""
  },
  "PagingRequestContext": {
    "NumberOfRecordsToReturn": 1,
    "NumberOfRecordsToSkip": 0
  },
  "SelectableFields": {
    "IncludeAllUserTrackingFields": true
  },
  "nxAttributes": {
    "customFields": {
      "appId": "{application-id}"
    }
  }
}

200

Successful operation.

{
  "UserTracking": [],
  "Token": null,
  "Version_1": null,
  "_value_1": null,
  "MessageId": "searchUserTrackingPagedSelectFields"
}

updateUserByID

post

Updates user information based on ID.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

UserNumberintegerRequired

The user number for the activity.

Responses

200

Successful operation.

application/json

post/updateUserByID

HTTPcURLJavaScriptPython

POST /nexum/627/persistent/user/updateUserByID HTTP/1.1
Host: naas.ymcu.libum.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 213

{
  "Credentials": {
    "AdministrativeCredentials": {
      "Password": {
        "symx-administrative-password": null
      }
    }
  },
  "UserNumber": 1234,
  "UserFields": {
    "Location": "NAAS TEST"
  },
  "nxAttributes": {
    "customFields": {
      "appId": "{application-id}"
    }
  }
}

200

Successful operation.

{
  "UpdateStatus": {
    "isAllFieldsUpdateSuccess": true,
    "FailedUpdateStatus": null,
    "Version_1": null,
    "_value_1": null
  },
  "MessageId": "updateUserByID"
}

updateUserTrackingByID

post

Updates user tracking information based on ID.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

UserNumberintegerRequired

The user number for the activity.

UserTrackingLocatorintegerRequired

The locator for user tracking.

Responses

200

Successful operation.

application/json

post/updateUserTrackingByID

HTTPcURLJavaScriptPython

POST /nexum/627/persistent/user/updateUserTrackingByID HTTP/1.1
Host: naas.ymcu.libum.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 269

{
  "Credentials": {
    "AdministrativeCredentials": {
      "Password": {
        "symx-administrative-password": null
      }
    }
  },
  "UserNumber": 1234,
  "UserTrackingLocator": 1,
  "UserTrackingFields": {
    "UserChar1": "NAAS WAVE1 PERSIST",
    "UserCode1": 3
  },
  "nxAttributes": {
    "customFields": {
      "appId": "{application-id}"
    }
  }
}

200

Successful operation.

{
  "UpdateStatus": {
    "isAllFieldsUpdateSuccess": true,
    "FailedUpdateStatus": null,
    "Version_1": null,
    "_value_1": null
  },
  "MessageId": "updateUserTrackingByID"
}

createUserTracking

post

Creates a new record for user tracking.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

UserNumberintegerRequired

The user number for the activity.

Responses

200

Successful operation.

application/json

UserTrackingLocatorintegerOptional

The locator for user tracking.

post/createUserTracking

HTTPcURLJavaScriptPython

POST /nexum/627/persistent/user/createUserTracking HTTP/1.1
Host: naas.ymcu.libum.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 257

{
  "Credentials": {
    "AdministrativeCredentials": {
      "Password": {
        "symx-administrative-password": null
      }
    }
  },
  "UserNumber": 1234,
  "UserTrackingFields": {
    "TrackingCode": 1,
    "UserChar1": "NAAS WAVE1 P2",
    "UserCode1": 4
  },
  "nxAttributes": {
    "customFields": {
      "appId": "{application-id}"
    }
  }
}

200

Successful operation.

{
  "UserTrackingLocator": 2,
  "MessageId": "createUserTracking"
}

deleteUserTracking

post

Deletes a record for user tracking.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

UserNumberintegerRequired

The user number for the activity.

UserTrackingLocatorintegerRequired

The locator for user tracking.

Responses

200

Successful operation.

application/json

nxAttributesobjectOptional

The custom object for NexumAPI response attributes.

post/deleteUserTracking

HTTPcURLJavaScriptPython

POST /nexum/627/persistent/user/deleteUserTracking HTTP/1.1
Host: naas.ymcu.libum.io
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 199

{
  "Credentials": {
    "AdministrativeCredentials": {
      "Password": {
        "symx-administrative-password": null
      }
    }
  },
  "UserNumber": 1234,
  "UserTrackingLocator": 2,
  "nxAttributes": {
    "customFields": {
      "appId": "{application-id}"
    }
  }
}

200

Successful operation.

{
  "MessageId": "deleteUserTracking"
}