Skip to content

List worlds

GET
/api/v1/worlds
curl --request GET \
--url http://localhost:11044/api/v1/worlds \
--header 'X-Embabel-Api-Key: <X-Embabel-Api-Key>'

Lists all worlds for the current user.

World listing

Media type*/*

Every world this user has, and which one they are in

object
current
required

The world the user is currently in, by name

string
worlds
required

Every world discovered on disk for this user, sorted by name

Array<object>

One of a user’s worlds, as the listing describes it

object
active
required

Whether this is the world the user is currently in

boolean
name
required

The world’s name, which is what the other endpoints take in the path

string
path
required

Where the world lives on the appliance’s disk

string