Mirror
Frozen, versioned snapshots of every package source a machine needs, served to the platform's own boxes.
partRunning the shop47 operationsid mirror
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 | 47 GET 30 · POST 12 · DELETE 3 · PATCH 2 |
| Resources | 13 |
| Leaned on by | no other service names it |
| Leans on | Auth |
| In recipes | none yet |
What it can do
47 operations in 13 resources, as the spec declares them. Each row is one call; paths are relative to the part.
releases
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/releases | List releases |
| POST | /api/v1/releases | Create a draft release |
| GET | /api/v1/releases/{release_id} | Get a release |
| PATCH | /api/v1/releases/{release_id} | Edit a draft release |
| GET | /api/v1/releases/{release_id}/bootstrap | Get bootstrap config pinned to a release |
| POST | /api/v1/releases/{release_id}/deprecate | Deprecate a release |
| GET | /api/v1/releases/{release_id}/diff | Diff two releases |
| GET | /api/v1/releases/{release_id}/manifest | Get a release's signed manifest |
| POST | /api/v1/releases/{release_id}/publish | Publish a release |
| GET | /api/v1/releases/{release_id}/revisions | List a release's history |
| POST | /api/v1/releases/{release_id}/revoke | Revoke a release |
11 operations
mirrors
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/mirrors | List mirrors |
| POST | /api/v1/mirrors | Create a mirror |
| DELETE | /api/v1/mirrors/{mirror_id} | Soft-delete a mirror |
| GET | /api/v1/mirrors/{mirror_id} | Get a mirror |
| PATCH | /api/v1/mirrors/{mirror_id} | Update a mirror's config |
| GET | /api/v1/mirrors/{mirror_id}/revisions | List a mirror's config history |
| POST | /api/v1/mirrors/{mirror_id}/snapshots | Freeze a mirror into a snapshot |
| POST | /api/v1/mirrors/{mirror_id}/sync | Sync a mirror from upstream |
8 operations
channels
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/channels | List channels |
| POST | /api/v1/channels | Create a channel |
| GET | /api/v1/channels/{channel_id} | Get a channel |
| POST | /api/v1/channels/{channel_id}/promote | Point a channel at a release |
| GET | /api/v1/channels/{channel_id}/revisions | List a channel's promotion history |
| POST | /api/v1/channels/{channel_id}/rollback | Roll a channel back |
6 operations
captures
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/captures | List captures |
| POST | /api/v1/captures | Upload a crawler capture |
| DELETE | /api/v1/captures/{capture_id} | Soft-delete a capture |
| GET | /api/v1/captures/{capture_id} | Get a capture summary |
| GET | /api/v1/captures/{capture_id}/inventory | Page through a capture's packages |
5 operations
snapshots
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/snapshots | List snapshots |
| DELETE | /api/v1/snapshots/{snapshot_id} | Soft-delete a snapshot |
| GET | /api/v1/snapshots/{snapshot_id} | Get a snapshot |
| GET | /api/v1/snapshots/{snapshot_id}/artifacts | List a snapshot's packages |
| GET | /api/v1/snapshots/{snapshot_id}/diff | Diff two snapshots |
5 operations
jobs
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/jobs | List jobs |
| GET | /api/v1/jobs/{job_id} | Get a job |
| POST | /api/v1/jobs/{job_id}/cancel | Cancel a job |
| GET | /api/v1/jobs/{job_id}/log | Read a job's log |
4 operations
health
| Method | Path | Does |
|---|---|---|
| GET | /health | Basic health check |
| GET | /health/detailed | Detailed health check |
2 operations
auth
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/auth/capabilities | Write capability of the caller |
1 operation
bootstrap
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/bootstrap/{channel_name} | Get bootstrap config for a channel |
1 operation
drivers
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/drivers | Check each driver's dependencies |
1 operation
prime
| Method | Path | Does |
|---|---|---|
| GET | /prime | Prime application caches |
1 operation
status
| Method | Path | Does |
|---|---|---|
| GET | /status | Service status overview |
1 operation
workers
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/workers | List job workers |
1 operation
All the partsRunning the shopThe platform's own id for this service is cbmirror.
forge-catalog.json, generated Oct 30, 2026