> ## Documentation Index
> Fetch the complete documentation index at: https://urantia.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Generate OG Image

> 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`).



## OpenAPI

````yaml GET /og/{ref}
openapi: 3.1.0
info:
  title: Urantia Papers API
  version: 1.0.0
  description: >-
    A developer and AI-agent friendly API for the Urantia Papers. Provides
    full-text search, structured content access, and audio URLs for all 17,000+
    paragraphs across 197 papers.
servers:
  - url: https://api.urantia.dev
    description: Production
  - url: http://localhost:3000
    description: Local development
security: []
paths:
  /og/{ref}:
    get:
      tags:
        - OG Images
      summary: Generate a dynamic Open Graph image for a passage
      description: >-
        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`).
      operationId: getOgImage
      parameters:
        - schema:
            type: string
          required: true
          name: ref
          in: path
        - schema:
            type: string
            enum:
              - default
              - warm
              - purple
              - minimal
            default: default
          required: false
          name: theme
          in: query
      responses:
        '200':
          description: PNG image
        '404':
          description: Paragraph not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  type:
                    type: string
                  title:
                    type: string
                  status:
                    type: integer
                  detail:
                    type: string
                required:
                  - type
                  - title
                  - status
                  - detail

````