Jump to

• Request
• Response

Add New User Group

post

/api/1.0/usergroup

This endpoint is used to add a new User Group.

Request

Supported Media Types

• application/json
• application/xml

Header Parameters

• appId: string
  The application ID of host service.
• branchCode: string
  The branch code of requesting branch.
• contentType(optional): string
  The content type of request or response body.
• userId: string
  The user ID of requesting user.

Body ()

Request Body contain data required for creating a new User Group.

Root Schema : DmTmUserGroupDTO

Type: object

Match All

Show Source

• allOf GenericDto
• object DmTmUserGroupDTO-allOf[1]

{
    "type":"object",
    "allOf":[
        {
            "$ref":"#/definitions/GenericDto"
        },
        {
            "type":"object",
            "properties":{
                "userGroupCd":{
                    "description":"User Group code",
                    "type":"string"
                },
                "userGroupDescr":{
                    "description":"User Group description",
                    "type":"string"
                },
                "hirachyOrder":{
                    "description":"Hierarchy order",
                    "type":"integer"
                },
                "supervisoryGroupCd":{
                    "description":"Supervisory Group code",
                    "type":"string"
                },
                "defaultAssigneeFlg":{
                    "description":"Default Assignee Flag",
                    "type":"boolean"
                },
                "DmTmUserGroupMembersDTO":{
                    "type":"array",
                    "items":{
                        "$ref":"#/definitions/DmTmUserGroupMembersDTO"
                    }
                }
            }
        }
    ]
}

Nested Schema : GenericDto

Match All

Show Source

• object GenericDto-allOf[0]
  Discriminator: resource_type

{
    "allOf":[
        {
            "type":"object",
            "discriminator":"resource_type"
        }
    ]
}

Nested Schema : GenericDto-allOf[0]

Type: object

Discriminator: resource_type

Nested Schema : DmTmUserGroupDTO-allOf[1]

Type: object

Show Source

• defaultAssigneeFlg(optional): boolean
  Default Assignee Flag
• DmTmUserGroupMembersDTO(optional): array DmTmUserGroupMembersDTO
• hirachyOrder(optional): integer
  Hierarchy order
• supervisoryGroupCd(optional): string
  Supervisory Group code
• userGroupCd(optional): string
  User Group code
• userGroupDescr(optional): string
  User Group description

{
    "type":"object",
    "properties":{
        "userGroupCd":{
            "description":"User Group code",
            "type":"string"
        },
        "userGroupDescr":{
            "description":"User Group description",
            "type":"string"
        },
        "hirachyOrder":{
            "description":"Hierarchy order",
            "type":"integer"
        },
        "supervisoryGroupCd":{
            "description":"Supervisory Group code",
            "type":"string"
        },
        "defaultAssigneeFlg":{
            "description":"Default Assignee Flag",
            "type":"boolean"
        },
        "DmTmUserGroupMembersDTO":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/DmTmUserGroupMembersDTO"
            }
        }
    }
}

Nested Schema : DmTmUserGroupMembersDTO

Type: array

Show Source

• Array of: object DmTmUserGroupMembersDTO
  User group Members Details.

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/DmTmUserGroupMembersDTO"
    }
}

Nested Schema : DmTmUserGroupMembersDTO

Type: object

User group Members Details.

Show Source

• activeFlg(optional): boolean
  Active Flag
• id(optional): string
  ID
• userGroupMasterId(optional): string
  User group Master ID
• userId(optional): string
  User ID
• userName(optional): string
  User Name

{
    "description":"User group Members Details.",
    "type":"object",
    "properties":{
        "userId":{
            "description":"User ID",
            "type":"string"
        },
        "userName":{
            "description":"User Name",
            "type":"string"
        },
        "activeFlg":{
            "description":"Active Flag",
            "type":"boolean"
        },
        "id":{
            "type":"string",
            "description":"ID"
        },
        "userGroupMasterId":{
            "type":"string",
            "description":"User group Master ID"
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json
• application/xml

201 Response

New User group added successfully.

Headers

• Location: string
  URL of newly created User Group.

Body ()

Root Schema : ResponseDtoWrapper

Type: object

Show Source

• data(optional): object ResponseResourceSupport
• messages(optional): object ResponseDto

{
    "type":"object",
    "properties":{
        "messages":{
            "$ref":"#/definitions/ResponseDto"
        },
        "data":{
            "$ref":"#/definitions/ResponseResourceSupport"
        }
    }
}

Nested Schema : ResponseResourceSupport

Type: object

Nested Schema : ResponseDto

Type: object

Show Source

• codes(optional): array codes
• id(optional): string
• requestId(optional): string
• status(optional): string

{
    "type":"object",
    "properties":{
        "id":{
            "type":"string"
        },
        "status":{
            "type":"string"
        },
        "codes":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/ResponseCode"
            }
        },
        "requestId":{
            "type":"string"
        }
    }
}

Nested Schema : codes

Type: array

Show Source

• Array of: object ResponseCode

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/ResponseCode"
    }
}

Nested Schema : ResponseCode

Type: object

Show Source

• arg(optional): string
• args(optional): array args
• Code(optional): string
• Desc(optional): string
• Language(optional): string
• Type(optional): string

{
    "type":"object",
    "properties":{
        "Code":{
            "type":"string"
        },
        "Desc":{
            "type":"string"
        },
        "Type":{
            "type":"string"
        },
        "Language":{
            "type":"string"
        },
        "args":{
            "type":"array",
            "items":{
                "type":"object"
            }
        },
        "arg":{
            "type":"string"
        }
    }
}

Nested Schema : args

Type: array

Show Source

• Array of: object items

{
    "type":"array",
    "items":{
        "type":"object"
    }
}

Nested Schema : items

Type: object

400 Response

Malformed syntax.

401 Response

Request does not have sufficient credentials.

403 Response

Request is not authorized.

405 Response

Invalid input.

500 Response

Internal error.

Back to Top