List builders

GET

/spaces/builders

const url = 'https://spaces.work.optidata.cloud/api/spaces/builders';
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/builders \
  --header 'Authorization: Bearer <token>'

The people allowed to design the company’s worlds, newest grant first. name and email are null for a person Spaces does not know yet. Company super-administrators only.

Authorizations

bearerAuth

Responses

200

The builders.

application/json

object

builders

required

Array<object>

object

uuid

required

string

name

string | null

email

string | null

granted_by_uuid

required

string | null

created_at

required

string format: date-time

Examples

builders

{
  "builders": [
    {
      "uuid": "5b1c7e22-9d40-4f6a-b3c8-1e2f3a4b5c6d",
      "name": "Bruno Lima",
      "email": "bruno.lima@example.com",
      "granted_by_uuid": "2d9e8f70-1a3b-4c5d-8e9f-a0b1c2d3e4f5",
      "created_at": "2026-08-24T11:38:15-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"
}