Skip to content

REST API#

This version of the REST API has been available since version 8.0 of the Laces Hub.

Groups#

Method Path Description
GET /api/v2/groups Return top-level groups
POST /api/v2/groups Create new top-level group
GET /api/v2/groups/{groupId} Return group details
DELETE /api/v2/groups/{groupId} Delete group
PATCH /api/v2/groups/{groupId} Update group partially
POST /api/v2/groups/{groupId} Create subgroup within group
GET /api/v2/groups/{groupId}/subgroups Return subgroups of group

Repositories#

Method Path Description
GET /api/v2/respositories Return repositories
POST /api/v2/respositories Create repository
GET /api/v2/respositories/{repositoryId} Return repository's details
PATCH /api/v2/respositories/{respositoryId} Update repository partially
DELETE /api/v2/respositories/{repositoryId} Delete repository
GET /api/v2/respositories/{groupId}/repositories Return repositories within group

Publications#

Method Path Description
GET /api/v2/respositories/{repositoryId}/publications Return publications within repository
POST /api/v2/respositories/{repositoryId}/publications Create publication
PUT /api/v2/respositories/{repositoryId}/publications Update publication
GET /api/v2/repositories/{repositoryId}/publications/publication Return publication
DELETE /api/v2/repositories/{repositoryId}/publications/publication Delete publication
GET /api/v2/repositories/{repositoryId}/publications Return publication's meta-data
PATCH /api/v2/repositories/{repositoryId}/publications Update publication's meta-data
GET /api/v2/repositories/{repositoryId}/publications/sparql Execute SPARQL query
POST /api/v2/repositories/{repositoryId}/publications/sparql Execute SPARQL query (with POST)

Note: should you just be interested in retrieving the RDF data or executing a SPARQL query on a publication, you can also directly use the publication's URL for this; for more info check out the REST API Basics.

Swagger#

Should you be familiar with Swagger, you can find the Swagger definition of the API in laces-hub-api-v2.json.