17.21. Return a List of Workspaces for a Repository

Once you know the name of an accessible repository, you can retrieve a list of its workspaces:

GET http://www.example.com/modeshape-rest/eds

This request (and all of the following requests) actually create a JCR session (javax.jcr.Session) to service the request and require that security be configured. The response looks similar to the following:

{
   "default" : {
      "workspace" : {
         "name" : "default",
         "resources" : { 
            "items":"/modeshape-rest/eds/default/items", 
            "query":"/modeshape-rest/eds/default/query"
         },
      }
   }
}

Like the first response, this response consists of a list of workspace names mapped to metadata about the workspaces. The example above only lists one workspace for simplicity, but there could be many different workspaces returned in a real deployment. Note that the "items" resource builds the full URI to the root of the items hierarchy, including the encoding of the repository name and the workspace name and the "query" resource builds the full URI needed to execute queries.