Definitions and schemas
Postforge's typed definitions (automations, segments, templates, campaigns), their JSON Schemas, versions and change proposals.
Automations, segments, templates, campaigns and the brand kit are definitions: typed JSON documents with immutable versions. The same schema validates the API, drives the dashboard's editor and is published for agents.
Schemas
GET /v1/schemaslists every kind with its resource, label and currentschemaVersion.GET /v1/schemas/{kind}answers the JSON Schema of one kind.
Validate a document against its schema before you send it; the API refuses an invalid one with a validation problem listing each invalid path.
Versions
Every save creates a new, immutable version with its author. A definition has a draft and, once published, a published version; you can read any earlier version and restore it.
Change proposals
A propose key, the in-app assistant and AI clients never change a definition directly: they
create a change proposal with the proposed document, a summary and a diff from the current
draft. A person approves or rejects it in the dashboard. That keeps every change an AI drafts
behind a human decision.