Skip to content
Last updated

Update the name or description of an existing department.

PATCHhttps://api.aitronos.com/v1/organizations/{organization_id}/departments/{department_id}

Partially updates a department. Only the fields provided in the request body are modified. To move a department to a different parent, use the Reparent Department endpoint instead.

Path Parameters

organization_id string required

The unique identifier of the organization (format: org_*).

department_id string required

The unique identifier of the department (format: dept_*).

Request Body

name string optional

The new name for the department. Must be between 1 and 255 characters.

description string | null optional

The new description for the department.


Returns

The updated department object.

cURL
curl -X PATCH https://api.aitronos.com/v1/organizations/org_xyz789/departments/dept_abc123 \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Platform Engineering",
    "description": "Platform and infrastructure team"
  }'