Social
The bridge to consumer messaging platforms: messages in, summaries out.
partReaching people57 operationsid social
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
57 operations in 16 resources, as the spec declares them. Each row is one call; paths are relative to the part.
accounts
| Method | Path | Does |
|---|---|---|
| GET | /api/accounts | List WhatsApp accounts |
| POST | /api/accounts | Create a new account (begins QR pairing) |
| DELETE | /api/accounts/{account_id} | Delete a WhatsApp account |
| GET | /api/accounts/{account_id} | Get account status |
| GET | /api/accounts/{account_id}/chats | List chats for an account |
| GET | /api/accounts/{account_id}/chats/{jid} | Chat detail with recent messages |
| GET | /api/accounts/{account_id}/media/{jid}/{filename} | Serve a media file scoped to an account |
| GET | /api/accounts/{account_id}/messages | List messages for an account |
| GET | /api/accounts/{account_id}/messages/{jid} | List messages for a JID under an account |
| GET | /api/accounts/{account_id}/qr | Pairing QR code (PNG) |
| GET | /api/accounts/{account_id}/qr.json | Pairing QR code (JSON) |
| POST | /api/accounts/{account_id}/restart | Restart account session |
| POST | /api/accounts/{account_id}/send | Send a WhatsApp message |
| DELETE | /api/accounts/{account_id}/webhook | Clear the webhook config |
| GET | /api/accounts/{account_id}/webhook | Read the webhook config (secret redacted) |
| PUT | /api/accounts/{account_id}/webhook | Set the per-account incoming-message webhook (mints a fresh secret) |
16 operations
connections
| Method | Path | Does |
|---|---|---|
| GET | /api/v2/connections | List connections |
| DELETE | /api/v2/connections/{connection_id} | Disconnect a connection |
| GET | /api/v2/connections/{connection_id} | Get a connection |
| DELETE | /api/v2/connections/{connection_id}/grants | Withdraw a user or group grant |
| POST | /api/v2/connections/{connection_id}/grants | Share a connection with a user or group |
| POST | /api/v2/connections/{connection_id}/publish | Publish a post, at most once |
6 operations
processed
| Method | Path | Does |
|---|---|---|
| GET | /api/processed | List processed runs |
| GET | /api/processed/{run_id} | Get a processed run (manifest + Markdown) |
| GET | /api/processed/{run_id}/media/{filename} | Serve media from a processed run |
| GET | /processed | Processed runs index (HTML) |
| GET | /processed/{run_id} | Processed run detail (HTML) |
| GET | /processed/{run_id}/media/{filename} | Serve run media for rendered pages |
6 operations
slack
| Method | Path | Does |
|---|---|---|
| GET | /api/slack/accounts | List Slack slots |
| POST | /api/slack/accounts | Register a Slack slot |
| DELETE | /api/slack/accounts/{slot_id} | Delete a Slack slot |
| GET | /api/slack/accounts/{slot_id} | Get a Slack slot |
| POST | /api/slack/accounts/{slot_id}/send | Send a Slack message via a slot |
| POST | /api/slack/send | Send a Slack alert routed to the caller's slot |
6 operations
gists
| Method | Path | Does |
|---|---|---|
| GET | /api/gists | List gist metadata |
| POST | /api/gists/generate | Regenerate all gists now |
| GET | /api/gists/{jid} | Get a chat's gist |
| GET | /gists | Chat gists index (HTML) |
| GET | /gists/{jid} | Chat gist detail (HTML) |
5 operations
oauth
| Method | Path | Does |
|---|---|---|
| POST | /api/v2/oauth/complete | Finish connecting: exchange the platform's code |
| POST | /api/v2/oauth/select | Choose which Facebook Page to connect |
| GET | /api/v2/oauth/setup | Is OAuth connecting set up? |
| POST | /api/v2/oauth/start | Start connecting a platform account |
4 operations
chats
| Method | Path | Does |
|---|---|---|
| GET | /api/chats | List all chats across accounts |
| GET | /api/chats/{jid} | Chat detail with recent messages |
2 operations
health
| Method | Path | Does |
|---|---|---|
| GET | /health | Basic health check |
| GET | /health/detailed | Detailed health check |
2 operations
messages
| Method | Path | Does |
|---|---|---|
| GET | /api/messages | List messages across all accounts |
| GET | /api/messages/{jid} | List messages for a JID (all accounts) |
2 operations
publishes
| Method | Path | Does |
|---|---|---|
| GET | /api/v2/publishes/{idempotency_key} | Read a publish outcome |
| POST | /api/v2/publishes/{idempotency_key}/release | Release a publish a person checked did not go out |
2 operations
media
| Method | Path | Does |
|---|---|---|
| GET | /api/media/{jid}/{filename} | Serve a media file (searches all accounts) |
1 operation
prime
| Method | Path | Does |
|---|---|---|
| GET | /prime | Prime application caches |
1 operation
process
| Method | Path | Does |
|---|---|---|
| POST | /api/process | Run the consolidation pipeline |
1 operation
reload
| Method | Path | Does |
|---|---|---|
| POST | /api/reload | Reload the message archive from disk |
1 operation
send
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/send | Send a WhatsApp message routed by X-User-Id (Social#13 contract) |
1 operation
status
| Method | Path | Does |
|---|---|---|
| GET | /status | Service status overview |
1 operation
All the partsReaching peopleThe platform's own id for this service is cbsocial.
forge-catalog.json, generated Oct 30, 2026