API docs by Redocly

Collection Schema - DRAFT (0.1.0)

Download OpenAPI specification:Download

E-mail: info@dina-project.net License: Apache 2.0

Collection API Schema

Collecting Event

Get collecting event

By passing in query string, user can get available collecting events authorised

query Parameters
filter[rsql]
string

pass an optional search string for looking up the collecting events

sort
string

optional sort order string, such as descending, denoted by "-"

page[offset]
integer <int32>

number of records to skip when paging

page[limit]
integer <int32> [ 0 .. 50 ]

maximum number of records to return when paging

Responses

Response samples

Content type
application/vnd.api+json
[
  • {
    }
]

Add collecting event

Adds a collecting event

Request Body schema: application/vnd.api+json

CollectingEvent to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Find collecting event by ID

Returns a single collecting event

path Parameters
Id
required
string <uuid>

ID of collecting event to return

Responses

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Update collecting event

update a collecting event

path Parameters
Id
required
string <uuid>

collecting event id to patch

Request Body schema: application/vnd.api+json

collecting event to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Delete collecting event

delete a collecting event

path Parameters
Id
required
string <uuid>

collecting event id to delete

Responses

Collection

Get collection

By passing in query string, user can get available collections authorised

query Parameters
filter[rsql]
string

pass an optional search string for looking up the collections

sort
string

optional sort order string, such as descending, denoted by "-"

page[offset]
integer <int32>

number of records to skip when paging

page[limit]
integer <int32> [ 0 .. 50 ]

maximum number of records to return when paging

Responses

Response samples

Content type
application/vnd.api+json
[
  • {
    }
]

Add collection

Adds a collection

Request Body schema: application/vnd.api+json

Collection to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Find collection by ID

Returns a single collection

path Parameters
Id
required
string <uuid>

ID of collection to return

Responses

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Update collection

update a collection

path Parameters
Id
required
string <uuid>

collection id to patch

Request Body schema: application/vnd.api+json

collection to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Delete collection

delete a collection

path Parameters
Id
required
string <uuid>

collection id to delete

Responses

Collection Sequence Generator

Generate reserved IDs for collection

Generates a set of reserved ids to use when naming a Material Sample that is using a collection. The result will provide the lowest and highest ID reserved, so all the IDs between these two values have been reserved if you are generating more than one using the amount attribute.

Request Body schema: application/vnd.api+json

Settings when generating sequences.

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Collection Managed Attribute

Get collection managed attribute

By passing in query string, user can get available collection managed attributes authorised

query Parameters
filter[rsql]
string

pass an optional search string for looking up the collection managed attributes

sort
string

optional sort order string, such as descending, denoted by "-"

page[offset]
integer <int32>

number of records to skip when paging

page[limit]
integer <int32> [ 0 .. 50 ]

maximum number of records to return when paging

Responses

Response samples

Content type
application/vnd.api+json
[
  • {
    }
]

Add collection managed attribute

Adds a collection managed attribute

Request Body schema: application/vnd.api+json

CollectionManagedAttribute to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Find collection managed attribute by ID

Returns a single collection managed attribute

path Parameters
Id
required
string <uuid>

ID of collection managed attribute to return

Responses

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Update collection managed attribute

update a collection managed attribute

path Parameters
Id
required
string <uuid>

collection managed attribute id to patch

Request Body schema: application/vnd.api+json

collection managed attribute to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Delete collection managed attribute

delete a collection managed attribute

path Parameters
Id
required
string <uuid>

collection managed attribute id to delete

Responses

Material Sample

Get material sample

By passing in query string, user can get available material samples authorised

query Parameters
filter[rsql]
string

pass an optional search string for looking up the material samples

sort
string

optional sort order string, such as descending, denoted by "-"

page[offset]
integer <int32>

number of records to skip when paging

page[limit]
integer <int32> [ 0 .. 50 ]

maximum number of records to return when paging

Responses

Response samples

Content type
application/vnd.api+json
[
  • {
    }
]

Add material sample

Adds a material sample

Request Body schema: application/vnd.api+json

MaterialSample to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Find material sample by ID

Returns a single material sample

path Parameters
Id
required
string <uuid>

ID of material sample to return

Responses

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Update material sample

update a material sample

path Parameters
Id
required
string <uuid>

material sample id to patch

Request Body schema: application/vnd.api+json

material sample to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Delete material sample

delete a material sample

path Parameters
Id
required
string <uuid>

material sample id to delete

Responses

Preparation Type

Get preparation type

By passing in query string, user can get available preparation types authorised

query Parameters
filter[rsql]
string

pass an optional search string for looking up the preparation types

sort
string

optional sort order string, such as descending, denoted by "-"

page[offset]
integer <int32>

number of records to skip when paging

page[limit]
integer <int32> [ 0 .. 50 ]

maximum number of records to return when paging

Responses

Response samples

Content type
application/vnd.api+json
[
  • {
    }
]

Add preparation type

Adds a preparation type

Request Body schema: application/vnd.api+json

PreparationType to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Find preparation type by ID

Returns a single preparation type

path Parameters
Id
required
string <uuid>

ID of preparation type to return

Responses

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Update preparation type

update a preparation type

path Parameters
Id
required
string <uuid>

preparation type id to patch

Request Body schema: application/vnd.api+json

preparation type to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Delete preparation type

delete a preparation type

path Parameters
Id
required
string <uuid>

preparation type id to delete

Responses

Preparation Method

Get preparation method

By passing in query string, user can get available preparation methods authorized

query Parameters
filter[rsql]
string

pass an optional search string for looking up the preparation methods

sort
string

optional sort order string, such as descending, denoted by "-"

page[offset]
integer <int32>

number of records to skip when paging

page[limit]
integer <int32> [ 0 .. 50 ]

maximum number of records to return when paging

Responses

Response samples

Content type
application/vnd.api+json
[
  • {
    }
]

Add preparation method

Adds a preparation method

Request Body schema: application/vnd.api+json

PreparationMethod to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Find preparation method by ID

Returns a single preparation method

path Parameters
Id
required
string <uuid>

ID of preparation method to return

Responses

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Update preparation method

update a preparation method

path Parameters
Id
required
string <uuid>

preparation method id to patch

Request Body schema: application/vnd.api+json

preparation method to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Delete preparation method

delete a preparation method

path Parameters
Id
required
string <uuid>

preparation method id to delete

Responses

Institution

Get institution

By passing in query string, user can get available institutions authorised

query Parameters
filter[rsql]
string

pass an optional search string for looking up the institutions

sort
string

optional sort order string, such as descending, denoted by "-"

page[offset]
integer <int32>

number of records to skip when paging

page[limit]
integer <int32> [ 0 .. 50 ]

maximum number of records to return when paging

Responses

Response samples

Content type
application/vnd.api+json
[
  • {
    }
]

Add institution

Adds a institution

Request Body schema: application/vnd.api+json

Institution to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Find institution by ID

Returns a single institution

path Parameters
Id
required
string <uuid>

ID of institution to return

Responses

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Update institution

update a institution

path Parameters
Id
required
string <uuid>

institution id to patch

Request Body schema: application/vnd.api+json

institution to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Delete institution

delete a institution

path Parameters
Id
required
string <uuid>

institution id to delete

Responses

Storage Unit Type

Get storage unit type

By passing in query string, user can get available storage unit types authorised

query Parameters
filter[rsql]
string

pass an optional search string for looking up the storage unit types

sort
string

optional sort order string, such as descending, denoted by "-"

page[offset]
integer <int32>

number of records to skip when paging

page[limit]
integer <int32> [ 0 .. 50 ]

maximum number of records to return when paging

Responses

Response samples

Content type
application/vnd.api+json
[
  • {
    }
]

Add storage unit type

Adds a storage unit type

Request Body schema: application/vnd.api+json

StorageUnitType to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Find storage unit type by ID

Returns a single storage unit type

path Parameters
Id
required
string <uuid>

ID of storage unit type to return

Responses

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Update storage unit type

update a storage unit type

path Parameters
Id
required
string <uuid>

storage unit type id to patch

Request Body schema: application/vnd.api+json

storage unit type to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Delete storage unit type

delete a storage unit type

path Parameters
Id
required
string <uuid>

storage unit type id to delete

Responses

Project

Get project

By passing in query string, user can get available projects authorised

query Parameters
filter[rsql]
string

pass an optional search string for looking up the projects

sort
string

optional sort order string, such as descending, denoted by "-"

page[offset]
integer <int32>

number of records to skip when paging

page[limit]
integer <int32> [ 0 .. 50 ]

maximum number of records to return when paging

Responses

Response samples

Content type
application/vnd.api+json
[
  • {
    }
]

Add project

Adds a project

Request Body schema: application/vnd.api+json

Project to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Find project by ID

Returns a single project

path Parameters
Id
required
string <uuid>

ID of project to return

Responses

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Update project

update a project

path Parameters
Id
required
string <uuid>

project id to patch

Request Body schema: application/vnd.api+json

project to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Delete project

delete a project

path Parameters
Id
required
string <uuid>

project id to delete

Responses

Assemblage

Get assemblage

By passing in query string, user can get available assemblages authorised

query Parameters
filter[rsql]
string

pass an optional search string for looking up the assemblages

sort
string

optional sort order string, such as descending, denoted by "-"

page[offset]
integer <int32>

number of records to skip when paging

page[limit]
integer <int32> [ 0 .. 50 ]

maximum number of records to return when paging

Responses

Response samples

Content type
application/vnd.api+json
[
  • {
    }
]

Add assemblage

Adds a assemblage

Request Body schema: application/vnd.api+json

Assemblage to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Find assemblage by ID

Returns a single assemblage

path Parameters
Id
required
string <uuid>

ID of assemblage to return

Responses

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Update assemblage

update a assemblage

path Parameters
Id
required
string <uuid>

Assemblage id to patch

Request Body schema: application/vnd.api+json

Assemblage to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Delete assemblage

delete an assemblage

path Parameters
Id
required
string <uuid>

Assemblage id to delete

Responses

Form Template

Get Form Template

By passing in query string, user can get Form Template authorized

query Parameters
sort
string

optional sort order string, such as descending, denoted by "-"

page[offset]
integer <int32>

number of records to skip when paging

page[limit]
integer <int32> [ 0 .. 50 ]

maximum number of records to return when paging

Responses

Response samples

Content type
application/vnd.api+json
[
  • {
    }
]

AddForm Template

Adds a Form Template

Request Body schema: application/vnd.api+json

Form Template to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Find Form Template by ID

Returns a single Form Template

path Parameters
Id
required
string <uuid>

ID of the Form Template to return

Responses

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Update Form Template

Update a Form Template

path Parameters
Id
required
string <uuid>

Form Template id to patch

Request Body schema: application/vnd.api+json

Form Template to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Delete Form Template

delete a Form Template

path Parameters
Id
required
string <uuid>

Form Template id to delete

Responses

Organism

Get organism

By passing in query string, user can get available organisms authorised

query Parameters
filter[rsql]
string

pass an optional search string for looking up the organisms

sort
string

optional sort order string, such as descending, denoted by "-"

page[offset]
integer <int32>

number of records to skip when paging

page[limit]
integer <int32> [ 0 .. 50 ]

maximum number of records to return when paging

Responses

Response samples

Content type
application/vnd.api+json
[
  • {
    }
]

Add organism

Adds a organism

Request Body schema: application/vnd.api+json

Organism to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Find organism by ID

Returns a single organism

path Parameters
Id
required
string <uuid>

ID of organism to return

Responses

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Update organism

update a organism

path Parameters
Id
required
string <uuid>

organism id to patch

Request Body schema: application/vnd.api+json

organism to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Delete organism

delete a organism

path Parameters
Id
required
string <uuid>

organism id to delete

Responses

Protocol

Get protocol

By passing in query string, user can get available protocol types authorised

query Parameters
filter[rsql]
string

pass an optional search string for looking up the protocol types

sort
string

optional sort order string, such as descending, denoted by "-"

page[offset]
integer <int32>

number of records to skip when paging

page[limit]
integer <int32> [ 0 .. 50 ]

maximum number of records to return when paging

Responses

Response samples

Content type
application/vnd.api+json
[
  • {
    }
]

Add protocol

Adds a protocol

Request Body schema: application/vnd.api+json

Protocol to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Find protocol by ID

Returns a single protocol

path Parameters
Id
required
string <uuid>

ID of protocol to return

Responses

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Update protocol

update a protocol

path Parameters
Id
required
string <uuid>

protocol id to patch

Request Body schema: application/vnd.api+json

protocol to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Delete protocol

delete a protocol

path Parameters
Id
required
string <uuid>

protocol id to delete

Responses

Storage Unit

Get storage unit

By passing in query string, user can get available storage unit authorised

query Parameters
filter[rsql]
string

pass an optional search string for looking up the storage unit

sort
string

optional sort order string, such as descending, denoted by "-"

page[offset]
integer <int32>

number of records to skip when paging

page[limit]
integer <int32> [ 0 .. 50 ]

maximum number of records to return when paging

Responses

Response samples

Content type
application/vnd.api+json
[
  • {
    }
]

Add storage unit

Adds a storage unit

Request Body schema: application/vnd.api+json

StorageUnit to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Find storage unit by ID

Returns a single storage unit

path Parameters
Id
required
string <uuid>

ID of storage unit to return

Responses

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Update storage unit

update a storage unit

path Parameters
Id
required
string <uuid>

storage unit id to patch

Request Body schema: application/vnd.api+json

storage unit to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Delete storage unit

delete a storage unit

path Parameters
Id
required
string <uuid>

storage unit id to delete

Responses

Storage Unit Usage

Get storage unit usage

By passing in query string, user can get available storage unit usage authorised

query Parameters
filter[rsql]
string

pass an optional search string for looking up the storage unit usage

sort
string

optional sort order string, such as descending, denoted by "-"

page[offset]
integer <int32>

number of records to skip when paging

page[limit]
integer <int32> [ 0 .. 50 ]

maximum number of records to return when paging

Responses

Response samples

Content type
application/vnd.api+json
[
  • {
    }
]

Add storage unit usage

Adds a storage unit usage

Request Body schema: application/vnd.api+json

StorageUnitUsage to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Find storage unit by ID

Returns a single storage unit usage

path Parameters
Id
required
string <uuid>

ID of storage unit usage to return

Responses

Response samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Update storage unit usage

update a storage unit usage

path Parameters
Id
required
string <uuid>

storage unit usage id to patch

Request Body schema: application/vnd.api+json

storage unit usage to add

required
object

Responses

Request samples

Content type
application/vnd.api+json
{
  • "data": {
    }
}

Delete storage unit usage

delete a storage unit usage

path Parameters
Id
required
string <uuid>

storage unit usage id to delete

Responses