---
title: "Generate a scene using oracle tables. With a recipe, rolls each table in the recipe, resolves cross-references, and composes a narrative sentence. Without, picks random tables."
method: POST
path: "/api/tools/oracle_scene"
---

# Generate a scene using oracle tables. With a recipe, rolls each table in the recipe, resolves cross-references, and composes a narrative sentence. Without, picks random tables.

`POST /api/tools/oracle_scene`

## Request

- Base URL: `https://tools.moddable.games`
- URL: `https://tools.moddable.games/api/tools/oracle_scene`
- Auth: none declared

## Request body

- object
  - `system` string: RPG system slug (default: ironsworn)
  - `recipe` string: Recipe ID (from oracle_list_recipes) — rolls each table in the recipe
  - `region` 'terminus' | 'outlands' | 'expanse': Region for Starforged region-aware recipes
  - `type` 'location' | 'npc' | 'event' | 'combat': Scene type for random mode (default: event)

## Response `200`

Tool result

---

[API](https://skmtc.dev/moddable/apis/moddable-games-tools.md) · [All operations](https://skmtc.dev/moddable/apis/moddable-games-tools/llms.txt) · [OpenAPI document](https://skmtc.dev/moddable/apis/moddable-games-tools/revisions/637a0b62cb9a?raw)