---
title: "Update folder"
method: PUT
path: "/v1/folders/{folder_id}"
tags: ["Folders"]
---

# Update folder

`PUT /v1/folders/{folder_id}`

Update a folder's title or description

## Path parameters

- `folder_id` string, required — Folder ID

## Headers

- `x-api-key` string, nullable — Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.

## Request body

- FolderUpdate — Request model for updating a folder
  - `title` string, nullable — Folder title
  - `description` string, nullable — Folder description

## Response `200`

Successfully updated folder

- Folder — Response model for a folder
  - `title` string, required — Folder title
  - `description` string, nullable — Folder description
  - `folder_id` string, required
  - `organization_id` string, required
  - `workflow_count` integer — Number of workflows in this folder
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, required

## Other responses

- `404` — Folder not found
- `422` — Validation Error

---

[API](https://skmtc.net/skyvern-ai/apis/skyvern-api-2.md) · [All operations](https://skmtc.net/skyvern-ai/apis/skyvern-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skyvern-ai/skyvern-api-2/versions/5116249dfff3/schema)