FastAPI (0.1.0)

Download OpenAPI specification:Download

Authentication

HTTPBearer

Security Scheme Type HTTP
HTTP Authorization Scheme bearer

Authentication

Config

Responses

Response samples

Content type
application/json
{
  • "plugins": [
    ]
}

Login

Login a user

Request Body schema: application/json
plugin
string (Plugin)
login
string (Login)
password
string (Password)
token
string (Token)

Responses

Request samples

Content type
application/json
{
  • "plugin": "string",
  • "login": "string",
  • "password": "string",
  • "token": "string"
}

Response samples

Content type
application/json
{
  • "login": "string",
  • "token": "string",
  • "permissions": [
    ]
}

Options

Get Ui Options

Get the available UI database options

Authorizations:

Responses

Response samples

Content type
application/json
{
  • "motd": "",
  • "beamLineGroups": [ ]
}

Get Options

Get the available database options

Authorizations:

Responses

Response samples

Content type
application/json
{
  • "motd": "",
  • "beamLineGroups": [ ],
  • "query_debug": false,
  • "enable_legacy_routes": true,
  • "enable_webservice_routes": true,
  • "create_person_on_missing": false
}

Update Options

Update the database options

Authorizations:
Request Body schema: application/json
motd
string (Message of the Day)
Default: ""

Displayed at the top of the UI

Array of objects (Beamline Groups)
Default: []
query_debug
boolean (Query Debugging)
Default: false

Enable query debugging

enable_legacy_routes
boolean (Legacy Routes)
Default: true

Enable legacy routes

enable_webservice_routes
boolean (Webservice Routes)
Default: true

Enable webservices called from external applications

create_person_on_missing
boolean (Create Missing Login)
Default: false

Automatically create a Person entry if the login is missing from the database. (!) Warning modifies the database

Responses

Request samples

Content type
application/json
{
  • "motd": "",
  • "beamLineGroups": [ ],
  • "query_debug": false,
  • "enable_legacy_routes": true,
  • "enable_webservice_routes": true,
  • "create_person_on_missing": false
}

Response samples

Content type
application/json
{
  • "motd": "",
  • "beamLineGroups": [ ],
  • "query_debug": false,
  • "enable_legacy_routes": true,
  • "enable_webservice_routes": true,
  • "create_person_on_missing": false
}

Mapping

Get Map Rois

Get a list of map rois

Authorizations:
query Parameters
xrfFluorescenceMappingROIId
integer (xrfFluorescenceMapping ROI id)
blSampleId
integer (Blsampleid)

Sample id to filter by

skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Maps

Get a list of maps

Authorizations:
query Parameters
xrfFluorescenceMappingId
integer (XrfFluorescenceMapping id)
dataCollectionId
integer (Datacollectionid)

Data collection id to filter by

dataCollectionGroupId
integer (Datacollectiongroupid)

Data collection group id to filter by

blSampleId
integer (Blsampleid)

Sample id to filter by

blSubSampleId
integer (Blsubsampleid)

Sub sample id to filter by

skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Map Histogram

Get a map histogram

Authorizations:
path Parameters
xrfFluorescenceMappingId
required
integer (Xrffluorescencemappingid)

Responses

Response samples

Content type
application/json
{
  • "xrfFluorescenceMappingId": 0,
  • "hist": [
    ],
  • "bins": [
    ],
  • "width": [
    ]
}

Get Map Pixel Value

Get a map histogram

Authorizations:
path Parameters
xrfFluorescenceMappingId
required
integer (Xrffluorescencemappingid)
query Parameters
x
integer (Y position)
y
integer (Y position)

Responses

Response samples

Content type
application/json
{
  • "xrfFluorescenceMappingId": 0,
  • "x": 0,
  • "y": 0,
  • "value": 0
}

Get Map

Get a map in image format

Authorizations:
path Parameters
xrfFluorescenceMappingId
required
integer (Xrffluorescencemappingid)

Responses

Response samples

Content type
application/json
null

Samples

Get Subsamples

Get a list of sub samples

Authorizations:
query Parameters
skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

blSampleId
integer (Blsampleid)

Sample id to filter by

proteinId
integer (Proteinid)

Protein id to filter by

proposal
string (Proposal) ^(\w|-)+\d+$

Proposal name to filter by

containerId
integer (Containerid)

Container id to filter by

order_by
any
Enum: "blSubSampleId" "datacollections"

Field to order by

order
string
Enum: "asc" "desc"

Order direction

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Subsample

Get a sub sample

Authorizations:
path Parameters
blSubSampleId
required
integer (Blsubsampleid)

Responses

Response samples

Content type
application/json
{
  • "type": "string",
  • "comments": "string",
  • "blSampleId": 0,
  • "_metadata": {
    },
  • "blSubSampleId": 0,
  • "BLSample": {
    },
  • "Position1": {
    },
  • "Position2": {
    }
}

Get Sample Images

Get a list of sample images

Authorizations:
query Parameters
skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

blSampleId
integer (Blsampleid)

Sample id to filter by

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Sample Image

Get a sample image

Authorizations:
path Parameters
blSampleImageId
required
integer (Blsampleimageid)

Responses

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

Get Samples

Get a list of samples

Authorizations:
query Parameters
status
any (SampleStatus)
Enum: "Sample Action" "Data Collected" "Strategy" "Auto Integrated"

An enumeration.

skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

search
string (Search)

Search string to filter by

proteinId
integer (Proteinid)

Protein id to filter by

proposal
string (Proposal) ^(\w|-)+\d+$

Proposal name to filter by

containerId
integer (Containerid)

Container id to filter by

beamLineName
string (Beamlinename)

Beamline name to filter by

order_by
any
Enum: "blSampleId" "name" "location" "datacollections"

Field to order by

order
string
Enum: "asc" "desc"

Order direction

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Sample

Get a sample

Authorizations:
path Parameters
blSampleId
required
integer (Blsampleid)

Responses

Response samples

Content type
application/json
{
  • "name": "string",
  • "comments": "string",
  • "location": 0,
  • "containerId": 0,
  • "Crystal": {
    },
  • "blSampleId": 0,
  • "Container": {
    },
  • "_metadata": {
    }
}

Dewars

Get Dewars

Get a list of dewars

Authorizations:
query Parameters
shippingId
integer (Shippingid)

Shipping id to filter by

proposal
string (Proposal) ^(\w|-)+\d+$

Proposal name to filter by

skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Create Dewar

Create a new dewar

Authorizations:
Request Body schema: application/json
shippingId
required
integer (Shippingid)
code
required
string (Name)
dewarType
string (Dewartype)

Responses

Request samples

Content type
application/json
{
  • "shippingId": 0,
  • "code": "string",
  • "dewarType": "string"
}

Response samples

Content type
application/json
{
  • "shippingId": 0,
  • "code": "string",
  • "dewarType": "string",
  • "dewarId": 0,
  • "Shipping": {
    }
}

Get Dewar

Get a dewar

Authorizations:
path Parameters
dewarId
required
integer (Dewarid)

Responses

Response samples

Content type
application/json
{
  • "shippingId": 0,
  • "code": "string",
  • "dewarType": "string",
  • "dewarId": 0,
  • "Shipping": {
    }
}

Update Dewar

Update a Dewar

Authorizations:
path Parameters
dewarId
required
integer (Dewarid)
Request Body schema: application/json
code
string (Code)
dewarType
string (Dewartype)

Responses

Request samples

Content type
application/json
{
  • "code": "string",
  • "dewarType": "string"
}

Response samples

Content type
application/json
{
  • "shippingId": 0,
  • "code": "string",
  • "dewarType": "string",
  • "dewarId": 0,
  • "Shipping": {
    }
}

Stats

Get Breakdown

Get stats breakdown for a session or run

Authorizations:
query Parameters
beamLineName
string (Beamlinename)

Beamline name to filter by

session
string (Session) ^(\w|-)+\d+-\d+$

Session name to filter by

sessionId
integer (Sessionid)

Session id to filter by

runId
string (Runid)

Run id filter by

Responses

Response samples

Content type
application/json
{
  • "overview": {
    },
  • "history": [
    ],
  • "plottables": {
    }
}

Get Times

Get total times for a session, proposal, or run

Authorizations:
query Parameters
beamLineName
string (Beamlinename)

Beamline name to filter by

session
string (Session) ^(\w|-)+\d+-\d+$

Session name to filter by

sessionId
integer (Sessionid)

Session id to filter by

proposal
string (Proposal) ^(\w|-)+\d+$

Proposal name to filter by

runId
string (Runid)

Run id filter by

Responses

Response samples

Content type
application/json
{
  • "average": {
    },
  • "sessions": [
    ]
}

Get Errors

Get the errors for a session or run

Authorizations:
query Parameters
beamLineName
string (Beamlinename)

Beamline name to filter by

session
string (Session) ^(\w|-)+\d+-\d+$

Session name to filter by

sessionId
integer (Sessionid)

Session id to filter by

runId
string (Runid)

Run id filter by

Responses

Response samples

Content type
application/json
{
  • "totals": [
    ]
}

Get Hourlies

Get the hourly stats for a session or run

Authorizations:
query Parameters
beamLineName
string (Beamlinename)

Beamline name to filter by

session
string (Session) ^(\w|-)+\d+-\d+$

Session name to filter by

sessionId
integer (Sessionid)

Session id to filter by

proposal
string (Proposal) ^(\w|-)+\d+$

Proposal name to filter by

runId
string (Runid)

Run id filter by

Responses

Response samples

Content type
application/json
{
  • "datacollections": {
    },
  • "loaded": {
    }
}

Get Parameter Histogram

Get histogram of parameters for a session or run

Authorizations:
query Parameters
beamLineName
string (Beamlinename)

Beamline name to filter by

session
string (Session) ^(\w|-)+\d+-\d+$

Session name to filter by

sessionId
integer (Sessionid)

Session id to filter by

runId
string (Runid)

Run id filter by

Responses

Response samples

Content type
application/json
{
  • "parameter": "string",
  • "unit": "string",
  • "beamLines": [
    ]
}

Get Runs

Get a list of runs

Authorizations:
query Parameters
skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Data

Get Image

Get raw image data

Authorizations:
query Parameters
imageNumber
required
integer (Imagenumber)
dataCollectionId
integer (Datacollectionid)

Data collection id to filter by

Responses

Response samples

Content type
application/json
null

Get Image Header

Get image header

Authorizations:
query Parameters
imageNumber
required
integer (Imagenumber)
dataCollectionId
integer (Datacollectionid)

Data collection id to filter by

Responses

Response samples

Content type
application/json
null

Get Image Histogram

Get image histogram data

Authorizations:
query Parameters
imageNumber
required
integer (Imagenumber)
dataCollectionId
integer (Datacollectionid)

Data collection id to filter by

Responses

Response samples

Content type
application/json
{
  • "values": [
    ],
  • "bins": [
    ],
  • "shape": [
    ],
  • "max": 0
}

Get Attr

h5grove /attr/ endpoint handler

Authorizations:
query Parameters
path
string (Path)
Default: "/"
attr_keys
Array of strings (Attr Keys)
autoProcProgramAttachmentId
integer (AutoProcProgramAttachment id)
robotActionId
integer (RobotAction id)
dataCollectionId
integer (Datacollectionid)

Data collection id to filter by

Responses

Response samples

Content type
application/json
null

Get Data

h5grove /data/ endpoint handler

Authorizations:
query Parameters
path
string (Path)
Default: "/"
dtype
string (Dtype)
Default: "origin"
format
string (Format)
Default: "json"
flatten
boolean (Flatten)
Default: false
selection
any (Selection)
autoProcProgramAttachmentId
integer (AutoProcProgramAttachment id)
robotActionId
integer (RobotAction id)
dataCollectionId
integer (Datacollectionid)

Data collection id to filter by

Responses

Response samples

Content type
application/json
null

Get Meta

h5grove /meta/ endpoint handler

Authorizations:
query Parameters
path
string (Path)
Default: "/"
resolve_links
string (Resolve Links)
Default: "only_valid"
autoProcProgramAttachmentId
integer (AutoProcProgramAttachment id)
robotActionId
integer (RobotAction id)
dataCollectionId
integer (Datacollectionid)

Data collection id to filter by

Responses

Response samples

Content type
application/json
null

Get Stats

h5grove /stats/ endpoint handler

Authorizations:
query Parameters
path
string (Path)
Default: "/"
selection
any (Selection)
autoProcProgramAttachmentId
integer (AutoProcProgramAttachment id)
robotActionId
integer (RobotAction id)
dataCollectionId
integer (Datacollectionid)

Data collection id to filter by

Responses

Response samples

Content type
application/json
null

Shipping

Get Shippings

Get a list of shipments

Authorizations:
query Parameters
proposal
string (Proposal) ^(\w|-)+\d+$

Proposal name to filter by

skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Create Shipping

Create a new shipment

Authorizations:
Request Body schema: application/json
proposalId
required
integer (Proposalid)
shippingName
required
string (Name)
sendingLabContactId
required
integer (Sending Lab Contact)
returnLabContactId
required
integer (Return Lab Contact)
safetyLevel
string (Safety Level)
Default: "GREEN"
Enum: "GREEN" "YELLOW" "RED"

An enumeration.

comments
string (Comments)

Responses

Request samples

Content type
application/json
{
  • "proposalId": 0,
  • "shippingName": "string",
  • "sendingLabContactId": 0,
  • "returnLabContactId": 0,
  • "safetyLevel": "GREEN",
  • "comments": "string"
}

Response samples

Content type
application/json
{
  • "proposalId": 0,
  • "shippingName": "string",
  • "sendingLabContactId": 0,
  • "returnLabContactId": 0,
  • "safetyLevel": "GREEN",
  • "comments": "string",
  • "shippingId": 0,
  • "bltimeStamp": "2019-08-24T14:15:22Z",
  • "_metadata": {
    },
  • "LabContact": {
    },
  • "LabContact1": {
    }
}

Get Shipping

Get a shipment

Authorizations:
path Parameters
shippingId
required
integer (Shippingid)

Responses

Response samples

Content type
application/json
{
  • "proposalId": 0,
  • "shippingName": "string",
  • "sendingLabContactId": 0,
  • "returnLabContactId": 0,
  • "safetyLevel": "GREEN",
  • "comments": "string",
  • "shippingId": 0,
  • "bltimeStamp": "2019-08-24T14:15:22Z",
  • "_metadata": {
    },
  • "LabContact": {
    },
  • "LabContact1": {
    }
}

Update Shipping

Update a Shipment

Authorizations:
path Parameters
shippingId
required
integer (Shippingid)
Request Body schema: application/json
proposalId
integer (Proposalid)
shippingName
string (Shippingname)
sendingLabContactId
integer (Sendinglabcontactid)
returnLabContactId
integer (Returnlabcontactid)
safetyLevel
string (SafetyLevelEnum)
Enum: "GREEN" "YELLOW" "RED"

An enumeration.

comments
string (Comments)

Responses

Request samples

Content type
application/json
{
  • "proposalId": 0,
  • "shippingName": "string",
  • "sendingLabContactId": 0,
  • "returnLabContactId": 0,
  • "safetyLevel": "GREEN",
  • "comments": "string"
}

Response samples

Content type
application/json
{
  • "proposalId": 0,
  • "shippingName": "string",
  • "sendingLabContactId": 0,
  • "returnLabContactId": 0,
  • "safetyLevel": "GREEN",
  • "comments": "string",
  • "shippingId": 0,
  • "bltimeStamp": "2019-08-24T14:15:22Z",
  • "_metadata": {
    },
  • "LabContact": {
    },
  • "LabContact1": {
    }
}

Events

Get Events

Get a list of events

Authorizations:
query Parameters
status
string (EventStatus)
Enum: "success" "failed" "processed" "processerror"

An enumeration.

eventType
string (Eventtype)
skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

session
string (Session) ^(\w|-)+\d+-\d+$

Session name to filter by

sessionId
integer (Sessionid)

Session id to filter by

proposal
string (Proposal) ^(\w|-)+\d+$

Proposal name to filter by

proposalId
integer (Proposalid)

Proposal id to filter by

beamLineName
string (Beamlinename)

Beamline name to filter by

dataCollectionId
integer (Datacollectionid)

Data collection id to filter by

dataCollectionGroupId
integer (Datacollectiongroupid)

Data collection group id to filter by

blSampleId
integer (Blsampleid)

Sample id to filter by

blSubSampleId
integer (Blsubsampleid)

Sub sample id to filter by

proteinId
integer (Proteinid)

Protein id to filter by

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Event Types

Get a list of event types

Authorizations:
query Parameters
session
string (Session) ^(\w|-)+\d+-\d+$

Session name to filter by

sessionId
integer (Sessionid)

Session id to filter by

blSampleId
integer (Blsampleid)

Sample id to filter by

proteinId
integer (Proteinid)

Protein id to filter by

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Current User

Current User

Authorizations:

Responses

Response samples

Content type
application/json
{
  • "givenName": "string",
  • "familyName": "string",
  • "login": "string",
  • "Permissions": [
    ],
  • "personId": 0,
  • "beamLineGroups": [
    ],
  • "beamLines": [
    ]
}

Sign Url

Sign a url with a one time token

Authorizations:
Request Body schema: application/json
validity
required
string (Validity)

The url to sign

token
string (Token)

Responses

Request samples

Content type
application/json
{
  • "validity": "string",
  • "token": "string"
}

Response samples

Content type
application/json
{
  • "validity": "string",
  • "token": "string"
}

Sessions

Get Sessions

Get a list of sessions

Authorizations:
query Parameters
beamLineGroup
string (Beamlinegroup)

Show sessions for a beamLineGroup

scheduled
boolean (Scheduled)

Get scheduled sessions only

upcoming
boolean (Upcoming)
Default: false

Get the upcoming sessions

previous
boolean (Previous)
Default: false

Get the recently finished sessions

sessionType
any (Sessiontype)

Filter by session type, i.e. commissioning, remote

proposal
string (Proposal) ^(\w|-)+\d+$

Proposal name to filter by

beamLineName
string (Beamlinename)

Beamline name to filter by

month
string (Month) ^\d\d?$

Month filter by

year
string (Year) ^\d\d\d\d$

Year filter by

skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Sessions For Beamline Group

Get a list of sessions for a beamline group Displays one session per beamline

Authorizations:
query Parameters
beamLineGroup
string (Beamlinegroup)

Beamline group to display session for

upcoming
boolean (Upcoming)
Default: false

Get the upcoming sessions

previous
boolean (Previous)
Default: false

Get the recently finished sessions

sessionType
any (Sessiontype)

Filter by session type, i.e. commissioning, remote

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Session

Get a session

Authorizations:
path Parameters
sessionId
required
integer (Sessionid)

Responses

Response samples

Content type
application/json
{
  • "sessionId": 0,
  • "proposalId": 0,
  • "session": "string",
  • "proposal": "string",
  • "BeamLineSetup": {
    },
  • "visit_number": 0,
  • "startDate": "2019-08-24T14:15:22Z",
  • "endDate": "2019-08-24T14:15:22Z",
  • "beamLineName": "string",
  • "beamLineOperator": "string",
  • "scheduled": true,
  • "comments": "string",
  • "nbReimbDewars": 0,
  • "_metadata": {
    }
}

Proteins

Get Proteins

Get a list of proteins

Authorizations:
query Parameters
skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

proteinId
integer (Proteinid)

Protein id to filter by

proposal
string (Proposal) ^(\w|-)+\d+$

Proposal name to filter by

search
string (Search)

Search string to filter by

order_by
any
Enum: "proteinId" "acronym" "name"

Field to order by

order
string
Enum: "asc" "desc"

Order direction

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Protein

Get a protein

Authorizations:
path Parameters
proteinId
required
integer (Proteinid)

Responses

Response samples

Content type
application/json
{
  • "name": "string",
  • "acronym": "string",
  • "proposalId": 0,
  • "sequence": "string",
  • "density": 0,
  • "molecularMass": 0,
  • "containmentLevel": "string",
  • "hazardGroup": "string",
  • "safetyLevel": "string",
  • "ComponentType": {
    },
  • "proteinId": 0,
  • "_metadata": {
    }
}

Processing Status and Results

Get Processing Statuses

Get processing statuses for a group of data collections

Authorizations:
query Parameters
dataCollectionIds
string <json-string> (List of data collection ids (JSON encoded))
Default: ""

Responses

Response samples

Content type
application/json
{
  • "statuses": {
    }
}

Get Screening Results

Get a list of screening results from Screening

Authorizations:
query Parameters
dataCollectionId
integer (Datacollectionid)

Data collection id to filter by

skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Processing Results

Get a list of processing results from ProcessingJob

Authorizations:
query Parameters
dataCollectionId
integer (Datacollectionid)

Data collection id to filter by

skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Auto Integration Results

Get a list of auto-integration results from AutoProcIntegration

Authorizations:
query Parameters
dataCollectionId
integer (Datacollectionid)

Data collection id to filter by

skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Processing Messages

Get a list of processing messages

Authorizations:
query Parameters
autoProcProgramMessageId
integer (Autoprocprogrammessageid)
dataCollectionId
integer (Datacollectionid)

Data collection id to filter by

skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Processing Messages Status

Get the processing messages status

Authorizations:
query Parameters
dataCollectionIds
string <json-string> (List of data collection ids (JSON encoded))
Default: ""

Responses

Response samples

Content type
application/json
{
  • "statuses": {
    }
}

Get Processing Attachments

Get a list of auto processing attachments

Authorizations:
query Parameters
autoProcProgramId
integer (Autoprocprogramid)
autoProcProgramAttachmentId
integer (Autoprocprogramattachmentid)
skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Processing Attachment

Get an auto processing attachment

Authorizations:
path Parameters
autoProcProgramAttachmentId
required
integer (Autoprocprogramattachmentid)

Responses

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

Lab Contacts

Get Lab Contacts

Get a list of lab contacts

Authorizations:
query Parameters
proposal
string (Proposal) ^(\w|-)+\d+$

Proposal name to filter by

skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Create Lab Contact

Create a new lab contact

Authorizations:
Request Body schema: application/json
proposalId
required
integer (Proposalid)
cardName
required
string (Card Name)

The name for this lab contact

defaultCourrierCompany
string (Courrier Company) Nullable
courierAccount
string (Account No.) Nullable
billingReference
string (Billing Reference) Nullable
dewarAvgCustomsValue
integer (Avg Customs Value)
dewarAvgTransportValue
integer (Avg Transport Value)
required
object (Person)

Responses

Request samples

Content type
application/json
{
  • "proposalId": 0,
  • "cardName": "string",
  • "defaultCourrierCompany": "string",
  • "courierAccount": "string",
  • "billingReference": "string",
  • "dewarAvgCustomsValue": 0,
  • "dewarAvgTransportValue": 0,
  • "Person": {
    }
}

Response samples

Content type
application/json
{
  • "proposalId": 0,
  • "cardName": "string",
  • "defaultCourrierCompany": "string",
  • "courierAccount": "string",
  • "billingReference": "string",
  • "dewarAvgCustomsValue": 0,
  • "dewarAvgTransportValue": 0,
  • "Person": {
    },
  • "labContactId": 0,
  • "personId": 0,
  • "recordTimeStamp": "2019-08-24T14:15:22Z"
}

Get Lab Contact

Get a lab contact

Authorizations:
path Parameters
labContactId
required
integer (Labcontactid)

Responses

Response samples

Content type
application/json
{
  • "proposalId": 0,
  • "cardName": "string",
  • "defaultCourrierCompany": "string",
  • "courierAccount": "string",
  • "billingReference": "string",
  • "dewarAvgCustomsValue": 0,
  • "dewarAvgTransportValue": 0,
  • "Person": {
    },
  • "labContactId": 0,
  • "personId": 0,
  • "recordTimeStamp": "2019-08-24T14:15:22Z"
}

Update Lab Contact

Update a Lab Contact

Authorizations:
path Parameters
labContactId
required
integer (Labcontactid)
Request Body schema: application/json
cardName
string (Cardname)
defaultCourrierCompany
string (Defaultcourriercompany)
courierAccount
string (Courieraccount)
billingReference
string (Billingreference)
dewarAvgCustomsValue
integer (Dewaravgcustomsvalue)
dewarAvgTransportValue
integer (Dewaravgtransportvalue)
object (PersonCreateOptional)

Responses

Request samples

Content type
application/json
{
  • "cardName": "string",
  • "defaultCourrierCompany": "string",
  • "courierAccount": "string",
  • "billingReference": "string",
  • "dewarAvgCustomsValue": 0,
  • "dewarAvgTransportValue": 0,
  • "Person": {
    }
}

Response samples

Content type
application/json
{
  • "proposalId": 0,
  • "cardName": "string",
  • "defaultCourrierCompany": "string",
  • "courierAccount": "string",
  • "billingReference": "string",
  • "dewarAvgCustomsValue": 0,
  • "dewarAvgTransportValue": 0,
  • "Person": {
    },
  • "labContactId": 0,
  • "personId": 0,
  • "recordTimeStamp": "2019-08-24T14:15:22Z"
}

Data Collections

Get Datacollection Diffraction Image

Get a data collection diffraction image

Authorizations:
path Parameters
dataCollectionId
required
integer (Datacollectionid)
query Parameters
snapshot
boolean (Snapshot)
Default: false

Get snapshot image

Responses

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

Get Datacollection Anaylsis Image

Get a data collection per image analysis image

Authorizations:
path Parameters
dataCollectionId
required
integer (Datacollectionid)

Responses

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

Get Datacollection Image

Get a data collection image

Authorizations:
path Parameters
dataCollectionId
required
integer (Datacollectionid)
query Parameters
imageId
integer (Imageid) [ 1 .. 4 ]
Default: 1

Image 1-4 to return

snapshot
boolean (Snapshot)
Default: false

Get snapshot image

Responses

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

Get Datacollection Attachments

Get a list of data collection attachments

Authorizations:
query Parameters
skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

dataCollectionId
integer (Datacollectionid)

Data collection id to filter by

dataCollectionGroupId
integer (Datacollectiongroupid)

Data collection group id to filter by

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Datacollection Attachment

Get a data collection attachment

Authorizations:
path Parameters
dataCollectionFileAttachmentId
required
integer (Datacollectionfileattachmentid)

Responses

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

Get Per Image Analysis

Get a list of per image/point analysis

Authorizations:
query Parameters
skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

dataCollectionId
integer (Datacollectionid)

Data collection id to filter by

dataCollectionGroupId
integer (Datacollectiongroupid)

Data collection group id to filter by

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Workflow Steps

Get a list of workflow steps

Authorizations:
query Parameters
workflowId
integer (Workflow id)
workflowStepId
integer (Workflow step id)
skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Workflow Step Attachment

Get a workflow step attachment

Authorizations:
path Parameters
workflowStepId
required
integer (Workflowstepid)
query Parameters
attachmentType
required
string (WorkflowStepAttachment)
Enum: "imageResultFilePath" "resultFilePath"

An enumeration.

Responses

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

Containers

Get Containers

Get a list of containers

Authorizations:
query Parameters
proposal
string (Proposal) ^(\w|-)+\d+$

Proposal name to filter by

skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Create Container

Create a new container

Authorizations:
Request Body schema: application/json
code
required
string (Name)
dewarId
required
integer (Dewarid)
containerType
required
string (Containertype)
sampleChangerLocation
string (Samplechangerlocation)

Position in sample change

beamlineLocation
string (Beamlinelocation)

Beamline if container is assigned

Responses

Request samples

Content type
application/json
{
  • "code": "string",
  • "dewarId": 0,
  • "containerType": "string",
  • "sampleChangerLocation": "string",
  • "beamlineLocation": "string"
}

Response samples

Content type
application/json
{
  • "code": "string",
  • "dewarId": 0,
  • "containerType": "string",
  • "sampleChangerLocation": "string",
  • "beamlineLocation": "string",
  • "containerId": 0,
  • "Dewar": {
    }
}

Get Container

Get a container

Authorizations:
path Parameters
containerId
required
integer (Containerid)

Responses

Response samples

Content type
application/json
{
  • "code": "string",
  • "dewarId": 0,
  • "containerType": "string",
  • "sampleChangerLocation": "string",
  • "beamlineLocation": "string",
  • "containerId": 0,
  • "Dewar": {
    }
}

Update Container

Update a Container

Authorizations:
path Parameters
containerId
required
integer (Containerid)
Request Body schema: application/json
code
string (Code)
dewarId
integer (Dewarid)
containerType
string (Containertype)
sampleChangerLocation
string (Samplechangerlocation)
beamlineLocation
string (Beamlinelocation)

Responses

Request samples

Content type
application/json
{
  • "code": "string",
  • "dewarId": 0,
  • "containerType": "string",
  • "sampleChangerLocation": "string",
  • "beamlineLocation": "string"
}

Response samples

Content type
application/json
{
  • "code": "string",
  • "dewarId": 0,
  • "containerType": "string",
  • "sampleChangerLocation": "string",
  • "beamlineLocation": "string",
  • "containerId": 0,
  • "Dewar": {
    }
}

Proposals

Get Proposals

Get a list of proposals

Authorizations:
query Parameters
search
string (Search)

Search string to filter by

skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Proposal

Get a proposal

Authorizations:
path Parameters
proposal
required
string (Proposal)

Responses

Response samples

Content type
application/json
{
  • "proposalCode": "string",
  • "proposalNumber": "string",
  • "proposal": "string",
  • "title": "string",
  • "state": "Open",
  • "_metadata": {
    },
  • "proposalId": 0
}

People

Get Persons

Get a list of people

Authorizations:
query Parameters
showAll
boolean (Showall)
Default: false
proposal
string (Proposal) ^(\w|-)+\d+$

Proposal name to filter by

sessionId
integer (Sessionid)

Session id to filter by

skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Data collections - legacy with header token

Get

Get data collection groups for session.

Args: session_id (str): session id

Authorizations:
path Parameters
session_id
required
string (Session Id)

Responses

Response samples

Content type
application/json
null

EM - legacy with header token

Get Movies

Get movies date for datacollection.

Args: proposal_id (str): proposal id or name datacollection_id (str): data collection id

Authorizations:
path Parameters
datacollection_id
required
integer (Datacollection Id)
proposal_id
required
string (Proposal Id)

Responses

Response samples

Content type
application/json
null

Get Movie Thumbnail

Get thumbnails for movie.

Args: proposal_id (str): proposal id or name movie_id (str): movie id

Authorizations:
path Parameters
movie_id
required
integer (Movie Id)
proposal_id
required
string (Proposal Id)

Responses

Response samples

Content type
application/json
null

Get Motion Thumbnail

Get motion correction thumbnail for movie.

Args: proposal_id (str): proposal id or name movie_id (str): movie id

Authorizations:
path Parameters
movie_id
required
integer (Movie Id)
proposal_id
required
string (Proposal Id)

Responses

Response samples

Content type
application/json
null

Get Ctf Thumbnail

Get CTF thumbnail for movie.

Args: proposal_id (str): proposal id or name movie_id (str): movie id

Authorizations:
path Parameters
movie_id
required
integer (Movie Id)
proposal_id
required
string (Proposal Id)

Responses

Response samples

Content type
application/json
null

Get Motion Drift Thumbnail

Get motion correction drift thumbnail for movie.

Args: proposal_id (str): proposal id or name movie_id (str): movie id

Authorizations:
path Parameters
movie_id
required
integer (Movie Id)
proposal_id
required
string (Proposal Id)

Responses

Response samples

Content type
application/json
null

Get Stats Session

Get stats for session.

Args: session_id (str): session id

Authorizations:
path Parameters
session_id
required
string (Session Id)

Responses

Response samples

Content type
application/json
null

Get Stats Dcids

Get stats for data collection ids.

Args: proposal_id (str): proposal id or name data_collections_ids (str): comma-separated datacollection ids

Authorizations:
path Parameters
data_collections_ids
required
string (Data Collections Ids)
proposal_id
required
string (Proposal Id)

Responses

Response samples

Content type
application/json
null

Get Stats Group

Get stats for datacollection group.

Args: proposal_id (str): proposal id or name data_collections_group_id (str): data collection group id

Authorizations:
path Parameters
data_collections_group_id
required
integer (Data Collections Group Id)
proposal_id
required
string (Proposal Id)

Responses

Response samples

Content type
application/json
null

Get Groups For Session

Get datacollection groups for session.

Args: proposal_id (str): proposal id or name session_id (str): session id

Authorizations:
path Parameters
proposal_id
required
string (Proposal Id)
session_id
required
string (Session Id)

Responses

Response samples

Content type
application/json
null

Get Classification

Get classification for session.

Args: session_id (str): session id

Authorizations:
path Parameters
session_id
required
string (Session Id)
query Parameters
self
required
any (Self)
kwargs
required
any (Kwargs)

Responses

Response samples

Content type
application/json
null

Sessions - legacy with header token

Get Sessions

Get all sessions that user is allowed to access.

Authorizations:

Responses

Response samples

Content type
application/json
null

Get Sessions By Dates

Get all sessions between two dates that user is allowed to access.

Args: start_date (str): start date end_date (str): end date

Authorizations:
path Parameters
start_date
required
string (Start Date)
end_date
required
string (End Date)

Responses

Response samples

Content type
application/json
null

Get Sessions For Proposal

Get all sessions for proposal that user is allowed to access.

Args: proposal_id (str): proposal id or name

Authorizations:
path Parameters
proposal_id
required
string (Proposal Id)

Responses

Response samples

Content type
application/json
null

Proposals - legacy with header token

Get Proposals

Get all proposal that user is allowed to access.

Authorizations:

Responses

Response samples

Content type
application/json
null

Get Proposal

Get proposal information.

Args: proposal_id (str): proposal id or name

Authorizations:
path Parameters
proposal_id
required
string (Proposal Id)

Responses

Response samples

Content type
application/json
null

Legacy with token in path ⚠️ only for compatibility ⚠️

Get

Get data collection groups for session.

Args: session_id (str): session id

path Parameters
token
required
string (Token)
session_id
required
string (Session Id)

Responses

Response samples

Content type
application/json
null

Get Movies

Get movies date for datacollection.

Args: proposal_id (str): proposal id or name datacollection_id (str): data collection id

path Parameters
datacollection_id
required
integer (Datacollection Id)
token
required
string (Token)
proposal_id
required
string (Proposal Id)

Responses

Response samples

Content type
application/json
null

Get Movie Thumbnail

Get thumbnails for movie.

Args: proposal_id (str): proposal id or name movie_id (str): movie id

path Parameters
movie_id
required
integer (Movie Id)
token
required
string (Token)
proposal_id
required
string (Proposal Id)

Responses

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

Get Motion Thumbnail

Get motion correction thumbnail for movie.

Args: proposal_id (str): proposal id or name movie_id (str): movie id

path Parameters
movie_id
required
integer (Movie Id)
token
required
string (Token)
proposal_id
required
string (Proposal Id)

Responses

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

Get Ctf Thumbnail

Get CTF thumbnail for movie.

Args: proposal_id (str): proposal id or name movie_id (str): movie id

path Parameters
movie_id
required
integer (Movie Id)
token
required
string (Token)
proposal_id
required
string (Proposal Id)

Responses

Response samples

Content type
application/json
null

Get Motion Drift Thumbnail

Get motion correction drift thumbnail for movie.

Args: proposal_id (str): proposal id or name movie_id (str): movie id

path Parameters
movie_id
required
integer (Movie Id)
token
required
string (Token)
proposal_id
required
string (Proposal Id)

Responses

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

Get Stats Session

Get stats for session.

Args: session_id (str): session id

path Parameters
token
required
string (Token)
session_id
required
string (Session Id)

Responses

Response samples

Content type
application/json
null

Get Stats Dcids

Get stats for data collection ids.

Args: proposal_id (str): proposal id or name data_collections_ids (str): comma-separated datacollection ids

path Parameters
data_collections_ids
required
string (Data Collections Ids)
proposal_id
required
string (Proposal Id)
query Parameters
token
required
string (Token)

Responses

Response samples

Content type
application/json
null

Get Stats Group

Get stats for datacollection group.

Args: proposal_id (str): proposal id or name data_collections_group_id (str): data collection group id

path Parameters
data_collections_group_id
required
integer (Data Collections Group Id)
proposal_id
required
string (Proposal Id)
query Parameters
token
required
string (Token)

Responses

Response samples

Content type
application/json
null

Get Groups For Session

Get datacollection groups for session.

Args: proposal_id (str): proposal id or name session_id (str): session id

path Parameters
token
required
string (Token)
proposal_id
required
string (Proposal Id)
session_id
required
string (Session Id)

Responses

Response samples

Content type
application/json
null

Get Classification

Get classification for session.

Args: session_id (str): session id

path Parameters
token
required
string (Token)
session_id
required
string (Session Id)
query Parameters
self
required
any (Self)
kwargs
required
any (Kwargs)

Responses

Response samples

Content type
application/json
null

Get Sessions

Get all sessions that user is allowed to access.

path Parameters
token
required
string (Token)

Responses

Response samples

Content type
application/json
null

Get Sessions By Dates

Get all sessions between two dates that user is allowed to access.

Args: start_date (str): start date end_date (str): end date

path Parameters
start_date
required
string (Start Date)
end_date
required
string (End Date)
token
required
string (Token)

Responses

Response samples

Content type
application/json
null

Get Sessions For Proposal

Get all sessions for proposal that user is allowed to access.

Args: proposal_id (str): proposal id or name

path Parameters
proposal_id
required
string (Proposal Id)
token
required
string (Token)

Responses

Response samples

Content type
application/json
null

Get Proposals

Get all proposal that user is allowed to access.

path Parameters
token
required
string (Token)

Responses

Response samples

Content type
application/json
null

Get Proposal

Get proposal information.

Args: proposal_id (str): proposal id or name

path Parameters
token
required
string (Token)
proposal_id
required
string (Proposal Id)

Responses

Response samples

Content type
application/json
null

Admin

Get Activity

Get list of admin activity

Authorizations:
query Parameters
action_type
string (ActionType)
Enum: "db_options" "online"

An enumeration.

skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Get Groups

Get a list of UserGroups

Authorizations:
query Parameters
userGroupId
integer (Usergroupid)

UserGroup id to filter by

skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Add Group

Add a new UserGroup

Authorizations:
Request Body schema: application/json
name
required
string (Name)

The name of the group

Responses

Request samples

Content type
application/json
{
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "name": "string",
  • "userGroupId": 0,
  • "_metadata": {
    }
}

Update Group

Update a UserGroup

Authorizations:
path Parameters
userGroupId
required
integer (Usergroupid)
Request Body schema: application/json
name
string (Name)

Responses

Request samples

Content type
application/json
{
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "name": "string",
  • "userGroupId": 0,
  • "_metadata": {
    }
}

Add Permission To Group

Add a Permission to a UserGroup

Authorizations:
path Parameters
userGroupId
required
integer (Usergroupid)
Request Body schema: application/json
permissionId
required
integer (Permission)

Responses

Request samples

Content type
application/json
{
  • "permissionId": 0
}

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

Remove Permission From Group

Remove a Permission from a UserGroup

Authorizations:
path Parameters
userGroupId
required
integer (Usergroupid)
permissionId
required
integer (Permissionid)

Responses

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

Add Person To Group

Add a Person to a UserGroup

Authorizations:
path Parameters
userGroupId
required
integer (Usergroupid)
Request Body schema: application/json
personId
required
integer (Person)

Responses

Request samples

Content type
application/json
{
  • "personId": 0
}

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

Remove Person From Group

Remove a Person from a UserGroup

Authorizations:
path Parameters
userGroupId
required
integer (Usergroupid)
personId
required
integer (Personid)

Responses

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

Get Permissions

Get a list of Permissions

Authorizations:
query Parameters
permissionId
integer (Permissionid)

Permission id to filter by

userGroupId
integer (Usergroupid)

UserGroup id to filter by

search
string (Search)

Search string to filter by

skip
integer (Skip) >= 0
Default: 0

Results to skip

limit
integer (Limit)
Default: 25

Number of results to show

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "results": [
    ],
  • "skip": 0,
  • "limit": 0
}

Add Permission

Add a new Permission

Authorizations:
Request Body schema: application/json
type
required
string (Permission) <= 15 characters

The permission identifier

description
string (Description) <= 100 characters

Description of this permission

Responses

Request samples

Content type
application/json
{
  • "type": "string",
  • "description": "string"
}

Response samples

Content type
application/json
{
  • "type": "string",
  • "description": "string",
  • "permissionId": 0
}

Update Permission

Update a Permission

Authorizations:
path Parameters
permissionId
required
integer (Permissionid)
Request Body schema: application/json
type
string (Type) <= 15 characters
description
string (Description) <= 100 characters

Responses

Request samples

Content type
application/json
{
  • "type": "string",
  • "description": "string"
}

Response samples

Content type
application/json
{
  • "type": "string",
  • "description": "string",
  • "permissionId": 0
}

Webservices - Used by external applications

Sync Proposal

Create/Update a proposal from the User Portal and all its related entities

Authorizations:
Request Body schema: application/json
required
object (UPProposal)
Array of objects (Sessions)
Array of objects (Proteins)

Responses

Request samples

Content type
application/json
{
  • "proposal": {
    },
  • "sessions": [
    ],
  • "proteins": [
    ]
}

Response samples

Content type
application/json
{
  • "message": "string"
}