/api/scene

Scene functions

A scene is a hierarchy of 3D objects.



Post
/api/scene?p=new
Create a new scene

Response. The id of the scene



Post
/api/scene?id={id}&command={cmd_and_params}
Add a command to a scene script




Get
/api/scene?id={id}
Get a scene with given id

Response is text/plain format scene file



Get
/api/scene?id={id}&since={utc_seconds}
Get list of changes in a scene since utc_seconds

The changes are returned as a text/plain file
See Scene file format for full documentation



Post
/api/scene?id={id}&p=user&userid={userid}&auth={permissions}
Add/Remove a user to a scene or change their permissions for the scene (for co-creativity)

By default only the user who created the scene can post commands to it
Permissions
perimissions can be
READ_WRITE Read and Write access
READ_ONLY Read only access (they cannot post changes)
NONE Remove the user



Get
/api/scene?id={id}&p=get_users
Retrieve a list of users with access to the scene




Post
/api/scene?id={id}&p=delete
Delete a scene

Only the owner of the scene can delete it



Post
/api/scene?id={id}&p=duplicate
Duplicate a scene. Returns id of new scene