Skip to main content
POST
Create quest

Body

application/json

POST /v1/projects/{project_id}/quests

title
string
required
Required string length: 1 - 200
summary
string | null
Maximum string length: 5000
status
string
default:offered
quest_giver_npc_id
string | null
location_id
string | null
reward_item_ids
string<uuid>[]
objectives
QuestObjective · object[]
notes
string | null
Maximum string length: 50000
tags
string[]
Maximum string length: 50

Response

Quest created

Quest resource representation.

id
string
required
title
string
required
status
string
required
project_id
string
required
external_id
string | null

Human-readable slug for the URL (/projects/<slug>/quests/<external_id>). Derived from title at create time and immutable across renames. May be null on legacy rows pre-migration 102 - frontend falls back to id.

summary
string | null
quest_giver_npc_id
string | null
location_id
string | null
reward_item_ids
string<uuid>[]
objectives
QuestObjective · object[]
notes
string | null
completed_session_id
string | null
tags
string[]
created_at
string<date-time> | null