Worlds API

Create and manage worlds in Narrative Protocol.

Endpoints

List Worlds

GET /api/worlds?page=1&limit=20

Create World

POST /api/worlds

Request Body

{
  "name": "Horse Racing",
  "description": "A horse racing simulation world",
  "domainTags": ["sports", "simulation"],
  "promptSeed": "This world simulates realistic horse racing events."
}

Field	Type	Required	Description
`name`	`string`	Yes	World name, 1-255 chars.
`description`	`string`	No	Human-readable description.
`domainTags`	`string[]`	No	Domain/category tags. Defaults to `[]`.
`promptSeed`	`string`	No	Base context used for event execution prompts.

Get World

GET /api/worlds/:idOrAddress

Supports both numeric ID (e.g., 39) or hex address (e.g., 0x1234...).

Update World

PUT /api/worlds/:idOrAddress

Request Body

{
  "name": "Horse Racing v2",
  "description": "Updated description",
  "domainTags": ["sports", "simulation", "strategy"],
  "promptSeed": "Updated world guidance"
}

Field	Type	Required	Description
`name`	`string`	No	Same as create; updates world name.
`description`	`string`	No	Same as create; updates description.
`domainTags`	`string[]`	No	Same as create; updates domain tags.
`promptSeed`	`string`	No	Same as create; updates prompt seed.

Publish World

POST /api/worlds/:idOrAddress/publish

Unpublish World

POST /api/worlds/:idOrAddress/unpublish

Delete World

DELETE /api/worlds/:idOrAddress