REST API
A REST API is an architectural style for an application program interface (API) that uses HTTP requests to access and use data. That data can be used to GET, POST, PATCH, and DELETE data types, referring to the reading, updating, creating, changing, and deleting operations concerning resources.
info
REST API is a licensed feature. For more details, please get in touch with our Licensing Team.
- Base URL: Your current Reality Hub address and port (ex:
http://localhost) - Endpoint: Communication channel that you want to do various processes (
/api/rest/v1/engines/1/nodes)
info
If the Endpoint contains characters that the URL doesn't support, those characters should be URL-Encoded. For more information, please visit: HTML URL Encoding Reference
info
You can download the OpenAPI spec by right clicking and saving the link content: Reality Hub OpenAPI.
API Endpoints Overview
The Reality Hub REST API provides the following main endpoint categories:
Engine Control
- Base Path:
/api/rest/v1/engines - Description: Manage Reality Engine instances and their nodes, properties, and functions
- Key Endpoints:
GET /engines/{engineId}- Get engine detailsGET /engines/{engineId}/nodes/{nodePath}- Get engine nodesPATCH /engines/{engineId}/nodes/{nodePath}/properties/{propertyPath}- Set node propertiesPOST /engines/{engineId}/nodes/{nodePath}/functions/{functionPath}- Call node functions
Playout Control
- Base Path:
/api/rest/v1/playout - Description: Manage playout rundowns and their items
- Key Endpoints:
GET /rundowns/{rundownId}- Get rundown detailsPOST /rundowns- Create new rundownGET /rundowns/{rundownId}/items/{rundownItemId}- Get rundown itemsPOST /rundowns/{rundownId}/items- Add rundown itemPATCH /rundowns/{rundownId}/items/{rundownItemId}- Update rundown itemDELETE /rundowns/{rundownId}/items/{rundownItemId}- Delete rundown item
Launcher Control
- Base Path:
/api/rest/v1/launcher - Description: Manage launch configurations and renderers
- Key Endpoints:
GET /launcher/{configID}- Get launch configurationPUT /launcher/{configID}/launch- Start launch configurationPUT /launcher/{configID}/stop- Stop launch configurationPUT /launcher/{configID}/retime- Retime launch configurationGET /launcher/{configID}/renderer- List renderersPUT /launcher/{configID}/renderer/{rendererID}/start- Start rendererPUT /launcher/{configID}/renderer/{rendererID}/stop- Stop renderer
Lino Control
- Base Path:
/api/rest/v1/lino - Description: Manage Lino rundowns and playout operations
- Key Endpoints:
GET /lino/engines/{engineId}- Get Lino enginesGET /lino/rundowns/{engineId}- Get Lino rundownsGET /lino/rundown/{engineId}/{rundownId}/items/{itemId}- Get rundown itemsPOST /lino/rundown/{engineId}/{rundownId}/items- Add rundown itemPUT /lino/rundown/{engineId}/{rundownId}/load- Load rundownPUT /lino/rundown/{engineId}/play/{itemId}/{preview}- Play itemPUT /lino/rundown/{engineId}/playnext/{preview}- Play next item
Graph Control
- Base Path:
/api/rest/v1/graphs - Description: Manage Reality Engine graphs
- Key Endpoints:
GET /graphs/{graphId}- Get graph detailsPOST /graphs/{graphId}/load- Load graph
Ustate Control
- Base Path:
/api/rest/v1/ustates - Description: Manage Unreal Engine states
- Key Endpoints:
GET /ustates/{ustateId}- Get ustate detailsPOST /ustates/{ustateId}/load- Load ustate
Newsroom Control
- Base Path:
/api/rest/v1/newsroom - Description: Manage newsroom rundowns and MOS objects
- Key Endpoints:
GET /newsroom/rundowns/{ncsID}- Get newsroom rundownsGET /newsroom/rundowns/{ncsID}/{roID}- Get specific rundownPATCH /newsroom/mosObjects/{objID}- Update MOS object
Projects Control
- Base Path:
/api/rest/v1/projects - Description: Manage projects and project maps
- Key Endpoints:
GET /projects- List all projects