v1

latestSwagger 2.0Apache 2.02026-07-1334102.9 MB
Users

Remove Institutions from a User's Affiliations

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.

Example Request Payload

  "data": [
    { "type": "institutions", "id": "mit" },
    { "type": "institutions", "id": "cambridge" }
  ]
} ```
delete/users/{user_id}/relationships/institutions/

Path parameters

user_idstring required

The unique identifier of the user. Example: abc123

Request body

Example request

{
  "data": [
    {
      "id": "mit"
    }
  ]
}

Response

Successfully removed institutions from user's affiliations.