Attach a node to the school structure

POST

https://ssuccessv2.com/app/api/v2/school/settings/structure/:yearId/nodes

POST

/app/api/v2/school/settings/structure/:yearId/nodes

$ curl -X POST https://ssuccessv2.com/app/api/v2/school/settings/structure/2026/nodes \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "nodeable_type": "SchoolDepartment",
>   "nodeable_id": 14,
>   "parent_node_id": 301
> }'

1 {
2   "status": "success",
3   "message": "Attached",
4   "data": {
5     "nodes": [
6       {
7         "id": "301",
8         "type": "School",
9         "data": {
10           "id": 9,
11           "label": "SchoolSet Academy",
12           "active": true
13         },
14         "position": {
15           "x": 0,
16           "y": 0
17         }
18       }
19     ],
20     "edges": [
21       {
22         "id": "301-302",
23         "source": "301",
24         "target": "302"
25       }
26     ]
27   }
28 }

Creates a department or grade node under an existing academic-year structure node and returns the refreshed tree.

Authentication

AuthorizationBearer

The signed-in SchoolSet user token sent by the frontend.

Path parameters

yearIdintegerRequired>=1

Academic year receiving the node.

Request

This endpoint expects an object.

nodeable_typeenumRequired

Allowed values:

nodeable_idintegerRequired>=1

parent_node_idintegerRequired>=1

Response

The node was attached and the refreshed school structure tree was returned.

statusstringOptional

messagestringOptional

dataobjectOptional

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error