Nodes

Update the relationships between a Node and its Subjects

Changed on

Replace all existing subject relationships on a node with a new list of subjects.

Permissions - The authenticated user must have write permissions on the node.

Request Body - A data array containing the new list of subject resource identifier objects (type and id).

Returns - The updated list of subject relationships for the node.

patch/nodes/{node_id}/relationships/subjects/

Request

  • Base URL
    https://api.test.osf.io/v2
  • URL
    https://api.test.osf.io/v2/nodes/{node_id}/relationships/subjects/
  • Auth
    none declared

Path parameters

node_idstring required

The unique identifier of the node.

Request body

Example request

{
  "data": [
    {
      "type": "subjects",
      "id": "abc123"
    },
    {
      "type": "subjects",
      "id": "def456"
    }
  ]
}

Response

Successfully updated the subject relationships for the node.

Changes