Share-card
Share card generation — PnL cards, market cards, and background management.
The Share-card API provides share card generation — pnl cards, market cards, and background management.
Endpoints
| Method | Path | Auth | Description |
|---|---|---|---|
| POST | /api/v1/share-card/generate | Bearer | Generate a share card image |
| POST | /api/v1/share-card/publish | Bearer | Publish a client-rendered share card PNG |
| POST | /api/v1/share-card/background/upload | Bearer | Upload a custom background image (base64 JSON body) |
| POST | /api/v1/share-card/background/presign | Bearer | Issue a pre-signed PUT URL for direct Spaces upload |
| POST | /api/v1/share-card/background/finalize | Bearer | Finalize a pre-signed upload — validates and creates the Background row |
| DELETE | /api/v1/share-card/background/{id} | Bearer | Delete one of the caller's uploaded backgrounds |
| GET | /api/v1/share-card/{jobId} | Bearer | Get share card generation status |
| GET | /api/v1/share-card/data | Bearer | Get hydrated share card data |
| GET | /api/v1/share-card/background/presets | Public | List curated preset + themed-event backgrounds |
| GET | /api/v1/share-card/background/mine | Bearer | List the current user's uploaded backgrounds (any status) |