Skip to main content
POST
/
context
/
region
/
{game_id}
/
{world_id}
Create a new region
curl --request POST \
  --url https://app.npcbuilder.com/api/context/region/{game_id}/{world_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "lore": "A dense forest with hidden secrets.",
  "name": "Mystic Forest",
  "weather": "Rainy",
  "culture": "Druidic traditions",
  "politicalStability": "stable"
}
'
{
  "message": "Region: region789 has been created with the following context.",
  "region_id": "region789",
  "region_context": {
    "lore": "A dense forest with hidden secrets.",
    "name": "Mystic Forest",
    "weather": "Rainy",
    "culture": "Druidic traditions",
    "politicalStability": "stable"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
game_id
string
required

The unique identifier for the game.

Example:

"game123"

​
world_id
string
required

The unique identifier for the world.

Example:

"world456"

Query Parameters

​
session_id
string

(Optional) The player's session ID.

Example:

"60Z5aZjIuFlyYbjbZZKe"

Body

application/json

The region data required for creating a new region.

​
lore
string

Background lore of the region.

Example:

"A dense forest with hidden secrets."

​
name
string

The name of the region.

Example:

"Mystic Forest"

​
weather
string

Typical weather conditions in the region.

Example:

"Rainy"

​
culture
string

Cultural aspects or traditions of the region.

Example:

"Druidic traditions"

​
politicalStability
enum<string>

The political stability status of the region.

Available options:
none,
highlyStable,
stable,
moderatelyStable,
unstable,
highlyUnstable,
anarchy
Example:

"stable"

Response

Region created successfully.

​
message
string

Confirmation message for region creation.

Example:

"Region: region789 has been created with the following context."

​
region_id
string

UID of the region.

Example:

"region789"

​
region_context
object

The context details of the created region.

Example:
{
  "lore": "A dense forest with hidden secrets.",
  "name": "Mystic Forest",
  "weather": "Rainy",
  "culture": "Druidic traditions",
  "politicalStability": "stable"
}