API reference

Create and manage cards programmatically. Authenticate with your API key from the dashboard.

Authentication

Authorization: Bearer ogf_your_api_key
# or
X-API-Key: ogf_your_api_key

The render URL (no auth — this is what you embed)

GET https://ogforge.raul.codes/i/{slug}.png

# override any field per-request via query params:
https://ogforge.raul.codes/i/{slug}.png?title=Launch+day&subtitle=We+shipped+it&accent=%23ef4444

Returns an image/png, 1200×630, cached 24h. Supported params: title, subtitle, eyebrow, badge, accent, bg, logo, brand.

Create a card

curl -X POST https://ogforge.raul.codes/api/v1/cards \
  -H "Authorization: Bearer ogf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Blog post card",
    "template": "editorial",
    "title": "How we cut render costs by 90%",
    "subtitle": "A deep dive into SVG rasterization",
    "eyebrow": "Engineering",
    "accent_color": "#10b981",
    "destination_url": "https://example.com/blog/render-costs"
  }'

Response includes image_url, smart_link, and share_url.

Other endpoints

GET    /api/v1/me               # plan + usage
GET    /api/v1/cards            # list your cards
GET    /api/v1/cards/{slug}     # fetch one
PATCH  /api/v1/cards/{slug}     # update
DELETE /api/v1/cards/{slug}     # delete

Templates

spotlight  # bold centered title on a brand gradient
editorial  # left-aligned article card with eyebrow + logo
product    # launch card with badge, title and subtitle
minimal    # clean light card with a brand accent bar

Get an API key