Publish
Artifact publishing: structured and semi-structured work normalized to one representation and rendered cleanly.
partLines of business22 operationsid publish
How it sits
A part does one thing, and any other part can call it. The counts and the links below are from the platform's spec and the other services' own descriptions.
| Operations | 22 GET 12 · POST 6 · DELETE 3 · PUT 1 |
| Resources | 9 |
| Leaned on by | Snail mail |
| Leans on | Intel |
| In recipes | none yet |
What it can do
22 operations in 9 resources, as the spec declares them. Each row is one call; paths are relative to the part.
artifacts
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/artifacts | List artifacts |
| POST | /api/v1/artifacts | Ingest an artifact |
| DELETE | /api/v1/artifacts/{artifact_id} | Soft-delete an artifact |
| GET | /api/v1/artifacts/{artifact_id} | Get an artifact |
| GET | /api/v1/artifacts/{artifact_id}/normalized | Normalize an artifact to its canonical IR |
5 operations
templates
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/templates | List templates |
| POST | /api/v1/templates | Create a template |
| DELETE | /api/v1/templates/{template_id} | Soft-delete a template |
| GET | /api/v1/templates/{template_id} | Get a template |
| PUT | /api/v1/templates/{template_id} | Update a template |
5 operations
workproducts
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/workproducts | List work products |
| DELETE | /api/v1/workproducts/{wp_id} | Soft-delete a work product |
| GET | /api/v1/workproducts/{wp_id} | Get a work product |
| GET | /api/v1/workproducts/{wp_id}/raw | Get a work product's rendered body (raw) |
| POST | /api/v1/workproducts/{wp_id}/upload | Push a work product's rendered body to a presigned share URL |
5 operations
health
| Method | Path | Does |
|---|---|---|
| GET | /health | Basic health check |
| GET | /health/detailed | Detailed health check |
2 operations
designs
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/designs | Render a design (HTML + page spec) to print PDF / PNG, with the text read back |
1 operation
documents
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/documents | Assemble + render a full document (PDF/HTML) |
1 operation
prime
| Method | Path | Does |
|---|---|---|
| GET | /prime | Prime application caches |
1 operation
publish
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/publish | Publish a work product |
1 operation
status
| Method | Path | Does |
|---|---|---|
| GET | /status | Service status overview |
1 operation
All the partsLines of businessThe platform's own id for this service is cbpublish.
forge-catalog.json, generated Oct 30, 2026