1. List data overlays

1.1. Path Parameters

Table 1. /projects/{projectId}/overlays/
Parameter Description

projectId

project identifier

1.2. Response Fields

Path Type Description

[].name

String

name

[].description

String

description

[].idObject

Number

identifier

[].publicOverlay

Boolean

is the data overlay publicaly available to all users

[].googleLicenseConsent

Boolean

did creator accepted license required by Google Maps API

[].order

Number

sort order

[].type

String

type; available options: GENERIC, GENETIC_VARIANT

[].genomeType

String

reference genome type; available options: UCSC

[].genomeVersion

String

reference genome version

[].creator

String

login of the user who uploaded data overlay

1.3. CURL sample 1

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/projects/test_project/overlays/' -i -X GET

1.4. Sample Response 1

[ {
  "creator" : "admin",
  "description" : "test description",
  "genomeType" : null,
  "genomeVersion" : null,
  "googleLicenseConsent" : false,
  "idObject" : 1000112,
  "name" : "test title",
  "order" : 0,
  "publicOverlay" : true,
  "type" : "GENERIC"
}, {
  "creator" : "test_user",
  "description" : "test description",
  "genomeType" : null,
  "genomeVersion" : null,
  "googleLicenseConsent" : false,
  "idObject" : 1000113,
  "name" : "test title",
  "order" : 0,
  "publicOverlay" : false,
  "type" : "GENERIC"
} ]

1.5. CURL sample 2

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/projects/test_project/overlays/?creator=test_curator' -i -X GET

1.6. Sample Response 2

[ {
  "creator" : "test_curator",
  "description" : "test description",
  "genomeType" : null,
  "genomeVersion" : null,
  "googleLicenseConsent" : false,
  "idObject" : 1000122,
  "name" : "test title",
  "order" : 0,
  "publicOverlay" : false,
  "type" : "GENERIC"
} ]

2. Get data overlay

2.1. Path Parameters

Table 2. /projects/{projectId}/overlays/{overlayId}/
Parameter Description

projectId

project identifier

overlayId

overlay identifier

2.2. Response Fields

Path Type Description

name

String

name

description

String

description

idObject

Number

identifier

publicOverlay

Boolean

is the data overlay publicaly available to all users

googleLicenseConsent

Boolean

did creator accepted license required by Google Maps API

order

Number

sort order

type

String

type; available options: GENERIC, GENETIC_VARIANT

genomeType

String

reference genome type; available options: UCSC

genomeVersion

String

reference genome version

creator

String

login of the user who uploaded data overlay

2.3. CURL sample

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/projects/test_project/overlays/1000087/' -i -X GET

2.4. Sample Response

{
  "creator" : "test_user",
  "description" : "test description",
  "genomeType" : null,
  "genomeVersion" : null,
  "googleLicenseConsent" : false,
  "idObject" : 1000087,
  "name" : "test title",
  "order" : 0,
  "publicOverlay" : false,
  "type" : "GENERIC"
}

3. Add overlay

3.1. Path Parameters

Table 3. /projects/{projectId}/overlays/
Parameter Description

projectId

project identifier

3.2. Request Parameters

Parameter Description

name

name of the data overlay

content

content of the file that is uploaded with definition what should be visible where (alternative to fileId)

fileId

uploaded file id that should be used as data overlay content content (alternative to content)

description

short description of the data overlay

filename

name of the file that should be used when downloading the source

type

type of the data overlay (default: GENERIC). Available options: GENERIC, GENETIC_VARIANT

googleLicenseConsent

true/false indicating if user agreed to the new Google Maps API license https://cloud.google.com/maps-platform/terms/

3.3. Response Fields

Path Type Description

name

String

name

description

String

description

idObject

Number

identifier

publicOverlay

Boolean

is the data overlay publicaly available to all users

googleLicenseConsent

Boolean

did creator accepted license required by Google Maps API

order

Number

sort order

type

String

type; available options: GENERIC, GENETIC_VARIANT

genomeType

String

reference genome type; available options: UCSC

genomeVersion

String

reference genome version

creator

String

login of the user who uploaded data overlay

3.4. CURL sample from file

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/projects/test_project/overlays/' -i -X POST \
    -H 'Content-Type: application/x-www-form-urlencoded' \
    -d 'fileId=434&name=overlay+name&description=overlay+name&filename=overlay+name&googleLicenseConsent=overlay+name&type=GENERIC' \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx"

3.5. Sample Response from file

{
  "creator" : "admin",
  "description" : "overlay name",
  "genomeType" : null,
  "genomeVersion" : null,
  "googleLicenseConsent" : false,
  "idObject" : 1000106,
  "name" : "overlay name",
  "order" : 1,
  "publicOverlay" : false,
  "type" : "GENERIC"
}

3.6. CURL sample from content

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/projects/test_project/overlays/' -i -X POST \
    -H 'Content-Type: application/x-www-form-urlencoded' \
    -d 'content=element_identifier%09value%0A%09-1&name=overlay+name&description=overlay+name&filename=overlay+name&googleLicenseConsent=overlay+name&type=GENERIC' \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx"

3.7. Sample Response from content

{
  "creator" : "admin",
  "description" : "overlay name",
  "genomeType" : null,
  "genomeVersion" : null,
  "googleLicenseConsent" : false,
  "idObject" : 1000081,
  "name" : "overlay name",
  "order" : 1,
  "publicOverlay" : false,
  "type" : "GENERIC"
}

4. Update overlay

4.1. Path Parameters

Table 4. /projects/{projectId}/overlays/{overlayId}
Parameter Description

projectId

project identifier

overlayId

overlay identifier

4.2. Request Fields

Path Type Description

overlay.name

String

name

overlay.description

String

description

overlay.publicOverlay

Boolean

is the data overlay publicaly available to all users

overlay.googleLicenseConsent

Boolean

did creator accepted license required by Google Maps API

overlay.order

Number

sort order

overlay.type

String

type; available options: GENERIC, GENETIC_VARIANT

overlay.genomeType

String

reference genome type; available options: UCSC

overlay.genomeVersion

String

reference genome version

overlay.creator

String

login of the user who uploaded data overlay

4.3. Response Fields

Path Type Description

name

String

name

description

String

description

idObject

Number

identifier

publicOverlay

Boolean

is the data overlay publicaly available to all users

googleLicenseConsent

Boolean

did creator accepted license required by Google Maps API

order

Number

sort order

type

String

type; available options: GENERIC, GENETIC_VARIANT

genomeType

String

reference genome type; available options: UCSC

genomeVersion

String

reference genome version

creator

String

login of the user who uploaded data overlay

4.4. CURL sample

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/projects/test_project/overlays/1000091' -i -X PATCH \
    -d '{"overlay":{"creator":"test_user","description":"test description","googleLicenseConsent":false,"name":"test title","order":0,"publicOverlay":false,"type":"GENERIC"}}' \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx"

4.5. Sample Response

{
  "creator" : "test_user",
  "description" : "test description",
  "genomeType" : null,
  "genomeVersion" : null,
  "googleLicenseConsent" : false,
  "idObject" : 1000091,
  "name" : "test title",
  "order" : 0,
  "publicOverlay" : false,
  "type" : "GENERIC"
}

5. Delete overlay

5.1. CURL sample

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/projects/test_project/overlays/1000131' -i -X DELETE

5.2. Path Parameters

Table 5. /projects/{projectId}/overlays/{overlayId}
Parameter Description

projectId

project identifier

overlayId

overlay identifier

6. Download source data

6.1. Path Parameters

Table 6. /projects/{projectId}/overlays/{overlayId}:downloadSource
Parameter Description

projectId

project identifier

overlayId

overlay identifier

6.2. CURL sample

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/projects/test_project/overlays/1000114:downloadSource' -i -X GET

6.3. Sample Response

element_identifier	value
	-1

7. Get list of associated bioEntites

7.1. Path Parameters

Table 7. /projects/{projectId}/overlays/{overlayId}/models/{mapId}/bioEntities/
Parameter Description

projectId

project identifier

mapId

map identifier

overlayId

overlay identifier

7.2. Response Fields

Path Type Description

[].type

string

type of bioEntity (ALIAS/REACTION)

[].overlayContent.idObject

number

identifier of the bioEntity

[].overlayContent.modelId

number

map identifier where bioEntity is located

[].overlayContent.value

number

normalized value assigned to the bioEntity from overlay

[].overlayContent.color

string

color assigned to the bioEntity from overlay

[].overlayContent.description

string

description assigned to the bioEntity from overlay

[].overlayContent.geneVariations

string

list of gene variants assigned to the bioEntity from overlay

[].overlayContent.width

number

line width of reaction bioEntity assigned to the bioEntity from overlay

7.3. CURL sample

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/projects/test_project/overlays/1000120/models/620/bioEntities/' -i -X GET

7.4. Sample Response

[ {
  "overlayContent" : {
    "modelId" : 620,
    "idObject" : "966",
    "value" : -1.0,
    "color" : null,
    "uniqueId" : 125
  },
  "type" : "ALIAS"
}, {
  "overlayContent" : {
    "modelId" : 620,
    "idObject" : "967",
    "value" : -1.0,
    "color" : null,
    "uniqueId" : 125
  },
  "type" : "ALIAS"
}, {
  "overlayContent" : {
    "modelId" : 621,
    "idObject" : "968",
    "value" : -1.0,
    "color" : null,
    "uniqueId" : 125
  },
  "type" : "ALIAS"
}, {
  "overlayContent" : {
    "modelId" : 620,
    "idObject" : "318",
    "value" : -1.0,
    "color" : null,
    "uniqueId" : 125,
    "width" : null
  },
  "type" : "REACTION"
} ]

8. Get reaction data

8.1. Path Parameters

Table 8. /projects/{projectId}/overlays/{overlayId}/models/{mapId}/bioEntities/reactions/{reactionId}/
Parameter Description

projectId

project identifier

mapId

map identifier

overlayId

overlay identifier

reactionId

reaction identifier

8.2. Response Fields

Path Type Description

[].type

string

type of bioEntity (ALIAS/REACTION)

[].overlayContent.idObject

number

identifier of the bioEntity

[].overlayContent.modelId

number

map identifier where bioEntity is located

[].overlayContent.value

number

normalized value assigned to the bioEntity from overlay

[].overlayContent.color

string

color assigned to the bioEntity from overlay

[].overlayContent.description

string

description assigned to the bioEntity from overlay

[].overlayContent.geneVariations

string

list of gene variants assigned to the bioEntity from overlay

[].overlayContent.width

number

line width of reaction bioEntity assigned to the bioEntity from overlay

8.3. CURL sample

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/projects/test_project/overlays/1000078/models/534/bioEntities/reactions/275/' -i -X GET

8.4. Sample Response

[ {
  "type" : "REACTION",
  "overlayContent" : {
    "modelId" : 534,
    "idObject" : "275",
    "value" : -1.0,
    "color" : null,
    "description" : null,
    "type" : "GENERIC",
    "geneVariations" : [ ],
    "uniqueId" : 83
  }
} ]

9. Get element data

9.1. Path Parameters

Table 9. /projects/{projectId}/overlays/{overlayId}/models/{mapId}/bioEntities/elements/{elementId}/
Parameter Description

projectId

project identifier

mapId

map identifier

overlayId

overlay identifier

elementId

element identifier

9.2. Response Fields

Path Type Description

[].type

string

type of bioEntity (ALIAS/REACTION)

[].overlayContent.idObject

number

identifier of the bioEntity

[].overlayContent.modelId

number

map identifier where bioEntity is located

[].overlayContent.value

number

normalized value assigned to the bioEntity from overlay

[].overlayContent.color

string

color assigned to the bioEntity from overlay

[].overlayContent.description

string

description assigned to the bioEntity from overlay

[].overlayContent.geneVariations

string

list of gene variants assigned to the bioEntity from overlay

[].overlayContent.width

number

line width of reaction bioEntity assigned to the bioEntity from overlay

9.3. CURL sample

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/projects/test_project/overlays/1000125/models/630/bioEntities/elements/981/' -i -X GET

9.4. Sample Response

[ {
  "type" : "ALIAS",
  "overlayContent" : {
    "modelId" : 630,
    "idObject" : "981",
    "value" : -1.0,
    "color" : null,
    "description" : null,
    "type" : "GENERIC",
    "geneVariations" : [ ],
    "uniqueId" : 130
  }
} ]