---
title: "Project Digest"
method: GET
path: "/projects/{project_id}/digest"
tags: ["dashboards"]
---

# Project Digest

`GET /projects/{project_id}/digest`

Everything the project holds, from its records alone: counts, names, JSON keys
and analysis columns, plus the same facts rendered as markdown for a prompt.

## Path parameters

- `project_id` string, uuid, required

## Response `200`

Successful Response

- ProjectDigest — Everything a project holds, in the shape an authoring turn needs up front.
  - `fingerprint` string, required
  - `generated_at` string, date-time, required
  - `text` string, required
  - `instances` DigestInstances
    - `count` integer
    - `batches` string[]
    - `measured_properties_keys` string[]
  - `cellSpecifications` DigestCellSpecifications
    - `count` integer
    - `names` string[]
    - `ratings_keys` string[]
    - `properties_keys` string[]
  - `measurements` DigestMeasurements
    - `count` integer
    - `by_type` object
    - `per_instance` DigestSpread — How many measurements the busiest and quietest instance carries.
      - `min` integer
      - `max` integer
      - `mean` number
    - `properties_keys` string[]
    - `recorded_duration_s` DigestRange
      - `min` number, nullable
      - `max` number, nullable
  - `analyses` DigestAnalyses
    - `count` integer
    - `by_type` object
    - `columns_by_type` object
  - `materials` DigestMaterials
    - `count` integer
    - `names` string[]
  - `materialProperties` DigestMaterialProperties
    - `count` integer
    - `names` string[]
    - `columns_by_name` object
  - `simulations` DigestSimulations
    - `count` integer
    - `metrics_keys` string[]
  - `described` DigestDescribed — What the ``describe`` cache already knows, so the agent can skip re-reading it. The counts are null until something has been described in this project.
    - `measurements_with_steps` integer, nullable
    - `measurements_with_cycles` integer, nullable
    - `of` integer

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-26** `8ed5440390f0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ionworks/apis/fastapi/changes/projects/:project_id/digest/get.md)

---

[API](https://skmtc.dev/ionworks/apis/fastapi.md) · [All operations](https://skmtc.dev/ionworks/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/ionworks/apis/fastapi/revisions/8ed5440390f0?raw)