Update folder properties including name, description, parent, or display order.

## Path Parameters

**`folder_id`** string required

Folder ID (sfold_ prefixed)

## Request Body

**`name`** string optional

New folder name (1-255 characters)

**`description`** string optional

New description

**`parent_folder_id`** string | null optional

New parent folder ID or null for root level

**`display_order`** integer optional

New sort position

## Returns

Returns the updated folder object.

Request

```bash cURL
curl -X PATCH "https://api.aitronos.com/api/v1/streamline/folders/sfold_abc123" \
  -H "X-API-Key: $FREDDY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production Workflows",
    "display_order": 5
  }'
```


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]
folder_id = "sfold_abc123"

response = requests.patch(
    f"https://api.aitronos.com/api/v1/streamline/folders/{folder_id}",
    headers={"X-API-Key": api_key},
    json={
        "name": "Production Workflows",
        "display_order": 5
    }
)

folder = response.json()
print(f"Updated folder: {folder['name']}")
```


```javascript JavaScript
const apiKey = process.env.FREDDY_API_KEY;
const folderId = "sfold_abc123";

const response = await fetch(
  `https://api.aitronos.com/api/v1/streamline/folders/${folderId}`,
  {
    method: "PATCH",
    headers: {
      "X-API-Key": apiKey,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      name: "Production Workflows",
      display_order: 5
    })
  }
);

const folder = await response.json();
console.log(`Updated folder: ${folder.name}`);
```

Response

```json 200 OK
{
  "id": "sfold_abc123",
  "organization_id": "org_xyz789",
  "created_by_user_id": "usr_def456",
  "parent_folder_id": null,
  "name": "Production Workflows",
  "description": "All production-ready workflows",
  "display_order": 5,
  "is_deleted": false,
  "created_at": "2025-11-28T10:30:00Z",
  "updated_at": "2025-11-28T14:00:00Z",
  "deleted_at": null
}
```


```json 422 Unprocessable Entity
{
  "success": false,
  "error": {
    "code": "CIRCULAR_FOLDER_REFERENCE",
    "message": "Cannot set parent folder - would create circular reference",
    "status": 422
  }
}
```