{
  "opencollection": "1.0.0",
  "info": {
    "name": "Mend Access Management Administration - Groups API",
    "version": "3.0"
  },
  "request": {
    "auth": {
      "type": "bearer",
      "token": "{{bearerToken}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "Administration - Groups",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get All Organization Groups",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://baseUrl/api/v3.0/orgs/:orgUuid/groups",
            "params": [
              {
                "name": "cursor",
                "value": "",
                "type": "query",
                "description": "Parameter indicates the starting point for retrieving results, the first call doesn't include a cursor parameter in the request, the API response includes the first set of results along with a cursor pointing to the last item retrieved."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Specifies the maximum number of items to be returned in the response."
              },
              {
                "name": "orgUuid",
                "value": "",
                "type": "path",
                "description": "org UUID (from the Mend App: **Administration** General > **Organization UUID**)."
              }
            ]
          },
          "docs": "Returns a list of all groups within an organization"
        },
        {
          "info": {
            "name": "Create Group",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://baseUrl/api/v3.0/orgs/:orgUuid/groups",
            "params": [
              {
                "name": "orgUuid",
                "value": "",
                "type": "path",
                "description": "org UUID (from the Mend App: **Administration** General > **Organization UUID**)."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates a new group for an organization"
        },
        {
          "info": {
            "name": "Get All Organization Groups with Role Definitions",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://baseUrl/api/v3.0/orgs/:orgUuid/groups/roleDefinitions",
            "params": [
              {
                "name": "cursor",
                "value": "",
                "type": "query",
                "description": "Parameter indicates the starting point for retrieving results, the first call doesn't include a cursor parameter in the request, the API response includes the first set of results along with a cursor pointing to the last item retrieved."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Specifies the maximum number of items to be returned in the response."
              },
              {
                "name": "orgUuid",
                "value": "",
                "type": "path",
                "description": "org UUID (from the Mend App: **Administration** General > **Organization UUID**)."
              }
            ]
          },
          "docs": "Returns a list of all groups within an organization with their role definitions"
        },
        {
          "info": {
            "name": "Get Group",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://baseUrl/api/v3.0/orgs/:orgUuid/groups/:groupUuid",
            "params": [
              {
                "name": "orgUuid",
                "value": "",
                "type": "path",
                "description": "org UUID (from the Mend App: **Administration** General > **Organization UUID**)."
              },
              {
                "name": "groupUuid",
                "value": "",
                "type": "path",
                "description": "Group UUID (Administration > Groups)"
              }
            ]
          },
          "docs": "Returns the given group of an organization"
        },
        {
          "info": {
            "name": "Update Group",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://baseUrl/api/v3.0/orgs/:orgUuid/groups/:groupUuid",
            "params": [
              {
                "name": "orgUuid",
                "value": "",
                "type": "path",
                "description": "org UUID (from the Mend App: **Administration** General > **Organization UUID**)."
              },
              {
                "name": "groupUuid",
                "value": "",
                "type": "path",
                "description": "Group UUID (Administration > Groups)"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Updates the properties of a given group"
        },
        {
          "info": {
            "name": "Delete Group",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://baseUrl/api/v3.0/orgs/:orgUuid/groups/:groupUuid",
            "params": [
              {
                "name": "orgUuid",
                "value": "",
                "type": "path",
                "description": "org UUID (from the Mend App: **Administration** General > **Organization UUID**)."
              },
              {
                "name": "groupUuid",
                "value": "",
                "type": "path",
                "description": "Group UUID (Administration > Groups)"
              }
            ]
          },
          "docs": "Deletes the given group"
        },
        {
          "info": {
            "name": "Get Group Roles",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://baseUrl/api/v3.0/orgs/:orgUuid/groups/:groupUuid/roles",
            "params": [
              {
                "name": "cursor",
                "value": "",
                "type": "query",
                "description": "Parameter indicates the starting point for retrieving results, the first call doesn't include a cursor parameter in the request, the API response includes the first set of results along with a cursor pointing to the last item retrieved."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Specifies the maximum number of items to be returned in the response."
              },
              {
                "name": "orgUuid",
                "value": "",
                "type": "path",
                "description": "org UUID (from the Mend App: **Administration** General > **Organization UUID**)."
              },
              {
                "name": "groupUuid",
                "value": "",
                "type": "path",
                "description": "The group UUID"
              }
            ]
          },
          "docs": "Returns the list of roles associated with a given group"
        },
        {
          "info": {
            "name": "Add Group Roles",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://baseUrl/api/v3.0/orgs/:orgUuid/groups/:groupUuid/roles",
            "params": [
              {
                "name": "orgUuid",
                "value": "",
                "type": "path",
                "description": "org UUID (from the Mend App: **Administration** General > **Organization UUID**)."
              },
              {
                "name": "groupUuid",
                "value": "",
                "type": "path",
                "description": "Group UUID (Administration > Groups)"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates a new group role for an organization"
        },
        {
          "info": {
            "name": "Remove Group Roles",
            "type": "http"
          },
          "http": {
            "method": "PUT",
            "url": "https://baseUrl/api/v3.0/orgs/:orgUuid/groups/:groupUuid/roles",
            "params": [
              {
                "name": "orgUuid",
                "value": "",
                "type": "path",
                "description": "org UUID (from the Mend App: **Administration** General > **Organization UUID**)."
              },
              {
                "name": "groupUuid",
                "value": "",
                "type": "path",
                "description": "Group UUID (Administration > Groups)"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Deletes a role from a group"
        },
        {
          "info": {
            "name": "Get Group Users",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://baseUrl/api/v3.0/orgs/:orgUuid/groups/:groupUuid/users",
            "params": [
              {
                "name": "cursor",
                "value": "",
                "type": "query",
                "description": "Parameter indicates the starting point for retrieving results, the first call doesn't include a cursor parameter in the request, the API response includes the first set of results along with a cursor pointing to the last item retrieved."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Specifies the maximum number of items to be returned in the response."
              },
              {
                "name": "orgUuid",
                "value": "",
                "type": "path",
                "description": "org UUID (from the Mend App: **Administration** General > **Organization UUID**)."
              },
              {
                "name": "groupUuid",
                "value": "",
                "type": "path",
                "description": "The group UUID"
              }
            ]
          },
          "docs": "Returns a list of users that belong to given group"
        },
        {
          "info": {
            "name": "Add User to Group",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://baseUrl/api/v3.0/orgs/:orgUuid/groups/:groupUuid/users",
            "params": [
              {
                "name": "orgUuid",
                "value": "",
                "type": "path",
                "description": "org UUID (from the Mend App: **Administration** General > **Organization UUID**)."
              },
              {
                "name": "groupUuid",
                "value": "",
                "type": "path",
                "description": "Group UUID (Administration > Groups)"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Adds a user to an organization's group"
        },
        {
          "info": {
            "name": "Remove User From Group",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://baseUrl/api/v3.0/orgs/:orgUuid/groups/:groupUuid/users/:userUuid",
            "params": [
              {
                "name": "orgUuid",
                "value": "",
                "type": "path",
                "description": "org UUID (from the Mend App: **Administration** General > **Organization UUID**)."
              },
              {
                "name": "groupUuid",
                "value": "",
                "type": "path",
                "description": "Group UUID (Administration > Groups)"
              },
              {
                "name": "userUuid",
                "value": "",
                "type": "path",
                "description": "User UUID (Administration > Users)"
              }
            ]
          },
          "docs": "Deletes a user from an organization's group"
        }
      ]
    }
  ],
  "bundled": true
}