---
title: "Generate a dynamic Open Graph image for a passage"
method: GET
path: "/og/{ref}"
tags: ["OG Images"]
---

# Generate a dynamic Open Graph image for a passage

`GET /og/{ref}`

Returns a 1200×630 PNG Open Graph image for a Urantia Book passage. Designed for social media previews.

Optional `?theme=` parameter: `default` (blue), `warm` (amber), `purple`, `minimal` (no glow).

Images are cached permanently (`Cache-Control: immutable`).

## Path parameters

- `ref` string, required

## Query parameters

- `theme` 'default' | 'warm' | 'purple' | 'minimal'

## Response `200`

PNG image

## Other responses

- `404` — Paragraph not found

---

[API](https://skmtc.dev/urantia/apis/urantia-papers-api.md) · [All operations](https://skmtc.dev/urantia/apis/urantia-papers-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/urantia/urantia-papers-api/revisions/6a8c13929fda/schema)