Departments & Locations

Organizational Structure

StackFlow models your organization's hierarchy using a two-level structure: Departments and Locations. Departments represent functional groups (e.g., Platform Engineering, IT Operations) while Locations represent physical or logical offices. Both are used for routing, reporting, and SLA policy scoping.

Every StackFlow user is assigned to exactly one department and one location. Assignment groups (used for incident routing) can be associated with one or more departments to create automatic routing rules based on the affected service's owning department.

Managing Departments

Navigate to Admin → Organization → Departments to create and manage departments. Each department has a unique code used in API calls and reporting queries.

curl -X POST https://your-instance.stackflow-tech.com/prod/api/admin/departments   -H "Authorization: Bearer $ADMIN_TOKEN"   -H "Content-Type: application/json"   -d '{
    "name": "Platform Engineering",
    "code": "PLAT_ENG",
    "manager_user_id": "usr_abc123",
    "parent_department_id": null,
    "cost_center": "CC-1042"
  }'

Locations

Locations are used for SLA policy scoping (e.g., different SLAs for different regions) and on-call routing. Each location has a timezone setting that affects SLA business hours calculations.

Assignment Routing

The assignment routing engine uses department and location data to automatically suggest the correct assignment group for new incidents. The routing algorithm considers: the affected CI's owning department, the reporter's location, and the current load of each assignment group.

Import from LDAP

If your organization uses Active Directory Organizational Units (OUs) to model departments, StackFlow can import the OU structure directly via the LDAP sync. Enable Sync Organizational Units as Departments in the LDAP configuration to activate this feature. OU import runs during every scheduled LDAP sync.

{
  "ldap_sync": {
    "sync_organizational_units": true,
    "ou_base_dn": "OU=Departments,DC=corp,DC=example,DC=com",
    "ou_attribute_map": {
      "name": "ou",
      "code": "description",
      "manager": "managedBy"
    }
  }
}