Log In and Authenticate a User
post
/api/core/Login/executeLogin
Logs in the user with the specified user name and password.
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
Password: string
The password.Example:
password
-
Username: string
The user name.Example:
admin
Response
Supported Media Types
- application/json
200 Response
Successful operation
Root Schema : schema
Match All
Show Source
-
object
SuccessfulAddOperation
The response body for a successful add operation.
-
object
type
Nested Schema : SuccessfulAddOperation
Type:
object
The response body for a successful add operation.
Show Source
-
message: string
The response message.Example:
Added record
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
true
Nested Schema : SessionInfoRead
Type:
Show Source
object
-
EmailAddress: string
The email address.Example:
example@example.com
-
FullName: string
The full name of the user.Example:
Example Name
-
Locale: string
The user's regional and language preferences.Example:
en_US
-
PasswordExpiration: integer
The time when the password will expire, in seconds from epoch time.Example:
2147483647
-
PermissionIDs: object
PermissionIDs
A JSON object with IDs of all the permissions that the user has.
-
Permissions: object
Permissions
A JSON object with subobjects for the operations, such as create, update, delete, that are available to the user for each endpoint.
-
Preferences: object
Preferences
An object showing the user preferences.
-
Properties: object
Properties
A JSON object with restrictive property IDs.
-
SamlUser: boolean
Whether the user is a SAML user (1) or not (0).Example:
false
-
SupportPassword: string
The support password.Example:
example password
-
SupportUsername: string
The support username.Example:
example username
-
ThemeDir: string
The theme selected by the user.Example:
light
-
TZ: string
The user's time zone, represented in an abbreviated format depicting offset from UTC.Example:
CST6CDT
-
UserGroupID: integer
The user group ID.Example:
1
-
UserID: integer
The user ID.Example:
1001
-
Username: string
The username.Example:
admin
Nested Schema : PermissionIDs
Type:
object
A JSON object with IDs of all the permissions that the user has.
Example:
{
"AAAAuthTypes":"10021",
"brokerServices":"11008"
}
Nested Schema : Permissions
Type:
object
A JSON object with subobjects for the operations, such as create, update, delete, that are available to the user for each endpoint.
Example:
{
"AAA":{
"AuthTypes":{
"read":true,
"create":false
},
"Permissions":{
"read":true,
"create":false
}
}
}
Nested Schema : Preferences
Type:
object
An object showing the user preferences.
Example:
{
"PageSize":"1000",
"RefreshRate":"60"
}
Nested Schema : Properties
Type:
object
A JSON object with restrictive property IDs.
Example:
{
"RestrictiveDeviceGroupId":"1"
}
Default Response
Failed operation
Root Schema : schema
Type:
Show Source
object
-
errors: array
errors
The list of errors reported. Validation errors will be keyed by record field.
-
message: string
The response message.Example:
Exception thrown
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
false
Nested Schema : errors
Type:
array
The list of errors reported. Validation errors will be keyed by record field.
Show Source
-
Array of:
object items
An error.
Nested Schema : items
Type:
object
An error.