1. List backgrounds

1.1. Path Parameters

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

projectId

project identifier

1.2. Response Fields

Path Type Description

[].id

Number

identifier

[].name

String

name

[].description

String

description

[].project.projectId

String

project id where this background belongs to

[].creator.login

String

who created background

[].status

String

is the background ready. Available statuses are: FAILURE, GENERATING, NA, OK, UNKNOWN

[].progress

Number

generating images progress information (in %)

[].order

Number

order used when listing all backgrounds

[].images[].path

String

directory where background tiles are located

[].images[].model.id

Number

(sub)map for which images are described

[].defaultOverlay

Boolean

should the background be used as default (at most one per project should be marked with true)

1.3. CURL sample

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

1.4. Sample Response

[ {
  "id" : 63,
  "name" : "Normal",
  "defaultOverlay" : true,
  "project" : {
    "projectId" : "test_project"
  },
  "creator" : {
    "login" : "admin"
  },
  "status" : "OK",
  "progress" : 100.0,
  "description" : null,
  "order" : 0,
  "images" : [ {
    "id" : 106,
    "model" : {
      "id" : 113
    },
    "projectBackground" : {
      "id" : 63
    },
    "path" : "directory_1"
  }, {
    "id" : 107,
    "model" : {
      "id" : 112
    },
    "projectBackground" : {
      "id" : 63
    },
    "path" : "directory_0"
  } ]
} ]

2. Get background by id

2.1. Path Parameters

Table 2. /minerva/api/projects/{projectId}/backgrounds/{backgroundId}
Parameter Description

projectId

project identifier

backgroundId

background identifier

2.2. Response Fields

Path Type Description

id

Number

identifier

name

String

name

description

String

description

project.projectId

String

project id where this background belongs to

creator.login

String

who created background

status

String

is the background ready. Available statuses are: FAILURE, GENERATING, NA, OK, UNKNOWN

progress

Number

generating images progress information (in %)

order

Number

order used when listing all backgrounds

images[].path

String

directory where background tiles are located

images[].model.id

Number

(sub)map for which images are described

defaultOverlay

Boolean

should the background be used as default (at most one per project should be marked with true)

2.3. CURL sample

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

2.4. Sample Response

{
  "id" : 73,
  "name" : "Normal",
  "defaultOverlay" : true,
  "project" : {
    "projectId" : "test_project"
  },
  "creator" : {
    "login" : "admin"
  },
  "status" : "OK",
  "progress" : 100.0,
  "description" : null,
  "order" : 0,
  "images" : [ {
    "id" : 120,
    "model" : {
      "id" : 123
    },
    "projectBackground" : {
      "id" : 73
    },
    "path" : "directory_1"
  }, {
    "id" : 121,
    "model" : {
      "id" : 122
    },
    "projectBackground" : {
      "id" : 73
    },
    "path" : "directory_0"
  } ]
}

3. Update Background

3.1. Path Parameters

Table 3. /minerva/api/projects/{projectId}/backgrounds/{backgroundId}
Parameter Description

projectId

project identifier

backgroundId

background identifier

3.2. Request Fields

Path Type Description

id

Number

identifier

name

String

name

description

String

description

creator

String

who created background

order

Number

order used when listing all backgrounds

defaultOverlay

Boolean

should the background be used as default (at most one per project should be marked with true)

3.3. Response Fields

Path Type Description

id

Number

identifier

name

String

name

description

String

description

project.projectId

String

project id where this background belongs to

creator.login

String

who created background

status

String

is the background ready. Available statuses are: FAILURE, GENERATING, NA, OK, UNKNOWN

progress

Number

generating images progress information (in %)

order

Number

order used when listing all backgrounds

images[].path

String

directory where background tiles are located

images[].model.id

Number

(sub)map for which images are described

defaultOverlay

Boolean

should the background be used as default (at most one per project should be marked with true)

3.4. CURL sample

$ curl 'https://minerva-service.lcsb.uni.lu/minerva/api/projects/test_project/backgrounds/66' -X PATCH \
    -d '{"id":66,"name":"weird_title","defaultOverlay":false,"creator":"admin","description":"new description","order":0}' \
    --cookie "MINERVA_AUTH_TOKEN=xxxxxxxx" \
    -H 'Content-Type: application/json'

3.5. Sample Response

{
  "id" : 66,
  "name" : "weird_title",
  "defaultOverlay" : false,
  "project" : {
    "projectId" : "test_project"
  },
  "creator" : {
    "login" : "admin"
  },
  "status" : "OK",
  "progress" : 100.0,
  "description" : "new description",
  "order" : 0,
  "images" : [ {
    "id" : 113,
    "model" : {
      "id" : 119
    },
    "projectBackground" : {
      "id" : 66
    },
    "path" : "directory_0"
  }, {
    "id" : 112,
    "model" : {
      "id" : 118
    },
    "projectBackground" : {
      "id" : 66
    },
    "path" : "directory_1"
  } ]
}

4. Delete overlay

4.1. CURL sample

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

4.2. Path Parameters

Table 4. /minerva/api/projects/{projectId}/backgrounds/{backgroundId}
Parameter Description

projectId

project identifier

backgroundId

background identifier