Skip to content
DARK
PAWNS

A Multi-User DungeonEST. 1994

Open a room OLC draft

Look up the Dark Pawns admin API request and response contract. Sign in with a level 40 character and use the authenticated admin console session.

POST
/admin/olc/room/{vnum}
curl --request POST \
  --url https://example.com/admin/olc/room/example

Claims a room lease and opens or recovers the player’s in-memory REDIT working copy.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
vnum
required

Room VNUM.

string

Room VNUM.

Responses

Section titled “Responses”

200

Section titled “200”

OK

Media typeapplication/json
object
dirty
required
Array<string> | null
kind
required
string
lease_expires_at
required
string format: date-time
lease_remaining_seconds
required
integer format: int64
room
required
object
Description
required
string
Exits
required
object
key
additional properties
object
Description
required
string
Direction
required
string
DoorState
required
integer format: int64
ExitInfo
required
integer format: int64
Key
required
integer format: int64
Keywords
required
string
ToRoom
required
integer format: int64
ExtraDescs
required
Array<object> | null
object
Description
required
string
Keywords
required
string
Flags
required
Array<string> | null
Light
required
integer format: int64
Name
required
string
ScriptFunctions
required
integer format: int64
ScriptName
required
string
Sector
required
integer format: int64
VNum
required
integer format: int64
Zone
required
integer format: int64
vnum
required
integer format: int64

Example generated

{
  "dirty": [
    "example"
  ],
  "kind": "example",
  "lease_expires_at": "2026-04-15T12:00:00Z",
  "lease_remaining_seconds": 1,
  "room": {
    "Description": "example",
    "Exits": {
      "additionalProperty": {
        "Description": "example",
        "Direction": "example",
        "DoorState": 1,
        "ExitInfo": 1,
        "Key": 1,
        "Keywords": "example",
        "ToRoom": 1
      }
    },
    "ExtraDescs": [
      {
        "Description": "example",
        "Keywords": "example"
      }
    ],
    "Flags": [
      "example"
    ],
    "Light": 1,
    "Name": "example",
    "ScriptFunctions": 1,
    "ScriptName": "example",
    "Sector": 1,
    "VNum": 1,
    "Zone": 1
  },
  "vnum": 1
}

default

Section titled “default”

Error

Media typeapplication/problem+json
object
detail

A human-readable explanation specific to this occurrence of the problem.

string
errors

Optional list of individual error details

Array<object> | null
object
location

Where the error occurred, e.g. ‘body.items[3].tags’ or ‘path.thing-id’

string
message

Error message text

string
value

The value at the given location

instance

A URI reference that identifies the specific occurrence of the problem.

string format: uri
status

HTTP status code

integer format: int64
title

A short, human-readable summary of the problem type. This value should not change between occurrences of the error.

string
type

A URI reference to human-readable documentation for the error.

string format: uri
default: about:blank

Example 

{
  "detail": "Property foo is required but is missing.",
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}