---
agentTools:
  projectIndex: https://developers.northpass.com/llms.txt
---

# Remove a person from a group

Delete existing groups from an existing person.
Depending on the `type` it will either remove a person as a learner (`membership-groups`) or a manager from a group (`managed-groups`).

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "OpenAPI Specification",
    "version": "1.0.0"
  },
  "paths": {
    "/v2/people/{person_uuid}/relationships/groups": {
      "delete": {
        "tags": [
          "People"
        ],
        "summary": "Remove a person from a group",
        "description": "Delete existing groups from an existing person.\nDepending on the `type` it will either remove a person as a learner (`membership-groups`) or a manager from a group (`managed-groups`).\n",
        "parameters": [
          {
            "name": "person_uuid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "$ref": "#/components/requestBodies/Body"
        },
        "responses": {
          "204": {
            "description": "successful operation",
            "headers": {
              "Cache-Control": {
                "x-example-value": "no-cache",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "*/*": {
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              },
              "application/json": {
                "examples": {
                  "response": {
                    "value": {}
                  }
                }
              }
            }
          },
          "403": {
            "description": "when you don't have the necessary permissions",
            "headers": {
              "Content-Type": {
                "x-example-value": "application/json; charset=utf-8",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "x-example-value": "no-cache",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "*/*": {
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              },
              "application/json": {
                "examples": {
                  "response": {
                    "value": {
                      "errors": [
                        {
                          "status": "403",
                          "title": "Forbidden",
                          "detail": "You don't have necessary permissions for the resource",
                          "code": "api_error",
                          "source": {}
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "when the person does not exist",
            "headers": {
              "Content-Type": {
                "x-example-value": "application/json; charset=utf-8",
                "schema": {
                  "type": "string"
                }
              },
              "Cache-Control": {
                "x-example-value": "no-cache",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "*/*": {
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              },
              "application/json": {
                "examples": {
                  "response": {
                    "value": {
                      "errors": [
                        {
                          "status": "404",
                          "title": "Not Found",
                          "detail": "The resource you requested does not exist",
                          "code": "api_error",
                          "source": {}
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": [
          {
            "X-Api-Key": []
          }
        ]
      }
    }
  },
  "tags": [
    {
      "name": "People"
    }
  ],
  "servers": [
    {
      "url": "https://api.northpass.com"
    }
  ],
  "components": {
    "requestBodies": {
      "Body": {
        "content": {
          "application/json": {
            "schema": {
              "required": [
                "data"
              ],
              "type": "object",
              "properties": {
                "data": {
                  "type": "array",
                  "description": "Data",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "type": {
                        "type": "string",
                        "enum": [
                          "membership-groups",
                          "managed-groups"
                        ]
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "X-Api-Key": {
        "type": "apiKey",
        "name": "X-Api-Key",
        "in": "header"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "_id": {
    "buffer": {
      "0": 94,
      "1": 131,
      "2": 105,
      "3": 179,
      "4": 156,
      "5": 162,
      "6": 182,
      "7": 0,
      "8": 57,
      "9": 227,
      "10": 168,
      "11": 70
    }
  }
}
```