> ## Documentation Index
> Fetch the complete documentation index at: https://cofounder.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Public Founder Diary

> Opt-in public stream of sanitized briefings — share your build journey without leaking $ figures.

Some founders build in public. The Public Founder Diary lets you publish a stream of co-founder briefings to a unique URL — `/v1/cofounder/diary/<your-slug>` — with revenue and credentials automatically scrubbed.

## Enable

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
PUT /v1/cofounder/preferences
{ "publicDiaryEnabled": true }
```

A unique slug is auto-generated the first time you enable. Get it back via:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
GET /v1/cofounder/preferences
```

You'll see `public_diary_slug: "yourname-a3kf9q"`. Share `https://api.appeeky.com/v1/cofounder/diary/yourname-a3kf9q` publicly.

## What gets sanitized

Every diary entry is the **briefing markdown** + the **headline** + a small `metricsSummary` object. We strip anything sensitive:

| Removed                                       | Kept                     |
| --------------------------------------------- | ------------------------ |
| Owner email                                   | App name                 |
| Integration credentials                       | ASO score + grade        |
| Absolute revenue dollars (`$1,234.56` → `$▒`) | Revenue *delta* (`+12%`) |
| Absolute MRR / ARR                            | Downloads delta          |
| API keys / webhooks                           | Conversion rate          |

## Public response

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
GET /v1/cofounder/diary/yourname-a3kf9q?limit=20
```

```jsonc theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": {
    "slug": "yourname-a3kf9q",
    "entries": [
      {
        "id": "uuid",
        "appName": "Phosum: Photo & Screenshot",
        "headline": "Conversion still flat, but Mexico is screaming for localization.",
        "briefing": "...full markdown briefing with $ values masked...",
        "metricsSummary": {
          "asoScore": 38,
          "grade": "D",
          "asoScoreDelta": 0,
          "downloadsDeltaPct": 13,
          "revenueDeltaPct": -100,
          "conversionRate": 0
        },
        "publishedAt": "2026-05-02T08:00:00Z"
      }
    ]
  }
}
```

## Disable / pause

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
PUT /v1/cofounder/preferences
{ "publicDiaryEnabled": false }
```

Disabling stops new entries from being published. Existing entries remain in `cofounder_public_diary` (set `is_public=false` if you want to retract them).

## Use cases

* **Build in public** — wire the slug to a personal site or Twitter bot.
* **Investor updates** — a single shareable link instead of weekly emails.
* **Accountability** — committing publicly to ship something this week tends to make you actually do it.
* **Hiring** — show prospective teammates how you actually run your business.

## Privacy notes

* The diary endpoint requires **no authentication** — anyone with the slug can read it. Treat the slug like a "shareable" link.
* You can rotate the slug by clearing it directly in the database (UI coming soon) — old links will 404 once a new entry hasn't been published in a while.
* We never expose the underlying `report` object publicly — only the sanitized `briefing` markdown is returned.