Documentation of OpenOLAT REST API

The goal of the REST API is to provide an easy way to exchange URLs. It is also used to integrate with other systems such as student administration, external course administration and/or external learning group administration.;

Concepts

Representational State Transfer or REST is a style of architecture to be primarily used with the HTTP protocol, but not exclusively. In the case of HTTP, it utilizes all its features: URIs to describe resources, HTTP Methods as "verbs" to manipulate resources (GET to retrieve resources, PUT to create new ones, POST to modify them, DELETE...), HTTP Headers and Media Types for content negotiation...

In OpenOLAT, the JRS-311 is used as a backend for the implementation of our REST API. JSR-311 is a standard from J2EE. We use the reference implementation from the following standard: Jersey.

Security

The security is based on a two level mechanism, as it is in OpenOLAT.

  1. The first level is a servlet filter which collects all requests to the REST API. This filter determines whether the URI is open to everyone (/api, /ping, /auth...) or if it needs an authentication. The authentication itself is delegated to a web service.
  2. The second level happens in all entry points of the REST API. Every method checks if the user (if a user must be authenticated) has enough privileges to operate on the desired resource.

To maintain a valid authentication over several requests, the filter proposes two methods:

  1. Reuse the session cookie on every request. The advantage of this method is that OpenOLAT doesn't need to create a session on every request.
  2. If you cannot use the session cookie, the filter always adds an HTTP Header (X-OLAT-TOKEN) to the response. Send this token with the next request to maintain your privileges.

Configuration

A spring bean allows to configure Resources, Singletons and Providers; either statically with the XML configuration of the bean (/org/olat/restapi/_spring/restApiContext.xml) or programmatically by adding or removing classes and singletons to/from the bean (bean id is the same as its interface: org.olat.restapi.support.RestRegistrationService).

OpenOLAT uses the standard JAXB provider from Jersey to produce XML from java objects, as well as the JSON provider from Jackson, which reuses the same JAXB annotations.

Very important! All configuration settings must be done before the Jersey's servlet starts.

Example

Here is a little example on how to create a user and add it to a learning group:

  1. PUT http://www.frentix.com/olat/restapi/users
    HTTP Header: Content-Type application/json
    Response: 200
  2. GET http://www.frentix.com/olat/restapi/groups
    HTTP Header: Accept application/json
    Response: 200
  3. Choose a group
  4. PUT http://www.frentix.com/olat/restapi/groups/{groupId}/users/{identityKey}
    Response: 200

Documentation

This documentation is based on the WADL format. The XML file is automatically generated by Jersey on runtime. For documentation purposes, this file is the base of a four step Maven process to produce a human readable HTML file.

  1. Generate a XSD schema from all the Java classes used by JAXB for mapping
  2. Generate Javadoc with a custom doclet for WADL
  3. Generate WADL with the output of the two preceding steps
  4. Produce the final HTML documentation with XSLT

To add java classes annoted with JAXB, you must update the pom file in the OpenOLAT directory under the artfact maven-jaxb-schemagen-plugin.

To add resources, you must add the packages to the following plugins configurations: maven-javadoc-plugin and maven-wadl-plugin. Be aware that the first uses commas to seperates the packages and the second semicolons. Both recursively search all resources under the packages.

Examples for the documentation can only be generated for XML. This is a limitation of the maven plugin.

Contents of resources

Resources

/repo/courses/{courseId}/elements/enrollment?parentNodeId&position&shortTitle&longTitle&objectives&visibilityExpertRules&accessExpertRules&groups&cancelEnabled

resource-wide template parameters
parameter value description

courseId

long

Methods

PUT

request query parameters
parameter value description

parentNodeId

string

position

int

shortTitle

string

Default: undefined

longTitle

string

Default: undefined

objectives

string

Default: undefined

visibilityExpertRules

string

accessExpertRules

string

groups

string

cancelEnabled

boolean

Default: false

available response representations:

POST

acceptable request representations:

available response representations:

/repo/courses/{courseId}/elements/enrollment/{nodeId}/groups

resource-wide template parameters
parameter value description

courseId

long

nodeId

string

courseId

long

Methods

GET

available response representations:

/catalog

Description:<br> A web service for the catalog <P> Initial Date: 5 may 2010 <br>

Methods

GET

Returns the list of root catalog entries.

available response representations:

/catalog/{path:.*}/owners/{identityKey}

resource-wide template parameters
parameter value description

path

string

The path

identityKey

long

The id of the user

Methods

GET

Retrieves data of an owner of the local sub tree

available response representations:

available response representations:

available response representations:

PUT

Add an owner of the local sub tree

available response representations:

available response representations:

available response representations:

DELETE

Remove an owner of the local sub tree

available response representations:

available response representations:

available response representations:

/catalog/{path:.*}/children?start&limit

resource-wide template parameters
parameter value description

path

string

The path

Methods

GET

Returns a list of catalog entries.

request query parameters
parameter value description

start

int

Default: 0

limit

int

Default: 25

available response representations:

available response representations:

/catalog/version

Methods

GET

Retrieves the version of the Catalog Web Service.

available response representations:

/catalog/{path:.*}

resource-wide template parameters
parameter value description

path

string

The path

Methods

GET

Returns the metadata of the catalog entry.

available response representations:

available response representations:

PUT

Adds a catalog entry under the path specified in the URL.

acceptable request representations:

available response representations:

available response representations:

available response representations:

PUT

Adds a catalog entry under the path specified in the URL.

request query parameters
parameter value description

name

string

The name

description

string

The description

type

int

The type (leaf or node)

repoEntryKey

long

The id of the repository entry

available response representations:

available response representations:

available response representations:

POST

Updates the catalog entry under the path specified in the URL.

acceptable request representations:

available response representations:

available response representations:

available response representations:

POST

Updates the catalog entry with the path specified in the URL.

request query parameters
parameter value description

newParentKey

long

acceptable request representations:

available response representations:

available response representations:

available response representations:

POST

Updates the catalog entry with the path specified in the URL.

request query parameters
parameter value description

name

string

description

string

newParentKey

long

available response representations:

available response representations:

available response representations:

DELETE

Deletes the catalog entry with the path specified in the URL.

available response representations:

available response representations:

available response representations:

/catalog/{path:.*}/owners

resource-wide template parameters
parameter value description

path

string

The path

Methods

GET

Get the owners of the local sub tree

available response representations:

available response representations:

available response representations:

/api

Description:<br> Service for general informations on the OLAT REST Api. <P> Initial Date: 14 apr. 2010 <br>

Methods

/api/version

Methods

GET

Version number of the whole REST API of OLAT.

available response representations:

/api/doc

Methods

GET

available response representations:

/api/doc/{filename}

resource-wide template parameters
parameter value description

filename

string

Methods

GET

Returns images for the documentation of OLAT.

available response representations:

/api/{filename}

resource-wide template parameters
parameter value description

filename

string

Methods

GET

Returns images for the documentation of OLAT.

available response representations:

/api/copyright

Methods

GET

Returns the copyright of OLAT.

available response representations:

GET

Returns the copyright of OLAT.

available response representations:

/groups

Description:<br> This handles the learning groups. <P> Initial Date: 23 mar. 2010 <br>

Methods

PUT

Create a group.

acceptable request representations:

available response representations:

available response representations:

available response representations:

GET

Return the list of all groups if you have group manager permission, or all learning group that you particip with or owne.

request query parameters
parameter value description

externalId

string

Search with an external ID

managed

boolean

(true / false) Search only managed / not managed groups

available response representations:

/groups/version

Methods

GET

Retrieves the version of the Group Web Service.

available response representations:

/groups/{groupKey}

resource-wide template parameters
parameter value description

groupKey

long

The key of the group

Methods

GET

Return the group specified by the key of the group.

available response representations:

POST

Updates a group.

acceptable request representations:

available response representations:

available response representations:

available response representations:

DELETE

Deletes the business group specified by the groupKey.

available response representations:

available response representations:

available response representations:

/groups/{groupKey}/configuration

resource-wide template parameters
parameter value description

groupKey

long

Methods

POST

acceptable request representations:

available response representations:

/groups/{groupKey}/infos

resource-wide template parameters
parameter value description

groupKey

long

The key of the group

Methods

GET

Returns the informations of the group specified by the groupKey.

available response representations:

available response representations:

/groups/{groupKey}/owners

resource-wide template parameters
parameter value description

groupKey

long

The key of the group

Methods

GET

Returns the list of owners of the group specified by the groupKey.

available response representations:

available response representations:

/groups/{groupKey}/participants

resource-wide template parameters
parameter value description

groupKey

long

The key of the group

Methods

GET

Returns the list of participants of the group specified by the groupKey.

available response representations:

available response representations:

/groups/{groupKey}/owners/{identityKey}

resource-wide template parameters
parameter value description

groupKey

long

The key of the group

identityKey

long

The user's id

Methods

PUT

Adds an owner to the group.

available response representations:

available response representations:

available response representations:

DELETE

Removes the owner from the group.

available response representations:

available response representations:

available response representations:

/groups/{groupKey}/participants/{identityKey}

resource-wide template parameters
parameter value description

groupKey

long

The key of the group

identityKey

long

The id of the user

Methods

PUT

Adds a participant to the group.

available response representations:

available response representations:

available response representations:

DELETE

Removes a participant from the group.

available response representations:

available response representations:

available response representations:

/groups/{groupKey}/forum

Description:<br> Web service to manage a forum. <P> Initial Date: 20 apr. 2010 <br>

resource-wide template parameters
parameter value description

groupKey

long

The key of the group

Methods

GET

Retrieves the forum.

available response representations:

available response representations:

available response representations:

/groups/{groupKey}/forum/threads?start&limit&orderBy&asc

resource-wide template parameters
parameter value description

groupKey

long

The key of the group

Methods

GET

Retrieves the threads in the forum

request query parameters
parameter value description

start

int

Default: 0

limit

int

Default: 25

orderBy

string

Default: creationDate

(value name,creationDate)

asc

boolean

Default: true

(value true/false)

available response representations:

available response representations:

available response representations:

PUT

Creates a new thread in the forum of the course node

request query parameters
parameter value description

title

string

The title for the first post in the thread

body

string

The body for the first post in the thread

authorKey

long

The author user key (optional)

available response representations:

available response representations:

available response representations:

POST

Creates a new thread in the forum of the course node

acceptable request representations:

available response representations:

available response representations:

available response representations:

/groups/{groupKey}/forum/posts/{threadKey}?start&limit&orderBy&asc

resource-wide template parameters
parameter value description

groupKey

long

The key of the group

threadKey

long

The key of the thread

Methods

GET

Retrieves the messages in the thread

request query parameters
parameter value description

start

int

Default: 0

limit

int

Default: 25

orderBy

string

Default: creationDate

(value name, creationDate)

asc

boolean

Default: true

(value true/false)

available response representations:

available response representations:

available response representations:

/groups/{groupKey}/forum/posts/{messageKey}

resource-wide template parameters
parameter value description

groupKey

long

The key of the group

messageKey

long

The id of the reply message

Methods

POST

Creates a new reply in the forum of the course node

acceptable request representations:

available response representations:

available response representations:

available response representations:

PUT

Creates a new reply in the forum of the course node

acceptable request representations:

available response representations:

available response representations:

available response representations:

PUT

Creates a new reply in the forum of the course node

request query parameters
parameter value description

title

string

The title for the first post in the thread

body

string

The body for the first post in the thread

authorKey

long

The author user key (optional)

available response representations:

available response representations:

available response representations:

/groups/{groupKey}/forum/posts/{messageKey}/attachments

resource-wide template parameters
parameter value description

groupKey

long

The key of the group

messageKey

long

The key of the message

Methods

GET

Retrieves the attachments of the message

available response representations:

available response representations:

POST

Upload the attachment of a message, as parameter:<br> filename The name of the attachment<br> file The attachment.

acceptable request representations:

available response representations:

available response representations:

PUT

Upload the attachment of a message, as parameter:<br> filename The name of the attachment<br> file The attachment.

acceptable request representations:

available response representations:

available response representations:

POST

Upload the attachment of a message, as parameter:<br> filename The name of the attachment<br> file The attachment.

available response representations:

available response representations:

/groups/{groupKey}/forum/posts/{messageKey}/attachments/{filename}

resource-wide template parameters
parameter value description

groupKey

long

The key of the group

filename

string

The name of the attachment

messageKey

long

The identity key of the user being searched

Methods

GET

Retrieves the attachment of the message

available response representations:

available response representations:

/groups/{groupKey}/folder

resource-wide template parameters
parameter value description

groupKey

long

Methods

GET

available response representations:

POST

available response representations:

POST

acceptable request representations:

available response representations:

PUT

available response representations:

PUT

acceptable request representations:

available response representations:

/groups/{groupKey}/folder/{path:.*}

resource-wide template parameters
parameter value description

groupKey

long

path

string

Methods

GET

available response representations:

POST

available response representations:

POST

acceptable request representations:

available response representations:

PUT

available response representations:

PUT

acceptable request representations:

available response representations:

PUT

available response representations:

DELETE

available response representations:

/groups/{groupKey}/folder/version

resource-wide template parameters
parameter value description

groupKey

long

Methods

GET

available response representations:

/groups/{groupKey}/folder/metadata/{path:.*}

resource-wide template parameters
parameter value description

groupKey

long

path

string

Methods

GET

available response representations:

/groups/{groupKey}/wiki

resource-wide template parameters
parameter value description

groupKey

long

The key of the group

Methods

GET

available response representations:

/repo/courses?start&limit&managed&externalId&externalRef&repositoryEntryKey

Description:<br> This web service handles the courses. <P> Initial Date: 27 apr. 2010 <br>

Methods

GET

Get all courses viewable by the authenticated user

request query parameters
parameter value description

start

int

Default: 0

limit

int

Default: 25

managed

boolean

externalId

string

externalRef

string

repositoryEntryKey

string

available response representations:

PUT

Creates an empty course, or a copy from a course if the parameter copyFrom is set.

acceptable request representations:

available response representations:

available response representations:

PUT

Creates an empty course, or a copy from a course if the parameter copyFrom is set.

request query parameters
parameter value description

shortTitle

string

title

string

displayName

string

softKey

string

access

int

membersOnly

boolean

externalId

string

externalRef

string

managedFlags

string

sharedFolderSoftKey

string

copyFrom

long

available response representations:

available response representations:

POST

available response representations:

/repo/courses/version

Methods

GET

The version of the Course Web Service

available response representations:

/repo/courses/{courseId}

Description:<br> This web service will handle the functionality related to <code>Course</code> and its contents. <P> Initial Date: 27 apr. 2010 <br>

resource-wide template parameters
parameter value description

courseId

long

Methods

DELETE

Delete a course by id

available response representations:

available response representations:

available response representations:

GET

Get the metadatas of the course by id

available response representations:

available response representations:

/repo/courses/{courseId}/configuration

resource-wide template parameters
parameter value description

courseId

long

courseId

long

The course resourceable's id

Methods

GET

Get the configuration of the course

available response representations:

available response representations:

available response representations:

POST

Update the course configuration

acceptable request representations:

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/authors

resource-wide template parameters
parameter value description

courseId

long

Methods

GET

Get all owners and authors of the course

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/version

resource-wide template parameters
parameter value description

courseId

long

Methods

GET

The version of the Course Web Service

available response representations:

/repo/courses/{courseId}/file

resource-wide template parameters
parameter value description

courseId

long

Methods

GET

Export the course

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/runstructure

resource-wide template parameters
parameter value description

courseId

long

Methods

GET

Get the runstructure of the course by id

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/editortreemodel

resource-wide template parameters
parameter value description

courseId

long

Methods

GET

Get the editor tree model of the course by id

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/authors/{identityKey}

resource-wide template parameters
parameter value description

courseId

long

identityKey

long

The user identifier

Methods

GET

Get this specific author and owner of the course

available response representations:

available response representations:

available response representations:

PUT

Add an owner and author to the course

available response representations:

available response representations:

available response representations:

DELETE

Remove an owner and author to the course

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/tutors/{identityKey}

resource-wide template parameters
parameter value description

courseId

long

identityKey

long

The user identifier

Methods

PUT

Add a coach to the course

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/tutors

resource-wide template parameters
parameter value description

courseId

long

Methods

GET

Get all coaches of the course (don't follow the groups)

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/participants

resource-wide template parameters
parameter value description

courseId

long

Methods

GET

Get all participants of the course (don't follow the groups)

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/participants/{identityKey}

resource-wide template parameters
parameter value description

courseId

long

identityKey

long

The user identifier

Methods

PUT

Add an participant to the course

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/resource

resource-wide template parameters
parameter value description

courseId

long

Methods

GET

available response representations:

/repo/courses/{courseId}/publish?locale&access&membersOnly

resource-wide template parameters
parameter value description

courseId

long

Methods

POST

Publish the course.

request query parameters
parameter value description

locale

string

access

int

membersOnly

boolean

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/groups

Description:<br> CourseGroupWebService <P> Initial Date: 7 apr. 2010 <br>

resource-wide template parameters
parameter value description

courseId

long

Methods

GET

Lists all learn groups of the specified course.

available response representations:

available response representations:

PUT

Creates a new group for the course.

acceptable request representations:

available response representations:

available response representations:

/repo/courses/{courseId}/groups/{groupKey}

resource-wide template parameters
parameter value description

courseId

long

groupKey

long

The group's id

Methods

GET

Retrieves the metadata of the specified group.

available response representations:

available response representations:

DELETE

Deletes the business group specified by the key of the group.

available response representations:

available response representations:

available response representations:

POST

Updates the metadata for the specified group.

acceptable request representations:

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/groups/version

resource-wide template parameters
parameter value description

courseId

long

Methods

GET

Retrieves the version of the Course Group Web Service.

available response representations:

/repo/courses/{courseId}/groups/{groupKey}/forum

Description:<br> Web service to manage a forum. <P> Initial Date: 20 apr. 2010 <br>

resource-wide template parameters
parameter value description

courseId

long

groupKey

long

The key of the group

Methods

GET

Retrieves the forum.

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/groups/{groupKey}/forum/threads?start&limit&orderBy&asc

resource-wide template parameters
parameter value description

courseId

long

groupKey

long

The key of the group

Methods

GET

Retrieves the threads in the forum

request query parameters
parameter value description

start

int

Default: 0

limit

int

Default: 25

orderBy

string

Default: creationDate

(value name,creationDate)

asc

boolean

Default: true

(value true/false)

available response representations:

available response representations:

available response representations:

PUT

Creates a new thread in the forum of the course node

request query parameters
parameter value description

title

string

The title for the first post in the thread

body

string

The body for the first post in the thread

authorKey

long

The author user key (optional)

available response representations:

available response representations:

available response representations:

POST

Creates a new thread in the forum of the course node

acceptable request representations:

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/groups/{groupKey}/forum/posts/{threadKey}?start&limit&orderBy&asc

resource-wide template parameters
parameter value description

courseId

long

groupKey

long

The key of the group

threadKey

long

The key of the thread

Methods

GET

Retrieves the messages in the thread

request query parameters
parameter value description

start

int

Default: 0

limit

int

Default: 25

orderBy

string

Default: creationDate

(value name, creationDate)

asc

boolean

Default: true

(value true/false)

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/groups/{groupKey}/forum/posts/{messageKey}

resource-wide template parameters
parameter value description

courseId

long

groupKey

long

The key of the group

messageKey

long

The id of the reply message

Methods

POST

Creates a new reply in the forum of the course node

acceptable request representations:

available response representations:

available response representations:

available response representations:

PUT

Creates a new reply in the forum of the course node

acceptable request representations:

available response representations:

available response representations:

available response representations:

PUT

Creates a new reply in the forum of the course node

request query parameters
parameter value description

title

string

The title for the first post in the thread

body

string

The body for the first post in the thread

authorKey

long

The author user key (optional)

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/groups/{groupKey}/forum/posts/{messageKey}/attachments

resource-wide template parameters
parameter value description

courseId

long

groupKey

long

The key of the group

messageKey

long

The key of the message

Methods

GET

Retrieves the attachments of the message

available response representations:

available response representations:

POST

Upload the attachment of a message, as parameter:<br> filename The name of the attachment<br> file The attachment.

acceptable request representations:

available response representations:

available response representations:

PUT

Upload the attachment of a message, as parameter:<br> filename The name of the attachment<br> file The attachment.

acceptable request representations:

available response representations:

available response representations:

POST

Upload the attachment of a message, as parameter:<br> filename The name of the attachment<br> file The attachment.

available response representations:

available response representations:

/repo/courses/{courseId}/groups/{groupKey}/forum/posts/{messageKey}/attachments/{filename}

resource-wide template parameters
parameter value description

courseId

long

groupKey

long

The key of the group

filename

string

The name of the attachment

messageKey

long

The identity key of the user being searched

Methods

GET

Retrieves the attachment of the message

available response representations:

available response representations:

/repo/courses/{courseId}/groups/{groupKey}/folder

resource-wide template parameters
parameter value description

courseId

long

groupKey

long

Methods

GET

available response representations:

POST

available response representations:

POST

acceptable request representations:

available response representations:

PUT

available response representations:

PUT

acceptable request representations:

available response representations:

/repo/courses/{courseId}/groups/{groupKey}/folder/{path:.*}

resource-wide template parameters
parameter value description

courseId

long

groupKey

long

path

string

Methods

GET

available response representations:

POST

available response representations:

POST

acceptable request representations:

available response representations:

PUT

available response representations:

PUT

acceptable request representations:

available response representations:

PUT

available response representations:

DELETE

available response representations:

/repo/courses/{courseId}/groups/{groupKey}/folder/version

resource-wide template parameters
parameter value description

courseId

long

groupKey

long

Methods

GET

available response representations:

/repo/courses/{courseId}/groups/{groupKey}/folder/metadata/{path:.*}

resource-wide template parameters
parameter value description

courseId

long

groupKey

long

path

string

Methods

GET

available response representations:

/repo/courses/{courseId}/calendar

resource-wide template parameters
parameter value description

courseId

long

Methods

/repo/courses/{courseId}/calendar/events?start&limit&onlyFuture

resource-wide template parameters
parameter value description

courseId

long

Methods

GET

request query parameters
parameter value description

start

int

Default: 0

limit

int

Default: 25

onlyFuture

boolean

Default: false

available response representations:

PUT

acceptable request representations:

available response representations:

POST

acceptable request representations:

available response representations:

/repo/courses/{courseId}/calendar/events/{eventId}

resource-wide template parameters
parameter value description

courseId

long

eventId

string

Methods

DELETE

available response representations:

/repo/courses/{courseId}/vitero/{subIdentifier}

resource-wide template parameters
parameter value description

courseId

long

subIdentifier

string

Methods

GET

available response representations:

PUT

acceptable request representations:

available response representations:

POST

acceptable request representations:

available response representations:

/repo/courses/{courseId}/vitero/{subIdentifier}/{bookingId}/members

resource-wide template parameters
parameter value description

courseId

long

subIdentifier

string

bookingId

int

Methods

GET

available response representations:

POST

acceptable request representations:

available response representations:

/repo/courses/{courseId}/vitero/{subIdentifier}/{bookingId}

resource-wide template parameters
parameter value description

courseId

long

subIdentifier

string

bookingId

int

Methods

DELETE

available response representations:

/ping

Description:<br> Ping to test the presence of the REST Api <P> Initial Date: 7 apr. 2010 <br>

Methods

GET

Return a string

available response representations:

/ping/version

Methods

GET

The version of the Ping Web Service

available response representations:

/ping/{name}

resource-wide template parameters
parameter value description

name

string

Methods

POST

Return a string

available response representations:

/repo/courses/{courseId}/resourcefolders

Description:<br> This will handle the resources folders in the course: the course storage folder and the shared folder. The course folder has a read-write access but the shared folder can only be read. <P> Initial Date: 26 apr. 2010 <br>

Methods

/repo/courses/{courseId}/resourcefolders/version

Methods

GET

The version of the resources folders Web Service

available response representations:

/repo/courses/{courseId}/resourcefolders/coursefolder/{path:.*}

resource-wide template parameters
parameter value description

path

string

courseId

long

Methods

GET

This retrieves the files in the course folder

available response representations:

available response representations:

available response representations:

POST

This attaches the uploaded file(s) to the supplied folder id.

available response representations:

available response representations:

available response representations:

available response representations:

PUT

This attaches the uploaded file(s) to the supplied folder id at the root level

available response representations:

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/resourcefolders/coursefolder

resource-wide template parameters
parameter value description

courseId

long

Methods

GET

This retrieves the files in the course folder

available response representations:

available response representations:

available response representations:

POST

This attaches the uploaded file(s) to the supplied folder id.

available response representations:

available response representations:

available response representations:

available response representations:

PUT

This attaches the uploaded file(s) to the supplied folder id at the root level

available response representations:

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/resourcefolders/sharedfolder

resource-wide template parameters
parameter value description

courseId

long

The course resourceable's id

Methods

GET

This retrieves the files in the shared folder

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/resourcefolders/sharedfolder/{path:.*}

resource-wide template parameters
parameter value description

path

string

courseId

long

The course resourceable's id

Methods

GET

This retrieves the files in the shared folder

available response representations:

available response representations:

available response representations:

/auth

Description:<br> Authenticate against OLAT Provider <P> Initial Date: 7 apr. 2010 <br>

Methods

/auth/{username}?password&x-olat-token

resource-wide template parameters
parameter value description

username

string

Methods

GET

Authenticates against OLAT Provider and provides a security token if authentication is successful. The security token is returned as a header named X-OLAT-TOKEN. Given that the password is sent in clear text and not encrypted, it is not advisable to use this service over a none secure connection (https).

request query parameters
parameter value description

password

string

x-olat-token

string

available response representations:

available response representations:

available response representations:

/auth/version

Methods

GET

Retrieves the version of the User Authentication Web Service

available response representations:

/repo/courses/{courseId}/elements/forum

Description:<br> REST API implementation for forum course node <P> Initial Date: 20.12.2010 <br>

resource-wide template parameters
parameter value description

courseId

long

Methods

POST

This attaches a Forum Element onto a given course. The element will be inserted underneath the supplied parentNodeId.

acceptable request representations:

available response representations:

available response representations:

available response representations:

GET

Retrieves metadata of the published course node

available response representations:

available response representations:

available response representations:

PUT

This attaches a Forum Element onto a given course. The element will be inserted underneath the supplied parentNodeId.

request query parameters
parameter value description

parentNodeId

string

position

int

shortTitle

string

Default: undefined

longTitle

string

Default: undefined

objectives

string

Default: undefined

visibilityExpertRules

string

accessExpertRules

string

moderatorExpertRules

string

posterExpertRules

string

readerExpertRules

string

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/forum/{nodeId}/thread?title&body&identityName&sticky

resource-wide template parameters
parameter value description

courseId

long

nodeId

string

The id of the course node.

courseId

long

The id of the course.

Methods

PUT

Creates a new thread in the forum of the course node

request query parameters
parameter value description

title

string

The title for the first post in the thread

body

string

The body for the first post in the thread

identityName

string

The author identity name (optional)

sticky

boolean

Creates sticky thread.

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/forum/{nodeId}/message?parentMessageId&title&body&identityName

resource-wide template parameters
parameter value description

courseId

long

nodeId

string

The id of the course node.

courseId

long

The id of the course.

Methods

PUT

Creates a new forum message in the forum of the course node

request query parameters
parameter value description

parentMessageId

long

The id of the parent message.

title

string

The title for the first post in the thread

body

string

The body for the first post in the thread

identityName

string

The author identity name (optional)

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/forum/{nodeId}

resource-wide template parameters
parameter value description

courseId

long

nodeId

string

The node's id

courseId

long

The course resourceable's id

Methods

GET

Retrieves metadata of the published course node

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/forum/{nodeId}/forum

Description:<br> Web service to manage a forum. <P> Initial Date: 20 apr. 2010 <br>

resource-wide template parameters
parameter value description

courseId

long

courseId

long

nodeId

string

Methods

GET

Retrieves the forum.

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/forum/{nodeId}/forum/threads?start&limit&orderBy&asc

resource-wide template parameters
parameter value description

courseId

long

courseId

long

nodeId

string

Methods

GET

Retrieves the threads in the forum

request query parameters
parameter value description

start

int

Default: 0

limit

int

Default: 25

orderBy

string

Default: creationDate

(value name,creationDate)

asc

boolean

Default: true

(value true/false)

available response representations:

available response representations:

available response representations:

PUT

Creates a new thread in the forum of the course node

request query parameters
parameter value description

title

string

The title for the first post in the thread

body

string

The body for the first post in the thread

authorKey

long

The author user key (optional)

available response representations:

available response representations:

available response representations:

POST

Creates a new thread in the forum of the course node

acceptable request representations:

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/forum/{nodeId}/forum/posts/{threadKey}?start&limit&orderBy&asc

resource-wide template parameters
parameter value description

courseId

long

courseId

long

nodeId

string

threadKey

long

The key of the thread

Methods

GET

Retrieves the messages in the thread

request query parameters
parameter value description

start

int

Default: 0

limit

int

Default: 25

orderBy

string

Default: creationDate

(value name, creationDate)

asc

boolean

Default: true

(value true/false)

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/forum/{nodeId}/forum/posts/{messageKey}

resource-wide template parameters
parameter value description

courseId

long

courseId

long

nodeId

string

messageKey

long

The id of the reply message

Methods

POST

Creates a new reply in the forum of the course node

acceptable request representations:

available response representations:

available response representations:

available response representations:

PUT

Creates a new reply in the forum of the course node

acceptable request representations:

available response representations:

available response representations:

available response representations:

PUT

Creates a new reply in the forum of the course node

request query parameters
parameter value description

title

string

The title for the first post in the thread

body

string

The body for the first post in the thread

authorKey

long

The author user key (optional)

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/forum/{nodeId}/forum/posts/{messageKey}/attachments

resource-wide template parameters
parameter value description

courseId

long

courseId

long

nodeId

string

messageKey

long

The key of the message

Methods

GET

Retrieves the attachments of the message

available response representations:

available response representations:

POST

Upload the attachment of a message, as parameter:<br> filename The name of the attachment<br> file The attachment.

acceptable request representations:

available response representations:

available response representations:

PUT

Upload the attachment of a message, as parameter:<br> filename The name of the attachment<br> file The attachment.

acceptable request representations:

available response representations:

available response representations:

POST

Upload the attachment of a message, as parameter:<br> filename The name of the attachment<br> file The attachment.

available response representations:

available response representations:

/repo/courses/{courseId}/elements/forum/{nodeId}/forum/posts/{messageKey}/attachments/{filename}

resource-wide template parameters
parameter value description

courseId

long

courseId

long

nodeId

string

filename

string

The name of the attachment

messageKey

long

The identity key of the user being searched

Methods

GET

Retrieves the attachment of the message

available response representations:

available response representations:

/repo/courses/{courseId}/elements/contact?parentNodeId&position&shortTitle&longTitle&objectives&visibilityExpertRules&accessExpertRules&coaches&participants&groups&areas&to&defaultSubject&defaultBody

resource-wide template parameters
parameter value description

courseId

long

Methods

PUT

request query parameters
parameter value description

parentNodeId

string

position

int

shortTitle

string

Default: undefined

longTitle

string

Default: undefined

objectives

string

Default: undefined

visibilityExpertRules

string

accessExpertRules

string

coaches

boolean

Default: false

participants

boolean

Default: false

groups

string

areas

string

to

string

defaultSubject

string

defaultBody

string

available response representations:

POST

acceptable request representations:

available response representations:

/repo/courses/{courseId}/elements/folder

resource-wide template parameters
parameter value description

courseId

long

Methods

GET

available response representations:

PUT

request query parameters
parameter value description

parentNodeId

string

position

int

shortTitle

string

Default: undefined

longTitle

string

Default: undefined

objectives

string

Default: undefined

visibilityExpertRules

string

downloadExpertRules

string

uploadExpertRules

string

available response representations:

POST

acceptable request representations:

available response representations:

/repo/courses/{courseId}/elements/folder/{nodeId}

resource-wide template parameters
parameter value description

courseId

long

nodeId

string

courseId

long

Methods

POST

acceptable request representations:

available response representations:

GET

available response representations:

/repo/courses/{courseId}/elements/folder/{nodeId}/files

resource-wide template parameters
parameter value description

courseId

long

courseId

long

nodeId

string

Methods

GET

available response representations:

POST

available response representations:

POST

acceptable request representations:

available response representations:

PUT

available response representations:

PUT

acceptable request representations:

available response representations:

/repo/courses/{courseId}/elements/folder/{nodeId}/files/{path:.*}

resource-wide template parameters
parameter value description

courseId

long

courseId

long

nodeId

string

path

string

Methods

GET

available response representations:

POST

available response representations:

POST

acceptable request representations:

available response representations:

PUT

available response representations:

PUT

acceptable request representations:

available response representations:

PUT

available response representations:

DELETE

available response representations:

/repo/courses/{courseId}/elements/folder/{nodeId}/files/version

resource-wide template parameters
parameter value description

courseId

long

courseId

long

nodeId

string

Methods

GET

available response representations:

/repo/courses/{courseId}/elements/folder/{nodeId}/files/metadata/{path:.*}

resource-wide template parameters
parameter value description

courseId

long

courseId

long

nodeId

string

path

string

Methods

GET

available response representations:

/system

<h3>Description:</h3> <p> Initial Date: 18 jun. 2010 <br>

Methods

/system/environment

Methods

GET

Return some informations about the environment.

available response representations:

available response representations:

/system/release

Methods

GET

Return the version of the instance.

available response representations:

available response representations:

/system/notifications

Methods

/system/notifications/status

Methods

GET

Return the status of the notifications job: running, stopped

available response representations:

available response representations:

POST

Update the status of the notifications job: running, stopped. Running start the indexer, stopped, stop it.

acceptable request representations:

available response representations:

available response representations:

GET

Return the status of the notifications job: running, stopped

available response representations:

available response representations:

/system/log

Description:<br> This web service returns logFiles <P> Initial Date: 23.12.2011 <br>

Methods

GET

available response representations:

/system/log/version

Methods

GET

The version of the Log Web Service

available response representations:

/system/log/{date}

resource-wide template parameters
parameter value description

date

string

Methods

GET

available response representations:

/system/monitoring

Methods

/system/monitoring/configuration

Methods

GET

Return the configuration of the monitoring, which probes are available, which dependency...

available response representations:

available response representations:

/system/monitoring/runtime

Methods

GET

Return the statistics about runtime: uptime, classes loaded, memory summary, threads count...

available response representations:

available response representations:

/system/monitoring/runtime/classes

Methods

GET

Return some informations about the number of Java classes...

available response representations:

available response representations:

/system/monitoring/runtime/memory

Methods

GET

Return the statistics about memory

available response representations:

available response representations:

/system/monitoring/runtime/threads

Methods

GET

Return the statistics about threads

available response representations:

available response representations:

/system/monitoring/database

Methods

GET

Return the statistics about database and hibernate

available response representations:

available response representations:

/system/monitoring/openolat

Methods

GET

Return the statistics about OpenOLAT, users count, courses count...

available response representations:

available response representations:

/system/monitoring/openolat/tasks

Methods

GET

Return some statistics about long running tasks.

available response representations:

available response representations:

/system/monitoring/openolat/users

Methods

GET

Return the statistics about OpenOLAT users

available response representations:

available response representations:

/system/monitoring/openolat/sessions

Methods

GET

Return some statistics about session.

available response representations:

available response representations:

/system/monitoring/openolat/repository

Methods

GET

Return the statistics about the repository, courses count, published courses...

available response representations:

available response representations:

/system/monitoring/openolat/indexer

Methods

GET

Return the statistics about the indexer

available response representations:

available response representations:

/system/monitoring/openolat/indexer/status

Methods

GET

Return the status of the indexer: running, stopped

available response representations:

available response representations:

POST

Update the status of the indexer: running, stopped. Running start the indexer, stopped, stop it.

acceptable request representations:

available response representations:

available response representations:

GET

Return the status of the indexer: running, stopped

available response representations:

available response representations:

/system/monitoring/memory

<h3>Description:</h3> Initial Date: 21 juin 2010 <br>

Methods

GET

Return informations about memory.

available response representations:

available response representations:

GET

Return some informations about memory.

available response representations:

available response representations:

/system/monitoring/memory/pools

Methods

GET

available response representations:

GET

available response representations:

/system/monitoring/memory/samples?from&to&lastSamples

Methods

GET

request query parameters
parameter value description

from

string

to

string

lastSamples

int

available response representations:

/system/monitoring/threads

<h3>Description:</h3> Initial Date: 21 juin 2010 <br>

Methods

GET

available response representations:

GET

available response representations:

/system/monitoring/threads/cpu

Methods

GET

available response representations:

/system/indexer

Methods

GET

Return the statistics about the indexer

available response representations:

available response representations:

/system/indexer/status

Methods

GET

Return the status of the indexer: running, stopped

available response representations:

available response representations:

POST

Update the status of the indexer: running, stopped. Running start the indexer, stopped, stop it.

acceptable request representations:

available response representations:

available response representations:

GET

Return the status of the indexer: running, stopped

available response representations:

available response representations:

/repo/entries

Description:<br> This handles the repository entries <P> Initial Date: 19.05.2009 <br>

Methods

GET

List all entries in the OLAT repository

available response representations:

PUT

Import a resource in the repository

available response representations:

available response representations:

GET

List all entries in the OLAT repository

request query parameters
parameter value description

start

int

Default: 0

(optional)

limit

int

Default: 25

(optional)

managed

boolean

(optional)

externalId

string

External ID (optional)

externalRef

string

External reference number (optional)

resourceType

string

The resource type (CourseModule) (optional)

available response representations:

/repo/entries/search?type&author&name&myentries

Methods

GET

Search for repository entries, possible search attributes are name, author and type

request query parameters
parameter value description

type

string

Filter by the file resource type of the repository entry

author

string

Default: *

Filter by the author's username

name

string

Default: *

Filter by name of repository entry

myentries

boolean

Default: false

Only search entries the requester owns

available response representations:

available response representations:

/repo/entries/version

Methods

GET

The version number of this web service

available response representations:

/repo/entries/{repoEntryKey}

Description:<br> Repository entry resource <P> Initial Date: 19.05.2009 <br>

resource-wide template parameters
parameter value description

repoEntryKey

string

The key or soft key of the repository entry

Methods

DELETE

Delete a course by id

available response representations:

available response representations:

available response representations:

POST

acceptable request representations:

available response representations:

POST

Replace a resource in the repository and update its display name. The implementation is limited to CP.

available response representations:

available response representations:

GET

get a resource in the repository

available response representations:

available response representations:

/repo/entries/{repoEntryKey}/file

resource-wide template parameters
parameter value description

repoEntryKey

string

The key or soft key of the repository entry

repoEntryKey

string

Methods

GET

Download the export zip file of a repository entry.

available response representations:

available response representations:

available response representations:

available response representations:

available response representations:

/repo/entries/{repoEntryKey}/coaches/{identityKey}

resource-wide template parameters
parameter value description

repoEntryKey

string

The key or soft key of the repository entry

repoEntryKey

string

The key of the repository entry

identityKey

long

The user's id

Methods

PUT

Adds a coach to the repository entry.

available response representations:

available response representations:

available response representations:

DELETE

Removes the coach from the repository entry.

available response representations:

available response representations:

available response representations:

/repo/entries/{repoEntryKey}/coaches

resource-wide template parameters
parameter value description

repoEntryKey

string

The key or soft key of the repository entry

repoEntryKey

string

The key of the repository entry

Methods

GET

Returns the list of coaches of the repository entry.

available response representations:

available response representations:

/repo/entries/{repoEntryKey}/participants

resource-wide template parameters
parameter value description

repoEntryKey

string

The key or soft key of the repository entry

repoEntryKey

string

The key of the repository entry

Methods

GET

Returns the list of participants of the repository entry.

available response representations:

available response representations:

/repo/entries/{repoEntryKey}/participants/{identityKey}

resource-wide template parameters
parameter value description

repoEntryKey

string

The key or soft key of the repository entry

repoEntryKey

string

The key of the repository entry

identityKey

long

The user's id

Methods

PUT

Adds a participant to the repository entry.

available response representations:

available response representations:

available response representations:

DELETE

Removes the participant from the repository entry.

available response representations:

available response representations:

available response representations:

/repo/entries/{repoEntryKey}/owners

resource-wide template parameters
parameter value description

repoEntryKey

string

The key or soft key of the repository entry

repoEntryKey

string

The key of the repository entry

Methods

GET

Returns the list of owners of the repository entry specified by the groupKey.

available response representations:

available response representations:

/repo/entries/{repoEntryKey}/owners/{identityKey}

resource-wide template parameters
parameter value description

repoEntryKey

string

The key or soft key of the repository entry

repoEntryKey

string

The key of the repository entry

identityKey

long

The user's id

Methods

PUT

Adds an owner to the repository entry.

available response representations:

available response representations:

available response representations:

DELETE

Removes the owner from the repository entry.

available response representations:

available response representations:

available response representations:

/repo/courses/infos?start&limit

Description:<br> <P> Initial Date: 7 févr. 2012 <br>

Methods

GET

Get courses informations viewable by the authenticated user

request query parameters
parameter value description

start

int

Default: 0

limit

int

Default: 25

available response representations:

/repo/courses/infos/{courseId}

resource-wide template parameters
parameter value description

courseId

long

The course id

Methods

GET

Get course informations viewable by the authenticated user

available response representations:

/contacts?start&limit

Description:<br> <P> Initial Date: 21 oct. 2011 <br>

Methods

GET

Retrieve the contacts of the logged in identity.

request query parameters
parameter value description

start

int

Default: 0

limit

int

Default: 25

available response representations:

/users/{identityKey}/forums

Description:<br> <P> Initial Date: 6 déc. 2011 <br>

resource-wide template parameters
parameter value description

identityKey

long

The key of the user (IdentityImpl)

Methods

GET

Retrieves a list of forums on a user base. All forums of groups where the user is participant/tutor + all forums in course where the user is a participant (owner, tutor or participant)

available response representations:

available response representations:

/users/{identityKey}/forums/group/{groupKey}

Description:<br> Web service to manage a forum. <P> Initial Date: 20 apr. 2010 <br>

resource-wide template parameters
parameter value description

identityKey

long

The key of the user (IdentityImpl)

groupKey

long

Methods

GET

Retrieves the forum.

available response representations:

available response representations:

available response representations:

/users/{identityKey}/forums/group/{groupKey}/threads?start&limit&orderBy&asc

resource-wide template parameters
parameter value description

identityKey

long

The key of the user (IdentityImpl)

groupKey

long

Methods

GET

Retrieves the threads in the forum

request query parameters
parameter value description

start

int

Default: 0

limit

int

Default: 25

orderBy

string

Default: creationDate

(value name,creationDate)

asc

boolean

Default: true

(value true/false)

available response representations:

available response representations:

available response representations:

PUT

Creates a new thread in the forum of the course node

request query parameters
parameter value description

title

string

The title for the first post in the thread

body

string

The body for the first post in the thread

authorKey

long

The author user key (optional)

available response representations:

available response representations:

available response representations:

POST

Creates a new thread in the forum of the course node

acceptable request representations:

available response representations:

available response representations:

available response representations:

/users/{identityKey}/forums/group/{groupKey}/posts/{threadKey}?start&limit&orderBy&asc

resource-wide template parameters
parameter value description

identityKey

long

The key of the user (IdentityImpl)

groupKey

long

threadKey

long

The key of the thread

Methods

GET

Retrieves the messages in the thread

request query parameters
parameter value description

start

int

Default: 0

limit

int

Default: 25

orderBy

string

Default: creationDate

(value name, creationDate)

asc

boolean

Default: true

(value true/false)

available response representations:

available response representations:

available response representations:

/users/{identityKey}/forums/group/{groupKey}/posts/{messageKey}

resource-wide template parameters
parameter value description

identityKey

long

The key of the user (IdentityImpl)

groupKey

long

messageKey

long

The id of the reply message

Methods

POST

Creates a new reply in the forum of the course node

acceptable request representations:

available response representations:

available response representations:

available response representations:

PUT

Creates a new reply in the forum of the course node

acceptable request representations:

available response representations:

available response representations:

available response representations:

PUT

Creates a new reply in the forum of the course node

request query parameters
parameter value description

title

string

The title for the first post in the thread

body

string

The body for the first post in the thread

authorKey

long

The author user key (optional)

available response representations:

available response representations:

available response representations:

/users/{identityKey}/forums/group/{groupKey}/posts/{messageKey}/attachments

resource-wide template parameters
parameter value description

identityKey

long

The key of the user (IdentityImpl)

groupKey

long

messageKey

long

The key of the message

Methods

GET

Retrieves the attachments of the message

available response representations:

available response representations:

POST

Upload the attachment of a message, as parameter:<br> filename The name of the attachment<br> file The attachment.

acceptable request representations:

available response representations:

available response representations:

PUT

Upload the attachment of a message, as parameter:<br> filename The name of the attachment<br> file The attachment.

acceptable request representations:

available response representations:

available response representations:

POST

Upload the attachment of a message, as parameter:<br> filename The name of the attachment<br> file The attachment.

available response representations:

available response representations:

/users/{identityKey}/forums/group/{groupKey}/posts/{messageKey}/attachments/{filename}

resource-wide template parameters
parameter value description

identityKey

long

The key of the user (IdentityImpl)

groupKey

long

filename

string

The name of the attachment

messageKey

long

The identity key of the user being searched

Methods

GET

Retrieves the attachment of the message

available response representations:

available response representations:

/users/{identityKey}/forums/course/{courseKey}/{courseNodeId}

Description:<br> Web service to manage a forum. <P> Initial Date: 20 apr. 2010 <br>

resource-wide template parameters
parameter value description

identityKey

long

The key of the user (IdentityImpl)

courseKey

long

courseNodeId

string

Methods

GET

Retrieves the forum.

available response representations:

available response representations:

available response representations:

/users/{identityKey}/forums/course/{courseKey}/{courseNodeId}/threads?start&limit&orderBy&asc

resource-wide template parameters
parameter value description

identityKey

long

The key of the user (IdentityImpl)

courseKey

long

courseNodeId

string

Methods

GET

Retrieves the threads in the forum

request query parameters
parameter value description

start

int

Default: 0

limit

int

Default: 25

orderBy

string

Default: creationDate

(value name,creationDate)

asc

boolean

Default: true

(value true/false)

available response representations:

available response representations:

available response representations:

PUT

Creates a new thread in the forum of the course node

request query parameters
parameter value description

title

string

The title for the first post in the thread

body

string

The body for the first post in the thread

authorKey

long

The author user key (optional)

available response representations:

available response representations:

available response representations:

POST

Creates a new thread in the forum of the course node

acceptable request representations:

available response representations:

available response representations:

available response representations:

/users/{identityKey}/forums/course/{courseKey}/{courseNodeId}/posts/{threadKey}?start&limit&orderBy&asc

resource-wide template parameters
parameter value description

identityKey

long

The key of the user (IdentityImpl)

courseKey

long

courseNodeId

string

threadKey

long

The key of the thread

Methods

GET

Retrieves the messages in the thread

request query parameters
parameter value description

start

int

Default: 0

limit

int

Default: 25

orderBy

string

Default: creationDate

(value name, creationDate)

asc

boolean

Default: true

(value true/false)

available response representations:

available response representations:

available response representations:

/users/{identityKey}/forums/course/{courseKey}/{courseNodeId}/posts/{messageKey}

resource-wide template parameters
parameter value description

identityKey

long

The key of the user (IdentityImpl)

courseKey

long

courseNodeId

string

messageKey

long

The id of the reply message

Methods

POST

Creates a new reply in the forum of the course node

acceptable request representations:

available response representations:

available response representations:

available response representations:

PUT

Creates a new reply in the forum of the course node

acceptable request representations:

available response representations:

available response representations:

available response representations:

PUT

Creates a new reply in the forum of the course node

request query parameters
parameter value description

title

string

The title for the first post in the thread

body

string

The body for the first post in the thread

authorKey

long

The author user key (optional)

available response representations:

available response representations:

available response representations:

/users/{identityKey}/forums/course/{courseKey}/{courseNodeId}/posts/{messageKey}/attachments

resource-wide template parameters
parameter value description

identityKey

long

The key of the user (IdentityImpl)

courseKey

long

courseNodeId

string

messageKey

long

The key of the message

Methods

GET

Retrieves the attachments of the message

available response representations:

available response representations:

POST

Upload the attachment of a message, as parameter:<br> filename The name of the attachment<br> file The attachment.

acceptable request representations:

available response representations:

available response representations:

PUT

Upload the attachment of a message, as parameter:<br> filename The name of the attachment<br> file The attachment.

acceptable request representations:

available response representations:

available response representations:

POST

Upload the attachment of a message, as parameter:<br> filename The name of the attachment<br> file The attachment.

available response representations:

available response representations:

/users/{identityKey}/forums/course/{courseKey}/{courseNodeId}/posts/{messageKey}/attachments/{filename}

resource-wide template parameters
parameter value description

identityKey

long

The key of the user (IdentityImpl)

courseKey

long

courseNodeId

string

filename

string

The name of the attachment

messageKey

long

The identity key of the user being searched

Methods

GET

Retrieves the attachment of the message

available response representations:

available response representations:

/repo/lifecycle

Initial date: 10.06.2013<br>

Methods

GET

List all public lifecycles

available response representations:

/users

This web service handles functionalities related to <code>User</code>.

Methods

PUT

Creates and persists a new user entity

acceptable request representations:

available response representations:

available response representations:

available response representations:

GET

Search users and return them in a simple form (without user properties). User properties can be added two the query parameters. If the authUsername and the authProvider are set, the search is made only with these two parameters because they are sufficient to return a single user.<br> The search with login and user properties are made default with wild cards. If an exact match is needed, the parameter msut be quoted:<br> users?login="username"<br> Don't forget the right escaping in the URL!<br> You can make a search with the user properties like this:<br> users?telMobile=39847592&login=test

request query parameters
parameter value description

login

string

authProvider

string

authUsername

string

statusVisibleLimit

string

available response representations:

available response representations:

/users/{identityKey}

resource-wide template parameters
parameter value description

identityKey

long

The user key identifier of the user being searched

Methods

DELETE

Delete an user from the system

available response representations:

available response representations:

available response representations:

POST

Update an user

acceptable request representations:

available response representations:

available response representations:

available response representations:

available response representations:

GET

Retrieves an user given its unique key identifier

request query parameters
parameter value description

withPortrait

boolean

Default: false

If true return the portrait as Base64 (default false)

available response representations:

available response representations:

available response representations:

/users/managed

Methods

GET

available response representations:

/users/{identityKey}/roles

resource-wide template parameters
parameter value description

identityKey

long

The user key identifier of the user being searched

Methods

POST

Update the roles of a user given its unique key identifier

acceptable request representations:

available response representations:

available response representations:

available response representations:

GET

Retrieves the roles of a user given its unique key identifier

available response representations:

available response representations:

available response representations:

/users/{identityKey}/status

resource-wide template parameters
parameter value description

identityKey

long

The user key identifier of the user being searched

Methods

POST

Update the roles of a user given its unique key identifier: <ul> <li>1: Permanent user</li> <li>2: activ</li> <li>101: login denied</li> <li>199: deleted</li> </ul>

acceptable request representations:

available response representations:

available response representations:

available response representations:

GET

Retrieves the status of a user given its unique key identifier

available response representations:

available response representations:

available response representations:

/users/{identityKey}/preferences

resource-wide template parameters
parameter value description

identityKey

long

The user key identifier of the user being searched

Methods

GET

Retrieves the preferences of a user given its unique key identifier

available response representations:

available response representations:

available response representations:

POST

Update the preferences of a user given its unique key identifier

acceptable request representations:

available response representations:

available response representations:

available response representations:

/users/{identityKey}/portrait

resource-wide template parameters
parameter value description

identityKey

long

The identity key identifier of the user being searched

Methods

GET

Retrieves the portrait of an user

available response representations:

available response representations:

POST

Upload the portrait of an user

available response representations:

available response representations:

available response representations:

DELETE

Deletes the portrait of an user

available response representations:

available response representations:

/users/version

Methods

GET

The version of the User Web Service

available response representations:

/users/{identityKey}/folders

Description:<br> <P> Initial Date: 16 déc. 2011 <br>

resource-wide template parameters
parameter value description

identityKey

long

Methods

GET

Retrieves a list of folders on a user base. All folders of groups where the user is participant/tutor + all folders in course where the user is a participant (owner, tutor or participant)

available response representations:

available response representations:

/users/{identityKey}/folders/course/{courseKey}/{courseNodeId}

resource-wide template parameters
parameter value description

identityKey

long

courseKey

long

courseNodeId

string

Methods

GET

available response representations:

POST

available response representations:

POST

acceptable request representations:

available response representations:

PUT

available response representations:

PUT

acceptable request representations:

available response representations:

/users/{identityKey}/folders/course/{courseKey}/{courseNodeId}/{path:.*}

resource-wide template parameters
parameter value description

identityKey

long

courseKey

long

courseNodeId

string

path

string

Methods

GET

available response representations:

POST

available response representations:

POST

acceptable request representations:

available response representations:

PUT

available response representations:

PUT

acceptable request representations:

available response representations:

PUT

available response representations:

DELETE

available response representations:

/users/{identityKey}/folders/course/{courseKey}/{courseNodeId}/version

resource-wide template parameters
parameter value description

identityKey

long

courseKey

long

courseNodeId

string

Methods

GET

available response representations:

/users/{identityKey}/folders/course/{courseKey}/{courseNodeId}/metadata/{path:.*}

resource-wide template parameters
parameter value description

identityKey

long

courseKey

long

courseNodeId

string

path

string

Methods

GET

available response representations:

/users/{identityKey}/folders/group/{groupKey}

resource-wide template parameters
parameter value description

identityKey

long

groupKey

long

Methods

GET

available response representations:

POST

available response representations:

POST

acceptable request representations:

available response representations:

PUT

available response representations:

PUT

acceptable request representations:

available response representations:

/users/{identityKey}/folders/group/{groupKey}/{path:.*}

resource-wide template parameters
parameter value description

identityKey

long

groupKey

long

path

string

Methods

GET

available response representations:

POST

available response representations:

POST

acceptable request representations:

available response representations:

PUT

available response representations:

PUT

acceptable request representations:

available response representations:

PUT

available response representations:

DELETE

available response representations:

/users/{identityKey}/folders/group/{groupKey}/version

resource-wide template parameters
parameter value description

identityKey

long

groupKey

long

Methods

GET

available response representations:

/users/{identityKey}/folders/group/{groupKey}/metadata/{path:.*}

resource-wide template parameters
parameter value description

identityKey

long

groupKey

long

path

string

Methods

GET

available response representations:

/users/{identityKey}/folders/personal

resource-wide template parameters
parameter value description

identityKey

long

Methods

GET

available response representations:

POST

available response representations:

POST

acceptable request representations:

available response representations:

PUT

available response representations:

PUT

acceptable request representations:

available response representations:

/users/{identityKey}/folders/personal/{path:.*}

resource-wide template parameters
parameter value description

identityKey

long

path

string

Methods

GET

available response representations:

POST

available response representations:

POST

acceptable request representations:

available response representations:

PUT

available response representations:

PUT

acceptable request representations:

available response representations:

PUT

available response representations:

DELETE

available response representations:

/users/{identityKey}/folders/personal/version

resource-wide template parameters
parameter value description

identityKey

long

Methods

GET

available response representations:

/users/{identityKey}/folders/personal/metadata/{path:.*}

resource-wide template parameters
parameter value description

identityKey

long

path

string

Methods

GET

available response representations:

/users/{identityKey}/courses

resource-wide template parameters
parameter value description

identityKey

long

Methods

/users/{identityKey}/courses/my?start&limit

resource-wide template parameters
parameter value description

identityKey

long

Methods

GET

Retrieves the list of "My entries" but limited to courses.

request query parameters
parameter value description

start

int

Default: 0

The first result

limit

int

Default: 25

Max result

available response representations:

available response representations:

/users/{identityKey}/courses/teached?start&limit

resource-wide template parameters
parameter value description

identityKey

long

Methods

GET

Retrieves the list of "My supervised courses" but limited to courses.

request query parameters
parameter value description

start

int

Default: 0

The first result

limit

int

Default: 25

Max result

available response representations:

available response representations:

/users/{identityKey}/courses/favorite?start&limit

resource-wide template parameters
parameter value description

identityKey

long

Methods

GET

Retrieves the list of my favorite courses.

request query parameters
parameter value description

start

int

Default: 0

The first result

limit

int

Default: 25

Max result

available response representations:

available response representations:

/users/{identityKey}/groups?start&limit&externalId&managed

Description:<br> <P> Initial Date: 18 oct. 2011 <br>

resource-wide template parameters
parameter value description

identityKey

long

Methods

GET

Return all groups of a user where the user is coach or participant.

request query parameters
parameter value description

start

int

Default: 0

The first result

limit

int

Default: 25

The maximum results

externalId

string

Search with an external ID

managed

boolean

(true / false) Search only managed / not managed groups

available response representations:

available response representations:

/users/{identityKey}/groups/owner?start&limit&externalId&managed

resource-wide template parameters
parameter value description

identityKey

long

Methods

GET

Return all groups of a user where the user is coach/owner.

request query parameters
parameter value description

start

int

Default: 0

The first result

limit

int

Default: 25

The maximum results

externalId

string

Search with an external ID

managed

boolean

(true / false) Search only managed / not managed groups

available response representations:

available response representations:

/users/{identityKey}/groups/participant?start&limit&externalId&managed

resource-wide template parameters
parameter value description

identityKey

long

Methods

GET

Return all groups of a user where the user is participant.

request query parameters
parameter value description

start

int

Default: 0

The first result

limit

int

Default: 25

The maximum results

externalId

string

Search with an external ID

managed

boolean

(true / false) Search only managed / not managed groups

available response representations:

available response representations:

/users/{identityKey}/groups/infos?start&limit&externalId&managed

resource-wide template parameters
parameter value description

identityKey

long

Methods

GET

Return all groups with information of a user. Paging is mandatory!

request query parameters
parameter value description

start

int

Default: 0

The first result

limit

int

Default: 25

The maximum results

externalId

string

Search with an external ID

managed

boolean

(true / false) Search only managed / not managed groups

available response representations:

available response representations:

/repo/forums

Description:<br> Web service to manage forums. <P> Initial Date: 26 aug. 2010 <br>

Methods

/repo/forums/version

Methods

GET

The version of the Forum Web Service

available response representations:

/repo/forums/{forumKey}

Description:<br> Web service to manage a forum. <P> Initial Date: 20 apr. 2010 <br>

resource-wide template parameters
parameter value description

forumKey

long

The key of the forum

Methods

GET

Retrieves the forum.

available response representations:

available response representations:

available response representations:

/repo/forums/{forumKey}/threads?start&limit&orderBy&asc

resource-wide template parameters
parameter value description

forumKey

long

The key of the forum

Methods

GET

Retrieves the threads in the forum

request query parameters
parameter value description

start

int

Default: 0

limit

int

Default: 25

orderBy

string

Default: creationDate

(value name,creationDate)

asc

boolean

Default: true

(value true/false)

available response representations:

available response representations:

available response representations:

PUT

Creates a new thread in the forum of the course node

request query parameters
parameter value description

title

string

The title for the first post in the thread

body

string

The body for the first post in the thread

authorKey

long

The author user key (optional)

available response representations:

available response representations:

available response representations:

POST

Creates a new thread in the forum of the course node

acceptable request representations:

available response representations:

available response representations:

available response representations:

/repo/forums/{forumKey}/posts/{threadKey}?start&limit&orderBy&asc

resource-wide template parameters
parameter value description

forumKey

long

The key of the forum

threadKey

long

The key of the thread

Methods

GET

Retrieves the messages in the thread

request query parameters
parameter value description

start

int

Default: 0

limit

int

Default: 25

orderBy

string

Default: creationDate

(value name, creationDate)

asc

boolean

Default: true

(value true/false)

available response representations:

available response representations:

available response representations:

/repo/forums/{forumKey}/posts/{messageKey}

resource-wide template parameters
parameter value description

forumKey

long

The key of the forum

messageKey

long

The id of the reply message

Methods

POST

Creates a new reply in the forum of the course node

acceptable request representations:

available response representations:

available response representations:

available response representations:

PUT

Creates a new reply in the forum of the course node

acceptable request representations:

available response representations:

available response representations:

available response representations:

PUT

Creates a new reply in the forum of the course node

request query parameters
parameter value description

title

string

The title for the first post in the thread

body

string

The body for the first post in the thread

authorKey

long

The author user key (optional)

available response representations:

available response representations:

available response representations:

/repo/forums/{forumKey}/posts/{messageKey}/attachments

resource-wide template parameters
parameter value description

forumKey

long

The key of the forum

messageKey

long

The key of the message

Methods

GET

Retrieves the attachments of the message

available response representations:

available response representations:

POST

Upload the attachment of a message, as parameter:<br> filename The name of the attachment<br> file The attachment.

acceptable request representations:

available response representations:

available response representations:

PUT

Upload the attachment of a message, as parameter:<br> filename The name of the attachment<br> file The attachment.

acceptable request representations:

available response representations:

available response representations:

POST

Upload the attachment of a message, as parameter:<br> filename The name of the attachment<br> file The attachment.

available response representations:

available response representations:

/repo/forums/{forumKey}/posts/{messageKey}/attachments/{filename}

resource-wide template parameters
parameter value description

forumKey

long

The key of the forum

filename

string

The name of the attachment

messageKey

long

The identity key of the user being searched

Methods

GET

Retrieves the attachment of the message

available response representations:

available response representations:

/users/{username}/auth

This web service handles functionalities related to authentication credentials of users.

resource-wide template parameters
parameter value description

username

string

The username of the user to retrieve authentication

Methods

PUT

Creates and persists an authentication

acceptable request representations:

available response representations:

available response representations:

available response representations:

GET

Returns all user authentications

available response representations:

available response representations:

available response representations:

/users/{username}/auth/{authKey}

resource-wide template parameters
parameter value description

username

string

The username of the user to retrieve authentication

username

string

The username of the user

authKey

long

The authentication key identifier

Methods

DELETE

Deletes an authentication from the system

available response representations:

available response representations:

available response representations:

/users/{username}/auth/password

resource-wide template parameters
parameter value description

username

string

The username of the user to retrieve authentication

username

string

The username of the user to change the password

Methods

POST

Change the password of a user.

acceptable request representations:

available response representations:

available response representations:

available response representations:

available response representations:

/users/{username}/auth/version

resource-wide template parameters
parameter value description

username

string

The username of the user to retrieve authentication

Methods

GET

The version of the User Authentication Web Service

available response representations:

/i18n

Description:<br> This handles translations from the i18n module of OLAT. <P> Initial Date: 14 apr. 2010 <br>

Methods

/i18n/version

Methods

GET

Retrieves the version of the i18n Web Service.

available response representations:

/i18n/{package}/{key}?locale

resource-wide template parameters
parameter value description

package

string

The name of the package

key

string

The key to translate

Methods

GET

Return the translation of the key. If the "locale" parameter is not specified, the method try to use the "locale" of the user and if it hasn't, take the default locale.

request query parameters
parameter value description

locale

string

The locale (optional)

available response representations:

/repo/courses/{courseId}/elements

This interface provides course building capabilities from our REST API. <p> Initial Date: Feb 8, 2010 Time: 3:45:50 PM<br>

Methods

/repo/courses/{courseId}/elements/version

Methods

GET

The version of the Course Elements Web Service

available response representations:

/repo/courses/{courseId}/elements/{nodeId}

resource-wide template parameters
parameter value description

nodeId

string

The node's id

courseId

long

The course resourceable's id

Methods

GET

Retrieves metadata of the course node

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/structure/{nodeId}

resource-wide template parameters
parameter value description

nodeId

string

courseId

long

Methods

POST

This updates a Structure Element onto a given course.

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/structure

resource-wide template parameters
parameter value description

courseId

long

Methods

POST

This attaches a Structure Element onto a given course. The element will be inserted underneath the supplied parentNodeId.

available response representations:

available response representations:

available response representations:

PUT

This attaches a Structure Element onto a given course. The element will be inserted underneath the supplied parentNodeId.

request query parameters
parameter value description

parentNodeId

string

position

int

shortTitle

string

Default: undefined

longTitle

string

Default: undefined

objectives

string

Default: undefined

visibilityExpertRules

string

accessExpertRules

string

displayType

string

Default: toc

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/singlepage/{nodeId}

resource-wide template parameters
parameter value description

nodeId

string

courseId

long

Methods

POST

This updates a Single Page Element onto a given course.

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/singlepage

resource-wide template parameters
parameter value description

courseId

long

Methods

POST

This attaches a Single Page Element onto a given course. The element will be inserted underneath the supplied parentNodeId.

acceptable request representations:

available response representations:

available response representations:

available response representations:

POST

This attaches a Single Page Element onto a given course. The element will be inserted underneath the supplied parentNodeId.

available response representations:

available response representations:

available response representations:

PUT

This attaches a Single Page Element onto a given course. The element will be inserted underneath the supplied parentNodeId.

available response representations:

available response representations:

available response representations:

PUT

This attaches a Single Page Element onto a given course. The element will be inserted underneath the supplied parentNodeId.

request query parameters
parameter value description

parentNodeId

string

position

int

shortTitle

string

Default: undefined

longTitle

string

Default: undefined

objectives

string

Default: undefined

visibilityExpertRules

string

accessExpertRules

string

filename

string

path

string

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/task/{nodeId}

resource-wide template parameters
parameter value description

nodeId

string

The node's id of this task

courseId

long

The course resourceable id

Methods

POST

This updates a Task Element onto a given course.

acceptable request representations:

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/task

resource-wide template parameters
parameter value description

courseId

long

The course resourceable id

Methods

POST

This attaches a Task Element onto a given course. The element will be inserted underneath the supplied parentNodeId.

acceptable request representations:

available response representations:

available response representations:

available response representations:

PUT

This attaches a Task Element onto a given course. The element will be inserted underneath the supplied parentNodeId.

request query parameters
parameter value description

parentNodeId

string

The node's id which will be the parent of this task

position

int

The node's position relative to its sibling nodes (optional)

shortTitle

string

Default: undefined

The node short title

longTitle

string

Default: undefined

The node long title

objectives

string

Default: undefined

The node learning objectives

visibilityExpertRules

string

The rules to view the node (optional)

accessExpertRules

string

The rules to access the node (optional)

text

string

The task node text

points

float

The task node's possible points

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/test/{nodeId}

resource-wide template parameters
parameter value description

nodeId

string

courseId

long

Methods

POST

This updates a Test Element onto a given course.

acceptable request representations:

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/test

resource-wide template parameters
parameter value description

courseId

long

The course resourceable id

Methods

POST

This attaches a Test Element onto a given course. The element will be inserted underneath the supplied parentNodeId.

acceptable request representations:

available response representations:

available response representations:

available response representations:

PUT

This attaches a Test Element onto a given course. The element will be inserted underneath the supplied parentNodeId.

request query parameters
parameter value description

parentNodeId

string

The node's id which will be the parent of this test

position

int

The test node's id which is retorned in the response of the import test resource

shortTitle

string

Default: undefined

The node's position relative to its sibling nodes (optional)

longTitle

string

Default: undefined

The node short title

objectives

string

Default: undefined

The node long title

visibilityExpertRules

string

The node learning objectives

accessExpertRules

string

The rules to view the node (optional)

testResourceableId

long

The rules to access the node (optional)

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/assessment/{nodeId}

resource-wide template parameters
parameter value description

nodeId

string

The node's id of this assessment

courseId

long

The course resourceable's id

Methods

POST

Updates an assessment building block.

acceptable request representations:

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/assessment

resource-wide template parameters
parameter value description

courseId

long

The course resourceable's id

Methods

POST

Attaches an assessment building block.

acceptable request representations:

available response representations:

available response representations:

available response representations:

PUT

Attaches an assessment building block.

request query parameters
parameter value description

parentNodeId

string

The node's id which will be the parent of this assessment

position

int

The node's position relative to its sibling nodes (optional)

shortTitle

string

Default: undefined

The node short title

longTitle

string

Default: undefined

The node long title

objectives

string

Default: undefined

The node learning objectives

visibilityExpertRules

string

The rules to view the node (optional)

accessExpertRules

string

The rules to access the node (optional)

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/wiki/{nodeId}

resource-wide template parameters
parameter value description

nodeId

string

The node's id which of this wiki

courseId

long

The course resourceable's id

Methods

POST

Attaches an wiki building block.

acceptable request representations:

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/wiki?parentNodeId&position&shortTitle&longTitle&objectives&visibilityExpertRules&accessExpertRules&wikiResourceableId

resource-wide template parameters
parameter value description

courseId

long

Methods

POST

Attaches an wiki building block.

request query parameters
parameter value description

parentNodeId

string

position

int

shortTitle

string

Default: undefined

longTitle

string

Default: undefined

objectives

string

Default: undefined

visibilityExpertRules

string

accessExpertRules

string

wikiResourceableId

long

available response representations:

available response representations:

available response representations:

PUT

Attaches an wiki building block.

request query parameters
parameter value description

parentNodeId

string

position

int

shortTitle

string

Default: undefined

longTitle

string

Default: undefined

objectives

string

Default: undefined

visibilityExpertRules

string

accessExpertRules

string

wikiResourceableId

long

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/blog/{nodeId}

resource-wide template parameters
parameter value description

nodeId

string

The node's id of this blog

courseId

long

The course resourceable's id

Methods

POST

Update an blog building block.

acceptable request representations:

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/blog?parentNodeId&position&shortTitle&longTitle&objectives&visibilityExpertRules&accessExpertRules&repoEntry

resource-wide template parameters
parameter value description

courseId

long

The course resourceable's id

Methods

POST

Attaches an blog building block.

request query parameters
parameter value description

parentNodeId

string

The node's id which will be the parent of this assessment

position

int

The node's position relative to its sibling nodes (optional)

shortTitle

string

Default: undefined

The node short title

longTitle

string

Default: undefined

The node long title

objectives

string

Default: undefined

The node learning objectives

visibilityExpertRules

string

The rules to view the node (optional)

accessExpertRules

string

The rules to access the node (optional)

repoEntry

long

The softkey of the blog resourceable (optional)

available response representations:

available response representations:

available response representations:

PUT

Attaches an blog building block.

request query parameters
parameter value description

parentNodeId

string

The node's id which will be the parent of this assessment

position

int

The node's position relative to its sibling nodes (optional)

shortTitle

string

Default: undefined

The node short title

longTitle

string

Default: undefined

The node long title

objectives

string

Default: undefined

The node learning objectives

visibilityExpertRules

string

The rules to view the node (optional)

accessExpertRules

string

The rules to access the node (optional)

repoEntry

long

The softkey of the blog resourceable (optional)

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/survey/{nodeId}

resource-wide template parameters
parameter value description

nodeId

string

The node's id which will be the parent of this assessment

courseId

long

The course resourceable's id

Methods

POST

Attaches an survey building block.

acceptable request representations:

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/survey?parentNodeId&position&shortTitle&longTitle&objectives&visibilityExpertRules&accessExpertRules&surveyResourceableId

resource-wide template parameters
parameter value description

courseId

long

Methods

POST

Attaches an survey building block.

request query parameters
parameter value description

parentNodeId

string

position

int

shortTitle

string

Default: undefined

The node's position relative to its sibling nodes (optional)

longTitle

string

Default: undefined

The node short title

objectives

string

Default: undefined

The node long title

visibilityExpertRules

string

The node learning objectives

accessExpertRules

string

The rules to view the node (optional)

surveyResourceableId

long

The rules to access the node (optional)

available response representations:

available response representations:

available response representations:

PUT

Attaches an survey building block.

request query parameters
parameter value description

parentNodeId

string

position

int

shortTitle

string

Default: undefined

longTitle

string

Default: undefined

objectives

string

Default: undefined

visibilityExpertRules

string

accessExpertRules

string

surveyResourceableId

long

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/externalpage/{nodeId}

resource-wide template parameters
parameter value description

parentNodeId

string

The node's id of this external page

courseId

long

The course resourceable's id

Methods

POST

Update an external page building block.

acceptable request representations:

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/externalpage?parentNodeId&position&shortTitle&longTitle&objectives&visibilityExpertRules&accessExpertRules&url

resource-wide template parameters
parameter value description

courseId

long

The course resourceable's id

Methods

POST

Attaches an external page building block.

request query parameters
parameter value description

parentNodeId

string

The node's id which will be the parent of this assessment

position

int

The node's position relative to its sibling nodes (optional)

shortTitle

string

Default: undefined

The node short title

longTitle

string

Default: undefined

The node long title

objectives

string

Default: undefined

The node learning objectives

visibilityExpertRules

string

The rules to view the node (optional)

accessExpertRules

string

The rules to access the node (optional)

url

string

The URL of the external page

available response representations:

available response representations:

available response representations:

PUT

Attaches an external page building block.

request query parameters
parameter value description

parentNodeId

string

The node's id which will be the parent of this assessment

position

int

The node's position relative to its sibling nodes (optional)

shortTitle

string

Default: undefined

The node short title

longTitle

string

Default: undefined

The node long title

objectives

string

Default: undefined

The node learning objectives

visibilityExpertRules

string

The rules to view the node (optional)

accessExpertRules

string

The rules to access the node (optional)

url

string

The URL of the external page

available response representations:

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/task/{nodeId}/file

resource-wide template parameters
parameter value description

nodeId

string

The node's id which will be the parent of this task file

courseId

long

The course resourceable id

Methods

POST

This attaches a Task file onto a given task element.

available response representations:

available response representations:

available response representations:

PUT

This attaches a Task file onto a given task element.

available response representations:

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/task/{nodeId}/configuration?enableAssignment&taskAssignmentType&taskAssignmentText&enableTaskPreview&enableTaskDeselect&onlyOneUserPerTask&enableDropbox&enableDropboxConfirmationMail&dropboxConfirmationText&enableReturnbox&enableScoring&grantScoring&scoreMin&scoreMax&grantPassing&scorePassingThreshold&enableCommentField&commentForUser&commentForCoaches&enableSolution&accessExpertRuleTask&accessExpertRuleDropbox&accessExpertRuleReturnbox&accessExpertRuleScoring&accessExpertRuleSolution

resource-wide template parameters
parameter value description

nodeId

string

courseId

long

Methods

POST

This attaches the run-time configuration onto a given task element.

request query parameters
parameter value description

enableAssignment

boolean

taskAssignmentType

string

taskAssignmentText

string

enableTaskPreview

boolean

enableTaskDeselect

boolean

onlyOneUserPerTask

boolean

enableDropbox

boolean

enableDropboxConfirmationMail

boolean

dropboxConfirmationText

string

enableReturnbox

boolean

enableScoring

boolean

grantScoring

boolean

scoreMin

float

scoreMax

float

grantPassing

boolean

scorePassingThreshold

float

enableCommentField

boolean

commentForUser

string

commentForCoaches

string

enableSolution

boolean

accessExpertRuleTask

string

accessExpertRuleDropbox

string

accessExpertRuleReturnbox

string

accessExpertRuleScoring

string

accessExpertRuleSolution

string

available response representations:

available response representations:

available response representations:

available response representations:

available response representations:

PUT

This attaches the run-time configuration onto a given task element.

request query parameters
parameter value description

enableAssignment

boolean

taskAssignmentType

string

taskAssignmentText

string

enableTaskPreview

boolean

enableTaskDeselect

boolean

onlyOneUserPerTask

boolean

enableDropbox

boolean

enableDropboxConfirmationMail

boolean

dropboxConfirmationText

string

enableReturnbox

boolean

enableScoring

boolean

grantScoring

boolean

scoreMin

float

scoreMax

float

grantPassing

boolean

scorePassingThreshold

float

enableCommentField

boolean

commentForUser

string

commentForCoaches

string

enableSolution

boolean

accessExpertRuleTask

string

accessExpertRuleDropbox

string

accessExpertRuleReturnbox

string

accessExpertRuleScoring

string

accessExpertRuleSolution

string

available response representations:

available response representations:

available response representations:

available response representations:

available response representations:

GET

Retrieves configuration of the task course node

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/survey/{nodeId}/configuration?allowCancel&allowNavigation&allowSuspend&sequencePresentation&showNavigation&showQuestionTitle&showSectionsOnly

resource-wide template parameters
parameter value description

nodeId

string

courseId

long

Methods

POST

This attaches the run-time configuration onto a given survey element.

request query parameters
parameter value description

allowCancel

boolean

Default: false

allowNavigation

boolean

Default: false

allowSuspend

boolean

Default: false

sequencePresentation

string

Default: itemPage

showNavigation

boolean

Default: true

showQuestionTitle

boolean

Default: true

showSectionsOnly

boolean

Default: false

available response representations:

available response representations:

available response representations:

available response representations:

available response representations:

PUT

This attaches the run-time configuration onto a given survey element.

request query parameters
parameter value description

allowCancel

boolean

Default: false

allowNavigation

boolean

Default: false

allowSuspend

boolean

Default: false

sequencePresentation

string

Default: itemPage

showNavigation

boolean

Default: true

showQuestionTitle

boolean

Default: true

showSectionsOnly

boolean

Default: false

available response representations:

available response representations:

available response representations:

available response representations:

available response representations:

GET

Retrieves configuration of the survey course node

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/elements/test/{nodeId}/configuration?allowCancel&allowNavigation&allowSuspend&numAttempts&sequencePresentation&showNavigation&showQuestionTitle&showResultsAfterFinish&showResultsDependendOnDate&showResultsOnHomepage&showScoreInfo&showQuestionProgress&showScoreProgress&showSectionsOnly&summaryPresentation&startDate&endDate

resource-wide template parameters
parameter value description

nodeId

string

courseId

long

Methods

POST

This attaches the run-time configuration onto a given test element.

request query parameters
parameter value description

allowCancel

boolean

Default: false

allowNavigation

boolean

Default: false

allowSuspend

boolean

Default: false

numAttempts

int

Default: 0

sequencePresentation

string

Default: itemPage

showNavigation

boolean

Default: true

showQuestionTitle

boolean

Default: true

showResultsAfterFinish

boolean

Default: true

showResultsDependendOnDate

boolean

Default: false

showResultsOnHomepage

boolean

Default: false

showScoreInfo

boolean

Default: true

showQuestionProgress

boolean

Default: true

showScoreProgress

boolean

Default: true

showSectionsOnly

boolean

Default: false

summaryPresentation

string

Default: summaryCompact

startDate

long

endDate

long

available response representations:

available response representations:

available response representations:

available response representations:

available response representations:

PUT

This attaches the run-time configuration onto a given test element.

request query parameters
parameter value description

allowCancel

boolean

Default: false

allowNavigation

boolean

Default: false

allowSuspend

boolean

Default: false

numAttempts

int

Default: 0

sequencePresentation

string

Default: itemPage

showNavigation

boolean

Default: true

showQuestionTitle

boolean

Default: true

showResultsAfterFinish

boolean

Default: true

showResultsDependendOnDate

boolean

Default: false

showResultsOnHomepage

boolean

Default: false

showScoreInfo

boolean

Default: true

showQuestionProgress

boolean

Default: true

showScoreProgress

boolean

Default: true

showSectionsOnly

boolean

Default: false

summaryPresentation

string

Default: summaryCompact

startDate

long

endDate

long

available response representations:

available response representations:

available response representations:

available response representations:

available response representations:

GET

Retrieves configuration of the test course node

available response representations:

available response representations:

available response representations:

/notifications?date&type

<h3>Description:</h3> REST API for notifications <p> Initial Date: 25 aug 2010 <br>

Methods

GET

Retrieves the notification of the logged in user.

request query parameters
parameter value description

date

string

The date (optional)

type

string

The type of notifications (User, Forum...) (optional)

available response representations:

available response representations:

/repo/courses/{courseId}/assessments

Description:<br> Retrieve and import course assessments <P> Initial Date: 7 apr. 2010 <br>

resource-wide template parameters
parameter value description

courseId

long

The course resourceable's id

Methods

GET

Returns the results of the course.

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/assessments/version

resource-wide template parameters
parameter value description

courseId

long

The course resourceable's id

Methods

GET

Retireves the version of the Course Assessment Web Service.

available response representations:

/repo/courses/{courseId}/assessments/users/{identityKey}

resource-wide template parameters
parameter value description

courseId

long

The course resourceable's id

identityKey

long

The id of the user

courseId

long

The course resourceable's id

Methods

GET

Returns the results of the course.

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/assessments/{nodeId}

resource-wide template parameters
parameter value description

courseId

long

The course resourceable's id

nodeId

string

The id of the course building block

courseId

long

The resourceable id of the course

Methods

GET

Exports results for an assessable course node for all students.

available response representations:

available response representations:

available response representations:

POST

Imports results for an assessable course node for the authenticated student.

acceptable request representations:

available response representations:

available response representations:

available response representations:

/repo/courses/{courseId}/assessments/{nodeId}/users/{identityKey}

resource-wide template parameters
parameter value description

courseId

long

The course resourceable's id

nodeId

long

The ident of the course building block

identityKey

long

The id of the user

courseId

long

The course resourceable's id

Methods

GET

Returns the results of a student at a specific assessable node

available response representations:

available response representations:

available response representations:

Representations

application/xml

application/json

application/x-www-form-urlencoded

application/xml

application/json

application/xml

application/json

application/xml, application/json (ns3:catalogEntryVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<catalogEntries totalCount="0">
    <catalogEntries>
        <catalogEntry>
            <key>478</key>
            <name>Category</name>
            <description>Description of the category</description>
            <type>0</type>
        </catalogEntry>
    </catalogEntries>
</catalogEntries>

The list of roots catalog entries

XML Schema

Source:

The path could not be resolved to a valid catalog entry

application/xml, application/json (ns3:userVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<users totalCount="0">
    <users>
        <user>
            <key>345</key>
            <login>john</login>
            <password></password>
            <firstName>John</firstName>
            <lastName>Smith</lastName>
            <email>john.smith@frentix.com</email>
            <properties>
                <property>
                    <name>telPrivate</name>
                    <value>238456782</value>
                </property>
                <property>
                    <name>telMobile</name>
                    <value>238456782</value>
                </property>
            </properties>
        </user>
    </users>
</users>

The catalog entry

XML Schema

Source:

Not authorized

The path could not be resolved to a valid catalog entry

application/xml, application/json (ns3:userVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<users totalCount="0">
    <users>
        <user>
            <key>345</key>
            <login>john</login>
            <password></password>
            <firstName>John</firstName>
            <lastName>Smith</lastName>
            <email>john.smith@frentix.com</email>
            <properties>
                <property>
                    <name>telPrivate</name>
                    <value>238456782</value>
                </property>
                <property>
                    <name>telMobile</name>
                    <value>238456782</value>
                </property>
            </properties>
        </user>
    </users>
</users>

The catalog entry

XML Schema

Source:

Not authorized

The path could not be resolved to a valid catalog entry

application/xml, application/json (ns3:userVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<users totalCount="0">
    <users>
        <user>
            <key>345</key>
            <login>john</login>
            <password></password>
            <firstName>John</firstName>
            <lastName>Smith</lastName>
            <email>john.smith@frentix.com</email>
            <properties>
                <property>
                    <name>telPrivate</name>
                    <value>238456782</value>
                </property>
                <property>
                    <name>telMobile</name>
                    <value>238456782</value>
                </property>
            </properties>
        </user>
    </users>
</users>

The catalog entry

XML Schema

Source:

Not authorized

The path could not be resolved to a valid catalog entry

application/xml, application/json (ns3:catalogEntryVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<catalogEntries totalCount="0">
    <catalogEntries>
        <catalogEntry>
            <key>478</key>
            <name>Category</name>
            <description>Description of the category</description>
            <type>0</type>
        </catalogEntry>
    </catalogEntries>
</catalogEntries>

The list of catalog entries

XML Schema

Source:

text/plain

Example
1.0

The version of this specific Web Service

application/xml, application/json (ns3:catalogEntryVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<catalogEntryVO>
    <key>478</key>
    <name>Category</name>
    <description>Description of the category</description>
    <type>0</type>
</catalogEntryVO>

The catalog entry

XML Schema

Source:

The path could not be resolved to a valid catalog entry

application/xml (catalogEntryVO)

XML Schema

Source:

application/json (catalogEntryVO)

XML Schema

Source:

The path could not be resolved to a valid catalog entry

application/xml, application/json (ns3:catalogEntryVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<catalogEntryVO>
    <key>478</key>
    <name>Category</name>
    <description>Description of the category</description>
    <type>0</type>
</catalogEntryVO>

The catalog entry

XML Schema

Source:

Not authorized

The path could not be resolved to a valid catalog entry

application/xml, application/json (ns3:catalogEntryVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<catalogEntryVO>
    <key>478</key>
    <name>Category</name>
    <description>Description of the category</description>
    <type>0</type>
</catalogEntryVO>

The catalog entry

XML Schema

Source:

Not authorized

application/x-www-form-urlencoded

The path could not be resolved to a valid catalog entry

application/xml, application/json (ns3:catalogEntryVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<catalogEntryVO>
    <key>478</key>
    <name>Category</name>
    <description>Description of the category</description>
    <type>0</type>
</catalogEntryVO>

The catalog entry

XML Schema

Source:

Not authorized

application/xml (catalogEntryVO)

XML Schema

Source:

application/json (catalogEntryVO)

XML Schema

Source:

The path could not be resolved to a valid catalog entry

application/xml, application/json (ns3:catalogEntryVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<catalogEntryVO>
    <key>478</key>
    <name>Category</name>
    <description>Description of the category</description>
    <type>0</type>
</catalogEntryVO>

The catalog entry

XML Schema

Source:

Not authorized

The path could not be resolved to a valid catalog entry

application/xml, application/json (ns3:catalogEntryVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<catalogEntryVO>
    <key>478</key>
    <name>Category</name>
    <description>Description of the category</description>
    <type>0</type>
</catalogEntryVO>

The catalog entry

XML Schema

Source:

Not authorized

The path could not be resolved to a valid catalog entry

application/xml, application/json (ns3:catalogEntryVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<catalogEntryVO>
    <key>478</key>
    <name>Category</name>
    <description>Description of the category</description>
    <type>0</type>
</catalogEntryVO>

The catalog entry

XML Schema

Source:

Not authorized

The path could not be resolved to a valid catalog entry

application/xml, application/json (ns3:userVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<users totalCount="0">
    <users>
        <user>
            <key>345</key>
            <login>john</login>
            <password></password>
            <firstName>John</firstName>
            <lastName>Smith</lastName>
            <email>john.smith@frentix.com</email>
            <properties>
                <property>
                    <name>telPrivate</name>
                    <value>238456782</value>
                </property>
                <property>
                    <name>telMobile</name>
                    <value>238456782</value>
                </property>
            </properties>
        </user>
    </users>
</users>

The catalog entry

XML Schema

Source:

Not authorized

text/plain

Example
1.0

Return the version number

text/html

image/jpeg

Images for the documentation

image/jpeg

Images for the documentation

text/html, application/xhtml+xml

The copyright of the REST API.

text/plain

The copyright of the REST API.

application/xml (groupVO)

XML Schema

Source:

application/json (groupVO)

XML Schema

Source:

The business group cannot be found

application/xml, application/json (ns3:groupVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<groupVO>
    <key>123467</key>
    <description>My group description</description>
    <externalId>External Identifier</externalId>
    <managedFlags>title,description</managedFlags>
    <name>My group</name>
    <minParticipants>0</minParticipants>
    <maxParticipants>0</maxParticipants>
</groupVO>

The saved business group

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json (ns3:groupVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<groups totalCount="0">
    <groups>
        <group>
            <key>123467</key>
            <description>My group description</description>
            <externalId>External Identifier</externalId>
            <managedFlags>title,description</managedFlags>
            <name>My group</name>
            <minParticipants>0</minParticipants>
            <maxParticipants>0</maxParticipants>
        </group>
    </groups>
</groups>

This is the list of all groups in OLAT system

XML Schema

Source:

text/plain

Example
1.0

The version of this specific Web Service

application/xml, application/json (ns3:groupVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<groupVO>
    <key>123467</key>
    <description>My group description</description>
    <externalId>External Identifier</externalId>
    <managedFlags>title,description</managedFlags>
    <name>My group</name>
    <minParticipants>0</minParticipants>
    <maxParticipants>0</maxParticipants>
</groupVO>

A business group in the OLAT system

XML Schema

Source:

application/xml (groupVO)

XML Schema

Source:

application/json (groupVO)

XML Schema

Source:

The business group cannot be found

application/xml, application/json (ns3:groupVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<groupVO>
    <key>123467</key>
    <description>My group description</description>
    <externalId>External Identifier</externalId>
    <managedFlags>title,description</managedFlags>
    <name>My group</name>
    <minParticipants>0</minParticipants>
    <maxParticipants>0</maxParticipants>
</groupVO>

The saved business group

XML Schema

Source:

The roles of the authenticated user are not sufficient

The business group cannot be found

The business group is deleted

The roles of the authenticated user are not sufficient

*/* (groupVO)

XML Schema

Source:

*/*

The business group cannot be found

application/xml, application/json (ns3:groupInfoVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<groupInfoVO folderWrite="false">
    <key>123467</key>
    <description>My group description</description>
    <externalId>External identifier</externalId>
    <name>My group</name>
    <minParticipants>0</minParticipants>
    <maxParticipants>0</maxParticipants>
    <news>&lt;p&gt;Hello world&lt;/p&gt;</news>
    <forumKey>374589</forumKey>
    <hasWiki>false</hasWiki>
    <hasFolder>false</hasFolder>
</groupInfoVO>

Participants of the business group

XML Schema

Source:

The business group cannot be found

application/xml, application/json (ns3:userVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<users totalCount="0">
    <users>
        <user>
            <key>345</key>
            <login>john</login>
            <password></password>
            <firstName>John</firstName>
            <lastName>Smith</lastName>
            <email>john.smith@frentix.com</email>
            <properties>
                <property>
                    <name>telPrivate</name>
                    <value>238456782</value>
                </property>
                <property>
                    <name>telMobile</name>
                    <value>238456782</value>
                </property>
            </properties>
        </user>
    </users>
</users>

Owners of the business group

XML Schema

Source:

The business group cannot be found

application/xml, application/json (ns3:userVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<users totalCount="0">
    <users>
        <user>
            <key>345</key>
            <login>john</login>
            <password></password>
            <firstName>John</firstName>
            <lastName>Smith</lastName>
            <email>john.smith@frentix.com</email>
            <properties>
                <property>
                    <name>telPrivate</name>
                    <value>238456782</value>
                </property>
                <property>
                    <name>telMobile</name>
                    <value>238456782</value>
                </property>
            </properties>
        </user>
    </users>
</users>

Participants of the business group

XML Schema

Source:

The business group or the user cannot be found

The user is added as owner of the group

The roles of the authenticated user are not sufficient

The business group or the user cannot be found

The user is removed as owner from the group

The roles of the authenticated user are not sufficient

The business group or the user cannot be found

The user is added as participant of the group

The roles of the authenticated user are not sufficient

The business group or the user cannot be found

The user is remove from the group as participant

The roles of the authenticated user are not sufficient

The forum not found

application/xml, application/json (ns3:forumVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<forum name="My forum" detailsName="It is a forum" forumKey="3865487" courseKey="286" courseNodeId="2784628" subscribed="false"/>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVOes)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messages totalCount="1">
    <messages>
        <message>
            <key>380</key>
            <authorKey>345</authorKey>
            <title>A message</title>
            <body>The content of the message</body>
        </message>
    </messages>
</messages>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The author, forum or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVOes)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messages totalCount="1">
    <messages>
        <message>
            <key>380</key>
            <authorKey>345</authorKey>
            <title>A message</title>
            <body>The content of the message</body>
        </message>
    </messages>
</messages>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The author or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml (replyVO)

XML Schema

Source:

application/json (replyVO)

XML Schema

Source:

The author or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The message not found

application/xml, application/json

The links to the attachments

application/x-www-form-urlencoded

The identity or the portrait not found

application/json, application/xml

Ok

application/xml (fileUpload)

XML Schema

Source:

application/json (fileUpload)

XML Schema

Source:

The identity or the portrait not found

application/json, application/xml

Ok

The identity or the portrait not found

application/json, application/xml

Ok

The identity or the portrait not found

application/octet-stream

The portrait as image

application/json

application/xml

text/html

application/octet-stream

*/*

application/json

application/xml

application/x-www-form-urlencoded

application/json

application/xml

application/json

application/xml

application/json (fileUpload)

XML Schema

Source:

application/xml (fileUpload)

XML Schema

Source:

application/json

application/xml

application/json

application/xml

text/html

application/octet-stream

*/*

application/json

application/xml

*/*

application/x-www-form-urlencoded

application/json

application/xml

*/*

application/json

application/xml

*/*

application/json (fileUpload)

XML Schema

Source:

application/xml (fileUpload)

XML Schema

Source:

application/json

application/xml

application/json

application/xml

application/json

application/xml

text/plain

application/json

application/xml

application/zip

application/octet-stream

application/xml, application/json, application/json;pagingspec=1.0 (ns3:courseVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courses totalCount="0">
    <courses>
        <course>
            <key>777</key>
            <softKey>internal_fx_cp</softKey>
            <repoEntryKey>27684</repoEntryKey>
            <externalId>External identifier</externalId>
            <externalRef>External reference</externalRef>
            <managedFlags>title,description</managedFlags>
            <title>Demo course</title>
            <displayName>Demo course</displayName>
        </course>
    </courses>
</courses>

List of visible courses

XML Schema

Source:

application/xml (courseVO)

XML Schema

Source:

application/json (courseVO)

XML Schema

Source:

application/xml, application/json (ns3:courseVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseVO>
    <key>777</key>
    <softKey>internal_fx_cp</softKey>
    <repoEntryKey>27684</repoEntryKey>
    <externalId>External identifier</externalId>
    <externalRef>External reference</externalRef>
    <managedFlags>title,description</managedFlags>
    <title>Demo course</title>
    <displayName>Demo course</displayName>
</courseVO>

The metadatas of the created course

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json (ns3:courseVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseVO>
    <key>777</key>
    <softKey>internal_fx_cp</softKey>
    <repoEntryKey>27684</repoEntryKey>
    <externalId>External identifier</externalId>
    <externalRef>External reference</externalRef>
    <managedFlags>title,description</managedFlags>
    <title>Demo course</title>
    <displayName>Demo course</displayName>
</courseVO>

The metadatas of the created course

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml

application/json

text/plain

Example
1.0

The version of this specific Web Service

The course not found

The metadatas of the created course

The roles of the authenticated user are not sufficient

The course not found

application/xml, application/json (ns3:courseVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseVO>
    <key>777</key>
    <softKey>internal_fx_cp</softKey>
    <repoEntryKey>27684</repoEntryKey>
    <externalId>External identifier</externalId>
    <externalRef>External reference</externalRef>
    <managedFlags>title,description</managedFlags>
    <title>Demo course</title>
    <displayName>Demo course</displayName>
</courseVO>

The metadatas of the created course

XML Schema

Source:

The course not found

application/xml, application/json (ns3:courseConfigVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseVO>
    <sharedFolderSoftKey>head_1_olat_43985684395</sharedFolderSoftKey>
</courseVO>

The configuration of the course

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The course not found

application/xml, application/json (ns3:courseConfigVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseVO>
    <sharedFolderSoftKey>head_1_olat_43985684395</sharedFolderSoftKey>
</courseVO>

The metadatas of the created course

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course not found

application/xml, application/json (ns3:userVO)

The array of authors

XML Schema

Source:

The roles of the authenticated user are not sufficient

text/plain

Example
1.0

The version of this specific Web Service

The course not found

application/zip

The course as a ZIP file

Not authorized to export the course

The course not found

application/xml

The run structure of the course

The roles of the authenticated user are not sufficient

The course not found

application/xml

The editor tree model of the course

The roles of the authenticated user are not sufficient

The course not found or the user is not an onwer or author of the course

application/xml, application/json (ns3:userVO)

The author

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or the user not found

The user is an author and owner of the course

The roles of the authenticated user are not sufficient

The course or the user not found

The user was successfully removed as owner of the course

The roles of the authenticated user are not sufficient

The course or the user not found

The user is a coach of the course

The roles of the authenticated user are not sufficient

The course not found

application/xml, application/json (ns3:userVO)

The array of coaches

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course not found

application/xml, application/json (ns3:userVO)

The array of participants

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or the user not found

The user is a participant of the course

The roles of the authenticated user are not sufficient

application/xml

application/json

The course not found

application/xml, application/json (ns3:courseVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseVO>
    <key>777</key>
    <softKey>internal_fx_cp</softKey>
    <repoEntryKey>27684</repoEntryKey>
    <externalId>External identifier</externalId>
    <externalRef>External reference</externalRef>
    <managedFlags>title,description</managedFlags>
    <title>Demo course</title>
    <displayName>Demo course</displayName>
</courseVO>

The metadatas of the created course

XML Schema

Source:

The roles of the authenticated user are not sufficient

The context of the group not found

application/xml, application/json (ns3:groupVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<groups totalCount="0">
    <groups>
        <group>
            <key>123467</key>
            <description>My group description</description>
            <externalId>External Identifier</externalId>
            <managedFlags>title,description</managedFlags>
            <name>My group</name>
            <minParticipants>0</minParticipants>
            <maxParticipants>0</maxParticipants>
        </group>
    </groups>
</groups>

The list of all learning group of the course

XML Schema

Source:

application/xml (groupVO)

XML Schema

Source:

application/json (groupVO)

XML Schema

Source:

application/xml, application/json (ns3:groupVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<groupVO>
    <key>123467</key>
    <description>My group description</description>
    <externalId>External Identifier</externalId>
    <managedFlags>title,description</managedFlags>
    <name>My group</name>
    <minParticipants>0</minParticipants>
    <maxParticipants>0</maxParticipants>
</groupVO>

The persisted group

XML Schema

Source:

The roles of the authenticated user are not sufficient

The business group cannot be found

application/xml, application/json (ns3:groupVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<groupVO>
    <key>123467</key>
    <description>My group description</description>
    <externalId>External Identifier</externalId>
    <managedFlags>title,description</managedFlags>
    <name>My group</name>
    <minParticipants>0</minParticipants>
    <maxParticipants>0</maxParticipants>
</groupVO>

This is the list of all groups in OLAT system

XML Schema

Source:

The business group cannot be found

The business group is deleted

The roles of the authenticated user are not sufficient

*/* (groupVO)

XML Schema

Source:

The business group cannot be found

application/xml, application/json (ns3:groupVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<groupVO>
    <key>123467</key>
    <description>My group description</description>
    <externalId>External Identifier</externalId>
    <managedFlags>title,description</managedFlags>
    <name>My group</name>
    <minParticipants>0</minParticipants>
    <maxParticipants>0</maxParticipants>
</groupVO>

The saved group

XML Schema

Source:

The roles of the authenticated user are not sufficient

text/plain

Example
1.0

The version of this specific Web Service

The forum not found

application/xml, application/json (ns3:forumVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<forum name="My forum" detailsName="It is a forum" forumKey="3865487" courseKey="286" courseNodeId="2784628" subscribed="false"/>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVOes)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messages totalCount="1">
    <messages>
        <message>
            <key>380</key>
            <authorKey>345</authorKey>
            <title>A message</title>
            <body>The content of the message</body>
        </message>
    </messages>
</messages>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The author, forum or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVOes)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messages totalCount="1">
    <messages>
        <message>
            <key>380</key>
            <authorKey>345</authorKey>
            <title>A message</title>
            <body>The content of the message</body>
        </message>
    </messages>
</messages>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The author or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml (replyVO)

XML Schema

Source:

application/json (replyVO)

XML Schema

Source:

The author or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The message not found

application/xml, application/json

The links to the attachments

application/x-www-form-urlencoded

The identity or the portrait not found

application/json, application/xml

Ok

application/xml (fileUpload)

XML Schema

Source:

application/json (fileUpload)

XML Schema

Source:

The identity or the portrait not found

application/json, application/xml

Ok

The identity or the portrait not found

application/json, application/xml

Ok

The identity or the portrait not found

application/octet-stream

The portrait as image

application/json

application/xml

text/html

application/octet-stream

*/*

application/json

application/xml

application/x-www-form-urlencoded

application/json

application/xml

application/json

application/xml

application/json (fileUpload)

XML Schema

Source:

application/xml (fileUpload)

XML Schema

Source:

application/json

application/xml

application/json

application/xml

text/html

application/octet-stream

*/*

application/json

application/xml

*/*

application/x-www-form-urlencoded

application/json

application/xml

*/*

application/json

application/xml

*/*

application/json (fileUpload)

XML Schema

Source:

application/xml (fileUpload)

XML Schema

Source:

application/json

application/xml

application/json

application/xml

application/json

application/xml

text/plain

application/json

application/xml

application/xml

application/json

application/xml (eventVO)

XML Schema

Source:

application/json (eventVO)

XML Schema

Source:

application/xml

application/json

application/x-www-form-urlencoded

application/xml (eventVO)

XML Schema

Source:

application/json (eventVO)

XML Schema

Source:

application/xml

application/json

application/xml

application/json

application/xml

application/json

application/xml (viteroBookingVO)

XML Schema

Source:

application/json (viteroBookingVO)

XML Schema

Source:

application/xml

application/json

application/xml (viteroBookingVO)

XML Schema

Source:

application/json (viteroBookingVO)

XML Schema

Source:

application/xml

application/json

application/xml

application/json

application/xml

application/json

application/xml

application/json

application/xml

application/json

text/plain

Example
Ping

Return a small string

text/plain

Example
1.0

The version of this specific Web Service

text/plain

Example
Ping

Return a small string

text/plain

Example
1.0

The version of this specific Web Service

The course not found

The list of files

The roles of the authenticated user are not sufficient

The course or course node not found

The file is correctly saved

The course node is not acceptable to copy a file

The roles of the authenticated user are not sufficient

The course or course node not found

The file is correctly saved

The course node is not acceptable to copy a file

The roles of the authenticated user are not sufficient

The course not found

The list of files

The roles of the authenticated user are not sufficient

The course or course node not found

The file is correctly saved

The course node is not acceptable to copy a file

The roles of the authenticated user are not sufficient

The course or course node not found

The file is correctly saved

The course node is not acceptable to copy a file

The roles of the authenticated user are not sufficient

The course or the shared folder not found

The list of files

The roles of the authenticated user are not sufficient

The course or the shared folder not found

The list of files

The roles of the authenticated user are not sufficient

The identity not found

text/plain, application/xml

Example
&lt;hello&gt;Hello john&lt;/hello&gt;

Say hello to the authenticated user, and give it a security token

The authentication has failed

text/plain

Example
1.0

The version of this specific Web Service

application/x-www-form-urlencoded

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:forumVOes)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<forums totalCount="1">
    <forums>
        <forums name="My forum" detailsName="It is a forum" forumKey="3865487" courseKey="286" courseNodeId="2784628" subscribed="false"/>
    </forums>
</forums>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:forumVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<forum name="My forum" detailsName="It is a forum" forumKey="3865487" courseKey="286" courseNodeId="2784628" subscribed="false"/>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The forum not found

application/xml, application/json (ns3:forumVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<forum name="My forum" detailsName="It is a forum" forumKey="3865487" courseKey="286" courseNodeId="2784628" subscribed="false"/>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVOes)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messages totalCount="1">
    <messages>
        <message>
            <key>380</key>
            <authorKey>345</authorKey>
            <title>A message</title>
            <body>The content of the message</body>
        </message>
    </messages>
</messages>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The author, forum or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVOes)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messages totalCount="1">
    <messages>
        <message>
            <key>380</key>
            <authorKey>345</authorKey>
            <title>A message</title>
            <body>The content of the message</body>
        </message>
    </messages>
</messages>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The author or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml (replyVO)

XML Schema

Source:

application/json (replyVO)

XML Schema

Source:

The author or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The message not found

application/xml, application/json

The links to the attachments

application/x-www-form-urlencoded

The identity or the portrait not found

application/json, application/xml

Ok

application/xml (fileUpload)

XML Schema

Source:

application/json (fileUpload)

XML Schema

Source:

The identity or the portrait not found

application/json, application/xml

Ok

The identity or the portrait not found

application/json, application/xml

Ok

The identity or the portrait not found

application/octet-stream

The portrait as image

application/xml

application/json

application/x-www-form-urlencoded

application/xml

application/json

application/xml

application/json

application/xml

application/json

application/x-www-form-urlencoded

application/xml

application/json

application/x-www-form-urlencoded

application/xml

application/json

application/xml

application/json

application/json

application/xml

text/html

application/octet-stream

*/*

application/json

application/xml

application/x-www-form-urlencoded

application/json

application/xml

application/json

application/xml

application/json (fileUpload)

XML Schema

Source:

application/xml (fileUpload)

XML Schema

Source:

application/json

application/xml

application/json

application/xml

text/html

application/octet-stream

*/*

application/json

application/xml

*/*

application/x-www-form-urlencoded

application/json

application/xml

*/*

application/json

application/xml

*/*

application/json (fileUpload)

XML Schema

Source:

application/xml (fileUpload)

XML Schema

Source:

application/json

application/xml

application/json

application/xml

application/json

application/xml

text/plain

application/json

application/xml

application/xml, application/json (ns3:environmentVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<environmentVO arch="x86_64" osName="Mac OS X" osVersion="10.7.2" availableProcessors="4" runtimeName="15261@agam.local" vmName="Java HotSpot(TM) 64-Bit Server VM" vmVendor="Apple Inc." vmVersion="20.4-b02-402"/>

A short summary of the number of classes

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json (ns3:releaseVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<versionVO buildVersion="" olatVersion="" repoRevision=""/>

The verison of the instance

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json

The status of the notifications job

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The status has changed

The roles of the authenticated user are not sufficient

text/plain

The status of the notifications job

The roles of the authenticated user are not sufficient

text/plain

application/octet-stream

text/plain

Example
1.0

The version of this specific Web Service

text/plain

application/octet-stream

application/xml, application/json (ns3:releaseVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<monitoringInfosVO>
    <type>openolat</type>
    <description>this is an OpenOLAT instance</description>
    <probes>
        <probe>Environment</probe>
        <probe>System</probe>
        <probe>Runtime</probe>
        <probe>Memory</probe>
    </probes>
    <dependencies>
        <dependency type="openfire" url="localhost"/>
        <dependency type="mysql" url="192.168.1.120"/>
    </dependencies>
</monitoringInfosVO>

The verison of the instance

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json (ns3:runtimeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<runtimeVO systemLoadAverage="1.16748046875" startTime="2015-07-15T13:18:08.591+02:00" upTime="21248">
    <classes loadedClassCount="7000" unloadedClassCount="1500" totalLoadedClassCount="8500"/>
    <threads threadCount="102" daemonCount="45" peakThreadCount="123"/>
    <memory usedMemory="12" freeMemory="45" totalMemory="56" initHeap="0" usedHeap="0" committedHeap="0" maxHeap="0" initNonHeap="0" usedNonHeap="0" committedNonHeap="0" maxNonHeap="0" garbageCollectionTime="0" garbageCollectionCount="0"/>
</runtimeVO>

The version of the instance

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json (ns3:classesVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<classeStatisticsVO loadedClassCount="7000" unloadedClassCount="1500" totalLoadedClassCount="8500"/>

A short summary of the number of classes

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json (ns3:runtimeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<memoryStatisticsVO usedMemory="12" freeMemory="45" totalMemory="56" initHeap="0" usedHeap="0" committedHeap="0" maxHeap="0" initNonHeap="0" usedNonHeap="0" committedNonHeap="0" maxNonHeap="0" garbageCollectionTime="0" garbageCollectionCount="0"/>

The version of the instance

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json (ns3:runtimeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<threadStatisticsVO threadCount="102" daemonCount="45" peakThreadCount="123"/>

The version of the instance

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json (ns3:runtimeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<databaseVO>
    <connectionInfos activeConnectionCount="10" currentConnectionCount="25"/>
    <hibernateStatistics openSessionsCount="12" transactionsCount="13900" successfulTransactionCount="13980" failedTransactionsCount="2" optimisticFailureCount="23" queryExecutionMaxTime="12000" queryExecutionMaxTimeQueryString="select * from PLock" queryExecutionCount="1237"/>
</databaseVO>

The version of the instance

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json (ns3:releaseVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<openolatStatisticsVO/>

The verison of the instance

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json (ns3:taskVOes)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<sessionsVO count="234" authenticatedCount="234" secureAuthenticatedCount="234" webdavCount="23" secureWebdavCount="12" restCount="0" secureRestCount="0" instantMessagingCount="123" authenticatedClickCountLastMinute="0" authenticatedPollCountLastMinute="0" authenticatedClickCountLastFiveMinutes="0" requestLastMinute="0" requestLastFiveMinutes="0" authenticatedPollCountLastFiveMinutes="0" concurrentDispatchThreads="0"/>

A short summary about sessions

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json (ns3:releaseVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<userStatisticsVO totalUserCount="0" activeUserCount="0" activeUserCountLastDay="0" activeUserCountLastWeek="0" activeUserCountLastMonth="0" activeUserCountLast6Month="0" externalUserCount="0" blockedUserCount="0" deletedUserCount="0" totalGroupCount="0"/>

The verison of the instance

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json (ns3:sessionVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<sessionsVO count="234" authenticatedCount="234" secureAuthenticatedCount="234" webdavCount="23" secureWebdavCount="12" restCount="0" secureRestCount="0" instantMessagingCount="123" authenticatedClickCountLastMinute="0" authenticatedPollCountLastMinute="0" authenticatedClickCountLastFiveMinutes="0" requestLastMinute="0" requestLastFiveMinutes="0" authenticatedPollCountLastFiveMinutes="0" concurrentDispatchThreads="0"/>

A short summary about sessions

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json (ns3:releaseVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<repositoryStatisticsVO coursesCount="0" publishedCoursesCount="0"/>

The verison of the instance

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json (ns3:releaseVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<indexerStatisticsVO indexedDocumentCount="0" excludedDocumentCount="0" documentQueueSize="0" runningFolderIndexerCount="0" availableFolderIndexerCount="0" indexSize="0" indexingTime="0"/>

Statistics about the indexer

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json

The status of the indexer

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The status has changed

The roles of the authenticated user are not sufficient

text/plain

The status of the indexer

The roles of the authenticated user are not sufficient

text/plain

Informations about memory

The roles of the authenticated user are not sufficient

application/xml, application/json (ns3:memoryVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<memoryVO date="2015-07-15T13:18:08.591+02:00" totalMem="230" totalUsed="546" maxAvailable="2000"/>

A short summary of the number of classes

XML Schema

Source:

The roles of the authenticated user are not sufficient

text/plain

application/xml

application/json

application/xml

application/json

text/plain

application/xml

application/json

application/xml

application/json

application/xml, application/json (ns3:releaseVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<indexerStatisticsVO indexedDocumentCount="0" excludedDocumentCount="0" documentQueueSize="0" runningFolderIndexerCount="0" availableFolderIndexerCount="0" indexSize="0" indexingTime="0"/>

Statistics about the indexer

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json

The status of the indexer

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The status has changed

The roles of the authenticated user are not sufficient

text/plain

The status of the indexer

The roles of the authenticated user are not sufficient

text/plain, text/html, application/xml, application/json (ns3:repositoryEntryVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<repositoryEntries totalCount="1">
    <repositoryEntries>
        <repositoryEntrie>
            <key>479286</key>
            <softkey>internal_cp</softkey>
            <resourcename>fdhasl</resourcename>
            <displayname>CP-demo</displayname>
            <externalId>External identifier</externalId>
            <externalRef>External reference</externalRef>
            <managedFlags>title.description</managedFlags>
            <resourceableId>4368567</resourceableId>
            <resourceableTypeName>CourseModule</resourceableTypeName>
        </repositoryEntrie>
    </repositoryEntries>
</repositoryEntries>

List all entries in the repository

XML Schema

Source:

application/xml, application/json (ns3:repositoryEntryVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<repositoryEntryVO>
    <key>479286</key>
    <softkey>internal_cp</softkey>
    <resourcename>fdhasl</resourcename>
    <displayname>CP-demo</displayname>
    <externalId>External identifier</externalId>
    <externalRef>External reference</externalRef>
    <managedFlags>title.description</managedFlags>
    <resourceableId>4368567</resourceableId>
    <resourceableTypeName>CourseModule</resourceableTypeName>
</repositoryEntryVO>

Import the resource and return the repository entry

XML Schema

Source:

The roles of the authenticated user are not sufficient

text/plain, text/html, application/xml, application/json (ns3:repositoryEntryVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<repositoryEntries totalCount="1">
    <repositoryEntries>
        <repositoryEntrie>
            <key>479286</key>
            <softkey>internal_cp</softkey>
            <resourcename>fdhasl</resourcename>
            <displayname>CP-demo</displayname>
            <externalId>External identifier</externalId>
            <externalRef>External reference</externalRef>
            <managedFlags>title.description</managedFlags>
            <resourceableId>4368567</resourceableId>
            <resourceableTypeName>CourseModule</resourceableTypeName>
        </repositoryEntrie>
    </repositoryEntries>
</repositoryEntries>

List all entries in the repository

XML Schema

Source:

application/xml, application/json (ns3:repositoryEntryVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<repositoryEntryVO>
    <key>479286</key>
    <softkey>internal_cp</softkey>
    <resourcename>fdhasl</resourcename>
    <displayname>CP-demo</displayname>
    <externalId>External identifier</externalId>
    <externalRef>External reference</externalRef>
    <managedFlags>title.description</managedFlags>
    <resourceableId>4368567</resourceableId>
    <resourceableTypeName>CourseModule</resourceableTypeName>
</repositoryEntryVO>

Search for repository entries

XML Schema

Source:

The roles of the authenticated user are not sufficient

text/plain

The course not found

The metadatas of the created course

The roles of the authenticated user are not sufficient

application/xml (repositoryEntryVO)

XML Schema

Source:

application/json (repositoryEntryVO)

XML Schema

Source:

application/xml

application/json

application/xml, application/json (ns3:repositoryEntryVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<repositoryEntryVO>
    <key>479286</key>
    <softkey>internal_cp</softkey>
    <resourcename>fdhasl</resourcename>
    <displayname>CP-demo</displayname>
    <externalId>External identifier</externalId>
    <externalRef>External reference</externalRef>
    <managedFlags>title.description</managedFlags>
    <resourceableId>4368567</resourceableId>
    <resourceableTypeName>CourseModule</resourceableTypeName>
</repositoryEntryVO>

Replace the resource and return the updated repository entry

XML Schema

Source:

The roles of the authenticated user are not sufficient

The repository entry not found

application/xml, application/json (ns3:repositoryEntryVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<repositoryEntryVO>
    <key>479286</key>
    <softkey>internal_cp</softkey>
    <resourcename>fdhasl</resourcename>
    <displayname>CP-demo</displayname>
    <externalId>External identifier</externalId>
    <externalRef>External reference</externalRef>
    <managedFlags>title.description</managedFlags>
    <resourceableId>4368567</resourceableId>
    <resourceableTypeName>CourseModule</resourceableTypeName>
</repositoryEntryVO>

Get the repository resource

XML Schema

Source:

The resource is locked

The resource could not found

application/zip

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<repositoryEntryVO>
    <key>479286</key>
    <softkey>internal_cp</softkey>
    <resourcename>fdhasl</resourcename>
    <displayname>CP-demo</displayname>
    <externalId>External identifier</externalId>
    <externalRef>External reference</externalRef>
    <managedFlags>title.description</managedFlags>
    <resourceableId>4368567</resourceableId>
    <resourceableTypeName>CourseModule</resourceableTypeName>
</repositoryEntryVO>

Download the repository entry as export zip file

Download of this resource is not possible

The roles of the authenticated user are not sufficient

The repository entry or the user cannot be found

The user is added as coach of the repository entry

The roles of the authenticated user are not sufficient

The repository entry or the user cannot be found

The user is removed as coach from the repository entry

The roles of the authenticated user are not sufficient

The repository entry cannot be found

application/xml, application/json (ns3:userVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<users totalCount="0">
    <users>
        <user>
            <key>345</key>
            <login>john</login>
            <password></password>
            <firstName>John</firstName>
            <lastName>Smith</lastName>
            <email>john.smith@frentix.com</email>
            <properties>
                <property>
                    <name>telPrivate</name>
                    <value>238456782</value>
                </property>
                <property>
                    <name>telMobile</name>
                    <value>238456782</value>
                </property>
            </properties>
        </user>
    </users>
</users>

Coaches of the repository entry

XML Schema

Source:

The repository entry cannot be found

application/xml, application/json (ns3:userVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<users totalCount="0">
    <users>
        <user>
            <key>345</key>
            <login>john</login>
            <password></password>
            <firstName>John</firstName>
            <lastName>Smith</lastName>
            <email>john.smith@frentix.com</email>
            <properties>
                <property>
                    <name>telPrivate</name>
                    <value>238456782</value>
                </property>
                <property>
                    <name>telMobile</name>
                    <value>238456782</value>
                </property>
            </properties>
        </user>
    </users>
</users>

Coaches of the repository entry

XML Schema

Source:

The repository entry or the user cannot be found

The user is added as participant of the repository entry

The roles of the authenticated user are not sufficient

The repository entry or the user cannot be found

The user is removed as participant from the repository entry

The roles of the authenticated user are not sufficient

The repository entry cannot be found

application/xml, application/json (ns3:userVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<users totalCount="0">
    <users>
        <user>
            <key>345</key>
            <login>john</login>
            <password></password>
            <firstName>John</firstName>
            <lastName>Smith</lastName>
            <email>john.smith@frentix.com</email>
            <properties>
                <property>
                    <name>telPrivate</name>
                    <value>238456782</value>
                </property>
                <property>
                    <name>telMobile</name>
                    <value>238456782</value>
                </property>
            </properties>
        </user>
    </users>
</users>

Owners of the repository entry

XML Schema

Source:

The repository entry or the user cannot be found

The user is added as owner of the repository entry

The roles of the authenticated user are not sufficient

The repository entry or the user cannot be found

The user is removed as owner from the repository entry

The roles of the authenticated user are not sufficient

application/xml, application/json, application/json;pagingspec=1.0 (ns3:courseVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseInfoVOes totalCount="1">
    <infos>
        <infos>
            <key>777</key>
            <softKey>oo_98237498</softKey>
            <repoEntryKey>456</repoEntryKey>
            <title>Demo course</title>
            <displayName>Demo course</displayName>
        </infos>
    </infos>
</courseInfoVOes>

List of visible courses

XML Schema

Source:

application/xml, application/json (ns3:courseVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseVO>
    <key>777</key>
    <softKey>oo_98237498</softKey>
    <repoEntryKey>456</repoEntryKey>
    <title>Demo course</title>
    <displayName>Demo course</displayName>
</courseVO>

Course informations

XML Schema

Source:

The list of contacts

application/xml, application/json (ns3:forumVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<forum name="My forum" detailsName="It is a forum" forumKey="3865487" courseKey="286" courseNodeId="2784628" subscribed="false"/>

The forums

XML Schema

Source:

The roles of the authenticated user are not sufficient

The forum not found

application/xml, application/json (ns3:forumVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<forum name="My forum" detailsName="It is a forum" forumKey="3865487" courseKey="286" courseNodeId="2784628" subscribed="false"/>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVOes)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messages totalCount="1">
    <messages>
        <message>
            <key>380</key>
            <authorKey>345</authorKey>
            <title>A message</title>
            <body>The content of the message</body>
        </message>
    </messages>
</messages>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The author, forum or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVOes)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messages totalCount="1">
    <messages>
        <message>
            <key>380</key>
            <authorKey>345</authorKey>
            <title>A message</title>
            <body>The content of the message</body>
        </message>
    </messages>
</messages>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The author or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml (replyVO)

XML Schema

Source:

application/json (replyVO)

XML Schema

Source:

The author or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The message not found

application/xml, application/json

The links to the attachments

application/x-www-form-urlencoded

The identity or the portrait not found

application/json, application/xml

Ok

application/xml (fileUpload)

XML Schema

Source:

application/json (fileUpload)

XML Schema

Source:

The identity or the portrait not found

application/json, application/xml

Ok

The identity or the portrait not found

application/json, application/xml

Ok

The identity or the portrait not found

application/octet-stream

The portrait as image

The forum not found

application/xml, application/json (ns3:forumVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<forum name="My forum" detailsName="It is a forum" forumKey="3865487" courseKey="286" courseNodeId="2784628" subscribed="false"/>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVOes)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messages totalCount="1">
    <messages>
        <message>
            <key>380</key>
            <authorKey>345</authorKey>
            <title>A message</title>
            <body>The content of the message</body>
        </message>
    </messages>
</messages>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The author, forum or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVOes)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messages totalCount="1">
    <messages>
        <message>
            <key>380</key>
            <authorKey>345</authorKey>
            <title>A message</title>
            <body>The content of the message</body>
        </message>
    </messages>
</messages>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The author or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml (replyVO)

XML Schema

Source:

application/json (replyVO)

XML Schema

Source:

The author or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The message not found

application/xml, application/json

The links to the attachments

application/x-www-form-urlencoded

The identity or the portrait not found

application/json, application/xml

Ok

application/xml (fileUpload)

XML Schema

Source:

application/json (fileUpload)

XML Schema

Source:

The identity or the portrait not found

application/json, application/xml

Ok

The identity or the portrait not found

application/json, application/xml

Ok

The identity or the portrait not found

application/octet-stream

The portrait as image

text/plain, text/html, application/xml, application/json (ns3:repositoryEntryVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<repositoryEntries totalCount="1">
    <repositoryEntries>
        <repositoryEntrie>
            <key>479286</key>
            <softkey>internal_cp</softkey>
            <resourcename>fdhasl</resourcename>
            <displayname>CP-demo</displayname>
            <externalId>External identifier</externalId>
            <externalRef>External reference</externalRef>
            <managedFlags>title.description</managedFlags>
            <resourceableId>4368567</resourceableId>
            <resourceableTypeName>CourseModule</resourceableTypeName>
        </repositoryEntrie>
    </repositoryEntries>
</repositoryEntries>

List all entries in the repository

XML Schema

Source:

application/xml (userVO)

XML Schema

Source:

application/json (userVO)

XML Schema

Source:

application/xml, application/json

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<userVO>
    <key>345</key>
    <login>john</login>
    <password></password>
    <firstName>John</firstName>
    <lastName>Smith</lastName>
    <email>john.smith@frentix.com</email>
    <properties>
        <property>
            <name>telPrivate</name>
            <value>238456782</value>
        </property>
        <property>
            <name>telMobile</name>
            <value>238456782</value>
        </property>
    </properties>
</userVO>

The persisted user

application/xml, application/json

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<errorVOes>
    <errorVO>
        <code>org.olat.restapi:error</code>
        <translation>Hello world, there is an error</translation>
    </errorVO>
</errorVOes>

The list of errors

The roles of the authenticated user are not sufficient

application/xml, application/json (ns3:userVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<users totalCount="0">
    <users>
        <user>
            <key>345</key>
            <login>john</login>
            <password></password>
            <firstName>John</firstName>
            <lastName>Smith</lastName>
            <email>john.smith@frentix.com</email>
            <properties>
                <property>
                    <name>telPrivate</name>
                    <value>238456782</value>
                </property>
                <property>
                    <name>telMobile</name>
                    <value>238456782</value>
                </property>
            </properties>
        </user>
    </users>
</users>

The list of all users in the OLAT system

XML Schema

Source:

The roles of the authenticated user are not sufficient

The identity not found

The user is removed from the group

The roles of the authenticated user are not sufficient

application/xml (userVO)

XML Schema

Source:

application/json (userVO)

XML Schema

Source:

The identity not found

application/xml, application/json (ns3:userVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<userVO>
    <key>345</key>
    <login>john</login>
    <password></password>
    <firstName>John</firstName>
    <lastName>Smith</lastName>
    <email>john.smith@frentix.com</email>
    <properties>
        <property>
            <name>telPrivate</name>
            <value>238456782</value>
        </property>
        <property>
            <name>telMobile</name>
            <value>238456782</value>
        </property>
    </properties>
</userVO>

The user

XML Schema

Source:

application/xml, application/json (ns3:errorVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<errorVOes>
    <errorVO>
        <code>org.olat.restapi:error</code>
        <translation>Hello world, there is an error</translation>
    </errorVO>
</errorVOes>

The list of validation errors

XML Schema

Source:

The roles of the authenticated user are not sufficient

The identity not found

application/xml, application/json

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<userVO>
    <key>345</key>
    <login>john</login>
    <password></password>
    <firstName>John</firstName>
    <lastName>Smith</lastName>
    <email>john.smith@frentix.com</email>
    <properties>
        <property>
            <name>telPrivate</name>
            <value>238456782</value>
        </property>
        <property>
            <name>telMobile</name>
            <value>238456782</value>
        </property>
    </properties>
</userVO>

The user

The roles of the authenticated user are not sufficient

application/xml

application/json

application/xml (rolesVO)

XML Schema

Source:

application/json (rolesVO)

XML Schema

Source:

The identity not found

application/xml, application/json

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<rolesVO>
    <olatAdmin>false</olatAdmin>
    <userManager>false</userManager>
    <groupManager>false</groupManager>
    <author>true</author>
    <guestOnly>false</guestOnly>
    <institutionalResourceManager>false</institutionalResourceManager>
    <poolAdmin>false</poolAdmin>
    <invitee>false</invitee>
</rolesVO>

The user

The roles of the authenticated user are not sufficient

The identity not found

application/xml, application/json

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<rolesVO>
    <olatAdmin>false</olatAdmin>
    <userManager>false</userManager>
    <groupManager>false</groupManager>
    <author>true</author>
    <guestOnly>false</guestOnly>
    <institutionalResourceManager>false</institutionalResourceManager>
    <poolAdmin>false</poolAdmin>
    <invitee>false</invitee>
</rolesVO>

The user

The roles of the authenticated user are not sufficient

application/xml (statusVO)

XML Schema

Source:

application/json (statusVO)

XML Schema

Source:

The identity not found

application/xml, application/json

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<rolesVO>
    <olatAdmin>false</olatAdmin>
    <userManager>false</userManager>
    <groupManager>false</groupManager>
    <author>true</author>
    <guestOnly>false</guestOnly>
    <institutionalResourceManager>false</institutionalResourceManager>
    <poolAdmin>false</poolAdmin>
    <invitee>false</invitee>
</rolesVO>

The user

The roles of the authenticated user are not sufficient

The identity not found

application/xml, application/json

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<statusVO>
    <status>2</status>
</statusVO>

The user

The roles of the authenticated user are not sufficient

The identity not found

application/xml, application/json

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<preferencesVO>
    <language>de</language>
</preferencesVO>

The preferences

The roles of the authenticated user are not sufficient

application/xml (preferencesVO)

XML Schema

Source:

application/json (preferencesVO)

XML Schema

Source:

The identity not found

application/xml, application/json

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<preferencesVO>
    <language>de</language>
</preferencesVO>

The user

The roles of the authenticated user are not sufficient

The identity or the portrait not found

application/octet-stream

The portrait as image

The identity or the portrait not found

application/octet-stream

The portrait as image

Not authorized

The portrait deleted

Not authorized

text/plain

Example
1.0

The version of this specific Web Service

application/xml, application/json (ns3:folderVOes)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<folders totalCount="1">
    <folders>
        <folder name="Course folder" courseKey="375397" courseNodeId="438950850389" subscribed="true" write="false" read="false" list="false" delete="false"/>
    </folders>
</folders>

The folders

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/json

application/xml

text/html

application/octet-stream

*/*

application/json

application/xml

application/x-www-form-urlencoded

application/json

application/xml

application/json

application/xml

application/json (fileUpload)

XML Schema

Source:

application/xml (fileUpload)

XML Schema

Source:

application/json

application/xml

application/json

application/xml

text/html

application/octet-stream

*/*

application/json

application/xml

*/*

application/x-www-form-urlencoded

application/json

application/xml

*/*

application/json

application/xml

*/*

application/json (fileUpload)

XML Schema

Source:

application/xml (fileUpload)

XML Schema

Source:

application/json

application/xml

application/json

application/xml

application/json

application/xml

text/plain

application/json

application/xml

application/json

application/xml

text/html

application/octet-stream

*/*

application/json

application/xml

application/x-www-form-urlencoded

application/json

application/xml

application/json

application/xml

application/json (fileUpload)

XML Schema

Source:

application/xml (fileUpload)

XML Schema

Source:

application/json

application/xml

application/json

application/xml

text/html

application/octet-stream

*/*

application/json

application/xml

*/*

application/x-www-form-urlencoded

application/json

application/xml

*/*

application/json

application/xml

*/*

application/json (fileUpload)

XML Schema

Source:

application/xml (fileUpload)

XML Schema

Source:

application/json

application/xml

application/json

application/xml

application/json

application/xml

text/plain

application/json

application/xml

application/json

application/xml

text/html

application/octet-stream

*/*

application/json

application/xml

application/x-www-form-urlencoded

application/json

application/xml

application/json

application/xml

application/json (fileUpload)

XML Schema

Source:

application/xml (fileUpload)

XML Schema

Source:

application/json

application/xml

application/json

application/xml

text/html

application/octet-stream

*/*

application/json

application/xml

*/*

application/x-www-form-urlencoded

application/json

application/xml

*/*

application/json

application/xml

*/*

application/json (fileUpload)

XML Schema

Source:

application/xml (fileUpload)

XML Schema

Source:

application/json

application/xml

application/json

application/xml

application/json

application/xml

text/plain

application/json

application/xml

application/xml, application/json (ns3:courseVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courses totalCount="0">
    <courses>
        <course>
            <key>777</key>
            <softKey>internal_fx_cp</softKey>
            <repoEntryKey>27684</repoEntryKey>
            <externalId>External identifier</externalId>
            <externalRef>External reference</externalRef>
            <managedFlags>title,description</managedFlags>
            <title>Demo course</title>
            <displayName>Demo course</displayName>
        </course>
    </courses>
</courses>

The courses

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json (ns3:courseVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courses totalCount="0">
    <courses>
        <course>
            <key>777</key>
            <softKey>internal_fx_cp</softKey>
            <repoEntryKey>27684</repoEntryKey>
            <externalId>External identifier</externalId>
            <externalRef>External reference</externalRef>
            <managedFlags>title,description</managedFlags>
            <title>Demo course</title>
            <displayName>Demo course</displayName>
        </course>
    </courses>
</courses>

The courses

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml, application/json (ns3:courseVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courses totalCount="0">
    <courses>
        <course>
            <key>777</key>
            <softKey>internal_fx_cp</softKey>
            <repoEntryKey>27684</repoEntryKey>
            <externalId>External identifier</externalId>
            <externalRef>External reference</externalRef>
            <managedFlags>title,description</managedFlags>
            <title>Demo course</title>
            <displayName>Demo course</displayName>
        </course>
    </courses>
</courses>

The courses

XML Schema

Source:

The roles of the authenticated user are not sufficient

The identity not found

application/xml, application/json (ns3:groupVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<groups totalCount="0">
    <groups>
        <group>
            <key>123467</key>
            <description>My group description</description>
            <externalId>External Identifier</externalId>
            <managedFlags>title,description</managedFlags>
            <name>My group</name>
            <minParticipants>0</minParticipants>
            <maxParticipants>0</maxParticipants>
        </group>
    </groups>
</groups>

The groups of the user

XML Schema

Source:

The identity not found

application/xml, application/json (ns3:groupVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<groups totalCount="0">
    <groups>
        <group>
            <key>123467</key>
            <description>My group description</description>
            <externalId>External Identifier</externalId>
            <managedFlags>title,description</managedFlags>
            <name>My group</name>
            <minParticipants>0</minParticipants>
            <maxParticipants>0</maxParticipants>
        </group>
    </groups>
</groups>

The groups of the user

XML Schema

Source:

The identity not found

application/xml, application/json (ns3:groupVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<groups totalCount="0">
    <groups>
        <group>
            <key>123467</key>
            <description>My group description</description>
            <externalId>External Identifier</externalId>
            <managedFlags>title,description</managedFlags>
            <name>My group</name>
            <minParticipants>0</minParticipants>
            <maxParticipants>0</maxParticipants>
        </group>
    </groups>
</groups>

The groups of the user

XML Schema

Source:

application/xml;pagingspec=1.0, application/json;pagingspec=1.0 (ns3:groupInfoVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<groups totalCount="0">
    <groups>
        <group folderWrite="false">
            <key>123467</key>
            <description>My group description</description>
            <externalId>External identifier</externalId>
            <name>My group</name>
            <minParticipants>0</minParticipants>
            <maxParticipants>0</maxParticipants>
            <news>&lt;p&gt;Hello world&lt;/p&gt;</news>
            <forumKey>374589</forumKey>
            <hasWiki>false</hasWiki>
            <hasFolder>false</hasFolder>
        </group>
    </groups>
</groups>

The groups of the user

XML Schema

Source:

The request hasn't paging information

text/plain

Example
1.0

The version of this specific Web Service

The forum not found

application/xml, application/json (ns3:forumVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<forum name="My forum" detailsName="It is a forum" forumKey="3865487" courseKey="286" courseNodeId="2784628" subscribed="false"/>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVOes)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messages totalCount="1">
    <messages>
        <message>
            <key>380</key>
            <authorKey>345</authorKey>
            <title>A message</title>
            <body>The content of the message</body>
        </message>
    </messages>
</messages>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The author, forum or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author, forum or message not found

application/xml, application/json (ns3:messageVOes)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messages totalCount="1">
    <messages>
        <message>
            <key>380</key>
            <authorKey>345</authorKey>
            <title>A message</title>
            <body>The content of the message</body>
        </message>
    </messages>
</messages>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The author or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml (replyVO)

XML Schema

Source:

application/json (replyVO)

XML Schema

Source:

The author or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The author or message not found

application/xml, application/json (ns3:messageVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<messageVO>
    <key>380</key>
    <authorKey>345</authorKey>
    <title>A message</title>
    <body>The content of the message</body>
</messageVO>

The root message of the thread

XML Schema

Source:

The roles of the authenticated user are not sufficient

The message not found

application/xml, application/json

The links to the attachments

application/x-www-form-urlencoded

The identity or the portrait not found

application/json, application/xml

Ok

application/xml (fileUpload)

XML Schema

Source:

application/json (fileUpload)

XML Schema

Source:

The identity or the portrait not found

application/json, application/xml

Ok

The identity or the portrait not found

application/json, application/xml

Ok

The identity or the portrait not found

application/octet-stream

The portrait as image

application/xml (authenticationVO)

XML Schema

Source:

application/json (authenticationVO)

XML Schema

Source:

The identity not found

application/xml, application/json (ns3:authenticationVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<authenticationVO>
    <key>38759</key>
    <identityKey>345</identityKey>
    <provider>OLAT</provider>
    <authUsername>john</authUsername>
</authenticationVO>

The saved authentication

XML Schema

Source:

The roles of the authenticated user are not sufficient

The identity not found

application/xml, application/json (ns3:authenticationVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<authenticationVOes>
    <authenticationVO>
        <key>38759</key>
        <identityKey>345</identityKey>
        <provider>OLAT</provider>
        <authUsername>john</authUsername>
    </authenticationVO>
</authenticationVOes>

The list of all users in the OLAT system

XML Schema

Source:

The roles of the authenticated user are not sufficient

The identity or the authentication not found

The authentication successfully deleted

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The identity or the authentication not found

The password was not changed

The password successfully changed

The roles of the authenticated user are not sufficient

text/plain

Example
1.0

The version of this specific Web Service

text/plain

Example
1.0

The version of this specific Web Service

text/plain

Example
OK

The translation of the package + key

text/plain

Example
1.0

The version of this specific Web Service

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

the course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

the course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

the course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The course, parentNode or test not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The test node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The course, parentNode or test not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The test node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

course, parentNode or test not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

the test node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/x-www-form-urlencoded

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The given URL is not valid

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course or parentNode not found

application/xml, application/json (ns3:courseNodeVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node metadatas

XML Schema

Source:

The course node is not of type task

The roles of the authenticated user are not sufficient

The configuration is not valid

The course or task node not found

application/xml, application/json (ns3:surveyConfigVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The task node configuration

XML Schema

Source:

The call is not applicable to task course node

The roles of the authenticated user are not sufficient

The configuration is not valid

The course or task node not found

application/xml, application/json (ns3:surveyConfigVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The task node configuration

XML Schema

Source:

The call is not applicable to task course node

The roles of the authenticated user are not sufficient

The course or task node not found

application/xml, application/json (ns3:surveyConfigVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node configuration

XML Schema

Source:

The roles of the authenticated user are not sufficient

The configuration is not valid

The course or survey node not found

application/xml, application/json (ns3:surveyConfigVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The survey node configuration

XML Schema

Source:

The call is not applicable to survey course node

The roles of the authenticated user are not sufficient

The configuration is not valid

The course or survey node not found

application/xml, application/json (ns3:surveyConfigVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The survey node configuration

XML Schema

Source:

The call is not applicable to survey course node

The roles of the authenticated user are not sufficient

The course or survey node not found

application/xml, application/json (ns3:surveyConfigVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node configuration

XML Schema

Source:

The roles of the authenticated user are not sufficient

The configuration is not valid

The course or test node not found

application/xml, application/json (ns3:testConfigVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The test node configuration

XML Schema

Source:

The call is not applicable to test course node

The roles of the authenticated user are not sufficient

The configuration is not valid

The course or test node not found

application/xml, application/json (ns3:testConfigVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The test node configuration

XML Schema

Source:

The call is not applicable to test course node

The roles of the authenticated user are not sufficient

The course or test node not found

application/xml, application/json (ns3:testConfigVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<courseNodeVO>
    <id>id</id>
</courseNodeVO>

The course node configuration

XML Schema

Source:

The roles of the authenticated user are not sufficient

The identity not found

application/xml, application/json

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<subscriptionInfoVOes>
    <subscriptionInfoVO>
        <title>Infos</title>
        <items/>
    </subscriptionInfoVO>
</subscriptionInfoVOes>

The notifications

The course not found

application/xml, application/json (ns3:assessableResultsVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assessableResultsVOes>
    <assessableResultsVO>
        <identityKey>345</identityKey>
        <score>34.0</score>
        <passed>true</passed>
    </assessableResultsVO>
</assessableResultsVOes>

Array of results for the whole the course

XML Schema

Source:

The roles of the authenticated user are not sufficient

text/plain

Example
1.0

The version of this specific Web Service

The identity or the course not found

application/xml, application/json (ns3:assessableResultsVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assessableResultsVO>
    <identityKey>345</identityKey>
    <score>34.0</score>
    <passed>true</passed>
</assessableResultsVO>

The result of the course

XML Schema

Source:

The roles of the authenticated user are not sufficient

The course not found

application/xml, application/json (ns3:assessableResultsVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assessableResultsVOes>
    <assessableResultsVO>
        <identityKey>345</identityKey>
        <score>34.0</score>
        <passed>true</passed>
    </assessableResultsVO>
</assessableResultsVOes>

Export all results of all user of the course

XML Schema

Source:

The roles of the authenticated user are not sufficient

application/xml (assessableResultsVO)

XML Schema

Source:

application/json (assessableResultsVO)

XML Schema

Source:

The identity not found

Import successful

The roles of the authenticated user are not sufficient

The identity or the course not found

application/xml, application/json (ns3:assessableResultsVO)

Example
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assessableResultsVO>
    <identityKey>345</identityKey>
    <score>34.0</score>
    <passed>true</passed>
</assessableResultsVO>

The result of a user at a specific node

XML Schema

Source:

The roles of the authenticated user are not sufficient