# GET /v1/workspaces/{workspace_id}/fs - Workspace root listing

Source: <https://everruns.com/docs/api/operations/get_root/>

GET

/v1/workspaces/{workspace\_id}/fs

Select code samplecURL (shell:curl)

```js
const url = 'https://app.everruns.com/api/v1/workspaces/example/fs';
const options = {method: 'GET'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```sh
curl --request GET \
  --url https://app.everruns.com/api/v1/workspaces/example/fs
```

* Production APIapp.everruns.com/api/v1/workspaces/{workspace\_id}/fs

## Parameters

### Path Parameters

**workspace\_id**

required

string

Workspace ID (wsp\_<32-hex>)

### Query Parameters

**recursive**

boolean

List recursively

## Responses

### 200

Directory listing

Media typeapplication/json

Response wrapper for list endpoints. All list endpoints return responses wrapped in a `data` field.

object

**data**

required

Array of items returned by the list operation.

Array\<object>

File metadata without content

object

**created\_at**

required

Timestamp when this entry was created (RFC 3339).

string format: date-time

**id**

required

Internal database UUID for this file entry.

string format: uuid

**is\_directory**

required

`true` when this entry represents a directory; `false` for a regular file.

boolean

**is\_readonly**

required

Whether the entry was marked read-only at creation. Read-only entries cannot be edited or deleted by the session.

boolean

**name**

required

File or directory name (the last segment of `path`).

string

**path**

required

Absolute path within the session workspace (e.g. `/notes.md`).

string

**session\_id**

required

UUID of the owning session.

string format: uuid

**size\_bytes**

required

File size in bytes. `0` for directories.

integer format: int64

**updated\_at**

required

Timestamp when this entry was last updated (RFC 3339).

string format: date-time

##### Example

```json
{
  "data": [
    {
      "created_at": "2026-05-25T10:14:00Z",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "is_directory": false,
      "is_readonly": false,
      "name": "notes.md",
      "path": "/notes.md",
      "session_id": "01933b5a-0000-7000-8000-000000000001",
      "size_bytes": 4096,
      "updated_at": "2026-05-25T10:15:30Z"
    }
  ]
}
```

### 404

Workspace not found

### 500

Internal server error