Web world instances

Info for a specific world

get

Path parameters

projectIdstringRequired

The id of the project the world is in

worldIdstringRequired

The id of the world to retrieve

Responses

200

Expected response to a valid request

application/json

idstringRequired

namestringRequired

descriptionstringOptional

createdAtstringRequired

createdByone ofRequired

or

urlstringRequired

enableTweakPanebooleanOptional

default

An error occurred

application/json

get/v1/worlds/{projectId}/web-world-instances/{worldId}

HTTPcURLJavaScriptPython

GET /v1/worlds/{projectId}/web-world-instances/{worldId} HTTP/1.1
Host: localhost:3050
Accept: */*

{
  "id": "text",
  "name": "text",
  "description": "text",
  "generalConfiguration": {
    "maxUserConnections": 1
  },
  "chatConfiguration": {
    "enabled": true
  },
  "authConfiguration": {
    "allowAnonymous": true,
    "password": "text",
    "authProviders": {
      "webhook": {
        "webhookUrl": "text"
      },
      "google": {
        "allowedOrganizations": [
          "text"
        ],
        "allowedUsers": [
          "text"
        ]
      },
      "discord": {
        "allowedUsers": [
          "text"
        ]
      }
    }
  },
  "mmlDocumentsConfiguration": {
    "mmlDocuments": {
      "ANY_ADDITIONAL_PROPERTY": {
        "url": "text",
        "position": {
          "x": 1,
          "y": 1,
          "z": 1
        },
        "rotation": {
          "x": 1,
          "y": 1,
          "z": 1
        },
        "scale": {
          "x": 1,
          "y": 1,
          "z": 1
        }
      }
    }
  },
  "environmentConfiguration": {
    "groundPlane": true,
    "skybox": {
      "intensity": 1,
      "blurriness": 1,
      "azimuthalAngle": 1,
      "polarAngle": 1
    },
    "envMap": {
      "intensity": 1
    },
    "sun": {
      "intensity": 1,
      "polarAngle": 1,
      "azimuthalAngle": 1
    },
    "postProcessing": {
      "bloomIntensity": 1
    },
    "ambientLight": {
      "intensity": 1
    }
  },
  "avatarConfiguration": {
    "availableAvatars": [
      {
        "isDefaultAvatar": true,
        "meshFileUrl": "text",
        "mmlCharacterString": null,
        "mmlCharacterUrl": null,
        "thumbnailUrl": "text",
        "name": "text"
      }
    ],
    "allowCustomAvatars": true,
    "customAvatarWebhookUrl": "text"
  },
  "createdAt": "text",
  "createdBy": {
    "userId": "text",
    "type": "user"
  },
  "url": "text",
  "enableTweakPane": true
}

Edit a world

post

Path parameters

projectIdstringRequired

The id of the project the world is in

worldIdstringRequired

The id of the world to edit

Body

application/json

namestringOptional

descriptionstringOptional

enableTweakPanebooleanOptional

Responses

200

Expected response to a valid request

application/json

idstringRequired

namestringRequired

descriptionstringOptional

createdAtstringRequired

createdByone ofRequired

or

urlstringRequired

enableTweakPanebooleanOptional

default

An error occurred

application/json

post/v1/worlds/{projectId}/web-world-instances/{worldId}

HTTPcURLJavaScriptPython

POST /v1/worlds/{projectId}/web-world-instances/{worldId} HTTP/1.1
Host: localhost:3050
Content-Type: application/json
Accept: */*
Content-Length: 1043

{
  "name": "text",
  "description": "text",
  "generalConfiguration": {
    "maxUserConnections": 1
  },
  "mmlDocumentsConfiguration": {
    "mmlDocuments": {
      "ANY_ADDITIONAL_PROPERTY": {
        "url": "text",
        "position": {
          "x": 1,
          "y": 1,
          "z": 1
        },
        "rotation": {
          "x": 1,
          "y": 1,
          "z": 1
        },
        "scale": {
          "x": 1,
          "y": 1,
          "z": 1
        }
      }
    }
  },
  "authConfiguration": {
    "allowAnonymous": true,
    "password": "text",
    "authProviders": {
      "webhook": {
        "webhookUrl": "text"
      },
      "google": {
        "allowedOrganizations": [
          "text"
        ],
        "allowedUsers": [
          "text"
        ]
      },
      "discord": {
        "allowedUsers": [
          "text"
        ]
      }
    }
  },
  "chatConfiguration": {
    "enabled": true
  },
  "environmentConfiguration": {
    "groundPlane": true,
    "skybox": {
      "intensity": 1,
      "blurriness": 1,
      "azimuthalAngle": 1,
      "polarAngle": 1
    },
    "envMap": {
      "intensity": 1
    },
    "sun": {
      "intensity": 1,
      "polarAngle": 1,
      "azimuthalAngle": 1
    },
    "postProcessing": {
      "bloomIntensity": 1
    },
    "ambientLight": {
      "intensity": 1
    }
  },
  "avatarConfiguration": {
    "availableAvatars": [
      {
        "isDefaultAvatar": true,
        "meshFileUrl": "text",
        "mmlCharacterString": null,
        "mmlCharacterUrl": null,
        "thumbnailUrl": "text",
        "name": "text"
      }
    ],
    "allowCustomAvatars": true,
    "customAvatarWebhookUrl": "text"
  },
  "enableTweakPane": true
}

{
  "id": "text",
  "name": "text",
  "description": "text",
  "generalConfiguration": {
    "maxUserConnections": 1
  },
  "chatConfiguration": {
    "enabled": true
  },
  "authConfiguration": {
    "allowAnonymous": true,
    "password": "text",
    "authProviders": {
      "webhook": {
        "webhookUrl": "text"
      },
      "google": {
        "allowedOrganizations": [
          "text"
        ],
        "allowedUsers": [
          "text"
        ]
      },
      "discord": {
        "allowedUsers": [
          "text"
        ]
      }
    }
  },
  "mmlDocumentsConfiguration": {
    "mmlDocuments": {
      "ANY_ADDITIONAL_PROPERTY": {
        "url": "text",
        "position": {
          "x": 1,
          "y": 1,
          "z": 1
        },
        "rotation": {
          "x": 1,
          "y": 1,
          "z": 1
        },
        "scale": {
          "x": 1,
          "y": 1,
          "z": 1
        }
      }
    }
  },
  "environmentConfiguration": {
    "groundPlane": true,
    "skybox": {
      "intensity": 1,
      "blurriness": 1,
      "azimuthalAngle": 1,
      "polarAngle": 1
    },
    "envMap": {
      "intensity": 1
    },
    "sun": {
      "intensity": 1,
      "polarAngle": 1,
      "azimuthalAngle": 1
    },
    "postProcessing": {
      "bloomIntensity": 1
    },
    "ambientLight": {
      "intensity": 1
    }
  },
  "avatarConfiguration": {
    "availableAvatars": [
      {
        "isDefaultAvatar": true,
        "meshFileUrl": "text",
        "mmlCharacterString": null,
        "mmlCharacterUrl": null,
        "thumbnailUrl": "text",
        "name": "text"
      }
    ],
    "allowCustomAvatars": true,
    "customAvatarWebhookUrl": "text"
  },
  "createdAt": "text",
  "createdBy": {
    "userId": "text",
    "type": "user"
  },
  "url": "text",
  "enableTweakPane": true
}

Delete a world

delete

Path parameters

projectIdstringRequired

The id of the project the world is in

worldIdstringRequired

The id of the world to delete

Responses

204

The world was deleted

No content

default

An error occurred

application/json

delete/v1/worlds/{projectId}/web-world-instances/{worldId}

HTTPcURLJavaScriptPython

DELETE /v1/worlds/{projectId}/web-world-instances/{worldId} HTTP/1.1
Host: localhost:3050
Accept: */*

No content