Create a new department within an organization.
POSThttps://api.aitronos.com/v1/organizations/{organization_id}/departments
Creates a new department in the specified organization. You can optionally place it under an existing parent department to build a hierarchy. The department name must be unique within the organization.
organization_id string required
The unique identifier of the organization (format: org_*).
name string required
The name of the department. Must be between 1 and 255 characters.
description string optional
A description of the department's purpose and responsibilities.
parent_id string | null optional
The ID of the parent department (format: dept_*). If omitted or null, the department is created as a top-level department.
The newly created department object with a 201 Created status code.
cURL
- Bash
- Python
- Python
- JavaScript
curl -X POST https://api.aitronos.com/v1/organizations/org_xyz789/departments \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Backend",
"description": "Backend engineering team",
"parent_id": "dept_abc123"
}'