> For the complete documentation index, see [llms.txt](https://developers.welcomekit.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.welcomekit.co/jobs-api/departments/update-a-department.md).

# Update a department

This endpoint lets you update departments for a given id.

{% hint style="info" %}
 This endpoint requires `departments_rw` scope.
{% endhint %}

## department update

<mark style="color:orange;">`PUT`</mark> `https://www.welcomekit.co/api/v1/external/departments/:id`

#### Path Parameters

| Name                                 | Type   | Description   |
| ------------------------------------ | ------ | ------------- |
| id<mark style="color:red;">\*</mark> | string | Department ID |

#### Query Parameters

| Name        | Type    | Description           |
| ----------- | ------- | --------------------- |
| name        | string  | Name                  |
| slug        | string  | Slug                  |
| is\_active  | boolean | Department is active? |
| description | string  | Description           |

{% tabs %}
{% tab title="200 Success" %}

```
{
  "id": 42,
  "name": "Whatever",
  "is_active": true,
  "slug": "tech",
  "description": "Foo bar"
}
```

{% endtab %}
{% endtabs %}

Request example

```
curl -X PUT "https://www.welcomekit.co/api/v1/external/departments/:id" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer WK_API_KEY" \
    -d @- <<EOF
{
  "name": "Whatever",
}
EOF
```