---
title: "GET /api/v1/file-views/{spaceId}"
method: GET
path: "/api/v1/file-views/{spaceId}"
---

# GET /api/v1/file-views/{spaceId}

`GET /api/v1/file-views/{spaceId}`

## Request

- Base URL: `https://falconer.com` (the document declares no server; this is the origin it was published from)
- URL: `https://falconer.com/api/v1/file-views/{spaceId}`
- Auth: none declared

## Path parameters

- `spaceId` integer, required: Space id, from GET /spaces.

## Query parameters

- `prefix` string: Only paths under this directory, such as guides.
- `type` 'file' | 'directory'
- `category` 'document' | 'asset' | 'config'
- `limit` integer
- `cursor` string: nextCursor from the previous page.

## Headers

- `x-organization-id` string: Required when using OAuth bearer tokens.

## Response `200`

Files in path order

- SpaceFileList
  - `data` SpaceFile[], required
    - `fileNodeId` string, required
    - `path` string, required
    - `name` string, required
    - `type` 'file' | 'directory', required
    - `kind` string, required: markdown (a page), text, config, or opaque (binary, such as an image).
    - `category` 'document' | 'asset' | 'config', nullable, required
    - `documentId` string, nullable, required: The page document for a markdown file; read it with GET /docs/{id}.
    - `hasNavPlacement` boolean, required: False for a page that is only in the Files view.
    - `hasContent` boolean, required
    - `managedConfig` boolean, required: Generated from site settings; edit those instead.
    - `inertConfig` boolean, required: Seeded the site once and is no longer read.
    - `repoBacked` boolean, required
    - `pendingRemoval` boolean, required: Queued for removal from GitHub on the next push.
  - `nextCursor` string

## Other responses

- `400`: Bad request, such as a missing parent folder
- `403`: Permission is missing
- `404`: Space not found, or file not found

---

[API](https://skmtc.dev/falconer/apis/falconer-public-api.md) · [All operations](https://skmtc.dev/falconer/apis/falconer-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/falconer/apis/falconer-public-api/revisions/c00420511526?raw)