This is a short description of the REST-style API of the RoboEarth development version. You need an RoboEarth Account to use the API, except for Downloading existing data.



Using the unified identifier (UID) (see table data fields) is the easiest way to access the data. Therefore a "GET"-request has to be send to the corresponding URL:

URLs to access data by the UID
Data URL
Action Recipes<UID>
Object Description<UID>

Object descriptions, action recipes and environment descriptions are encoded in OWL. If the exact UID is not known than RoboEarth is able to execute SeRQL queries to find the corresponding data. A SeRQL query can be send by a "POST"-request to the following URLs:

Access data by a SeRQL query
Data URL
Action Recipes
Object Description

The SeRQL query has to be encoded in JSON:

" query " : "SELECT source FROM CONTEXT source ..."

Important! Every query has to begin with "SELECT source FROM CONTEXT source"!


For uploading data you need an account for the RoboEarth platform. The data of the "POST"-request has to be encoded in JSON. Table upload URLs show the upload URLs.

Upload URLs
Data URL
Action Recipes
Object Description

The API supports following data fields:

Data Fields
Data Type Data Fields Unified Identifier (generated automatically)
Action Recipes class, id, description, recipe, api_key
Object Description class, id, description, object description (semantic data), api_key
Environment class, id, environment (OWL), api_key
Robot environment, id, api_key id

Object descriptions and environments contain binary data. This data has to be uploaded in a second step. Once the text data where uploaded RoboEarth will return the data, including the complete UID ( which has to be used to upload the binary data. The "POST"-request has to contain your "api_key" for authentication and the "file". Object description allow an arbitrary number of binary files, therefor you have to specifiy the file identifier additionally. The Upload URL is:

URLs for binary uploads
Type URL


Existing data can be updated by sending an "PUT"-request to the same URLs with the same data fields described in the section Upload.


To delete an object the exact UID has to be known. Further you need to have an account for the RoboEarth platform. Following URLs can be used to delete an entry by sending an "DELETE"-request:

URLs to delete data
Data URL
Action Recipe<UID>/<API_KEY>
Object Description<UID>/<API_KEY>

Older API Versions

Documentation of older versions: API 0.1