Jump to

• Request
• Response

Remove User Groups Assigned to a Project

post

/api/restapi/project/removeUserGroups

Send a request to this endpoint to remove user groups from a project.

Request

Header Parameters

• singleTransaction: boolean
  Enabling this boolean flag fails to complete the request if an error occurred while processing any user group removal sent as part of the request.
  Allowed Values: [ "true", "false" ]

  Default Value: false

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : ApiEntityRemoveProjectUserGroupPermissions

Type: object

Title: ApiEntityRemoveProjectUserGroupPermissions

Show Source

• projectCode: string
  Maximum Length: 60

  The unique identifier for a project set by the user who created the project.
• projectId: integer (int64)
  The unique identifier for the project.
• userGroupIds: array userGroupIds
  List of user group IDs for removing user groups.
• workspaceCode: string
  Maximum Length: 60

  The user-specified identifier of a workspace.
• workspaceId: integer (int64)
  The unique identifier for the workspace.The workspace object can also be identified by its unique criteria.

{
    "title":"ApiEntityRemoveProjectUserGroupPermissions",
    "type":"object",
    "properties":{
        "workspaceId":{
            "type":"integer",
            "description":"The unique identifier for the workspace.The workspace object can also be identified by its unique criteria.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "userGroupIds":{
            "type":"array",
            "description":"List of user group IDs for removing user groups.",
            "exampleSetFlag":false,
            "items":{
                "type":"string",
                "exampleSetFlag":false,
                "types":[
                    "string"
                ]
            },
            "types":[
                "array"
            ]
        },
        "projectId":{
            "type":"integer",
            "description":"The unique identifier for the project.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "projectCode":{
            "maxLength":60,
            "type":"string",
            "description":"The unique identifier for a project set by the user who created the project.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "workspaceCode":{
            "maxLength":60,
            "type":"string",
            "description":"The user-specified identifier of a workspace.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        }
    },
    "exampleSetFlag":false
}

Nested Schema : userGroupIds

Type: array

List of user group IDs for removing user groups.

Show Source

• Array of: string

{
    "type":"array",
    "description":"List of user group IDs for removing user groups.",
    "exampleSetFlag":false,
    "items":{
        "type":"string",
        "exampleSetFlag":false,
        "types":[
            "string"
        ]
    },
    "types":[
        "array"
    ]
}

Back to Top

Response

Supported Media Types

• application/json

207 Response

The object was successfully integrated.

Body ()

Root Schema : List<ApiEntityRemoveProjectUserGroupPermissionsResponse>

Type: array

Title: List<ApiEntityRemoveProjectUserGroupPermissionsResponse>

Show Source

• Array of: object ApiEntityRemoveProjectUserGroupPermissionsResponse
  Title: ApiEntityRemoveProjectUserGroupPermissionsResponse

{
    "title":"List<ApiEntityRemoveProjectUserGroupPermissionsResponse>",
    "type":"array",
    "exampleSetFlag":false,
    "items":{
        "$ref":"#/components/schemas/ApiEntityRemoveProjectUserGroupPermissionsResponse",
        "exampleSetFlag":false
    },
    "types":[
        "array"
    ]
}

Nested Schema : ApiEntityRemoveProjectUserGroupPermissionsResponse

Type: object

Title: ApiEntityRemoveProjectUserGroupPermissionsResponse

Show Source

• message: string
  Error message or reason for operation failure is populated. The field is non-persistable and thus maximum length is not applicable.
• projectId: integer (int64)
  The unique identifier for the project.
• statusCode: integer (int32)
  The response code representing the state of the API operation.
• userGroupId: string
  System-defined identifier of the user group.

{
    "title":"ApiEntityRemoveProjectUserGroupPermissionsResponse",
    "type":"object",
    "properties":{
        "message":{
            "type":"string",
            "description":"Error message or reason for operation failure is populated. The field is non-persistable and thus maximum length is not applicable.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "userGroupId":{
            "type":"string",
            "description":"System-defined identifier of the user group.",
            "exampleSetFlag":false,
            "types":[
                "string"
            ]
        },
        "statusCode":{
            "type":"integer",
            "description":"The response code representing the state of the API operation.",
            "format":"int32",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        },
        "projectId":{
            "type":"integer",
            "description":"The unique identifier for the project.",
            "format":"int64",
            "exampleSetFlag":false,
            "types":[
                "integer"
            ]
        }
    },
    "exampleSetFlag":false
}

400 Response

Invalid input for the Project service.

Back to Top