REST API
This version of the REST API has been available since version 9.0 of the Laces Hub.
Groups
| Method |
Path |
Description |
| GET |
/api/v3/groups |
Return top-level groups |
| POST |
/api/v3/groups |
Create new top-level group |
| GET |
/api/v3/groups/{id} |
Return group details |
| DELETE |
/api/v3/groups/{id} |
Delete group |
| PATCH |
/api/v3/groups/{id} |
Update group partially |
| POST |
/api/v3/groups/{id} |
Create subgroup within group |
| GET |
/api/v3/groups/{id}/subgroups |
Return subgroups of group |
Repositories
| Method |
Path |
Description |
| GET |
/api/v3/groups/{groupId}/repositories |
Return repositories within group |
| GET |
/api/v3/respositories |
Return repositories |
| POST |
/api/v3/respositories |
Create repository |
| GET |
/api/v3/respositories/{id} |
Return repository's details |
| PATCH |
/api/v3/respositories/{id} |
Update repository partially |
| DELETE |
/api/v3/respositories/{id} |
Delete repository |
Publications
| Method |
Path |
Description |
| GET |
/api/v3/publications.delta |
Delta between versions |
| GET |
/api/v3/respositories/{repositoryId}/publications |
Return publications within repository |
| POST |
/api/v3/respositories/{repositoryId}/publications |
Create publication |
| GET |
/api/v3/publications/{id} |
Return publication's meta-data |
| PATCH |
/api/v3/publications/{id} |
Update publication's content and/or meta-data |
| DELETE |
/api/v3/publications/{id} |
Delete publication |
| GET |
/api/v3/publications/{id}/statements |
Returns publication's content (RDF) |
| GET |
/api/v3/publications/{id}/sparql |
Execute SPARQL query |
| POST |
/api/v3/publications/{id}/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.
Files
| Method |
Path |
Description |
| GET |
/api/v3/repositories/{repositoryId}/files |
Returns files within repository |
| POST |
/api/v3/repositories/{repositoryId}/files |
Create file |
| GET |
/api/v3/repositories/{repositoryId}/{filename} |
Return file content |
| GET |
/api/v3/repositories/{repositoryId}/{filename}/versions/{version} |
Return versioned file content |
| GET |
/api/v3/files/{id} |
Return file metadata |
| GET |
/api/v3/files/{id}/content |
Return file content |
| DELETE |
/api/v3/files/{id} |
Delete file |
| PUT |
/api/v3/files/{id} |
Update file meta-data |
Swagger
Should you be familiar with Swagger, you can find the Swagger definition of the API in laces-hub-api-v3.json.