Request list of parent nodes

v1.0.0

🚀 Since v4.10.0

Description:

Requests a list of node ancestors, sorted from root node to the node's direct parent node.

Precondition:

User is allowed to browse through the node tree until the requested node.

Postcondition:

List of parent nodes is returned.

Further Information:

None.

Input

{
  "type": "object",
  "properties": {
    "X-Sds-Auth-Token": {
      "type": "string"
    },
    "node_id": {
      "type": "integer",
      "format": "int64"
    }
  },
  "required": [
    "node_id"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "description": "List of parent nodes",
  "properties": {
    "items": {
      "type": "array",
      "description": "List of node parents",
      "items": {
        "type": "object",
        "description": "Parent node",
        "required": [
          "id",
          "name",
          "type"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64",
            "description": "Node ID"
          },
          "name": {
            "type": "string",
            "description": "Node name"
          },
          "parentId": {
            "type": "integer",
            "format": "int64",
            "description": "Parent node ID (room or folder)"
          },
          "type": {
            "type": "string",
            "description": "Node type"
          }
        }
      }
    }
  }
}