1. List data overlays

1.1. Path Parameters

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

projectId

project identifier

1.2. Response Fields

Path Type Description

[].id

Number

id

[].name

String

name

[].description

String

description

[].idObject

Number

identifier

[].group

Number

overlay group identifier

[].publicOverlay

Boolean

is the data overlay publicly available to all users

[].order

Number

sort order

[].notMatchingAlpha

Number

alpha to be used for all not matching bioEntities when highlighting this overlay

[].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/' -X GET \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx"

1.4. Sample Response 1

[ {
  "name" : "test title",
  "group" : null,
  "notMatchingAlpha" : null,
  "creator" : "admin",
  "description" : "test description",
  "genomeType" : null,
  "genomeVersion" : null,
  "idObject" : 1000005,
  "id" : 1000005,
  "publicOverlay" : true,
  "type" : "GENERIC",
  "order" : 0
}, {
  "name" : "test title",
  "group" : null,
  "notMatchingAlpha" : null,
  "creator" : "test_user",
  "description" : "test description",
  "genomeType" : null,
  "genomeVersion" : null,
  "idObject" : 1000006,
  "id" : 1000006,
  "publicOverlay" : false,
  "type" : "GENERIC",
  "order" : 0
} ]

1.5. CURL sample 2

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/projects/test_project/overlays/?creator=test_curator' -X GET \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx"

1.6. Sample Response 2

[ {
  "name" : "test title",
  "group" : null,
  "notMatchingAlpha" : null,
  "creator" : "test_curator",
  "description" : "test description",
  "genomeType" : null,
  "genomeVersion" : null,
  "idObject" : 1000003,
  "id" : 1000003,
  "publicOverlay" : false,
  "type" : "GENERIC",
  "order" : 0
} ]

2. Get data overlay

2.1. Path Parameters

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

projectId

project identifier

overlayId

overlay identifier

2.2. Response Fields

Path Type Description

id

Number

id

name

String

name

description

String

description

idObject

Number

identifier

group

Number

overlay group identifier

publicOverlay

Boolean

is the data overlay publicly available to all users

order

Number

sort order

notMatchingAlpha

Number

alpha to be used for all not matching bioEntities when highlighting this overlay

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/1000016/' -X GET \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx"

2.4. Sample Response

{
  "name" : "test title",
  "group" : null,
  "notMatchingAlpha" : null,
  "creator" : "test_user",
  "description" : "test description",
  "genomeType" : null,
  "genomeVersion" : null,
  "idObject" : 1000016,
  "id" : 1000016,
  "publicOverlay" : false,
  "type" : "GENERIC",
  "order" : 0
}

3. Add overlay

3.1. Path Parameters

Table 3. /minerva/api/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

3.3. Response Fields

Path Type Description

id

Number

id

name

String

name

description

String

description

idObject

Number

identifier

group

Number

overlay group identifier

publicOverlay

Boolean

is the data overlay publicly available to all users

order

Number

sort order

notMatchingAlpha

Number

alpha to be used for all not matching bioEntities when highlighting this overlay

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/' -X POST \
    -d 'fileId=70&name=overlay+name&description=overlay+name&filename=overlay+name&type=GENERIC' \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx" \
    -H 'Content-Type: application/x-www-form-urlencoded'

3.5. Sample Response from file

{
  "name" : "overlay name",
  "group" : null,
  "notMatchingAlpha" : null,
  "creator" : "admin",
  "description" : "overlay name",
  "genomeType" : null,
  "genomeVersion" : null,
  "idObject" : 1000011,
  "id" : 1000011,
  "publicOverlay" : false,
  "type" : "GENERIC",
  "order" : 1
}

3.6. CURL sample from content

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

3.7. Sample Response from content

{
  "name" : "overlay name",
  "group" : null,
  "notMatchingAlpha" : null,
  "creator" : "admin",
  "description" : "overlay description",
  "genomeType" : null,
  "genomeVersion" : null,
  "idObject" : 1000010,
  "id" : 1000010,
  "publicOverlay" : false,
  "type" : "GENERIC",
  "order" : 1
}

4. Update overlay

4.1. Path Parameters

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

projectId

project identifier

overlayId

overlay identifier

4.2. Request Fields

Path Type Description

overlay.id

Number

id

overlay.name

String

name

overlay.description

String

description

overlay.group

Number

overlay group identifier

overlay.publicOverlay

Boolean

is the data overlay publicly available to all users

overlay.order

Number

sort order

overlay.notMatchingAlpha

Number

alpha to be used for all not matching bioEntities when highlighting this overlay

overlay.type

String

type; available options: GENERIC, GENETIC_VARIANT

overlay.creator

String

login of the user who uploaded data overlay

4.3. Response Fields

Path Type Description

id

Number

id

name

String

name

description

String

description

idObject

Number

identifier

group

Number

overlay group identifier

publicOverlay

Boolean

is the data overlay publicly available to all users

order

Number

sort order

notMatchingAlpha

Number

alpha to be used for all not matching bioEntities when highlighting this overlay

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/1000014' -X PATCH \
    -d '{"overlay":{"name":"test title","group":null,"notMatchingAlpha":null,"creator":"test_user","description":"test description","id":1000014,"publicOverlay":false,"type":"GENERIC","order":0}}' \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx" \
    -H 'Content-Type: application/json'

4.5. Sample Response

{
  "name" : "test title",
  "group" : null,
  "notMatchingAlpha" : null,
  "creator" : "test_user",
  "description" : "test description",
  "genomeType" : null,
  "genomeVersion" : null,
  "idObject" : 1000014,
  "id" : 1000014,
  "publicOverlay" : false,
  "type" : "GENERIC",
  "order" : 0
}

5. Delete overlay

5.1. CURL sample

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/projects/test_project/overlays/1000008' -X DELETE \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx"

5.2. Path Parameters

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

projectId

project identifier

overlayId

overlay identifier

6. Download source data

6.1. Path Parameters

Table 6. /minerva/api/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/1000007:downloadSource' -X GET \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx"

6.3. Sample Response

element_identifier	value
	-1

7. Download legend

7.1. Path Parameters

Table 7. /minerva/api/projects/{projectId}/overlays/{overlayId}:downloadLegend
Parameter Description

projectId

project identifier

overlayId

overlay identifier

7.2. CURL sample

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/projects/test_project/overlays/1000013:downloadLegend' -X GET \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx"

8. Get list of associated bioEntities

8.1. Path Parameters

Table 8. /minerva/api/projects/{projectId}/overlays/{overlayId}/models/{mapId}/bioEntities/
Parameter Description

projectId

project identifier

mapId

map identifier

overlayId

overlay identifier

8.2. Response Fields

Path Type Description

[].type

String

type of bioEntity (ALIAS/REACTION)

[].overlayContent.idObject

String

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

Object

color assigned to the bioEntity from overlay

[].overlayContent.description

String

description assigned to the bioEntity from overlay

[].overlayContent.sourceData

String

source data

[].overlayContent.geneVariations

Array

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/1000009/models/*/bioEntities/' -X GET \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx"

8.4. Sample Response

[ {
  "type" : "ALIAS",
  "overlayContent" : {
    "modelId" : 75,
    "idObject" : "192",
    "value" : 1.0,
    "color" : null,
    "description" : null,
    "type" : "GENERIC",
    "uniqueId" : 192,
    "sourceData" : null
  }
}, {
  "type" : "ALIAS",
  "overlayContent" : {
    "modelId" : 75,
    "idObject" : "187",
    "value" : 1.0,
    "color" : null,
    "description" : null,
    "type" : "GENERIC",
    "uniqueId" : 187,
    "sourceData" : null
  }
}, {
  "type" : "ALIAS",
  "overlayContent" : {
    "modelId" : 75,
    "idObject" : "190",
    "value" : 1.0,
    "color" : null,
    "description" : null,
    "type" : "GENERIC",
    "uniqueId" : 190,
    "sourceData" : null
  }
}, {
  "type" : "ALIAS",
  "overlayContent" : {
    "modelId" : 75,
    "idObject" : "191",
    "value" : 1.0,
    "color" : null,
    "description" : null,
    "type" : "GENERIC",
    "uniqueId" : 191,
    "sourceData" : null
  }
}, {
  "type" : "ALIAS",
  "overlayContent" : {
    "modelId" : 75,
    "idObject" : "189",
    "value" : 1.0,
    "color" : null,
    "description" : null,
    "type" : "GENERIC",
    "uniqueId" : 189,
    "sourceData" : null
  }
}, {
  "type" : "REACTION",
  "overlayContent" : {
    "modelId" : 75,
    "idObject" : "38",
    "value" : -1.0,
    "color" : null,
    "description" : null,
    "type" : "GENERIC",
    "uniqueId" : 38,
    "sourceData" : null,
    "width" : null
  }
}, {
  "type" : "ALIAS",
  "overlayContent" : {
    "modelId" : 76,
    "idObject" : "188",
    "value" : 1.0,
    "color" : null,
    "description" : null,
    "type" : "GENERIC",
    "uniqueId" : 188,
    "sourceData" : null
  }
} ]

9. Get reaction data

9.1. Path Parameters

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

projectId

project identifier

mapId

map identifier

overlayId

overlay identifier

reactionId

reaction identifier

9.2. Response Fields

Path Type Description

[].type

String

type of bioEntity (ALIAS/REACTION)

[].overlayContent.idObject

String

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

Object

color assigned to the bioEntity from overlay

[].overlayContent.description

String

description assigned to the bioEntity from overlay

[].overlayContent.sourceData

String

source data

[].overlayContent.geneVariations

Array

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/1000012/models/81/bioEntities/reactions/41/' -X GET \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx"

9.4. Sample Response

[ {
  "type" : "REACTION",
  "overlayContent" : {
    "modelId" : 81,
    "idObject" : "41",
    "value" : -1.0,
    "color" : null,
    "description" : null,
    "type" : "GENERIC",
    "geneVariations" : [ ],
    "uniqueId" : 41,
    "sourceData" : null,
    "width" : null
  }
} ]

10. Get element data

10.1. Path Parameters

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

projectId

project identifier

mapId

map identifier

overlayId

overlay identifier

elementId

element identifier

10.2. Response Fields

Path Type Description

[].type

String

type of bioEntity (ALIAS/REACTION)

[].overlayContent.idObject

String

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

Object

color assigned to the bioEntity from overlay

[].overlayContent.description

String

description assigned to the bioEntity from overlay

[].overlayContent.sourceData

String

source data

[].overlayContent.geneVariations

Array

list of gene variants assigned to the bioEntity from overlay

[].overlayContent.width

Number

line width of reaction bioEntity assigned to the bioEntity from overlay

10.3. CURL sample

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/projects/test_project/overlays/1000004/models/67/bioEntities/elements/167/' -X GET \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx"

10.4. Sample Response

[ {
  "type" : "ALIAS",
  "overlayContent" : {
    "modelId" : 67,
    "idObject" : "167",
    "value" : -1.0,
    "color" : null,
    "description" : null,
    "type" : "GENERIC",
    "geneVariations" : [ ],
    "uniqueId" : 167,
    "sourceData" : null
  }
} ]