---
title: "Update a department"
method: PATCH
path: "/v3/classifications/departments/{id}"
tags: ["classifications"]
---

# Update a department

`PATCH /v3/classifications/departments/{id}`

Update details about an existing department.

## Path parameters

- `id` string, required — BILL-generated ID of the department. The value begins with `0de`.

## Headers

- `sessionId` string, nullable — API session ID generated with `/v3/login`
- `devKey` string, nullable — Developer key generated with your BILL developer account

## Request body

- UpdateClassificationDepartmentRequestDto — Update a department (description updated)
  - `name` string — Department name
  - `shortName` string — Department short name
  - `description` string — Department description
  - `parentId` string — BILL-generated ID of the parent department. You can set this field if this department is a child object.

## Response `200`

Update a department response

- ClassificationDepartmentResponseDto — ClassificationDepartment response Dto.
  - `id` string — BILL-generated ID of the department. The value begins with `0de`.
  - `name` string — Department name
  - `shortName` string — Department short name
  - `description` string — Department description
  - `parentId` string — BILL-generated ID of the parent department. You can set this field if this department is a child object.
  - `archived` boolean — Set as `true` if the department is archived
  - `createdTime` string, date-time — Created date and time
  - `updatedTime` string, date-time — Updated date and time

## Other responses

- `4XX` — List of errors.
- `5XX` — List of errors.

---

[API](https://skmtc.net/bill/apis/bill-v3-api.md) · [All operations](https://skmtc.net/bill/apis/bill-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bill/bill-v3-api/versions/0483350c434e/schema)