---
title: "What one folder link opens (public, by capability token)"
method: GET
path: "/v1/shared-folders/{token}"
tags: ["shared-assets"]
---

# What one folder link opens (public, by capability token)

`GET /v1/shared-folders/{token}`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/shared-folders/{token}`
- Auth: none declared

The folder's name and how many live files it holds. No sign-in, no workspace name, no ids. Answers 404 for an unknown, revoked or expired link. Behind the asset_folder_sharing_enabled kill switch.

## Path parameters

- `token` string, required: The share link's capability token.

## Response `200`

Successful Response

- SharedFolderFacts: One shared FOLDER as its recipient sees it — no workspace name, no ids, just the label and the true count of files inside it.
  - `name` string, required: The folder's name. UNTRUSTED text: render escaped.
  - `total` integer, required: How many live files this folder currently holds.

## Other responses

- `404`: No shared folder for that link.
- `422`: Validation Error

---

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