---
title: "Group workspace files by GitHub path"
method: GET
path: "/v1/workspaces/{workspace}/files/by-path"
---

# Group workspace files by GitHub path

`GET /v1/workspaces/{workspace}/files/by-path`

## Request

- Base URL: `https://api.uploads.sh`
- URL: `https://api.uploads.sh/v1/workspaces/{workspace}/files/by-path`
- Auth: HTTP bearer

Powers the web Screenshots page's grouped-by-path view. Groups recently uploaded `gh.*`-tagged files by project and path.

## Query parameters

- `merged` '1'

## Response `200`

Path groups, a flat catalog, known projects, and a flat recent feed.

- FileByPath
  - `groups` object[], required
  - `catalog` object[], required
  - `projects` string[], required
  - `latest` object[], required
  - `truncated` boolean, required
  - `catalogTruncated` boolean, required

## Other responses

- `401`: Missing or invalid credential.
- `403`: The credential lacks the required scope or role.

---

[API](https://skmtc.dev/uploads/apis/uploads-sh-api.md) · [All operations](https://skmtc.dev/uploads/apis/uploads-sh-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uploads/apis/uploads-sh-api/revisions/6df242babacd?raw)