Legacy REST API Documentation

1. List all users

1.1. CURL sample

$ curl 'https://minerva-dev.lcsb.uni.lu/minerva/api/users/' -X GET \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx"

1.2. Response Fields

Path Type Description

Path	Type	Description
`[]`	`Array`	list of users
`[].login`	`String`	user login
`[].connectedToLdap`	`Boolean`	is user account connected to LDAP
`[].ldapAccountAvailable`	`Boolean`	does the account exist in LDAP
`[].active`	`Boolean`	ist the use account active (can user login)
`[].confirmed`	`Boolean`	is the user email confirmed
`[].email`	`String`	email address
`[].orcidId`	`String`	orcid identifier
`[].id`	`Number`	user unique id
`[].name`	`String`	first name
`[].surname`	`String`	last name
`[].removed`	`Boolean`	is the account removed
`[].termsOfUseConsent`	`Boolean`	did user agree to terms of use
`[].privileges`	`Array`	list of user privileges
`[].privileges[].objectId`	`String`	object id to which project has privilege
`[].lastActive`	`String`	datetime of the last activity in the active session
`[].privileges[].privilegeType`	`String`	type of privilege, available values: IS_ADMIN, IS_CURATOR, READ_PROJECT

[]

Array

list of users

[].login

String

user login

[].connectedToLdap

Boolean

is user account connected to LDAP

[].ldapAccountAvailable

Boolean

does the account exist in LDAP

[].active

Boolean

ist the use account active (can user login)

[].confirmed

Boolean

is the user email confirmed

[].email

String

email address

[].orcidId

String

orcid identifier

[].id

Number

user unique id

[].name

String

first name

[].surname

String

last name

[].removed

Boolean

is the account removed

[].termsOfUseConsent

Boolean

did user agree to terms of use

[].privileges

Array

list of user privileges

[].privileges[].objectId

String

object id to which project has privilege

[].lastActive

String

datetime of the last activity in the active session

[].privileges[].privilegeType

String

type of privilege, available values: IS_ADMIN, IS_CURATOR, READ_PROJECT

1.3. Sample Response

[ {
  "id" : 124,
  "login" : "test_user",
  "name" : "Refugio",
  "surname" : "Gaylord",
  "email" : "ashlee.hand@yahoo.com",
  "orcidId" : null,
  "removed" : false,
  "connectedToLdap" : false,
  "termsOfUseConsent" : false,
  "privileges" : [ ],
  "active" : true,
  "confirmed" : false,
  "ldapAccountAvailable" : false,
  "lastActive" : "2026-11-15T00:11:15Z"
}, {
  "id" : 3,
  "login" : "anonymous",
  "name" : "",
  "surname" : "",
  "email" : null,
  "orcidId" : null,
  "removed" : false,
  "connectedToLdap" : false,
  "termsOfUseConsent" : false,
  "privileges" : [ {
    "privilegeType" : "READ_PROJECT",
    "objectId" : "empty"
  } ],
  "active" : true,
  "confirmed" : true,
  "ldapAccountAvailable" : false,
  "lastActive" : null
}, {
  "id" : 1,
  "login" : "admin",
  "name" : "",
  "surname" : "",
  "email" : "",
  "orcidId" : null,
  "removed" : false,
  "connectedToLdap" : false,
  "termsOfUseConsent" : false,
  "privileges" : [ {
    "privilegeType" : "IS_ADMIN",
    "objectId" : null
  }, {
    "privilegeType" : "IS_CURATOR",
    "objectId" : null
  }, {
    "privilegeType" : "READ_PROJECT",
    "objectId" : "empty"
  } ],
  "active" : true,
  "confirmed" : true,
  "ldapAccountAvailable" : false,
  "lastActive" : "2026-11-15T00:11:17Z"
} ]

2. Get specific user data

2.1. CURL sample

$ curl 'https://minerva-dev.lcsb.uni.lu/minerva/api/users/test_user' -X GET \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx"

2.2. Path Parameters

Table 1. /minerva/api/users/{login}
Parameter	Description
`login`	user login

2.3. Response Fields

Path Type Description

Path	Type	Description
`login`	`String`	user login
`connectedToLdap`	`Boolean`	is user account connected to LDAP
`ldapAccountAvailable`	`Boolean`	does the account exist in LDAP
`active`	`Boolean`	ist the use account active (can user login)
`confirmed`	`Boolean`	is the user email confirmed
`email`	`String`	email address
`orcidId`	`String`	orcid identifier
`id`	`Number`	user unique id
`name`	`String`	first name
`surname`	`String`	last name
`removed`	`Boolean`	is the account removed
`termsOfUseConsent`	`Boolean`	did user agree to terms of use
`privileges`	`Array`	list of user privileges
`privileges[].objectId`	`String`	object id to which project has privilege
`lastActive`	`String`	datetime of the last activity in the active session
`privileges[].privilegeType`	`String`	type of privilege, available values: IS_ADMIN, IS_CURATOR, READ_PROJECT

login

String

user login

connectedToLdap

Boolean

is user account connected to LDAP

ldapAccountAvailable

Boolean

does the account exist in LDAP

active

Boolean

ist the use account active (can user login)

confirmed

Boolean

is the user email confirmed

email

String

email address

orcidId

String

orcid identifier

id

Number

user unique id

name

String

first name

surname

String

last name

removed

Boolean

is the account removed

termsOfUseConsent

Boolean

did user agree to terms of use

privileges

Array

list of user privileges

privileges[].objectId

String

object id to which project has privilege

lastActive

String

datetime of the last activity in the active session

privileges[].privilegeType

String

type of privilege, available values: IS_ADMIN, IS_CURATOR, READ_PROJECT

2.4. Sample Response

{
  "id" : 117,
  "login" : "test_user",
  "name" : "Dierdre",
  "surname" : "Stracke",
  "email" : "rachael.kiehn@gmail.com",
  "orcidId" : null,
  "removed" : false,
  "connectedToLdap" : false,
  "termsOfUseConsent" : false,
  "privileges" : [ ],
  "active" : true,
  "confirmed" : true,
  "ldapAccountAvailable" : false,
  "lastActive" : "2026-11-15T00:11:15Z"
}

3. Create user

3.1. CURL sample

$ curl 'https://minerva-dev.lcsb.uni.lu/minerva/api/users/test_login?name=Esteban&surname=Schimmel&password=g3mcb2yjr5qmk2' -X POST \
    -d 'name=Esteban&surname=Schimmel&password=g3mcb2yjr5qmk2' \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx" \
    -H 'Content-Type: application/octet-stream'

3.2. Path Parameters

Table 2. /minerva/api/users/{login}
Parameter	Description
`login`	user login

3.3. Form Parameters

Parameter Description

Parameter	Description
`name`	first name
`surname`	last name
`password`	user password
`email`	email address
`defaultPrivileges`	should the default privileges be added to the user after user creation

name

first name

surname

last name

password

user password

email

email address

defaultPrivileges

should the default privileges be added to the user after user creation

3.4. Response Fields

Path Type Description

Path	Type	Description
`login`	`String`	user login
`connectedToLdap`	`Boolean`	is user account connected to LDAP
`ldapAccountAvailable`	`Boolean`	does the account exist in LDAP
`active`	`Boolean`	ist the use account active (can user login)
`confirmed`	`Boolean`	is the user email confirmed
`email`	`String`	email address
`orcidId`	`String`	orcid identifier
`id`	`Number`	user unique id
`name`	`String`	first name
`surname`	`String`	last name
`removed`	`Boolean`	is the account removed
`termsOfUseConsent`	`Boolean`	did user agree to terms of use
`privileges`	`Array`	list of user privileges
`privileges[].objectId`	`String`	object id to which project has privilege
`lastActive`	`String`	datetime of the last activity in the active session
`privileges[].privilegeType`	`String`	type of privilege, available values: IS_ADMIN, IS_CURATOR, READ_PROJECT

login

String

user login

connectedToLdap

Boolean

is user account connected to LDAP

ldapAccountAvailable

Boolean

does the account exist in LDAP

active

Boolean

ist the use account active (can user login)

confirmed

Boolean

is the user email confirmed

email

String

email address

orcidId

String

orcid identifier

id

Number

user unique id

name

String

first name

surname

String

last name

removed

Boolean

is the account removed

termsOfUseConsent

Boolean

did user agree to terms of use

privileges

Array

list of user privileges

privileges[].objectId

String

object id to which project has privilege

lastActive

String

datetime of the last activity in the active session

privileges[].privilegeType

String

type of privilege, available values: IS_ADMIN, IS_CURATOR, READ_PROJECT

3.5. Sample Response

{
  "id" : 123,
  "login" : "test_login",
  "name" : "Esteban",
  "surname" : "Schimmel",
  "email" : null,
  "orcidId" : null,
  "removed" : false,
  "connectedToLdap" : false,
  "termsOfUseConsent" : false,
  "privileges" : [ ],
  "active" : true,
  "confirmed" : true,
  "ldapAccountAvailable" : false,
  "lastActive" : null
}

4. Update user

4.1. CURL sample

$ curl 'https://minerva-dev.lcsb.uni.lu/minerva/api/users/test_user' -X PATCH \
    -d '{"user":{"password":"new pass"}}' \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx" \
    -H 'Content-Type: application/json'

4.2. Path Parameters

Table 3. /minerva/api/users/{login}
Parameter	Description
`login`	user login

4.3. Request Fields

Path Type Description

Path	Type	Description
`user.password`	`String`	user password
`user.connectedToLdap`	`Boolean`	is user account connected to LDAP
`user.ldapAccountAvailable`	`Boolean`	does is account exist in LDAP
`user.email`	`String`	email address
`user.name`	`String`	first name
`user.surname`	`String`	last name

user.password

String

user password

user.connectedToLdap

Boolean

is user account connected to LDAP

user.ldapAccountAvailable

Boolean

does is account exist in LDAP

user.email

String

email address

user.name

String

first name

user.surname

String

last name

4.4. Response Fields

Path Type Description

Path	Type	Description
`login`	`String`	user login
`connectedToLdap`	`Boolean`	is user account connected to LDAP
`ldapAccountAvailable`	`Boolean`	does the account exist in LDAP
`active`	`Boolean`	ist the use account active (can user login)
`confirmed`	`Boolean`	is the user email confirmed
`email`	`String`	email address
`orcidId`	`String`	orcid identifier
`id`	`Number`	user unique id
`name`	`String`	first name
`surname`	`String`	last name
`removed`	`Boolean`	is the account removed
`termsOfUseConsent`	`Boolean`	did user agree to terms of use
`privileges`	`Array`	list of user privileges
`privileges[].objectId`	`String`	object id to which project has privilege
`lastActive`	`String`	datetime of the last activity in the active session
`privileges[].privilegeType`	`String`	type of privilege, available values: IS_ADMIN, IS_CURATOR, READ_PROJECT

login

String

user login

connectedToLdap

Boolean

is user account connected to LDAP

ldapAccountAvailable

Boolean

does the account exist in LDAP

active

Boolean

ist the use account active (can user login)

confirmed

Boolean

is the user email confirmed

email

String

email address

orcidId

String

orcid identifier

id

Number

user unique id

name

String

first name

surname

String

last name

removed

Boolean

is the account removed

termsOfUseConsent

Boolean

did user agree to terms of use

privileges

Array

list of user privileges

privileges[].objectId

String

object id to which project has privilege

lastActive

String

datetime of the last activity in the active session

privileges[].privilegeType

String

type of privilege, available values: IS_ADMIN, IS_CURATOR, READ_PROJECT

4.5. Sample Response

{
  "id" : 116,
  "login" : "test_user",
  "name" : "Ina",
  "surname" : "Bogisich",
  "email" : "federico.hamill@gmail.com",
  "orcidId" : null,
  "removed" : false,
  "connectedToLdap" : false,
  "termsOfUseConsent" : false,
  "privileges" : [ ],
  "active" : true,
  "confirmed" : true,
  "ldapAccountAvailable" : false,
  "lastActive" : "2026-11-15T00:11:15Z"
}

5. Update user privileges

5.1. Path Parameters

Table 4. /minerva/api/users/{login}:updatePrivileges
Parameter	Description
`login`	user login

5.2. Request Fields

Path Type Description

Path	Type	Description
`privileges.*`	`Boolean`	should the privilege defined as PRIVILEGE_TYPE:ID_OBJECT be granted or not

privileges.*

Boolean

should the privilege defined as PRIVILEGE_TYPE:ID_OBJECT be granted or not

5.3. Response Fields

Path Type Description

Path	Type	Description
`login`	`String`	user login
`connectedToLdap`	`Boolean`	is user account connected to LDAP
`ldapAccountAvailable`	`Boolean`	does the account exist in LDAP
`active`	`Boolean`	ist the use account active (can user login)
`confirmed`	`Boolean`	is the user email confirmed
`email`	`String`	email address
`orcidId`	`String`	orcid identifier
`id`	`Number`	user unique id
`name`	`String`	first name
`surname`	`String`	last name
`removed`	`Boolean`	is the account removed
`termsOfUseConsent`	`Boolean`	did user agree to terms of use
`privileges`	`Array`	list of user privileges
`privileges[].objectId`	`String`	object id to which project has privilege
`lastActive`	`String`	datetime of the last activity in the active session
`privileges[].privilegeType`	`String`	type of privilege, available values: IS_ADMIN, IS_CURATOR, READ_PROJECT

login

String

user login

connectedToLdap

Boolean

is user account connected to LDAP

ldapAccountAvailable

Boolean

does the account exist in LDAP

active

Boolean

ist the use account active (can user login)

confirmed

Boolean

is the user email confirmed

email

String

email address

orcidId

String

orcid identifier

id

Number

user unique id

name

String

first name

surname

String

last name

removed

Boolean

is the account removed

termsOfUseConsent

Boolean

did user agree to terms of use

privileges

Array

list of user privileges

privileges[].objectId

String

object id to which project has privilege

lastActive

String

datetime of the last activity in the active session

privileges[].privilegeType

String

type of privilege, available values: IS_ADMIN, IS_CURATOR, READ_PROJECT

5.4. CURL sample 1

$ curl 'https://minerva-dev.lcsb.uni.lu/minerva/api/users/test_user:updatePrivileges' -X PATCH \
    -d '{"privileges":{"IS_ADMIN":true}}' \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx" \
    -H 'Content-Type: application/json'

5.5. Sample Response 1

{
  "id" : 125,
  "login" : "test_user",
  "name" : "Maureen",
  "surname" : "Medhurst",
  "email" : "florentino.weber@gmail.com",
  "orcidId" : null,
  "removed" : false,
  "connectedToLdap" : false,
  "termsOfUseConsent" : false,
  "privileges" : [ {
    "privilegeType" : "IS_ADMIN",
    "objectId" : null
  } ],
  "active" : true,
  "confirmed" : false,
  "ldapAccountAvailable" : false,
  "lastActive" : "2026-11-15T00:11:15Z"
}

5.6. CURL sample 2

$ curl 'https://minerva-dev.lcsb.uni.lu/minerva/api/users/test_user:updatePrivileges' -X PATCH \
    -d '{"privileges":{"READ_PROJECT:test_project":true}}' \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx" \
    -H 'Content-Type: application/json'

5.7. Sample Response 2

{
  "id" : 121,
  "login" : "test_user",
  "name" : "Dane",
  "surname" : "Hettinger",
  "email" : "terra.roberts@yahoo.com",
  "orcidId" : null,
  "removed" : false,
  "connectedToLdap" : false,
  "termsOfUseConsent" : false,
  "privileges" : [ {
    "privilegeType" : "READ_PROJECT",
    "objectId" : "test_project"
  } ],
  "active" : true,
  "confirmed" : false,
  "ldapAccountAvailable" : false,
  "lastActive" : "2026-11-15T00:11:15Z"
}

6. Delete user

6.1. CURL sample

$ curl 'https://minerva-dev.lcsb.uni.lu/minerva/api/users/test_user' -X PATCH \
    -d '{"user":{"password":"new pass"}}' \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx" \
    -H 'Content-Type: application/json'

6.2. Path Parameters

Table 5. /minerva/api/users/{login}
Parameter	Description
`login`	user login

7. Request password reset over email

7.1. CURL sample

$ curl 'https://minerva-dev.lcsb.uni.lu/minerva/api/users/test_user:requestResetPassword' -X POST

7.2. Path Parameters

Table 6. /minerva/api/users/{login}:requestResetPassword
Parameter	Description
`login`	user login

8. Reset password using a token obtained over email

8.1. CURL sample

$ curl 'https://minerva-dev.lcsb.uni.lu/minerva/api/users:resetPassword?token=49500735-0000-4404-8090-204678734087&password=pass2' -X POST \
    -d 'token=49500735-0000-4404-8090-204678734087&password=pass2' \
    -H 'Content-Type: application/octet-stream'

8.2. Form Parameters

Parameter Description

Parameter	Description
`password`	new password
`token`	reset password token obtained using email

password

new password

token

reset password token obtained using email

9. Register new user

9.1. CURL sample

$ curl 'https://minerva-dev.lcsb.uni.lu/minerva/api/users:registerUser' -X POST \
    -d '{"password":"123qweasdzxc","surname":"Gawron","name":"Piotr","email":"piotr.gawron@uni.lu"}' \
    -H 'Content-Type: application/json'

9.2. Request Fields

Path Type Description

Path	Type	Description
`email`	`String`	user email (and login)
`password`	`String`	password
`name`	`String`	given name)
`surname`	`String`	family name

email

String

user email (and login)

password

String

password

name

String

given name)

surname

String

family name

9.3. Response Fields

Path Type Description

Path	Type	Description
`login`	`String`	user login
`connectedToLdap`	`Boolean`	is user account connected to LDAP
`ldapAccountAvailable`	`Boolean`	does the account exist in LDAP
`active`	`Boolean`	ist the use account active (can user login)
`confirmed`	`Boolean`	is the user email confirmed
`email`	`String`	email address
`orcidId`	`String`	orcid identifier
`id`	`Number`	user unique id
`name`	`String`	first name
`surname`	`String`	last name
`removed`	`Boolean`	is the account removed
`termsOfUseConsent`	`Boolean`	did user agree to terms of use
`privileges`	`Array`	list of user privileges
`privileges[].objectId`	`String`	object id to which project has privilege
`lastActive`	`String`	datetime of the last activity in the active session
`privileges[].privilegeType`	`String`	type of privilege, available values: IS_ADMIN, IS_CURATOR, READ_PROJECT

login

String

user login

connectedToLdap

Boolean

is user account connected to LDAP

ldapAccountAvailable

Boolean

does the account exist in LDAP

active

Boolean

ist the use account active (can user login)

confirmed

Boolean

is the user email confirmed

email

String

email address

orcidId

String

orcid identifier

id

Number

user unique id

name

String

first name

surname

String

last name

removed

Boolean

is the account removed

termsOfUseConsent

Boolean

did user agree to terms of use

privileges

Array

list of user privileges

privileges[].objectId

String

object id to which project has privilege

lastActive

String

datetime of the last activity in the active session

privileges[].privilegeType

String

type of privilege, available values: IS_ADMIN, IS_CURATOR, READ_PROJECT

9.4. Sample Response

{
  "id" : 120,
  "login" : "piotr.gawron@uni.lu",
  "name" : "Piotr",
  "surname" : "Gawron",
  "email" : "piotr.gawron@uni.lu",
  "orcidId" : null,
  "removed" : false,
  "connectedToLdap" : false,
  "termsOfUseConsent" : false,
  "privileges" : [ {
    "privilegeType" : "READ_PROJECT",
    "objectId" : "empty"
  } ],
  "active" : false,
  "confirmed" : false,
  "ldapAccountAvailable" : false,
  "lastActive" : null
}

10. Confirm email

10.1. CURL sample

$ curl 'https://minerva-dev.lcsb.uni.lu/minerva/api/users/test_user:confirmEmail?token=7ddf8305-ad44-4a74-b7ee-4a00588dea99' -X POST \
    -d 'token=7ddf8305-ad44-4a74-b7ee-4a00588dea99' \
    -H 'Content-Type: application/octet-stream'

10.2. Form Parameters

Parameter Description

Parameter	Description
`token`	token obtained in the registration email

token

token obtained in the registration email

10.3. Path Parameters

Table 7. /minerva/api/users/{login}:confirmEmail
Parameter	Description
`login`	user login

10.4. Response Fields

Path Type Description

Path	Type	Description
`message`	`String`	detailed information about the status
`status`	`String`	status

message

String

detailed information about the status

status

String

status

10.5. Sample Response

{
  "message" : "Your email is confirmed. You need to wait for admin approval before you can login",
  "status" : "OK"
}

Legacy REST API Documentation - Users

1. List all users

1.1. CURL sample

1.2. Response Fields

1.3. Sample Response

2. Get specific user data

2.1. CURL sample

2.2. Path Parameters

2.3. Response Fields

2.4. Sample Response

3. Create user

3.1. CURL sample

3.2. Path Parameters

3.3. Form Parameters

3.4. Response Fields

3.5. Sample Response

4. Update user

4.1. CURL sample

4.2. Path Parameters

4.3. Request Fields

4.4. Response Fields

4.5. Sample Response

5. Update user privileges

5.1. Path Parameters

5.2. Request Fields

5.3. Response Fields

5.4. CURL sample 1

5.5. Sample Response 1

5.6. CURL sample 2

5.7. Sample Response 2

6. Delete user

6.1. CURL sample

6.2. Path Parameters

7. Request password reset over email

7.1. CURL sample

7.2. Path Parameters

8. Reset password using a token obtained over email

8.1. CURL sample

8.2. Form Parameters

9. Register new user

9.1. CURL sample

9.2. Request Fields

9.3. Response Fields

9.4. Sample Response

10. Confirm email

10.1. CURL sample

10.2. Form Parameters

10.3. Path Parameters

10.4. Response Fields

10.5. Sample Response