---
title: "Remove Institutions from a User's Affiliations"
method: DELETE
path: "/users/{user_id}/relationships/institutions/"
tags: ["Users"]
---

# Remove Institutions from a User's Affiliations

`DELETE /users/{user_id}/relationships/institutions/`

Removes one or more institutions from a user's list of affiliations.
#### Usage Notes
- Only the authenticated user can remove their institution affiliations. - You cannot add institutions through this endpoint—use the user-institutions list endpoint for reading full records.
#### Returns
Returns a `204 No Content` response if the removal is successful.
#### Errors
If the request is unsuccessful, an `errors` key containing information about the failure will be returned. Refer to the [list of error codes](#tag/Errors-and-Error-Codes).
#### Example Request Payload
```json {
  "data": [
    { "type": "institutions", "id": "mit" },
    { "type": "institutions", "id": "cambridge" }
  ]
} ```

## Path parameters

- `user_id` string, required

## Request body

- object
  - `data` object[], required
    - `type` 'institutions', required
    - `id` string, required

## Response `204`

Successfully removed institutions from user's affiliations.

## Other responses

- `400` — Bad request. Possible reasons include: - Institution `type` does not match `institutions`. - Institution ID is invalid or not affiliated with the user.
- `403` — Permission denied. You do not have permission to modify these affiliations.
- `404` — User not found.

---

[API](https://skmtc.net/osf/apis/osf-apiv2-documentation.md) · [All operations](https://skmtc.net/osf/apis/osf-apiv2-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/osf/osf-apiv2-documentation/versions/ca701048eb0d/schema)