Organization Unit Repository

Fetch all units for an organization (flat list)

{
  "data": [
    {
      "unit_id": "unit-001",
      "organization_id": "org-42",
      "name": "Northern Region",
      "level_type": "region",
      "parent_id": null,
      "depth": 0
    },
    {
      "unit_id": "unit-002",
      "organization_id": "org-42",
      "name": "Oslo Chapter",
      "level_type": "chapter",
      "parent_id": "unit-001",
      "depth": 1
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 12
  }
}

Fetch a single unit by ID

{
  "unit_id": "unit-002",
  "organization_id": "org-42",
  "name": "Oslo Chapter",
  "level_type": "chapter",
  "parent_id": "unit-001",
  "depth": 1,
  "created_at": "2025-02-10T11:30:00Z"
}

Fetch direct children of a unit

{
  "data": [
    {
      "unit_id": "unit-019",
      "name": "Bergen Chapter",
      "level_type": "chapter",
      "parent_id": "unit-001",
      "depth": 1
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 4
  }
}

Fetch all ancestor units up to the root

{
  "data": [
    {
      "unit_id": "unit-001",
      "name": "Northern Region",
      "level_type": "region",
      "depth": 0
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1
  }
}

Insert a new organization unit record

{
  "organization_id": "org-42",
  "name": "Trondheim Chapter",
  "level_type": "chapter",
  "parent_id": "unit-001"
}

{
  "unit_id": "unit-020",
  "organization_id": "org-42",
  "name": "Trondheim Chapter",
  "level_type": "chapter",
  "parent_id": "unit-001",
  "depth": 1,
  "created_at": "2026-03-26T10:50:00Z"
}

Update an organization unit record

{
  "name": "Trondheim & Stjørdal Chapter"
}

{
  "unit_id": "unit-020",
  "name": "Trondheim & Stjørdal Chapter",
  "updated_at": "2026-03-26T11:10:00Z"
}

Delete an organization unit record

{
  "deleted": true,
  "unit_id": "unit-020"
}

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}