---
title: "Read a shared dashboard's cached data"
method: GET
path: "/v1/shared-assets/{token}/app-data"
tags: ["shared-assets"]
---

# Read a shared dashboard's cached data

`GET /v1/shared-assets/{token}/app-data`

## 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-assets/{token}/app-data`
- Auth: one of:
  - HTTP bearer
  - none

The latest cached data for the external dashboard named by a live file share link. No sign-in is required. Password-protected links require their current grant. Returns only data and its fetch time, without source credentials or action authority. Answers 404 for non-app files, non-external dashboards, and links that cannot open the file.

## Path parameters

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

## Query parameters

- `access_acknowledgement` string, uuid, nullable: A UUID for one deliberate private-file opening. Reuse across requests for the same opening.

## Headers

- `X-Share-Grant` string, nullable

## Response `200`

Successful Response

- SharedAppData: The cached dashboard data one share link opens.
  - `data` object, nullable, required
  - `fetched_at` string, date-time, nullable, required

## Other responses

- `401`: A password grant is required.
- `403`: PRIVATE_ASSET_ACKNOWLEDGEMENT_REQUIRED: a workspace owner or admin must confirm a deliberate opening of a teammate's private file.
- `404`: No shared file for that link.
- `422`: Validation Error
- `429`: The address request ceiling is reached.
- `503`: The private access audit or result storage is unavailable.

---

[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)