# Filesystems API

> List, create, read, rename and delete filesystems over REST, including the region field that pins where a filesystem's data is stored for its lifetime.

## List Filesystems

```
GET /fs
```

Returns all filesystems accessible by the authenticated account.

### Response

```json
{
  "filesystems": [
    {
      "uid": "fs_abc123",
      "name": "My Project",
      "region": "us",
      "createdAt": "2025-01-15T10:30:00Z"
    }
  ]
}
```

## Create Filesystem

```
POST /fs
```

### Request Body

```json
{
  "name": "My Project",
  "region": "us"
}
```

### Response

```json
{
  "uid": "fs_abc123",
  "name": "My Project",
  "region": "us",
  "createdAt": "2025-06-15T10:30:00Z"
}
```

## Get Filesystem

```
GET /fs/:uid
```

Returns details for a specific filesystem.

## Update Filesystem

```
PATCH /fs/:uid
```

### Request Body

```json
{
  "name": "Updated Name"
}
```

## Delete Filesystem

```
DELETE /fs/:uid
```

Permanently deletes a filesystem and all its contents. This action cannot be undone.

---

Canonical HTML version: https://hyperfile.io/docs/api/filesystems/