---
title: "Add registration relationships to an institution"
method: POST
path: "/institutions/{institution_id}/relationships/registrations/"
tags: ["Institutions"]
---

# Add registration relationships to an institution

`POST /institutions/{institution_id}/relationships/registrations/`

## Request

- Base URL: `https://api.test.osf.io/v2`
- URL: `https://api.test.osf.io/v2/institutions/{institution_id}/relationships/registrations/`
- Auth: none declared

Add registrations to an institution's affiliated registrations relationship.

### Permissions
- Requires write access on each registration being added.
- User must be affiliated with the institution.

## Path parameters

- `institution_id` string, required

## Request body

- object
  - `data` object[]
    - `type` string
    - `id` string

## Response `201`

Registrations successfully affiliated with institution.

## Other responses

- `204`: No changes made (registrations already affiliated).
- `400`: Invalid request payload.
- `401`: Authentication credentials were not provided or are invalid.
- `403`: You do not have permission to affiliate these registrations.
- `404`: Institution not found.

---

[API](https://skmtc.dev/osf/apis/osf-apiv2-documentation.md) - [All operations](https://skmtc.dev/osf/apis/osf-apiv2-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/osf/apis/osf-apiv2-documentation/revisions/3c5164c707eb?raw)