GET Tree (tree)

Developing

GET

/api/departments/tree

Get the full hierarchical tree structure (departments > teams > users) for a specific org chart. Falls back to reading from org chart nodes when Department records don't exist in the database.

Uses DepartmentService::getHierarchicalTree() with configurable limits to prevent memory issues on large datasets. Organization-scoped: filters users by the current tenant's organization ID.

Request

Query Params

Header Params

Responses

🟢200Success

application/json

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-dev.commandroom.ai/api/api/departments/tree?org_chart_id=15&include_users=true&max_teams=10&max_users=10&max_depth=2' \
--header 'Authorization: Bearer {{token}}' \
--header 'X-Tenant-UUID: '

Response Example

200 - OK

{
  "success": true,
  "data": [
    {
      "id": 1,
      "type": "department",
      "name": "Sample Name",
      "description": "Sample description text.",
      "original_id": 1,
      "teams_count": 10,
      "users_count": 10,
      "parent_id": 1,
      "has_more": true,
      "depth_limit_reached": true,
      "lazy_load_hint": "string",
      "goteam_id": 1,
      "email": "user@example.com",
      "assignment_type": "team",
      "is_team_lead": true,
      "children": [
        {}
      ]
    }
  ]
}

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

GET Users (teamUsers)

GET Paginated (treePaginated)