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"