# Manage departments

Use the Business API to create, update, retrieve, and delete departments in your Revolut Business account.

## About departments

Departments let you organise your [team members](/docs/guides/manage-accounts/teams/manage-team-members) into groups within your business.
You can [assign team members to departments](/docs/guides/manage-accounts/teams/manage-team-members#assign-or-remove-a-department) to reflect your organisational structure.

Each department has a name and a unique ID.

## Manage departments via API

The Business API lets you:

- [Create a department](#create-a-department)
- [Retrieve a list of departments](#retrieve-a-list-of-departments)
- [Retrieve a department](#retrieve-a-department)
- [Update a department](#update-a-department)
- [Delete a department](#delete-a-department)

### Create a department

To create a new department, make a `POST` request providing the department name.
Department names must be **unique** within your business.

In the response, you get the ID of the created department.

To see example requests and responses:

[See the API reference: Create a department](/docs/api/business#create-department)

### Retrieve a list of departments

You can list all the departments in your business.
The results are paginated using a `page_token` cursor.

Use the `limit` parameter to control the number of departments returned per page (maximum 500).
To get the next page, use the `next_page_token` from the previous response.

In the response, for each department you get its ID, name, and the date-times of creation and last update.

To see example requests and responses:

[See the API reference: Retrieve a list of departments](/docs/api/business#get-departments)

### Retrieve a department

To get details of a single department, make a `GET` request providing the department's ID.

To see example requests and responses:

[See the API reference: Retrieve a department](/docs/api/business#get-department)

### Update a department

To update a department's name, make a `PATCH` request providing the department's ID and the new name.

Department names must be **unique** within your business.

To see example requests and responses:

[See the API reference: Update a department](/docs/api/business#update-department)

### Delete a department

To delete a department, make a `DELETE` request providing the department's ID.

Deleting a department does **not** delete the team members assigned to it.
The department assignment is simply removed from the team members.

To see example requests and responses:

[See the API reference: Delete a department](/docs/api/business#delete-department)

## What's next

See how to [manage team members](/docs/guides/manage-accounts/teams/manage-team-members) and assign them to departments.