List worlds

GET

/spaces/maps

const url = 'https://spaces.work.optidata.cloud/api/spaces/maps';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://spaces.work.optidata.cloud/api/spaces/maps \
  --header 'Authorization: Bearer <token>'

Every world of your company, active and drafts, without their map documents. Builders only.

Authorizations

bearerAuth

Responses

200

The company’s worlds.

application/json

object

maps

required

Array<object>

object

identifier

required

string

name

required

string

source_map

The world this one was copied from, if any.

string | null

status

required

string

Allowed values: draft active

is_active

required

boolean

version

required

Grows with every saved change.

integer

activated_at

string | null format: date-time

created_by_uuid

string | null

updated_by_uuid

string | null

created_at

string format: date-time

updated_at

string format: date-time

Examples

worlds

{
  "maps": [
    {
      "identifier": "a28e5bf3-26b4-4a34-9f98-9a116a2700ca",
      "name": "Head office",
      "source_map": null,
      "status": "active",
      "is_active": true,
      "version": 8,
      "activated_at": "2026-08-24T15:27:23-03:00",
      "created_by_uuid": "2d9e8f70-1a3b-4c5d-8e9f-a0b1c2d3e4f5",
      "updated_by_uuid": "2d9e8f70-1a3b-4c5d-8e9f-a0b1c2d3e4f5",
      "created_at": "2026-08-21T11:38:37-03:00",
      "updated_at": "2026-08-24T15:27:23-03:00"
    },
    {
      "identifier": "a294b231-90a1-49d2-9170-410890f299e1",
      "name": "Head office — new meeting rooms",
      "source_map": "a28e5bf3-26b4-4a34-9f98-9a116a2700ca",
      "status": "draft",
      "is_active": false,
      "version": 2,
      "activated_at": null,
      "created_by_uuid": "2d9e8f70-1a3b-4c5d-8e9f-a0b1c2d3e4f5",
      "updated_by_uuid": "2d9e8f70-1a3b-4c5d-8e9f-a0b1c2d3e4f5",
      "created_at": "2026-08-24T15:14:44-03:00",
      "updated_at": "2026-08-24T15:20:47-03:00"
    }
  ]
}

401

No authentication key was sent.

application/json

Authentication failures use an error key rather than message.

object

error

required

string

Examples

missing

No bearer token sent

{
  "error": "JWT passport exception: Missing bearer token in request"
}

403

The caller is not allowed to do this (see “Who may do what”), or the authentication key is not recognised (empty message).

application/json

object

message

required

string

Examples

Not the space's owner

{
  "message": "You do not have permission to update this space."
}

Not a builder

{
  "message": "You do not have permission to view this map."
}

Not a super-administrator

{
  "message": "You do not have permission to activate this map."
}

419

The authentication key is expired or not recognised. Get a fresh one and retry.

application/json

Authentication failures use an error key rather than message.

object

error

required

string

Examples

expired

{
  "error": "JWT passport expired: Passport expired"
}