Download OpenAPI specification:Download
Login a user
plugin | string (Plugin) |
login | string (Login) |
password | string (Password) |
token | string (Token) |
{- "plugin": "string",
- "login": "string",
- "password": "string",
- "token": "string"
}
{- "login": "string",
- "token": "string",
- "permissions": [
- "string"
]
}
Update the database options
motd | string (Message of the Day) Default: "" Displayed at the top of the UI |
Array of objects (Beamline Groups) Default: [] | |
enableShipping | boolean (Enable Shipping) Default: false |
enableReprocessing | boolean (Enable Reprocessing) Default: false |
query_debug | boolean (Query Debugging) Default: false Enable query debugging |
create_person_on_missing | boolean (Create Missing Login) Default: false Automatically create a |
{- "motd": "",
- "beamLineGroups": [ ],
- "enableShipping": false,
- "enableReprocessing": false,
- "query_debug": false,
- "create_person_on_missing": false
}
{- "motd": "",
- "beamLineGroups": [ ],
- "enableShipping": false,
- "enableReprocessing": false,
- "query_debug": false,
- "create_person_on_missing": false
}
Sign a url with a one time token
validity required | string (Validity) The url to sign |
token | string (Token) |
{- "validity": "string",
- "token": "string"
}
{- "validity": "string",
- "token": "string"
}
Get a list of proposals
search | string (Search) Search string to filter by |
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "proposalCode": "string",
- "proposalNumber": "string",
- "proposal": "string",
- "title": "string",
- "state": "Open",
- "_metadata": {
- "persons": 0,
- "sessions": 0,
- "beamLines": [
- "string"
], - "uiGroups": [
- "string"
]
}, - "proposalId": 0
}
], - "skip": 0,
- "limit": 0
}
Get a proposal
proposal required | string (Proposal) |
{- "proposalCode": "string",
- "proposalNumber": "string",
- "proposal": "string",
- "title": "string",
- "state": "Open",
- "_metadata": {
- "persons": 0,
- "sessions": 0,
- "beamLines": [
- "string"
], - "uiGroups": [
- "string"
]
}, - "proposalId": 0
}
Get a list of lab contacts
proposal | string (Proposal) ^(\w|-)+\d+$ Proposal name to filter by |
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "proposalId": 0,
- "cardName": "string",
- "defaultCourrierCompany": "string",
- "courierAccount": "string",
- "billingReference": "string",
- "dewarAvgCustomsValue": 0,
- "dewarAvgTransportValue": 0,
- "Person": {
- "givenName": "string",
- "familyName": "string",
- "emailAddress": "string",
- "phoneNumber": "string",
- "Laboratory": {
- "name": "string",
- "address": "string",
- "city": "string",
- "country": "string",
- "url": "string",
- "laboratoryId": 0,
- "recordTimeStamp": "2019-08-24T14:15:22Z"
}
}, - "labContactId": 0,
- "personId": 0,
- "recordTimeStamp": "2019-08-24T14:15:22Z"
}
], - "skip": 0,
- "limit": 0
}
Create a new lab contact
proposalId required | integer (Proposalid) |
cardName required | string (Card Name) The name for this lab contact |
defaultCourrierCompany | string or null (Courrier Company) |
courierAccount | string or null (Account No.) |
billingReference | string or null (Billing Reference) |
dewarAvgCustomsValue | integer (Avg Customs Value) |
dewarAvgTransportValue | integer (Avg Transport Value) |
required | object (Person) |
{- "proposalId": 0,
- "cardName": "string",
- "defaultCourrierCompany": "string",
- "courierAccount": "string",
- "billingReference": "string",
- "dewarAvgCustomsValue": 0,
- "dewarAvgTransportValue": 0,
- "Person": {
- "givenName": "string",
- "familyName": "string",
- "emailAddress": "string",
- "phoneNumber": "string",
- "Laboratory": {
- "name": "string",
- "address": "string",
- "city": "string",
- "country": "string",
- "url": "string"
}
}
}
{- "proposalId": 0,
- "cardName": "string",
- "defaultCourrierCompany": "string",
- "courierAccount": "string",
- "billingReference": "string",
- "dewarAvgCustomsValue": 0,
- "dewarAvgTransportValue": 0,
- "Person": {
- "givenName": "string",
- "familyName": "string",
- "emailAddress": "string",
- "phoneNumber": "string",
- "Laboratory": {
- "name": "string",
- "address": "string",
- "city": "string",
- "country": "string",
- "url": "string",
- "laboratoryId": 0,
- "recordTimeStamp": "2019-08-24T14:15:22Z"
}
}, - "labContactId": 0,
- "personId": 0,
- "recordTimeStamp": "2019-08-24T14:15:22Z"
}
Get a lab contact
labContactId required | integer (Labcontactid) |
{- "proposalId": 0,
- "cardName": "string",
- "defaultCourrierCompany": "string",
- "courierAccount": "string",
- "billingReference": "string",
- "dewarAvgCustomsValue": 0,
- "dewarAvgTransportValue": 0,
- "Person": {
- "givenName": "string",
- "familyName": "string",
- "emailAddress": "string",
- "phoneNumber": "string",
- "Laboratory": {
- "name": "string",
- "address": "string",
- "city": "string",
- "country": "string",
- "url": "string",
- "laboratoryId": 0,
- "recordTimeStamp": "2019-08-24T14:15:22Z"
}
}, - "labContactId": 0,
- "personId": 0,
- "recordTimeStamp": "2019-08-24T14:15:22Z"
}
Update a Lab Contact
labContactId required | integer (Labcontactid) |
cardName | string (Cardname) |
defaultCourrierCompany | string (Defaultcourriercompany) |
courierAccount | string (Courieraccount) |
billingReference | string (Billingreference) |
dewarAvgCustomsValue | integer (Dewaravgcustomsvalue) |
dewarAvgTransportValue | integer (Dewaravgtransportvalue) |
object (PersonCreateOptional) |
{- "cardName": "string",
- "defaultCourrierCompany": "string",
- "courierAccount": "string",
- "billingReference": "string",
- "dewarAvgCustomsValue": 0,
- "dewarAvgTransportValue": 0,
- "Person": {
- "familyName": "string",
- "emailAddress": "string",
- "phoneNumber": "string",
- "Laboratory": {
- "name": "string",
- "address": "string",
- "city": "string",
- "country": "string",
- "url": "string"
}
}
}
{- "proposalId": 0,
- "cardName": "string",
- "defaultCourrierCompany": "string",
- "courierAccount": "string",
- "billingReference": "string",
- "dewarAvgCustomsValue": 0,
- "dewarAvgTransportValue": 0,
- "Person": {
- "givenName": "string",
- "familyName": "string",
- "emailAddress": "string",
- "phoneNumber": "string",
- "Laboratory": {
- "name": "string",
- "address": "string",
- "city": "string",
- "country": "string",
- "url": "string",
- "laboratoryId": 0,
- "recordTimeStamp": "2019-08-24T14:15:22Z"
}
}, - "labContactId": 0,
- "personId": 0,
- "recordTimeStamp": "2019-08-24T14:15:22Z"
}
Get a list of shipments
proposal | string (Proposal) ^(\w|-)+\d+$ Proposal name to filter by |
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "proposalId": 0,
- "shippingName": "string",
- "sendingLabContactId": 0,
- "returnLabContactId": 0,
- "safetyLevel": "GREEN",
- "comments": "string",
- "shippingId": 0,
- "bltimeStamp": "2019-08-24T14:15:22Z",
- "_metadata": {
- "dewars": 0
}, - "LabContact": {
- "cardName": "string",
- "Person": {
- "givenName": "string",
- "familyName": "string"
}
}, - "LabContact1": {
- "cardName": "string",
- "Person": {
- "givenName": "string",
- "familyName": "string"
}
}
}
], - "skip": 0,
- "limit": 0
}
Create a new shipment
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) |
{- "proposalId": 0,
- "shippingName": "string",
- "sendingLabContactId": 0,
- "returnLabContactId": 0,
- "safetyLevel": "GREEN",
- "comments": "string"
}
{- "proposalId": 0,
- "shippingName": "string",
- "sendingLabContactId": 0,
- "returnLabContactId": 0,
- "safetyLevel": "GREEN",
- "comments": "string",
- "shippingId": 0,
- "bltimeStamp": "2019-08-24T14:15:22Z",
- "_metadata": {
- "dewars": 0
}, - "LabContact": {
- "cardName": "string",
- "Person": {
- "givenName": "string",
- "familyName": "string"
}
}, - "LabContact1": {
- "cardName": "string",
- "Person": {
- "givenName": "string",
- "familyName": "string"
}
}
}
Get a shipment
shippingId required | integer (Shippingid) |
{- "proposalId": 0,
- "shippingName": "string",
- "sendingLabContactId": 0,
- "returnLabContactId": 0,
- "safetyLevel": "GREEN",
- "comments": "string",
- "shippingId": 0,
- "bltimeStamp": "2019-08-24T14:15:22Z",
- "_metadata": {
- "dewars": 0
}, - "LabContact": {
- "cardName": "string",
- "Person": {
- "givenName": "string",
- "familyName": "string"
}
}, - "LabContact1": {
- "cardName": "string",
- "Person": {
- "givenName": "string",
- "familyName": "string"
}
}
}
Update a Shipment
shippingId required | integer (Shippingid) |
proposalId | integer (Proposalid) |
shippingName | string (Shippingname) |
sendingLabContactId | integer (Sendinglabcontactid) |
returnLabContactId | integer (Returnlabcontactid) |
safetyLevel | string (SafetyLevelEnum) Enum: "GREEN" "YELLOW" "RED" An enumeration. |
comments | string (Comments) |
{- "proposalId": 0,
- "shippingName": "string",
- "sendingLabContactId": 0,
- "returnLabContactId": 0,
- "safetyLevel": "GREEN",
- "comments": "string"
}
{- "proposalId": 0,
- "shippingName": "string",
- "sendingLabContactId": 0,
- "returnLabContactId": 0,
- "safetyLevel": "GREEN",
- "comments": "string",
- "shippingId": 0,
- "bltimeStamp": "2019-08-24T14:15:22Z",
- "_metadata": {
- "dewars": 0
}, - "LabContact": {
- "cardName": "string",
- "Person": {
- "givenName": "string",
- "familyName": "string"
}
}, - "LabContact1": {
- "cardName": "string",
- "Person": {
- "givenName": "string",
- "familyName": "string"
}
}
}
Get a list of sub samples
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 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 (SubSampleOrder) Enum: "blSubSampleId" "datacollections" "type" Field to order by |
order | string (Order) Enum: "asc" "desc" Order direction |
{- "total": 0,
- "results": [
- {
- "type": "string",
- "comments": "string",
- "blSampleId": 0,
- "_metadata": {
- "datacollections": 0,
- "types": [
- "string"
]
}, - "blSubSampleId": 0,
- "extraMetadata": { },
- "BLSample": {
- "name": "string"
}, - "Position1": {
- "posX": 0,
- "posY": 0
}, - "Position2": {
- "posX": 0,
- "posY": 0
}
}
], - "skip": 0,
- "limit": 0
}
Get a sub sample
blSubSampleId required | integer (Blsubsampleid) |
{- "type": "string",
- "comments": "string",
- "blSampleId": 0,
- "_metadata": {
- "datacollections": 0,
- "types": [
- "string"
]
}, - "blSubSampleId": 0,
- "extraMetadata": { },
- "BLSample": {
- "name": "string"
}, - "Position1": {
- "posX": 0,
- "posY": 0
}, - "Position2": {
- "posX": 0,
- "posY": 0
}
}
Get a list of sample images
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 Default: 25 Number of results to show |
blSampleId | integer (Blsampleid) Sample id to filter by |
{- "total": 0,
- "results": [
- {
- "blSampleImageId": 0,
- "blSampleId": 0,
- "micronsPerPixelX": 0,
- "micronsPerPixelY": 0,
- "offsetX": 0,
- "offsetY": 0,
- "_metadata": {
- "url": "string"
}
}
], - "skip": 0,
- "limit": 0
}
Get a list of samples
status | any (SampleStatus) Enum: "Sample Action" "Data Collected" "Strategy" "Auto Integrated" "Processed" An enumeration. |
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 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 (SampleOrder) Enum: "blSampleId" "name" "location" "datacollections" Field to order by |
order | string (Order) Enum: "asc" "desc" Order direction |
{- "total": 0,
- "results": [
- {
- "name": "string",
- "comments": "string",
- "location": 0,
- "containerId": 0,
- "Crystal": {
- "cell_a": 0,
- "cell_b": 0,
- "cell_c": 0,
- "cell_alpha": 0,
- "cell_beta": 0,
- "cell_gamma": 0,
- "Protein": {
- "proposalId": "string",
- "name": "string",
- "acronym": "string"
}, - "crystalId": 0,
- "proteinId": 0
}, - "blSampleId": 0,
- "extraMetadata": { },
- "Container": {
- "code": "string",
- "sampleChangerLocation": "string",
- "beamlineLocation": "string"
}, - "_metadata": {
- "subsamples": 0,
- "datacollections": 0,
- "types": [
- "string"
], - "queued": true,
- "strategies": 0,
- "autoIntegrations": 0,
- "integratedResolution": 0,
- "proposal": "string"
}
}
], - "skip": 0,
- "limit": 0
}
Create a new sample
name required | string (Name) |
comments | string or null (Comments) |
location | integer (Location) Location in container |
containerId | integer (Containerid) |
required | object (SampleCrystalCreate) |
{- "name": "string",
- "comments": "string",
- "location": 0,
- "containerId": 0,
- "Crystal": {
- "proteinId": 0
}
}
{- "name": "string",
- "comments": "string",
- "location": 0,
- "containerId": 0,
- "Crystal": {
- "cell_a": 0,
- "cell_b": 0,
- "cell_c": 0,
- "cell_alpha": 0,
- "cell_beta": 0,
- "cell_gamma": 0,
- "Protein": {
- "proposalId": "string",
- "name": "string",
- "acronym": "string"
}, - "crystalId": 0,
- "proteinId": 0
}, - "blSampleId": 0,
- "extraMetadata": { },
- "Container": {
- "code": "string",
- "sampleChangerLocation": "string",
- "beamlineLocation": "string"
}, - "_metadata": {
- "subsamples": 0,
- "datacollections": 0,
- "types": [
- "string"
], - "queued": true,
- "strategies": 0,
- "autoIntegrations": 0,
- "integratedResolution": 0,
- "proposal": "string"
}
}
Get a sample
blSampleId required | integer (Blsampleid) |
{- "name": "string",
- "comments": "string",
- "location": 0,
- "containerId": 0,
- "Crystal": {
- "cell_a": 0,
- "cell_b": 0,
- "cell_c": 0,
- "cell_alpha": 0,
- "cell_beta": 0,
- "cell_gamma": 0,
- "Protein": {
- "proposalId": "string",
- "name": "string",
- "acronym": "string"
}, - "crystalId": 0,
- "proteinId": 0
}, - "blSampleId": 0,
- "extraMetadata": { },
- "Container": {
- "code": "string",
- "sampleChangerLocation": "string",
- "beamlineLocation": "string"
}, - "_metadata": {
- "subsamples": 0,
- "datacollections": 0,
- "types": [
- "string"
], - "queued": true,
- "strategies": 0,
- "autoIntegrations": 0,
- "integratedResolution": 0,
- "proposal": "string"
}
}
Update a BLSample
blSampleId required | integer (Blsampleid) |
name | string (Name) |
comments | string (Comments) |
location | integer (Location) |
object (SampleCrystalCreateOptional) |
{- "name": "string",
- "comments": "string",
- "location": 0,
- "Crystal": {
- "proteinId": 0
}
}
{- "name": "string",
- "comments": "string",
- "location": 0,
- "containerId": 0,
- "Crystal": {
- "cell_a": 0,
- "cell_b": 0,
- "cell_c": 0,
- "cell_alpha": 0,
- "cell_beta": 0,
- "cell_gamma": 0,
- "Protein": {
- "proposalId": "string",
- "name": "string",
- "acronym": "string"
}, - "crystalId": 0,
- "proteinId": 0
}, - "blSampleId": 0,
- "extraMetadata": { },
- "Container": {
- "code": "string",
- "sampleChangerLocation": "string",
- "beamlineLocation": "string"
}, - "_metadata": {
- "subsamples": 0,
- "datacollections": 0,
- "types": [
- "string"
], - "queued": true,
- "strategies": 0,
- "autoIntegrations": 0,
- "integratedResolution": 0,
- "proposal": "string"
}
}
Get stats breakdown for a session or run
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 |
{- "overview": {
- "startDate": "2019-08-24T14:15:22Z",
- "endDate": "2019-08-24T14:15:22Z",
- "duration": 0,
- "beamLineName": "string",
- "sessionId": "string",
- "session": "string",
- "counts": {
- "datacollections": 0,
- "failed": 0,
- "datacollectionTypes": {
- "property1": 0,
- "property2": 0
}, - "robot": 0,
- "edge": 0,
- "xrf": 0
}
}, - "history": [
- {
- "eventType": "string",
- "startTime": "2019-08-24T14:15:22Z",
- "endTime": "2019-08-24T14:15:22Z",
- "protein": "string",
- "sample": "string",
- "subType": "string",
- "status": "string",
- "title": "string",
- "session": "string",
- "sessionId": 0,
- "proposal": "string",
- "dataCollectionId": 0
}
], - "plottables": {
- "time": [
- "2019-08-24T14:15:22Z"
], - "series": [
- {
- "title": "string",
- "unit": "string",
- "data": [
- null
]
}
]
}
}
Get total times for a session, proposal, or run
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 |
{- "average": {
- "duration": 0,
- "startup": 0,
- "datacollection": 0,
- "edge": 0,
- "xrf": 0,
- "robot": 0,
- "strategy": 0,
- "centring": 0,
- "remaining": 0,
- "thinking": 0
}, - "sessions": [
- {
- "duration": 0,
- "startup": 0,
- "datacollection": 0,
- "edge": 0,
- "xrf": 0,
- "robot": 0,
- "strategy": 0,
- "centring": 0,
- "remaining": 0,
- "thinking": 0,
- "sessionId": 0
}
]
}
Get the errors for a session or run
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 |
{- "totals": [
- {
- "experimentType": "string",
- "total": 0,
- "failed": 0,
- "failedPercent": 0,
- "aborted": 0,
- "abortedPercent": 0,
- "messages": [
- {
- "count": 0,
- "message": "string"
}
]
}
]
}
Get the hourly stats for a session or run
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 |
{- "datacollections": {
- "hour": [
- 0
], - "average": [
- 0
]
}, - "loaded": {
- "hour": [
- 0
], - "average": [
- 0
]
}
}
Get histogram of parameters for a session or run
parameter | string (Parameter) Default: "energy" |
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 |
{- "parameter": "string",
- "unit": "string",
- "beamLines": [
- {
- "beamLineName": "string",
- "bin": [
- 0
], - "frequency": [
- 0
]
}
]
}
Get histogram of datacollection times for a session or run
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 |
{- "beamlines": [ ]
}
Get a list of runs
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "run": "string",
- "runId": 0,
- "startDate": "2019-08-24T14:15:22Z",
- "endDate": "2019-08-24T14:15:22Z"
}
], - "skip": 0,
- "limit": 0
}
Get a list of sessions
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) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "sessionId": 0,
- "proposalId": 0,
- "session": "string",
- "proposal": "string",
- "BeamLineSetup": {
- "beamLineSetupId": 0,
- "synchrotronMode": "string",
- "undulatorType1": "string",
- "undulatorType2": "string",
- "undulatorType3": "string",
- "focalSpotSizeAtSample": 0,
- "focusingOptic": "string",
- "beamDivergenceHorizontal": 0,
- "beamDivergenceVertical": 0,
- "polarisation": 0,
- "monochromatorType": "string",
- "setupDate": "2019-08-24T14:15:22Z",
- "synchrotronName": "string",
- "maxExpTimePerDataCollection": 0,
- "minExposureTimePerImage": 0,
- "goniostatMaxOscillationSpeed": 0,
- "goniostatMinOscillationWidth": 0,
- "minTransmission": 0,
- "CS": 0
}, - "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": {
- "datacollections": 0,
- "uiGroups": [
- "string"
], - "persons": 0,
- "active": true,
- "active_soon": true,
- "sessionTypes": [
- "string"
]
}
}
], - "skip": 0,
- "limit": 0
}
Get a list of sessions for a beamline group Displays one session per beamline
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 |
{- "total": 0,
- "results": [
- {
- "sessionId": 0,
- "proposalId": 0,
- "session": "string",
- "proposal": "string",
- "BeamLineSetup": {
- "beamLineSetupId": 0,
- "synchrotronMode": "string",
- "undulatorType1": "string",
- "undulatorType2": "string",
- "undulatorType3": "string",
- "focalSpotSizeAtSample": 0,
- "focusingOptic": "string",
- "beamDivergenceHorizontal": 0,
- "beamDivergenceVertical": 0,
- "polarisation": 0,
- "monochromatorType": "string",
- "setupDate": "2019-08-24T14:15:22Z",
- "synchrotronName": "string",
- "maxExpTimePerDataCollection": 0,
- "minExposureTimePerImage": 0,
- "goniostatMaxOscillationSpeed": 0,
- "goniostatMinOscillationWidth": 0,
- "minTransmission": 0,
- "CS": 0
}, - "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": {
- "datacollections": 0,
- "uiGroups": [
- "string"
], - "persons": 0,
- "active": true,
- "active_soon": true,
- "sessionTypes": [
- "string"
]
}
}
], - "skip": 0,
- "limit": 0
}
Get a session
sessionId required | integer (Sessionid) |
{- "sessionId": 0,
- "proposalId": 0,
- "session": "string",
- "proposal": "string",
- "BeamLineSetup": {
- "beamLineSetupId": 0,
- "synchrotronMode": "string",
- "undulatorType1": "string",
- "undulatorType2": "string",
- "undulatorType3": "string",
- "focalSpotSizeAtSample": 0,
- "focusingOptic": "string",
- "beamDivergenceHorizontal": 0,
- "beamDivergenceVertical": 0,
- "polarisation": 0,
- "monochromatorType": "string",
- "setupDate": "2019-08-24T14:15:22Z",
- "synchrotronName": "string",
- "maxExpTimePerDataCollection": 0,
- "minExposureTimePerImage": 0,
- "goniostatMaxOscillationSpeed": 0,
- "goniostatMinOscillationWidth": 0,
- "minTransmission": 0,
- "CS": 0
}, - "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": {
- "datacollections": 0,
- "uiGroups": [
- "string"
], - "persons": 0,
- "active": true,
- "active_soon": true,
- "sessionTypes": [
- "string"
]
}
}
Get a data collection diffraction image
dataCollectionId required | integer (Datacollectionid) |
snapshot | boolean (Snapshot) Default: false Get snapshot image |
{- "detail": [
- {
- "loc": [
- "string"
], - "msg": "string",
- "type": "string"
}
]
}
Get a robot (sample) action snapshot
robotActionId required | integer (Robotactionid) |
snapshot | boolean (Snapshot) Default: false Get snapshot image |
after | boolean (After) Default: false Get |
{- "detail": [
- {
- "loc": [
- "string"
], - "msg": "string",
- "type": "string"
}
]
}
Get a data collection image
dataCollectionId required | integer (Datacollectionid) |
imageId | integer (Imageid) [ 1 .. 4 ] Default: 1 Image 1-4 to return |
snapshot | boolean (Snapshot) Default: false Get snapshot image |
{- "detail": [
- {
- "loc": [
- "string"
], - "msg": "string",
- "type": "string"
}
]
}
Get a list of data collection attachments
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 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 |
{- "total": 0,
- "results": [
- {
- "dataCollectionFileAttachmentId": 0,
- "dataCollectionId": 0,
- "fileType": "string",
- "_metadata": {
- "url": "string",
- "fileName": "string"
}
}
], - "skip": 0,
- "limit": 0
}
Get a data collection attachment
dataCollectionFileAttachmentId required | integer (Datacollectionfileattachmentid) |
{- "detail": [
- {
- "loc": [
- "string"
], - "msg": "string",
- "type": "string"
}
]
}
Get a list of per image/point analysis
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 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 |
{- "total": 0,
- "results": [
- {
- "dataCollectionId": 0,
- "imageNumber": [
- 0
], - "totalIntegratedSignal": [
- 0
], - "goodBraggCandidates": [
- 0
], - "method2Res": [
- 0
]
}
], - "skip": 0,
- "limit": 0
}
Get a list of workflow steps
workflowId | integer (Workflow id) |
workflowStepId | integer (Workflow step id) |
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "workflowId": 0,
- "workflowStepId": 0,
- "workflowStepType": "string",
- "status": "string",
- "comments": "string",
- "_metadata": {
- "attachments": {
- "property1": true,
- "property2": true
}
}
}
], - "skip": 0,
- "limit": 0
}
Get a workflow step attachment
workflowStepId required | integer (Workflowstepid) |
attachmentType required | string (WorkflowStepAttachment) Enum: "imageResultFilePath" "resultFilePath" An enumeration. |
{- "detail": [
- {
- "loc": [
- "string"
], - "msg": "string",
- "type": "string"
}
]
}
Get processing statuses for a group of data collections
dataCollectionIds | string <json-string> (List of data collection ids (JSON encoded)) Default: "" |
{- "statuses": {
- "property1": {
- "screening": {
- "property1": [
- {
- "status": null,
- "indexingSuccess": null
}
], - "property2": [
- {
- "status": null,
- "indexingSuccess": null
}
]
}, - "xrc": {
- "property1": [
- {
- "status": null
}
], - "property2": [
- {
- "status": null
}
]
}, - "processing": {
- "property1": [
- {
- "status": null,
- "autoProcProgramId": 0
}
], - "property2": [
- {
- "status": null,
- "autoProcProgramId": 0
}
]
}, - "autoIntegration": {
- "property1": [
- {
- "status": null,
- "autoProcProgramId": 0
}
], - "property2": [
- {
- "status": null,
- "autoProcProgramId": 0
}
]
}, - "em": {
- "movie": 0,
- "motionCorrection": 0,
- "ctf": 0
}
}, - "property2": {
- "screening": {
- "property1": [
- {
- "status": null,
- "indexingSuccess": null
}
], - "property2": [
- {
- "status": null,
- "indexingSuccess": null
}
]
}, - "xrc": {
- "property1": [
- {
- "status": null
}
], - "property2": [
- {
- "status": null
}
]
}, - "processing": {
- "property1": [
- {
- "status": null,
- "autoProcProgramId": 0
}
], - "property2": [
- {
- "status": null,
- "autoProcProgramId": 0
}
]
}, - "autoIntegration": {
- "property1": [
- {
- "status": null,
- "autoProcProgramId": 0
}
], - "property2": [
- {
- "status": null,
- "autoProcProgramId": 0
}
]
}, - "em": {
- "movie": 0,
- "motionCorrection": 0,
- "ctf": 0
}
}
}
}
Get a list of screening results from Screening
dataCollectionId | integer (Datacollectionid) Data collection id to filter by |
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "screeningId": 0,
- "programVersion": "string",
- "comments": "string",
- "shortComments": "string",
- "ScreeningOutput": [
- {
- "screeningOutputId": 0,
- "indexingSuccess": 0,
- "strategySuccess": 0,
- "ScreeningStrategy": [
- {
- "screeningStrategyId": 0,
- "rankingResolution": 0,
- "ScreeningStrategyWedge": [
- {
- "screeningStrategyWedgeId": 0,
- "wedgeNumber": 0,
- "resolution": 0,
- "completeness": 0,
- "multiplicity": 0,
- "doseTotal": 0,
- "numberOfImages": 0,
- "phi": 0,
- "kappa": 0,
- "chi": 0,
- "comments": "string",
- "wavelength": 0,
- "ScreeningStrategySubWedge": [
- null
]
}
]
}
], - "ScreeningOutputLattice": [
- {
- "unitCell_a": 0,
- "unitCell_b": 0,
- "unitCell_c": 0,
- "unitCell_alpha": 0,
- "unitCell_beta": 0,
- "unitCell_gamma": 0,
- "spaceGroup": "string",
- "pointGroup": "string"
}
]
}
]
}
], - "skip": 0,
- "limit": 0
}
Get a list of processing results from ProcessingJob
dataCollectionId | integer (Datacollectionid) Data collection id to filter by |
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "autoProcProgramId": 0,
- "processingCommandLine": "string",
- "processingPrograms": "string",
- "processingStatus": null,
- "processingMessage": "string",
- "processingStartTime": "2019-08-24T14:15:22Z",
- "processingEndTime": "2019-08-24T14:15:22Z",
- "processingEnvironment": "string",
- "recordTimeStamp": "2019-08-24T14:15:22Z",
- "ProcessingJob": {
- "processingJobId": 0,
- "displayName": "string",
- "comments": "string",
- "recordTimestamp": "2019-08-24T14:15:22Z",
- "recipe": "string",
- "automatic": true,
- "ProcessingJobParameters": [
- {
- "parameterKey": "string",
- "parameterValue": "string"
}
]
}, - "_metadata": {
- "attachments": 0,
- "autoProcProgramMessages": [
- {
- "autoProcProgramMessageId": 0,
- "autoProcProgramId": 0,
- "description": "string",
- "message": "string",
- "severity": "ERROR",
- "recordTimeStamp": "2019-08-24T14:15:22Z"
}
], - "imageSweepCount": 0
}
}
], - "skip": 0,
- "limit": 0
}
Get a list of auto-integration results from AutoProcIntegration
dataCollectionId | integer (Datacollectionid) Data collection id to filter by |
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "autoProcProgramId": 0,
- "processingCommandLine": "string",
- "processingPrograms": "string",
- "processingStatus": null,
- "processingMessage": "string",
- "processingStartTime": "2019-08-24T14:15:22Z",
- "processingEndTime": "2019-08-24T14:15:22Z",
- "processingEnvironment": "string",
- "recordTimeStamp": "2019-08-24T14:15:22Z",
- "ProcessingJob": {
- "processingJobId": 0,
- "displayName": "string",
- "comments": "string",
- "recordTimestamp": "2019-08-24T14:15:22Z",
- "recipe": "string",
- "automatic": true,
- "ProcessingJobParameters": [
- {
- "parameterKey": "string",
- "parameterValue": "string"
}
]
}, - "_metadata": {
- "attachments": 0,
- "autoProcProgramMessages": [
- {
- "autoProcProgramMessageId": 0,
- "autoProcProgramId": 0,
- "description": "string",
- "message": "string",
- "severity": "ERROR",
- "recordTimeStamp": "2019-08-24T14:15:22Z"
}
], - "imageSweepCount": 0
}, - "AutoProcIntegration": [
- {
- "refinedXBeam": 0,
- "refinedYBeam": 0,
- "AutoProcScalingHasInt": [
- {
- "AutoProcScaling": {
- "AutoProc": {
- "spaceGroup": "string",
- "refinedCell_a": 0,
- "refinedCell_b": 0,
- "refinedCell_c": 0,
- "refinedCell_alpha": 0,
- "refinedCell_beta": 0,
- "refinedCell_gamma": 0
}, - "AutoProcScalingStatistics": [
- {
- "comments": null,
- "scalingStatisticsType": null,
- "resolutionLimitLow": null,
- "resolutionLimitHigh": null,
- "rMerge": null,
- "rMeasAllIPlusIMinus": null,
- "rPimAllIPlusIMinus": null,
- "fractionalPartialBias": null,
- "nTotalObservations": null,
- "nTotalUniqueObservations": null,
- "meanIOverSigI": null,
- "completeness": null,
- "multiplicity": null,
- "anomalousCompleteness": null,
- "anomalousMultiplicity": null,
- "anomalous": null,
- "ccHalf": null,
- "ccAnomalous": null,
- "resIOverSigI2": null
}
]
}
}
], - "DataCollection": {
- "xBeam": 0,
- "yBeam": 0
}
}
]
}
], - "skip": 0,
- "limit": 0
}
Get a list of processing messages
autoProcProgramMessageId | integer (Autoprocprogrammessageid) |
dataCollectionId | integer (Datacollectionid) Data collection id to filter by |
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "autoProcProgramMessageId": 0,
- "autoProcProgramId": 0,
- "description": "string",
- "message": "string",
- "severity": "ERROR",
- "recordTimeStamp": "2019-08-24T14:15:22Z"
}
], - "skip": 0,
- "limit": 0
}
Get the processing messages status
dataCollectionIds | string <json-string> (List of data collection ids (JSON encoded)) Default: "" |
{- "statuses": {
- "property1": {
- "errors": 0,
- "warnings": 0,
- "info": 0
}, - "property2": {
- "errors": 0,
- "warnings": 0,
- "info": 0
}
}
}
Get a list of auto processing attachments
autoProcProgramId | integer (Autoprocprogramid) |
autoProcProgramAttachmentId | integer (Autoprocprogramattachmentid) |
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "autoProcProgramAttachmentId": 0,
- "autoProcProgramId": 0,
- "fileName": "string",
- "fileType": "string",
- "importanceRank": 0,
- "_metadata": {
- "url": "string"
}
}
], - "skip": 0,
- "limit": 0
}
Get a list of map rois
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) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "xrfFluorescenceMappingROIId": 0,
- "element": "string",
- "edge": "string",
- "scalar": "string",
- "startEnergy": 0,
- "endEnergy": 0,
- "_metadata": {
- "maps": 0
}
}
], - "skip": 0,
- "limit": 0
}
Add a new map roi
element required | string (Element) |
edge required | string (Edge) |
startEnergy required | number (Start Energy) |
endEnergy required | number (End Energy) |
blSampleId required | integer (Blsampleid) |
{- "element": "string",
- "edge": "string",
- "startEnergy": 0,
- "endEnergy": 0,
- "blSampleId": 0
}
{- "xrfFluorescenceMappingROIId": 0,
- "element": "string",
- "edge": "string",
- "scalar": "string",
- "startEnergy": 0,
- "endEnergy": 0,
- "_metadata": {
- "maps": 0
}
}
Update a Map
xrfFluorescenceMappingROIId required | integer (Xrffluorescencemappingroiid) |
element | string (Element) |
edge | string (Edge) |
startEnergy | number (Startenergy) |
endEnergy | number (Endenergy) |
{- "element": "string",
- "edge": "string",
- "startEnergy": 0,
- "endEnergy": 0
}
{- "xrfFluorescenceMappingROIId": 0,
- "element": "string",
- "edge": "string",
- "scalar": "string",
- "startEnergy": 0,
- "endEnergy": 0,
- "_metadata": {
- "maps": 0
}
}
Get a list of composite maps
xfeFluorescenceCompositeId | integer (XfeFluorescenceCompositeId id) |
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) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "r": 0,
- "g": 0,
- "b": 0,
- "rOpacity": 1,
- "gOpacity": 1,
- "bOpacity": 1,
- "opacity": 1,
- "xfeFluorescenceCompositeId": 0,
- "_metadata": {
- "url": "string",
- "blSubSampleId": 0,
- "blSampleId": 0,
- "rROI": "string",
- "gROI": "string",
- "bROI": "string"
}, - "XRFFluorescenceMapping": {
- "xrfFluorescenceMappingId": 0,
- "points": 0,
- "GridInfo": {
- "gridInfoId": 0,
- "steps_x": 0,
- "steps_y": 0,
- "snaked": true,
- "orientation": "string"
}
}
}
], - "skip": 0,
- "limit": 0
}
Create a new composite map
r required | integer (R) |
g required | integer (G) |
b required | integer (B) |
rOpacity | number (Ropacity) Default: 1 |
gOpacity | number (Gopacity) Default: 1 |
bOpacity | number (Bopacity) Default: 1 |
opacity | number (Opacity) Default: 1 |
{- "r": 0,
- "g": 0,
- "b": 0,
- "rOpacity": 1,
- "gOpacity": 1,
- "bOpacity": 1,
- "opacity": 1
}
{- "r": 0,
- "g": 0,
- "b": 0,
- "rOpacity": 1,
- "gOpacity": 1,
- "bOpacity": 1,
- "opacity": 1,
- "xfeFluorescenceCompositeId": 0,
- "_metadata": {
- "url": "string",
- "blSubSampleId": 0,
- "blSampleId": 0,
- "rROI": "string",
- "gROI": "string",
- "bROI": "string"
}, - "XRFFluorescenceMapping": {
- "xrfFluorescenceMappingId": 0,
- "points": 0,
- "GridInfo": {
- "gridInfoId": 0,
- "steps_x": 0,
- "steps_y": 0,
- "snaked": true,
- "orientation": "string"
}
}
}
Update a Composite map
xfeFluorescenceCompositeId required | integer (Xfefluorescencecompositeid) |
rOpacity | number (Ropacity) |
gOpacity | number (Gopacity) |
bOpacity | number (Bopacity) |
opacity | number (Opacity) |
{- "rOpacity": 0,
- "gOpacity": 0,
- "bOpacity": 0,
- "opacity": 0
}
{- "r": 0,
- "g": 0,
- "b": 0,
- "rOpacity": 1,
- "gOpacity": 1,
- "bOpacity": 1,
- "opacity": 1,
- "xfeFluorescenceCompositeId": 0,
- "_metadata": {
- "url": "string",
- "blSubSampleId": 0,
- "blSampleId": 0,
- "rROI": "string",
- "gROI": "string",
- "bROI": "string"
}, - "XRFFluorescenceMapping": {
- "xrfFluorescenceMappingId": 0,
- "points": 0,
- "GridInfo": {
- "gridInfoId": 0,
- "steps_x": 0,
- "steps_y": 0,
- "snaked": true,
- "orientation": "string"
}
}
}
Create a new scalar map
dataCollectionId required | integer (Datacollectionid) |
scalar required | string (Scalar Name) |
{- "dataCollectionId": 0,
- "scalar": "string"
}
{- "colourMap": "string",
- "opacity": 0,
- "scale": "string",
- "min": 0,
- "max": 0,
- "xrfFluorescenceMappingId": 0,
- "points": 0,
- "dataFormat": "string",
- "_metadata": {
- "url": "string",
- "blSubSampleId": 0,
- "blSampleId": 0,
- "dataCollectionId": 0
}, - "GridInfo": {
- "gridInfoId": 0,
- "steps_x": 0,
- "steps_y": 0,
- "snaked": true,
- "orientation": "string"
}, - "XRFFluorescenceMappingROI": {
- "xrfFluorescenceMappingROIId": 0,
- "element": "string",
- "edge": "string",
- "scalar": "string",
- "startEnergy": 0,
- "endEnergy": 0,
- "_metadata": {
- "maps": 0
}
}
}
Regenerate maps for a sample
blSampleId required | integer (Blsampleid) |
dataCollectionId | integer (Datacollectionid) |
ev_per_bin | number (Ev Per Bin) Default: 5 eV per bin for MCA |
ev_offset | number (Ev Offset) Default: 0 eV zero offset for MCA |
{- "blSampleId": 0,
- "dataCollectionId": 0,
- "ev_per_bin": 5,
- "ev_offset": 0
}
{- "xrfFluorescenceMappingIds": [
- 0
]
}
Update a Map
xrfFluorescenceMappingId required | integer (Xrffluorescencemappingid) |
colourMap | string (Colourmap) |
opacity | number (Opacity) |
scale | string (Scale) |
min | number (Min) |
max | number (Max) |
{- "colourMap": "string",
- "opacity": 0,
- "scale": "string",
- "min": 0,
- "max": 0
}
{- "colourMap": "string",
- "opacity": 0,
- "scale": "string",
- "min": 0,
- "max": 0,
- "xrfFluorescenceMappingId": 0,
- "points": 0,
- "dataFormat": "string",
- "_metadata": {
- "url": "string",
- "blSubSampleId": 0,
- "blSampleId": 0,
- "dataCollectionId": 0
}, - "GridInfo": {
- "gridInfoId": 0,
- "steps_x": 0,
- "steps_y": 0,
- "snaked": true,
- "orientation": "string"
}, - "XRFFluorescenceMappingROI": {
- "xrfFluorescenceMappingROIId": 0,
- "element": "string",
- "edge": "string",
- "scalar": "string",
- "startEnergy": 0,
- "endEnergy": 0,
- "_metadata": {
- "maps": 0
}
}
}
Get a list of maps
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) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "colourMap": "string",
- "opacity": 0,
- "scale": "string",
- "min": 0,
- "max": 0,
- "xrfFluorescenceMappingId": 0,
- "points": 0,
- "dataFormat": "string",
- "_metadata": {
- "url": "string",
- "blSubSampleId": 0,
- "blSampleId": 0,
- "dataCollectionId": 0
}, - "GridInfo": {
- "gridInfoId": 0,
- "steps_x": 0,
- "steps_y": 0,
- "snaked": true,
- "orientation": "string"
}, - "XRFFluorescenceMappingROI": {
- "xrfFluorescenceMappingROIId": 0,
- "element": "string",
- "edge": "string",
- "scalar": "string",
- "startEnergy": 0,
- "endEnergy": 0,
- "_metadata": {
- "maps": 0
}
}
}
], - "skip": 0,
- "limit": 0
}
Get a map histogram
xrfFluorescenceMappingId required | integer (Xrffluorescencemappingid) |
x | integer (Y position) |
y | integer (Y position) |
{- "xrfFluorescenceMappingId": 0,
- "x": 0,
- "y": 0,
- "value": 0
}
Get a list of queued containers
proposal | string (Proposal) ^(\w|-)+\d+$ Proposal name to filter by |
beamLineName | string (Beamlinename) Beamline name to filter by |
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "containerQueueId": 0,
- "createdTimeStamp": "2019-08-24T14:15:22Z",
- "completedTimeStamp": "2019-08-24T14:15:22Z",
- "Container": {
- "code": "string",
- "dewarId": 0,
- "containerType": "string",
- "capacity": 0,
- "containerStatus": "string",
- "sampleChangerLocation": "string",
- "beamlineLocation": "string",
- "containerId": 0,
- "Dewar": {
- "code": "string",
- "Shipping": {
- "proposalId": 0,
- "shippingName": "string"
}
}, - "_metadata": {
- "samples": 0,
- "assigned": true
}
}, - "_metadata": {
- "samples": 0
}
}
], - "skip": 0,
- "limit": 0
}
Update a queued container
containerQueueId required | integer (Containerqueueid) |
completed | boolean (Completed) |
{- "completed": true
}
{- "containerQueueId": 0,
- "createdTimeStamp": "2019-08-24T14:15:22Z",
- "completedTimeStamp": "2019-08-24T14:15:22Z",
- "Container": {
- "code": "string",
- "dewarId": 0,
- "containerType": "string",
- "capacity": 0,
- "containerStatus": "string",
- "sampleChangerLocation": "string",
- "beamlineLocation": "string",
- "containerId": 0,
- "Dewar": {
- "code": "string",
- "Shipping": {
- "proposalId": 0,
- "shippingName": "string"
}
}, - "_metadata": {
- "samples": 0,
- "assigned": true
}
}, - "_metadata": {
- "samples": 0
}
}
Get a list of queued samples and sub samples
status | any (QueuedSampleStatus) Enum: "Queued" "Completed" "Failed" An enumeration. |
proposal | string (Proposal) ^(\w|-)+\d+$ Proposal name to filter by |
blSampleId | integer (Blsampleid) Sample id to filter by |
containerId | integer (Containerid) Container id to filter by |
beamLineName | string (Beamlinename) Beamline name to filter by |
order_by | any (QueuedSampleOrder) Enum: "containerQueueSampleId" "started" "finished" Field to order by |
order | string (Order) Enum: "asc" "desc" Order direction |
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "containerQueueSampleId": 0,
- "dataCollectionPlanId": 0,
- "blSubSampleId": 0,
- "BLSample": {
- "blSampleId": 0,
- "name": "string"
}, - "BLSubSample": {
- "type": "string",
- "BLSample": {
- "blSampleId": 0,
- "name": "string"
}
}, - "DiffractionPlan": {
- "diffractionPlanId": 0,
- "recordTimeStamp": "2019-08-24T14:15:22Z",
- "scanParameters": null,
- "monoBandwidth": 0
}, - "_metadata": {
- "datacollections": [
- {
- "dataCollectionId": 0,
- "runStatus": "string"
}
], - "dataCollectionGroupId": 0,
- "sessionId": 0,
- "proposal": "string",
- "started": "2019-08-24T14:15:22Z",
- "finished": "2019-08-24T14:15:22Z",
- "types": [
- "string"
]
}
}
], - "skip": 0,
- "limit": 0
}
Get a list of container history
proposal | string (Proposal) ^(\w|-)+\d+$ Proposal name to filter by |
containerId | integer (Containerid) Container id to filter by |
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "containerHistoryId": 0,
- "containerId": 0,
- "blTimeStamp": "2019-08-24T14:15:22Z",
- "location": "string",
- "beamlineName": "string",
- "status": "string"
}
], - "skip": 0,
- "limit": 0
}
Get a list of containers
assigned | boolean (Assigned) Default: false List containers assigned on a beamline |
proposal | string (Proposal) ^(\w|-)+\d+$ Proposal name to filter by |
beamLineName | string (Beamlinename) Beamline name to filter by |
dewarId | integer (Dewarid) Dewar id to filter by |
search | string (Search) Search string to filter by |
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "code": "string",
- "dewarId": 0,
- "containerType": "string",
- "capacity": 0,
- "containerStatus": "string",
- "sampleChangerLocation": "string",
- "beamlineLocation": "string",
- "containerId": 0,
- "Dewar": {
- "code": "string",
- "Shipping": {
- "proposalId": 0,
- "shippingName": "string"
}
}, - "_metadata": {
- "samples": 0,
- "assigned": true
}
}
], - "skip": 0,
- "limit": 0
}
Create a new container
code required | string (Name) |
dewarId required | integer (Dewarid) |
containerType required | string (Container Type) |
capacity | integer (Capacity) |
containerStatus | string (Status) |
sampleChangerLocation | string (Sample Changer Location) Position in sample change |
beamlineLocation | string (Beamline Location) Beamline if container is assigned |
{- "code": "string",
- "dewarId": 0,
- "containerType": "string",
- "capacity": 0,
- "containerStatus": "string",
- "sampleChangerLocation": "string",
- "beamlineLocation": "string"
}
{- "code": "string",
- "dewarId": 0,
- "containerType": "string",
- "capacity": 0,
- "containerStatus": "string",
- "sampleChangerLocation": "string",
- "beamlineLocation": "string",
- "containerId": 0,
- "Dewar": {
- "code": "string",
- "Shipping": {
- "proposalId": 0,
- "shippingName": "string"
}
}, - "_metadata": {
- "samples": 0,
- "assigned": true
}
}
Get the default session container
sessionId required | integer (Sessionid) |
{- "code": "string",
- "dewarId": 0,
- "containerType": "string",
- "capacity": 0,
- "containerStatus": "string",
- "sampleChangerLocation": "string",
- "beamlineLocation": "string",
- "containerId": 0,
- "Dewar": {
- "code": "string",
- "Shipping": {
- "proposalId": 0,
- "shippingName": "string"
}
}, - "_metadata": {
- "samples": 0,
- "assigned": true
}
}
Get a container
containerId required | integer (Containerid) |
{- "code": "string",
- "dewarId": 0,
- "containerType": "string",
- "capacity": 0,
- "containerStatus": "string",
- "sampleChangerLocation": "string",
- "beamlineLocation": "string",
- "containerId": 0,
- "Dewar": {
- "code": "string",
- "Shipping": {
- "proposalId": 0,
- "shippingName": "string"
}
}, - "_metadata": {
- "samples": 0,
- "assigned": true
}
}
Update a Container
containerId required | integer (Containerid) |
code | string (Code) |
dewarId | integer (Dewarid) |
containerType | string (Containertype) |
capacity | integer (Capacity) |
containerStatus | string (Containerstatus) |
sampleChangerLocation | string (Samplechangerlocation) |
beamlineLocation | string (Beamlinelocation) |
{- "code": "string",
- "dewarId": 0,
- "containerType": "string",
- "capacity": 0,
- "containerStatus": "string",
- "sampleChangerLocation": "string",
- "beamlineLocation": "string"
}
{- "code": "string",
- "dewarId": 0,
- "containerType": "string",
- "capacity": 0,
- "containerStatus": "string",
- "sampleChangerLocation": "string",
- "beamlineLocation": "string",
- "containerId": 0,
- "Dewar": {
- "code": "string",
- "Shipping": {
- "proposalId": 0,
- "shippingName": "string"
}
}, - "_metadata": {
- "samples": 0,
- "assigned": true
}
}
Get a list of people
userGroupId | integer (Usergroupid) |
showAll | boolean (Showall) Default: false |
proposal | string (Proposal) ^(\w|-)+\d+$ Proposal name to filter by |
sessionId | integer (Sessionid) Session id to filter by |
search | string (Search) Search string to filter by |
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "personId": 0,
- "givenName": "string",
- "familyName": "string",
- "login": "string",
- "_metadata": {
- "sessions": 0,
- "lastSession": "2019-08-24T14:15:22Z",
- "role": "string",
- "remote": true
}
}
], - "skip": 0,
- "limit": 0
}
Get a list of proteins
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 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 (ProteinOrder) Enum: "proteinId" "acronym" "name" Field to order by |
order | string (Order) Enum: "asc" "desc" Order direction |
{- "total": 0,
- "results": [
- {
- "name": "string",
- "acronym": "string",
- "proposalId": 0,
- "sequence": "string",
- "density": 0,
- "molecularMass": 0,
- "containmentLevel": "string",
- "hazardGroup": "string",
- "safetyLevel": "string",
- "ComponentType": {
- "componentTypeId": 0,
- "name": "string"
}, - "proteinId": 0,
- "_metadata": {
- "crystals": 0,
- "samples": 0,
- "datacollections": 0
}
}
], - "skip": 0,
- "limit": 0
}
Get a protein
proteinId required | integer (Proteinid) |
{- "name": "string",
- "acronym": "string",
- "proposalId": 0,
- "sequence": "string",
- "density": 0,
- "molecularMass": 0,
- "containmentLevel": "string",
- "hazardGroup": "string",
- "safetyLevel": "string",
- "ComponentType": {
- "componentTypeId": 0,
- "name": "string"
}, - "proteinId": 0,
- "_metadata": {
- "crystals": 0,
- "samples": 0,
- "datacollections": 0
}
}
Update a Protein
proteinId required | integer (Proteinid) |
name | string (Name) |
acronym | string (Acronym) |
sequence | string (Sequence) |
density | number (Density) |
molecularMass | number (Molecularmass) |
object (ComponentTypeOptional) |
{- "name": "string",
- "acronym": "string",
- "sequence": "string",
- "density": 0,
- "molecularMass": 0,
- "ComponentType": {
- "componentTypeId": 0,
- "name": "string"
}
}
{- "name": "string",
- "acronym": "string",
- "proposalId": 0,
- "sequence": "string",
- "density": 0,
- "molecularMass": 0,
- "containmentLevel": "string",
- "hazardGroup": "string",
- "safetyLevel": "string",
- "ComponentType": {
- "componentTypeId": 0,
- "name": "string"
}, - "proteinId": 0,
- "_metadata": {
- "crystals": 0,
- "samples": 0,
- "datacollections": 0
}
}
Get a list of dewars
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) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "shippingId": 0,
- "code": "string",
- "dewarType": "string",
- "dewarId": 0,
- "Shipping": {
- "proposalId": 0,
- "shippingName": "string"
}
}
], - "skip": 0,
- "limit": 0
}
Create a new dewar
shippingId required | integer (Shippingid) |
code required | string (Name) |
dewarType | string (Dewartype) |
{- "shippingId": 0,
- "code": "string",
- "dewarType": "string"
}
{- "shippingId": 0,
- "code": "string",
- "dewarType": "string",
- "dewarId": 0,
- "Shipping": {
- "proposalId": 0,
- "shippingName": "string"
}
}
Update a Dewar
dewarId required | integer (Dewarid) |
code | string (Code) |
dewarType | string (Dewartype) |
{- "code": "string",
- "dewarType": "string"
}
{- "shippingId": 0,
- "code": "string",
- "dewarType": "string",
- "dewarId": 0,
- "Shipping": {
- "proposalId": 0,
- "shippingName": "string"
}
}
Get a list of events
blSubSampleType | string (SubSampleType) Enum: "roi" "poi" "loi" An enumeration. |
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) > 0 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 |
{- "total": 0,
- "results": [
- {
- "id": 0,
- "type": "string",
- "startTime": "2019-08-24T14:15:22Z",
- "endTime": "2019-08-24T14:15:22Z",
- "duration": 0,
- "count": 0,
- "session": "string",
- "sessionId": 0,
- "proposal": "string",
- "blSample": "string",
- "blSampleId": 0,
- "attachments": 0,
- "Item": {
- "runStatus": "string",
- "imageDirectory": "string",
- "fileTemplate": "string",
- "imageContainerSubPath": "string",
- "numberOfImages": 0,
- "numberOfPasses": 0,
- "wavelength": 0,
- "exposureTime": 0,
- "flux": 0,
- "xBeam": 0,
- "yBeam": 0,
- "beamSizeAtSampleX": 0,
- "beamSizeAtSampleY": 0,
- "transmission": 0,
- "resolution": 0,
- "detectorDistance": 0,
- "axisStart": 0,
- "axisEnd": 0,
- "axisRange": 0,
- "rotationAxis": "string",
- "overlap": 0,
- "phiStart": 0,
- "kappaStart": 0,
- "omegaStart": 0,
- "chiStart": 0,
- "xBeamPix": 0,
- "yBeamPix": 0,
- "magnification": 0,
- "binning": 0,
- "particleDiameter": 0,
- "defocusStepSize": 0,
- "amountAstigmatism": 0,
- "voltage": 0,
- "objAperture": 0,
- "dataCollectionId": 0,
- "DataCollectionGroup": {
- "dataCollectionGroupId": 0,
- "experimentType": "string",
- "Workflow": {
- "workflowId": 0,
- "comments": "string",
- "status": "string",
- "workflowTitle": "string",
- "workflowType": "string"
}
}, - "GridInfo": [
- {
- "gridInfoId": 0,
- "xOffset": 0,
- "yOffset": 0,
- "dx_mm": 0,
- "dy_mm": 0,
- "steps_x": 0,
- "steps_y": 0,
- "patchesX": 0,
- "patchesY": 0,
- "meshAngle": 0,
- "orientation": "string",
- "pixelsPerMicronX": 0,
- "pixelsPerMicronY": 0,
- "snapshot_offsetXPixel": 0,
- "snapshot_offsetYPixel": 0,
- "snaked": true
}
], - "BLSubSample": {
- "blSubSampleId": 0,
- "type": "string"
}, - "_metadata": {
- "snapshots": {
- "property1": true,
- "property2": true
}
}
}
}
], - "skip": 0,
- "limit": 0
}
Get a list of event types
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 |
beamLineName | string (Beamlinename) Beamline name to filter by |
{- "total": 0,
- "results": [
- {
- "eventTypeName": "string",
- "eventType": "string"
}
], - "skip": 0,
- "limit": 0
}
Get image histogram data
imageNumber required | integer (Imagenumber) |
dataCollectionId | integer (Datacollectionid) Data collection id to filter by |
{- "values": [
- 0
], - "bins": [
- 0
], - "shape": [
- null
], - "max": 0
}
h5grove /attr/
endpoint handler
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 |
null
h5grove /data/
endpoint handler
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 |
null
h5grove /meta/
endpoint handler
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 |
null
h5grove /stats/
endpoint handler
path | string (Path) Default: "/" |
selection | any (Selection) |
autoProcProgramAttachmentId | integer (AutoProcProgramAttachment id) |
robotActionId | integer (RobotAction id) |
dataCollectionId | integer (Datacollectionid) Data collection id to filter by |
null
Get list of admin activity
action_type | string (ActionType) Enum: "db_options" "online" An enumeration. |
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "username": "string",
- "action": "string",
- "comments": "string",
- "dateTime": "2019-08-24T14:15:22Z"
}
], - "skip": 0,
- "limit": 0
}
Get a list of UserGroups
userGroupId | integer (Usergroupid) UserGroup id to filter by |
skip | integer (Skip) >= 0 Default: 0 Results to skip |
limit | integer (Limit) > 0 Default: 25 Number of results to show |
search | string (Search) Search string to filter by |
{- "total": 0,
- "results": [
- {
- "name": "string",
- "userGroupId": 0,
- "_metadata": {
- "permissions": 0,
- "people": 0
}
}
], - "skip": 0,
- "limit": 0
}
Add a new UserGroup
name required | string (Name) The name of the group |
{- "name": "string"
}
{- "name": "string",
- "userGroupId": 0,
- "_metadata": {
- "permissions": 0,
- "people": 0
}
}
Update a UserGroup
userGroupId required | integer (Usergroupid) |
name | string (Name) |
{- "name": "string"
}
{- "name": "string",
- "userGroupId": 0,
- "_metadata": {
- "permissions": 0,
- "people": 0
}
}
Add a Permission to a UserGroup
userGroupId required | integer (Usergroupid) |
permissionId required | integer (Permission) |
{- "permissionId": 0
}
{- "detail": [
- {
- "loc": [
- "string"
], - "msg": "string",
- "type": "string"
}
]
}
Remove a Permission from a UserGroup
userGroupId required | integer (Usergroupid) |
permissionId required | integer (Permissionid) |
{- "detail": [
- {
- "loc": [
- "string"
], - "msg": "string",
- "type": "string"
}
]
}
Add a Person to a UserGroup
userGroupId required | integer (Usergroupid) |
personId required | integer (Person) |
{- "personId": 0
}
{- "detail": [
- {
- "loc": [
- "string"
], - "msg": "string",
- "type": "string"
}
]
}
Get a list of Permissions
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) > 0 Default: 25 Number of results to show |
{- "total": 0,
- "results": [
- {
- "type": "string",
- "description": "string",
- "permissionId": 0
}
], - "skip": 0,
- "limit": 0
}
Add a new Permission
type required | string (Permission) <= 15 characters The permission identifier |
description | string (Description) <= 100 characters Description of this permission |
{- "type": "string",
- "description": "string"
}
{- "type": "string",
- "description": "string",
- "permissionId": 0
}
Update a Permission
permissionId required | integer (Permissionid) |
type | string (Type) <= 15 characters |
description | string (Description) <= 100 characters |
{- "type": "string",
- "description": "string"
}
{- "type": "string",
- "description": "string",
- "permissionId": 0
}