POST Nodes (store)

Developing

POST

/api/orgcharts/{orgchart}/nodes

Create a new node within an organization chart. Supports role, team, department, user, and assistant node types. Can link to existing users, departments, and teams. Validates parent exists within the same chart. Permission: policy create on OrgChartNode.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-dev.commandroom.ai/api/api/orgcharts/1/nodes' \
--header 'Authorization: Bearer {{token}}' \
--header 'X-Tenant-UUID: ' \
--header 'Content-Type: application/json' \
--data '{
  "parent_id": 1,
  "order": 1,
  "title": "Sample Title",
  "subtitle": "Sample Title",
  "type": "string",
  "node_type": "string",
  "icon": "FolderOpen",
  "is_leader": true,
  "user_id": 1,
  "onshore": {},
  "offshore": {},
  "ai_agents": [],
  "automations": [],
  "suggestions": [],
  "ai_automation_metadata": {},
  "data": {},
  "position_details": {},
  "ideas_backlog": []
}'

Response Example

201 - OK

{
  "data": {
    "orgchart_node_id": 1,
    "orgchart_id": 1,
    "title": "Sample Title",
    "node_type": "string",
    "created_at": "2026-01-15T10:30:00.000000Z",
    "updated_at": "2026-01-15T10:30:00.000000Z"
  }
}

Modified at 2026-07-02 04:47:16

GET Nodes (index)

GET Item (show)