Customer Departments

Update a department

Partially update a department by its ID.

Only supplied fields are updated. If field is not provided, the existing value is preserved.

Returns 200 with the full DepartmentItem on success.

patch/v1/partner/customers/{customerId}/departments/{departmentId}

Path parameters

customerIdstring uuid required

Customer ID (UUID)

departmentIdstring uuid required

Department ID (UUID)

Request body

namestring nullable

Department name. If omitted, existing name is preserved.

codestring nullable

Department code. If omitted, existing code is preserved.

descriptionstring nullable

Department description. If omitted, existing description is preserved.

Example request

{
  "name": "New Department Name",
  "code": "DEPT_99",
  "description": "Updated description"
}

Response

Department updated successfully

idstring uuid

Department ID (UUID).

codestring nullable

Department code

namestring

Department name

descriptionstring nullable

Department description

createdAtstring date-time

Timestamp when the department was created (ISO 8601)

Example response

{
  "id": "018e3b2a-1c4d-7f8e-9b0a-2d3e4f5a6b7c",
  "code": "DEPT_99",
  "name": "Global Sales",
  "description": "Internal code: GS-001",
  "createdAt": "2026-03-24T10:00:00Z"
}