> For the complete documentation index, see [llms.txt](https://docs.coherent.global/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coherent.global/spark-apis/folder-apis/update-folder.md).

# Update folder

Update folder details including category or description.

Returns: `status` to indicate whether the request was completed.

{% code overflow="wrap" %}

```shellscript
POST /api/v1/product/update/{folderId}
```

{% endcode %}

### Path parameters

| Key           | Value                                                                                                                                                                                                                                                                                         |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `folderId` \* | <p>Folder <code>id</code> which can be found from <a data-mention href="/pages/UTyvyR7LrG1oH8JwjzAX">/pages/UTyvyR7LrG1oH8JwjzAX</a> or <a data-mention href="/pages/y7N9EfD0zFVQ8l1CDUxX">/pages/y7N9EfD0zFVQ8l1CDUxX</a>.<br>Example: <code>9efb97d3-59b5-4ab1-b138-525797d58a91</code></p> |

### Authorization

* `Bearer {token}` accessible from [Authorization - Bearer token](/spark-apis/authorization-bearer-token.md) or systematically via [Client credentials](/identity-and-access-management/client-credentials.md).
  * The request headers should include a key for `Authorization` with the value `Bearer {token}`.

### Request body <a href="#request-body" id="request-body"></a>

`Content-Type: application/json`

| Key                     | Value                                                                                                                                    |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `category`              | Folder category. Must be a valid folder category. The category names are managed in [Options](/navigation/options.md#folder-categories). |
| `description`           | Folder description.                                                                                                                      |
| `shouldTrackUserAction` | `true`                                                                                                                                   |

### Sample request <a href="#request-body" id="request-body"></a>

The required request body should be in JSON format and should look similar to the following:

```json
{
    "category": "Critical Illness",
    "description": "CI",
    "shouldTrackUserAction": true
}
```

### Sample response

`HTTP 200 OK` `Content-Type: application/json`

```json
{
    "message": null,
    "data": null,
    "errorCode": null,
    "status": "Success"
}
```