chore(codegen): daily schema refresh (2026-08-12)

[timgl]

Summary

Automated daily refresh of src/generated/api.d.ts from the live PostHog OpenAPI
spec (https://us.posthog.com/api/schema/?format=json, filtered by
openapi-filter.yaml), plus the minimal client fixes needed to reconcile drift
in the managed resource families.

Why: the scheduled drift check flagged that api.d.ts changed and that
managed operations had moved/renamed upstream; regenerating keeps the typed
client in sync with the live API.

Spec diff size

src/generated/api.d.ts: 17,571 → 21,295 lines (+5,803 / −2,079).

New operationIds added to the filter

The endpoints resource moved namespaces upstream — the old operationIds no longer
exist, so their replacements were added to openapi-filter.yaml:

• environments_endpoints_list → endpoints_list
• environments_endpoints_create → endpoints_create
• environments_endpoints_retrieve → endpoints_retrieve
• environments_endpoints_update → endpoints_update
• environments_endpoints_partial_update → endpoints_partial_update
• environments_endpoints_destroy → endpoints_destroy

The path also moved from /api/environments/{environment_id}/endpoints/ to
/api/projects/{project_id}/endpoints/.

Resources touched

• endpoint (src/resources/endpoint/client.ts): repointed all 5 calls to the
  new /api/projects/{project_id}/endpoints/ path and project_id param.
• experiment (src/resources/experiment/client.ts): schema aliases renamed —
  Experiment → ExperimentWrite (create body), PatchedExperiment →
  PatchedExperimentWrite, PaginatedExperimentList → PaginatedExperimentBasicList.
• dashboard (src/resources/dashboard/client.ts): PATCH schema alias renamed
  PatchedDashboard → PatchedPatchedDashboardOpenApi.

No hand-edits to src/generated/api.d.ts — regenerated via pnpm codegen.

Verification

• pnpm typecheck ✅
• pnpm test ✅ (291 tests)
• Pre-existing repo-wide lint/prettier debt in untouched files was left as-is to
  avoid touching unrelated files; the heavily-edited endpoint/client.ts is
  prettier-clean.

Unresolved drift / notes for reviewers

• The drift check reports "new operationIds missing from the filter" by diffing
  every live operationId against the allowlist, so that list is dominated by
  intentionally-unmanaged API surface (accounts, alerts, annotations, warehouse,
  etc.). None of those are in scope for this IaC client, so they were left out of
  the filter by design. Only the endpoints rename was actionable.
• The experiments list response is now PaginatedExperimentBasicList (results are
  ExperimentBasic, a narrower shape than the full Experiment). ExperimentBasic
  still carries description, feature_flag_key, name, status, etc., so the
  managed-filter and pull paths are unaffected, but flagging in case a reviewer
  wants the list to hydrate full experiments.
• No managed operationIds disappeared without a replacement — all 71 filter entries
  resolve in the live spec after the endpoints remap.

TaskRun: https://us.posthog.com/project/423401/tasks/9c5d8153-96c4-4656-8830-f942a48ad501

---

Created with PostHog Desktop