Lists
Durable lists and audiences: ingest, normalize, dedup, geocode, score, tag, export.
partData36 operationsid list
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.
What it can do
36 operations in 8 resources, as the spec declares them. Each row is one call; paths are relative to the part.
segments
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/segments | List saved segments |
| POST | /api/v1/segments | Create a segment |
| GET | /api/v1/segments/fields | Filterable fields for one source |
| POST | /api/v1/segments/preview | Evaluate an unsaved segment definition |
| GET | /api/v1/segments/sources | Pools this user can build a segment over |
| GET | /api/v1/segments/values | Distinct values of one field, for a searchable picker |
| DELETE | /api/v1/segments/{segment_id} | Soft-delete a segment |
| GET | /api/v1/segments/{segment_id} | Get one segment |
| PATCH | /api/v1/segments/{segment_id} | Update a segment |
| POST | /api/v1/segments/{segment_id}/activate | Push a segment to a delivery platform (not implemented) |
| POST | /api/v1/segments/{segment_id}/execute | Re-evaluate a saved segment and record the run |
| POST | /api/v1/segments/{segment_id}/export | Freeze a segment's membership as a versioned snapshot |
| GET | /api/v1/segments/{segment_id}/history | Recent runs for a segment |
| GET | /api/v1/segments/{segment_id}/members | Resolve a segment to recipients for a send channel |
| GET | /api/v1/segments/{segment_id}/projection | Projected outcome for a segment, from the CC scoring expectations |
15 operations
lists
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/lists | List all lists |
| POST | /api/v1/lists | Create a list |
| DELETE | /api/v1/lists/{list_id} | Soft-delete a list |
| GET | /api/v1/lists/{list_id} | Get one list |
| PATCH | /api/v1/lists/{list_id} | Update a list |
| POST | /api/v1/lists/{list_id}/enrich | Enrich a list: geocode → district |
| GET | /api/v1/lists/{list_id}/members | Resolve a list to recipients for a send channel |
| POST | /api/v1/lists/{list_id}/promote | Promote rows to CRM golden persons |
| GET | /api/v1/lists/{list_id}/rows | Get rows (paginated) |
| POST | /api/v1/lists/{list_id}/rows | Append rows |
10 operations
ingest
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/ingest | Upload a file, parse it, and suggest a mapping |
| GET | /api/v1/ingest/{job_id} | Get an ingest job |
| POST | /api/v1/ingest/{job_id}/execute | Commit the ingest into the list |
| PUT | /api/v1/ingest/{job_id}/mappings | Override the column mapping |
4 operations
health
| Method | Path | Does |
|---|---|---|
| GET | /health | Basic health check |
| GET | /health/detailed | Detailed health check |
2 operations
internal
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/internal/enrich/sweep | Drain one enrichment window for EVERY tenant (Cron) |
| POST | /api/v1/internal/enrich/tick | Drain one enrichment-job window (Cron) |
2 operations
enrich-jobs
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/enrich-jobs/{job_id} | Poll an async enrichment job |
1 operation
prime
| Method | Path | Does |
|---|---|---|
| GET | /prime | Prime application caches |
1 operation
status
| Method | Path | Does |
|---|---|---|
| GET | /status | Service status overview |
1 operation
All the partsDataThe platform's own id for this service is cblist.
forge-catalog.json, generated Oct 30, 2026