Changelog Entry
Each agent gets its own changelog displayed on a tab of its detail page.
Schema (agent_changelog)
| Column | Type | Notes |
|---|---|---|
id | UUID | PK |
agentId | UUID | FK → agents |
version | text | Free-form, e.g. v1.2.0, 2026-05-14 |
summary | text | One-paragraph release note |
publishedAt | timestamptz | Display sort key (newest first) |
Endpoints
| Verb | Path | Guard |
|---|---|---|
| GET | /agents/:agentId/changelog | public |
| POST | /agents/:agentId/changelog | platform_admin |
| DELETE | /agents/:agentId/changelog/:entryId | platform_admin |
DTO
type ChangelogEntryDto = {
id: string;
version: string;
summary: string;
publishedAt: string;
};
Conventions
Keep the summary short (≤ 200 chars). The detail page renders the whole list inline. For deep release notes, link out to the agent's external changelog URL (the agents.changelogUrl field).
Not to be confused with
- Marketplace release notes — the docs site has its own changelog at /12-changelog/release-notes covering the platform itself. Per-agent changelog is separate.