mago3D GraphQL API Userset Reference
This is a sample server for a mago3D GraphQL API Dataset Reference. You can find out more about mago3D at https://www.mago3d.com.
Experience the Future with mago3D.
Terms of Service
API Endpoints
https://map.gaia3d.com/app/api/userset/graphql
Headers
# Your foo from bar
Authorization: Bearer <YOUR_TOKEN_HERE>
Introduction
This is a sample server for a mago3D GraphQL API Userset Reference. You can find out more about mago3D at https://www.mago3d.com.
Queries
existsUser
Response
Returns an
ExistsUserResponse!
Arguments
Name | Description |
---|---|
input -
ExistsUserInput!
|
Example
Query
query existsUser($input: ExistsUserInput!) {
existsUser(input: $input)
}
Variables
{"input": ExistsUserInput}
Response
{"data": {"existsUser": ExistsUserResult}}
profile
Response
Returns a
User!
Example
Query
query profile {
profile {
id
username
firstName
lastName
roles {
id
name
description
attributes
composite
composites {
...UserRoleFragment
}
}
groups {
id
name
path
attributes
users {
...UserFragment
}
children {
...UserGroupFragment
}
}
email
cellphones
telephones
emailVerified
enabled
properties
createdBy
createdAt
}
}
Response
{
"data": {
"profile": {
"id": 4,
"username": "xyz789",
"firstName": "xyz789",
"lastName": "abc123",
"roles": [UserRole],
"groups": [UserGroup],
"email": "abc123",
"cellphones": ["xyz789"],
"telephones": ["abc123"],
"emailVerified": false,
"enabled": false,
"properties": {},
"createdBy": 4,
"createdAt": "xyz789"
}
}
}
user
Example
Query
query user($id: ID!) {
user(id: $id) {
id
username
firstName
lastName
roles {
id
name
description
attributes
composite
composites {
...UserRoleFragment
}
}
groups {
id
name
path
attributes
users {
...UserFragment
}
children {
...UserGroupFragment
}
}
email
cellphones
telephones
emailVerified
enabled
properties
createdBy
createdAt
}
}
Variables
{"id": 4}
Response
{
"data": {
"user": {
"id": "4",
"username": "abc123",
"firstName": "abc123",
"lastName": "xyz789",
"roles": [UserRole],
"groups": [UserGroup],
"email": "xyz789",
"cellphones": ["abc123"],
"telephones": ["xyz789"],
"emailVerified": true,
"enabled": false,
"properties": {},
"createdBy": "4",
"createdAt": "abc123"
}
}
}
userGroup
Response
Returns a
UserGroup!
Arguments
Name | Description |
---|---|
id -
ID!
|
|
filter -
UserGroupFilter
|
Example
Query
query userGroup(
$id: ID!,
$filter: UserGroupFilter
) {
userGroup(
id: $id,
filter: $filter
) {
id
name
path
attributes
users {
id
username
firstName
lastName
roles {
...UserRoleFragment
}
groups {
...UserGroupFragment
}
email
cellphones
telephones
emailVerified
enabled
properties
createdBy
createdAt
}
children {
id
name
path
attributes
users {
...UserFragment
}
children {
...UserGroupFragment
}
}
}
}
Variables
{"id": 4, "filter": UserGroupFilter}
Response
{
"data": {
"userGroup": {
"id": 4,
"name": "abc123",
"path": "abc123",
"attributes": {},
"users": [User],
"children": [UserGroup]
}
}
}
userGroups
Response
Returns a
UserGroupPaged!
Arguments
Name | Description |
---|---|
filter -
UserGroupFilter
|
|
pageable -
UserGroupPageable
|
Example
Query
query userGroups(
$filter: UserGroupFilter,
$pageable: UserGroupPageable
) {
userGroups(
filter: $filter,
pageable: $pageable
) {
items {
id
name
path
attributes
users {
...UserFragment
}
children {
...UserGroupFragment
}
}
pageInfo {
totalPages
totalItems
page
size
hasNextPage
hasPreviousPage
}
}
}
Variables
{
"filter": UserGroupFilter,
"pageable": UserGroupPageable
}
Response
{
"data": {
"userGroups": {
"items": [UserGroup],
"pageInfo": PaginationInfo
}
}
}
userRole
Example
Query
query userRole($id: ID!) {
userRole(id: $id) {
id
name
description
attributes
composite
composites {
id
name
description
attributes
composite
composites {
...UserRoleFragment
}
}
}
}
Variables
{"id": 4}
Response
{
"data": {
"userRole": {
"id": "4",
"name": "abc123",
"description": "xyz789",
"attributes": {},
"composite": false,
"composites": [UserRole]
}
}
}
userRoles
Response
Returns a
UserRolePaged!
Arguments
Name | Description |
---|---|
filter -
UserRoleFilter
|
|
pageable -
UserRolePageable
|
Example
Query
query userRoles(
$filter: UserRoleFilter,
$pageable: UserRolePageable
) {
userRoles(
filter: $filter,
pageable: $pageable
) {
items {
id
name
description
attributes
composite
composites {
...UserRoleFragment
}
}
pageInfo {
totalPages
totalItems
page
size
hasNextPage
hasPreviousPage
}
}
}
Variables
{
"filter": UserRoleFilter,
"pageable": UserRolePageable
}
Response
{
"data": {
"userRoles": {
"items": [UserRole],
"pageInfo": PaginationInfo
}
}
}
users
Response
Returns a
UserPaged!
Arguments
Name | Description |
---|---|
filter -
UserFilter
|
|
pageable -
UserPageable
|
Example
Query
query users(
$filter: UserFilter,
$pageable: UserPageable
) {
users(
filter: $filter,
pageable: $pageable
) {
items {
id
username
firstName
lastName
roles {
...UserRoleFragment
}
groups {
...UserGroupFragment
}
email
cellphones
telephones
emailVerified
enabled
properties
createdBy
createdAt
}
pageInfo {
totalPages
totalItems
page
size
hasNextPage
hasPreviousPage
}
}
}
Variables
{
"filter": UserFilter,
"pageable": UserPageable
}
Response
{
"data": {
"users": {
"items": [User],
"pageInfo": PaginationInfo
}
}
}
Mutations
associateUserRole
Example
Query
mutation associateUserRole(
$id: ID!,
$append: [ID!],
$remove: [ID!]
) {
associateUserRole(
id: $id,
append: $append,
remove: $remove
)
}
Variables
{"id": 4, "append": [4], "remove": [4]}
Response
{"data": {"associateUserRole": false}}
createUser
Response
Returns a
CreateUserResponse!
Arguments
Name | Description |
---|---|
input -
CreateUserInput!
|
Example
Query
mutation createUser($input: CreateUserInput!) {
createUser(input: $input) {
id
username
firstName
lastName
email
groups
roles
enabled
properties
}
}
Variables
{"input": CreateUserInput}
Response
{
"data": {
"createUser": {
"id": 4,
"username": "abc123",
"firstName": "xyz789",
"lastName": "xyz789",
"email": "xyz789",
"groups": [4],
"roles": ["4"],
"enabled": true,
"properties": {}
}
}
}
createUserGroup
Response
Returns a
CreateUserGroupResponse!
Arguments
Name | Description |
---|---|
input -
CreateUserGroupInput!
|
Example
Query
mutation createUserGroup($input: CreateUserGroupInput!) {
createUserGroup(input: $input) {
id
name
path
attributes
}
}
Variables
{"input": CreateUserGroupInput}
Response
{
"data": {
"createUserGroup": {
"id": "4",
"name": "xyz789",
"path": "xyz789",
"attributes": {}
}
}
}
createUserRole
Response
Returns a
CreateUserRoleResponse!
Arguments
Name | Description |
---|---|
input -
CreateUserRoleInput!
|
Example
Query
mutation createUserRole($input: CreateUserRoleInput!) {
createUserRole(input: $input) {
id
name
description
attributes
}
}
Variables
{"input": CreateUserRoleInput}
Response
{
"data": {
"createUserRole": {
"id": "4",
"name": 4,
"description": "abc123",
"attributes": {}
}
}
}
deleteUser
deleteUserGroup
deleteUserRole
joinUser
Response
Returns a
JoinUserResponse!
Arguments
Name | Description |
---|---|
input -
JoinUserInput!
|
Example
Query
mutation joinUser($input: JoinUserInput!) {
joinUser(input: $input)
}
Variables
{"input": JoinUserInput}
Response
{"data": {"joinUser": User}}
resetUserPassword
Response
Returns a
ResetUserPasswordResponse!
Arguments
Name | Description |
---|---|
input -
ResetUserPasswordInput!
|
Example
Query
mutation resetUserPassword($input: ResetUserPasswordInput!) {
resetUserPassword(input: $input)
}
Variables
{"input": ResetUserPasswordInput}
Response
{"data": {"resetUserPassword": User}}
updateUser
Response
Returns an
UpdateUserResponse!
Arguments
Name | Description |
---|---|
id -
ID!
|
|
input -
UpdateUserInput!
|
Example
Query
mutation updateUser(
$id: ID!,
$input: UpdateUserInput!
) {
updateUser(
id: $id,
input: $input
) {
id
username
firstName
lastName
email
groups
roles
properties
}
}
Variables
{
"id": "4",
"input": UpdateUserInput
}
Response
{
"data": {
"updateUser": {
"id": "4",
"username": "xyz789",
"firstName": "xyz789",
"lastName": "abc123",
"email": "abc123",
"groups": [4],
"roles": [4],
"properties": {}
}
}
}
updateUserGroup
Response
Returns an
UpdateUserGroupResponse!
Arguments
Name | Description |
---|---|
id -
ID!
|
|
input -
UpdateUserGroupInput!
|
Example
Query
mutation updateUserGroup(
$id: ID!,
$input: UpdateUserGroupInput!
) {
updateUserGroup(
id: $id,
input: $input
) {
id
name
path
attributes
}
}
Variables
{
"id": "4",
"input": UpdateUserGroupInput
}
Response
{
"data": {
"updateUserGroup": {
"id": 4,
"name": "xyz789",
"path": "abc123",
"attributes": {}
}
}
}
updateUserPassword
Response
Returns a
Boolean!
Example
Query
mutation updateUserPassword(
$id: ID!,
$oldPassword: String!,
$newPassword: String!
) {
updateUserPassword(
id: $id,
oldPassword: $oldPassword,
newPassword: $newPassword
)
}
Variables
{
"id": "4",
"oldPassword": "abc123",
"newPassword": "xyz789"
}
Response
{"data": {"updateUserPassword": false}}
updateUserRole
Response
Returns an
UpdateUserRoleResponse!
Arguments
Name | Description |
---|---|
id -
ID!
|
|
input -
UpdateUserRoleInput!
|
Example
Query
mutation updateUserRole(
$id: ID!,
$input: UpdateUserRoleInput!
) {
updateUserRole(
id: $id,
input: $input
) {
id
name
description
attributes
}
}
Variables
{"id": 4, "input": UpdateUserRoleInput}
Response
{
"data": {
"updateUserRole": {
"id": 4,
"name": 4,
"description": "xyz789",
"attributes": {}
}
}
}
Types
Boolean
Description
The Boolean
scalar type represents true
or false
.
BooleanCriteria
Example
{
"lt": false,
"le": false,
"eq": true,
"ne": false,
"ge": true,
"gt": false,
"isNull": true,
"in": [true],
"notIn": [true],
"between": [false],
"notBetween": [false],
"min": BooleanCriteria,
"max": BooleanCriteria
}
CommonCriteria
Example
{
"lt": "4",
"le": 4,
"eq": "4",
"ne": "4",
"ge": 4,
"gt": "4",
"isNull": false,
"in": ["4"],
"notIn": ["4"],
"between": [4],
"notBetween": ["4"],
"min": CommonCriteria,
"max": CommonCriteria
}
CreateUserGroupInput
CreateUserGroupResponse
CreateUserInput
Example
{
"username": 4,
"firstName": "xyz789",
"lastName": "xyz789",
"email": "abc123",
"password": "xyz789",
"enabled": false,
"cellphones": ["xyz789"],
"telephones": ["abc123"],
"groups": [4],
"roles": [4],
"properties": {}
}
CreateUserResponse
Example
{
"id": 4,
"username": "abc123",
"firstName": "abc123",
"lastName": "abc123",
"email": "abc123",
"groups": [4],
"roles": ["4"],
"enabled": true,
"properties": {}
}
CreateUserRoleInput
CreateUserRoleResponse
DefaultError
Error
Possible Types
Error Types |
---|
Example
{
"message": "xyz789",
"errors": [Error]
}
ExistsUserInput
ExistsUserResponse
Types
Union Types |
---|
Example
ExistsUserResult
ExistsUserResult
ID
Description
The ID
scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4"
) or integer (such as 4
) input value will be accepted as an ID.
Example
"4"
Int
Description
The Int
scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
Example
123
JSON
Example
{}
JoinUserInput
Example
{
"username": "xyz789",
"firstName": "xyz789",
"lastName": "xyz789",
"password": "abc123",
"cellphones": ["xyz789"],
"telephones": ["xyz789"],
"email": "xyz789",
"groups": [4],
"properties": {}
}
JoinUserResponse
Types
Union Types |
---|
Example
User
JsonPropertyInput
Fields
Input Field | Description |
---|---|
patch -
[JsonPropertyPatchInput]
|
|
merge -
JSON
|
Example
{"patch": [JsonPropertyPatchInput], "merge": {}}
JsonPropertyPatchInput
Fields
Input Field | Description |
---|---|
op -
JsonPropertyPatchOperation!
|
|
path -
String!
|
|
from -
String
|
|
value -
JSON
|
Example
{
"op": "add",
"path": "abc123",
"from": "abc123",
"value": {}
}
JsonPropertyPatchOperation
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
|
|
|
|
Example
"add"
PaginationInfo
ResetUserPasswordError
ResetUserPasswordInput
ResetUserPasswordResponse
Types
Union Types |
---|
Example
User
SimpleCriteria
String
Description
The String
scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.
Example
"xyz789"
StringCriteria
Fields
Input Field | Description |
---|---|
lt -
String
|
|
le -
String
|
|
eq -
String
|
|
ne -
String
|
|
ge -
String
|
|
gt -
String
|
|
isNull -
Boolean
|
|
in -
[String]
|
|
notIn -
[String]
|
|
between -
[String]
|
|
notBetween -
[String]
|
|
min -
StringCriteria
|
|
max -
StringCriteria
|
|
eqIgnoreCase -
String
|
|
contains -
String
|
|
containsIgnoreCase -
String
|
|
startsWith -
String
|
|
startsWithIgnoreCase -
String
|
|
endsWith -
String
|
|
endsWithIgnoreCase -
String
|
|
isEmpty -
Boolean
|
|
matches -
String
|
Example
{
"lt": "abc123",
"le": "xyz789",
"eq": "xyz789",
"ne": "xyz789",
"ge": "abc123",
"gt": "xyz789",
"isNull": true,
"in": ["abc123"],
"notIn": ["abc123"],
"between": ["abc123"],
"notBetween": ["abc123"],
"min": StringCriteria,
"max": StringCriteria,
"eqIgnoreCase": "xyz789",
"contains": "abc123",
"containsIgnoreCase": "xyz789",
"startsWith": "xyz789",
"startsWithIgnoreCase": "xyz789",
"endsWith": "xyz789",
"endsWithIgnoreCase": "abc123",
"isEmpty": false,
"matches": "abc123"
}
UpdateUserGroupInput
UpdateUserGroupResponse
UpdateUserInput
Example
{
"username": "xyz789",
"firstName": "xyz789",
"lastName": "xyz789",
"email": "abc123",
"cellphones": ["abc123"],
"telephones": ["abc123"],
"groupId": [4],
"roles": [4],
"enabled": true,
"properties": JsonPropertyInput
}
UpdateUserResponse
Example
{
"id": "4",
"username": "abc123",
"firstName": "abc123",
"lastName": "abc123",
"email": "xyz789",
"groups": [4],
"roles": ["4"],
"properties": {}
}
UpdateUserRoleInput
UpdateUserRoleResponse
User
Example
{
"id": "4",
"username": "xyz789",
"firstName": "abc123",
"lastName": "abc123",
"roles": [UserRole],
"groups": [UserGroup],
"email": "abc123",
"cellphones": ["xyz789"],
"telephones": ["xyz789"],
"emailVerified": true,
"enabled": true,
"properties": {},
"createdBy": 4,
"createdAt": "abc123"
}
UserFilter
Fields
Input Field | Description |
---|---|
id -
SimpleCriteria
|
|
name -
StringCriteria
|
|
username -
StringCriteria
|
|
email -
StringCriteria
|
|
firstName -
StringCriteria
|
|
lastName -
StringCriteria
|
|
enabled -
BooleanCriteria
|
|
division -
StringCriteria
|
|
unit -
StringCriteria
|
|
and -
[UserFilter!]
|
|
or -
[UserFilter!]
|
|
not -
UserFilter
|
Example
{
"id": SimpleCriteria,
"name": StringCriteria,
"username": StringCriteria,
"email": StringCriteria,
"firstName": StringCriteria,
"lastName": StringCriteria,
"enabled": BooleanCriteria,
"division": StringCriteria,
"unit": StringCriteria,
"and": [UserFilter],
"or": [UserFilter],
"not": UserFilter
}
UserGroup
UserGroupChildQueryResponse
Fields
Field Name | Description |
---|---|
id -
ID!
|
|
name -
String!
|
|
path -
String!
|
|
attributes -
JSON
|
|
children -
[UserGroupChildQueryResponse]!
|
Example
{
"id": "4",
"name": "abc123",
"path": "xyz789",
"attributes": {},
"children": [UserGroupChildQueryResponse]
}
UserGroupFilter
Fields
Input Field | Description |
---|---|
id -
SimpleCriteria
|
|
name -
SimpleCriteria
|
|
enabled -
BooleanCriteria
|
|
and -
[UserGroupFilter!]
|
|
or -
[UserGroupFilter!]
|
|
not -
UserGroupFilter
|
Example
{
"id": SimpleCriteria,
"name": SimpleCriteria,
"enabled": BooleanCriteria,
"and": [UserGroupFilter],
"or": [UserGroupFilter],
"not": UserGroupFilter
}
UserGroupPageable
Fields
Input Field | Description |
---|---|
page -
Int!
|
|
size -
Int!
|
|
sort -
[UserGroupSort!]
|
Example
{"page": 123, "size": 987, "sort": ["NameAsc"]}
UserGroupPaged
Fields
Field Name | Description |
---|---|
items -
[UserGroup!]!
|
|
pageInfo -
PaginationInfo!
|
Example
{
"items": [UserGroup],
"pageInfo": PaginationInfo
}
UserGroupParentQueryResponse
Fields
Field Name | Description |
---|---|
id -
ID!
|
|
name -
String!
|
|
path -
String!
|
|
attributes -
JSON
|
|
parent -
UserGroupParentQueryResponse
|
|
ancestors -
[UserGroupParentQueryResponse]!
|
Example
{
"id": 4,
"name": "xyz789",
"path": "xyz789",
"attributes": {},
"parent": UserGroupParentQueryResponse,
"ancestors": [UserGroupParentQueryResponse]
}
UserGroupSort
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
Example
"NameAsc"
UserPageable
Fields
Input Field | Description |
---|---|
page -
Int!
|
|
size -
Int!
|
|
sort -
[UserSort!]
|
Example
{"page": 123, "size": 987, "sort": ["UsernameAsc"]}
UserPaged
Fields
Field Name | Description |
---|---|
items -
[User!]!
|
|
pageInfo -
PaginationInfo!
|
Example
{
"items": [User],
"pageInfo": PaginationInfo
}
UserRole
UserRoleFilter
Fields
Input Field | Description |
---|---|
id -
SimpleCriteria
|
|
name -
SimpleCriteria
|
|
enabled -
BooleanCriteria
|
|
and -
[UserRoleFilter!]
|
|
or -
[UserRoleFilter!]
|
|
not -
UserRoleFilter
|
Example
{
"id": SimpleCriteria,
"name": SimpleCriteria,
"enabled": BooleanCriteria,
"and": [UserRoleFilter],
"or": [UserRoleFilter],
"not": UserRoleFilter
}
UserRolePageable
Fields
Input Field | Description |
---|---|
page -
Int!
|
|
size -
Int!
|
|
sort -
[UserRoleSort!]
|
Example
{"page": 123, "size": 987, "sort": ["NameAsc"]}
UserRolePaged
Fields
Field Name | Description |
---|---|
items -
[UserRole!]!
|
|
pageInfo -
PaginationInfo!
|
Example
{
"items": [UserRole],
"pageInfo": PaginationInfo
}
UserRoleSort
Values
Enum Value | Description |
---|---|
|
|
|
Example
"NameAsc"
UserSort
Values
Enum Value | Description |
---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Example
"UsernameAsc"