Skip to main content
GET
Get encounter

Path Parameters

encounter_id
string
required

Response

Encounter record

Encounter resource representation.

encounter_id
string
required

Unique encounter identifier

description
string
required

Brief description of the encounter scenario

project_id
string
required

Project this encounter belongs to

external_id
string | null

Human-readable slug for the URL (/projects/<slug>/encounters/<external_id>). Derived from description at create time and immutable. May be null on rows that pre-date migration 102 backfill - frontend falls back to id. See docs/conventions/dashboard-slug-urls.md.

status
string
default:brainstorm

Lifecycle status: brainstorm | draft | final

difficulty
string
default:medium

Encounter difficulty level

session_id
string | null

Active generation session ID, if any

created_at
string<date-time> | null

ISO 8601 creation timestamp

token_url
string | null

URL of a generated battle-map / token image when generate_token=true was passed and image generation succeeded. Null otherwise.