List Operations:
GET: /admin/lists[?projectIri=<projectIri>]
: return all lists optionally filtered by projectGET: /admin/lists/<listIri>
: return complete list with childrenPOST: /admin/lists
: create new listPOST: /admin/lists/<nodeIri>
: create new child node under the supplied parent node IRI- NOT IMPLEMENTED:
DELETE: /admin/lists/<listIri>
: delete list including children if not used GET: /admin/lists/infos/<listIri>
: return list information (without children)PUT: /admin/lists/infos/<listIri>
: update list information
List Node operations
GET: /admin/lists/nodes/<nodeIri>
: return list node information (without children)- NOT IMPLEMENTED:
POST: /admin/lists/nodes/<nodeIri>
: update list node information - NOT IMPLEMENTED:
DELETE: /admin/lists/nodes/<nodeIri>
: delete list node including children if not used
- Required permission: none
- Return all lists optionally filtered by project
- GET:
/admin/lists[?projectIri=<projectIri>]
- Required permission: none
- Return complete list with children
- GET:
/admin/lists/<listIri>
- Required permission: SystemAdmin / ProjectAdmin
- POST:
/admin/lists
- BODY:
{
"projectIri": "someprojectiri",
"labels": [{ "value": "Neue Liste", "language": "de"}],
"comments": []
}
Additionally, each list can have an optional custom IRI (of Knora IRI form) specified by the id
in the request body as below:
{
"id": "http://rdfh.ch/lists/0001/a-list-with-IRI",
"projectIri": "http://rdfh.ch/projects/0001",
"labels": [{ "value": "Neue Liste mit IRI", "language": "de"}],
"comments": []
}
- Required permission: SystemAdmin / ProjectAdmin
- Appends a new child node under the supplied nodeIri. If the supplied nodeIri is the listIri, then a new child node is appended to the top level. Children are currently only appended.
- POST:
/admin/lists/<nodeIri>
- BODY:
{
"parentNodeIri": "nodeIri",
"projectIri": "someprojectiri",
"name": "first",
"labels": [{ "value": "New First Child List Node Value", "language": "en"}],
"comments": [{ "value": "New First Child List Node Comment", "language": "en"}]
}
- Required permission: none
- Return list information (without children)
- GET:
/admin/lists/infos/<listIri>
- Required permission: none
- Update list information
- PUT:
/admin/lists/infos/<listIri>
- BODY:
{
"listIri": "listIri",
"projectIri": "someprojectiri",
"labels": [{ "value": "Neue geönderte Liste", "language": "de"}, { "value": "Changed list", "language": "en"}],
"comments": [{ "value": "Neuer Kommentar", "language": "de"}, { "value": "New comment", "language": "en"}]
}
- Required permission: none
- Return list node information (without children)
- GET:
/admin/lists/nodes/<nodeIri>