---
title: "Browse files from other projects in this workspace"
method: GET
path: "/api/projects/{id}/files/workspace"
---

# Browse files from other projects in this workspace

`GET /api/projects/{id}/files/workspace`

## Request

- Base URL: `https://editor.pascal.app`
- URL: `https://editor.pascal.app/api/projects/{id}/files/workspace`
- Auth: HTTP bearer

The authorized anchor project determines the workspace. Excludes files already in the anchor project. Personal projects only include other projects owned by the same user. Search also matches project names. Workspace-scoped keys and OAuth scene:read are supported; project-bound executor and chat sandbox credentials cannot use this endpoint.

## Query parameters

- `query` string
- `type` 'scan' | 'guide' | 'image' | 'document' | 'other'
- `cursor` string
- `limit` integer

## Response `200`

Newest workspace files first, with their owning project names

- object
  - `files` object[], required
    - `id` string, required
    - `projectId` string, required
    - `name` string, required
    - `originalName` string, required
    - `url` string, uri, required
    - `type` 'scan' | 'guide' | 'image' | 'document' | 'other', required
    - `origin` 'upload' | 'plugin' | 'snapshot' | 'render', required
    - `typeLabel` string, nullable
    - `mimeType` string, nullable
    - `fileSize` integer, nullable
    - `thumbnailUrl` string, nullable
    - `notes` string, nullable
    - `tags` string[]
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `projectName` string, required
  - `nextCursor` string, nullable, required

## Other responses

- `400`: Invalid file request
- `401`: Authentication required
- `403`: Missing scene:read or scene:write OAuth scope
- `404`: Project or file not accessible to this workspace member

---

[API](https://skmtc.dev/pascal/apis/pascal-editor-scene-api.md) · [All operations](https://skmtc.dev/pascal/apis/pascal-editor-scene-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pascal/apis/pascal-editor-scene-api/revisions/08f1f3f41067?raw)